# 创建多播组并将设备添加到组
您可以使用控制台或 CLI 创建多播组。如果您是第一次创建多播组，我们建议您使用控制台添加多播组。如果要管理多播组并在组中添加或删除设备时，可以使用 CLI。
在与添加的终端设备交换信令之后，适用于 LoRaWAN 的 AWS IoT Core 与终端设备建立共享密钥并设置数据传输的参数。
## 先决条件
在创建多播组并将设备添加到组之前，请执行以下操作：
+ 通过指定 FUOTA 配置参数 `GenAppKey` 和 `FPorts`，为设备多播和 FUOTA 设置做好准备。有关更多信息，请参阅[为组播和 FUOTA 配置准备设备](lorawan-prepare-devices-multicast.md)。
+ 检查设备是否支持 B 类或 C 类操作模式。根据您的设备支持的设备类别，选择**支持 B 类**或**支持 C 类**或两者都支持的的设备配置文件。有关设备配置文件的更多信息，请参阅 [将配置文件添加到 适用于 LoRaWAN 的 AWS IoT Core](lorawan-define-profiles.md)。
在多播会话开始时，使用 B 类或 C 类分发窗口向组中的设备发送下行链路消息。
## 使用控制台查创建多播组
要使用控制台创建多播组，请转至 AWS IoT 控制台的 [Multicast groups](https://console.aws.amazon.com/iot/home#/wireless/multicastGroups)（多播组）页面并选择 **Create multicast group**（创建多播组）。
1.
**创建多播组**
要创建您的多播组，请为组指定多播属性和标签。
1.
**指定多播属性**
要指定多播属性，请为多播组输入下列信息。
+ **名称**：为您的多播组输入唯一的名称。名称只能包含字母、数字、连字符和下划线。它不能包含空格。
+ **说明**：您可以为多播组提供可选描述。描述的长度最多为 2,048 个字符。
1.
**多播组的标签**
您可以选择提供任何键值作为多播组的 **标签**。要继续创建多播组，请选择 **Next**（下一步）。
1.
**将设备添加到多播组**
您可以将单个设备或一组设备添加到多播组中。要添加设备：
1.
**指定 RFRegion**
为您的多播组指定**RfRegion**或频段。的您的多播组**RfRegion**必须匹配您在多播组中添加设备的 **RfRegion**。有关 **RfRegion** 的更多信息，请参阅 [为您的网关和设备连接选择 LoRa 频带](lorawan-rfregion-permissions.md#lorawan-frequency-bands)。
1.
**选择多播设备类别**
在多播会话开始时，选择您希望多播组中的设备切换到 B 类还是 C 类模式。B 类会话可以在常规的下行链路槽接收下行链路消息，C 类会话可以随时接收下行链路消息。
1.
**选择您想要添加在组中的设备。**
选择您要在多播组中单独添加设备还是批量添加设备。
+ 要单独添加设备，请输入要添加到组的每台设备的无线设备 ID。
+ 要批量添加设备，您可以按设备配置文件或标签筛选要添加的设备。对于设备配置文件，您可以添加带支持 B 类、C 类或支持两者的配置文件的设备。
1. 要创建多播组，请选择 **Create** （创建）。
组 中出现多播组详细信息和您添加的设备 。有关多播组和设备的状态以及对任何问题的故障排除信息，请参阅 [监控多播组和组中设备的状态并对进行故障排除](lorawan-multicast-status.md)。
创建多播组后，您可以选择 **Action**（操作）编辑、删除或将设备添加到多播组中。添加设备后，您可以调度会话，将下行链路负载发送到组中的设备。
## 使用 API 创建多播组
要使用 API 创建多播组并将设备添加到组中，请执行以下操作：
1.
**创建多播组**
要创建多播组，请使用[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateMulticastGroup.html) API 操作或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-multicast-group.html)CLI 命令。您可以将 `input.json` 文件作为 `create-multicast-group` 命令的输入。
```
aws iotwireless create-multicast-group \
--cli-input-json file://input.json
```
其中：
**input.json 的内容**
```
{
"Description": "Multicast group to send downlink payload and perform FUOTA.",
"LoRaWAN": {
"DlClass": "ClassB",
"RfRegion": "US915"
},
"Name": "MC_group_FUOTA"
}
```
创建多播组后，您可以使用下列 API 操作或 CLI 命令来更新、删除或获取有关多播组的信息。
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup) 或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup) 或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListMulticastGroups](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListMulticastGroups) 或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-multicast-groups.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-multicast-groups.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteMulticastGroup) 或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-multicast-group.html)
1.
**将设备添加到多播组**
您可以将设备单独添加或批量添加到多播组。
+ 要将设备批量添加到多播组，请使用 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkAssociateWirelessDeviceWithMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkAssociateWirelessDeviceWithMulticastGroup.html) API 操作或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-associate-wireless-device-with-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-associate-wireless-device-with-multicast-group.html)CLI 命令。要筛选批量添加到多播组的设备，请提供查询字符串。下面说明了如何通过相关的特定 ID 添加一组具有配置文件的设备。
```
aws iotwireless start-bulk-associate-wireless-device-with-multicast-group \
--id "12abd34e-5f67-89c2-9293-593b1bd862e0" \
--cli-input-json file://input.json
```
其中：
**input.json 的内容**
```
{
"QueryString": "DeviceProfileName: MyWirelessDevice AND DeviceProfileId: d6d8ef8e-7045-496d-b3f4-ebcaa1d564bf",
"Tags": [
{
"Key": "Multicast",
"Value": "ClassB"
}
]
}
```
在这里，`multicast-groups/d6d8ef8e-7045-496d-b3f4-ebcaa1d564bf/bulk` 是用于将设备与组进行关联的 URL。
+ 要将设备单独添加到多播组中，请使用 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithMulticastGroup.html) API 操作或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-wireless-device-with-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-wireless-device-with-multicast-group.html) CLI。为要添加到组的每个设备提供无线设备 ID。
```
aws iotwireless associate-wireless-device-with-multicast-group \
--id "12abd34e-5f67-89c2-9293-593b1bd862e0" \
--wireless-device-id "ab0c23d3-b001-45ef-6a01-2bc3de4f5333"
```
创建多播组后，您可以使用以下 API 操作或 CLI 命令获取有关多播组的信息或取消设备的关联。
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromMulticastGroup.html) 或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-wireless-device-from-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-wireless-device-from-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkDisassociateWirelessDeviceFromMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkDisassociateWirelessDeviceFromMulticastGroup.html) 或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-disassociate-wireless-device-from-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-disassociate-wireless-device-from-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices) 或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-wireless-devices.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-wireless-devices.html)
**注意**
`ListWirelessDevices` API 操作可用于列出一般的无线设备，以及与多播组或 FUOTA 任务关联的无线设备。
要列出与多播组关联的无线设备，请将 `ListWirelessDevices` API 操作和 `MulticastGroupID` 用作筛选器。
要列出与 FUOTA 任务关联的无线设备，请将 `ListWirelessDevices` API 操作和 `FuotaTaskID` 用作筛选器。
## 后续步骤
创建多播组并添加设备后，您可以继续添加设备并监控多播组和设备的状态。如果您的设备已成功添加到组中，可以配置并调度向设备发送下行链路消息。在发送下行链路消息之前，设备的状态必须为**多播设置已就绪**。调度下行链路消息后，状态将变为**尝试会话**。有关更多信息，请参阅[调度向多播组中的设备发送下行链路消息](lorawan-multicast-schedule-downlink.md)。
如果要更新多播组中设备的固件，可以通过以下方式用 适用于 LoRaWAN 的 AWS IoT Core 执行无线固件更新 (FUOTA)。有关更多信息，请参阅[对 适用于 LoRaWAN 的 AWS IoT Core 设备进行无线固件更新（FUOTA）](lorawan-mc-fuota-overview.md)。
如果没有添加设备，或如果在多播组或设备状态中看到错误，可以将鼠标悬停在错误上获取更多信息并解决问题。如果错误仍然存在，有关如何排查和解决问题的信息，请参阅 [监控多播组和组中设备的状态并对进行故障排除](lorawan-multicast-status.md)。