创建多播组并将设备添加到组 - AWS IoT Wireless
先决条件使用控制台查创建多播组使用 API 创建多播组后续步骤

创建多播组并将设备添加到组

您可以使用控制台或 CLI 创建多播组。如果您是第一次创建多播组，我们建议您使用控制台添加多播组。如果要管理多播组并在组中添加或删除设备时，可以使用 CLI。

在与添加的终端设备交换信令之后，适用于 LoRaWAN 的 AWS IoT Core 与终端设备建立共享密钥并设置数据传输的参数。

先决条件

在创建多播组并将设备添加到组之前，请执行以下操作：

  • 通过指定 FUOTA 配置参数 GenAppKey 和 FPorts，为设备多播和 FUOTA 设置做好准备。有关更多信息，请参阅为组播和 FUOTA 配置准备设备。

  • 检查设备是否支持 B 类或 C 类操作模式。根据您的设备支持的设备类别，选择支持 B 类或支持 C 类或两者都支持的的设备配置文件。有关设备配置文件的更多信息，请参阅 将配置文件添加到 适用于 LoRaWAN 的 AWS IoT Core。

    在多播会话开始时，使用 B 类或 C 类分发窗口向组中的设备发送下行链路消息。

使用控制台查创建多播组

要使用控制台创建多播组，请转至 AWS IoT 控制台的 Multicast groups（多播组）页面并选择 Create multicast group（创建多播组）。

  1. 创建多播组

    要创建您的多播组，请为组指定多播属性和标签。

    1. 指定多播属性

      要指定多播属性，请为多播组输入下列信息。

      • 名称：为您的多播组输入唯一的名称。名称只能包含字母、数字、连字符和下划线。它不能包含空格。

      • 说明：您可以为多播组提供可选描述。描述的长度最多为 2,048 个字符。

    2. 多播组的标签

      您可以选择提供任何键值作为多播组的 标签。要继续创建多播组，请选择 Next（下一步）。

  2. 将设备添加到多播组

    您可以将单个设备或一组设备添加到多播组中。要添加设备：

    1. 指定 RFRegion

      为您的多播组指定RfRegion或频段。的您的多播组RfRegion必须匹配您在多播组中添加设备的 RfRegion。有关 RfRegion 的更多信息，请参阅 为您的网关和设备连接选择 LoRa 频带。

    2. 选择多播设备类别

      在多播会话开始时，选择您希望多播组中的设备切换到 B 类还是 C 类模式。B 类会话可以在常规的下行链路槽接收下行链路消息，C 类会话可以随时接收下行链路消息。

    3. 选择您想要添加在组中的设备。

      选择您要在多播组中单独添加设备还是批量添加设备。

      • 要单独添加设备，请输入要添加到组的每台设备的无线设备 ID。

      • 要批量添加设备，您可以按设备配置文件或标签筛选要添加的设备。对于设备配置文件，您可以添加带支持 B 类、C 类或支持两者的配置文件的设备。

    4. 要创建多播组，请选择 Create （创建）。

      组 中出现多播组详细信息和您添加的设备 。有关多播组和设备的状态以及对任何问题的故障排除信息，请参阅 监控多播组和组中设备的状态并对进行故障排除。

创建多播组后，您可以选择 Action（操作）编辑、删除或将设备添加到多播组中。添加设备后，您可以调度会话，将下行链路负载发送到组中的设备。

使用 API 创建多播组

要使用 API 创建多播组并将设备添加到组中，请执行以下操作：

  1. 创建多播组

    要创建多播组，请使用CreateMulticastGroup API 操作或 create-multicast-groupCLI 命令。您可以将 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 命令来更新、删除或获取有关多播组的信息。

  2. 将设备添加到多播组

    您可以将设备单独添加或批量添加到多播组。

    • 要将设备批量添加到多播组，请使用 StartBulkAssociateWirelessDeviceWithMulticastGroup API 操作或 start-bulk-associate-wireless-device-with-multicast-groupCLI 命令。要筛选批量添加到多播组的设备，请提供查询字符串。下面说明了如何通过相关的特定 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。

    • 要将设备单独添加到多播组中，请使用 AssociateWirelessDeviceWithMulticastGroup API 操作或 associate-wireless-device-with-multicast-group 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 命令获取有关多播组的信息或取消设备的关联。

后续步骤

创建多播组并添加设备后，您可以继续添加设备并监控多播组和设备的状态。如果您的设备已成功添加到组中，可以配置并调度向设备发送下行链路消息。在发送下行链路消息之前，设备的状态必须为多播设置已就绪。调度下行链路消息后，状态将变为尝试会话。有关更多信息，请参阅调度向多播组中的设备发送下行链路消息。

如果要更新多播组中设备的固件，可以通过以下方式用 适用于 LoRaWAN 的 AWS IoT Core 执行无线固件更新 (FUOTA)。有关更多信息，请参阅对 适用于 LoRaWAN 的 AWS IoT Core 设备进行无线固件更新（FUOTA）。

如果没有添加设备，或如果在多播组或设备状态中看到错误，可以将鼠标悬停在错误上获取更多信息并解决问题。如果错误仍然存在，有关如何排查和解决问题的信息，请参阅 监控多播组和组中设备的状态并对进行故障排除。