本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
创建多播组并将设备添加到组
您可以使用控制台或 CLI 创建多播组。如果您是第一次创建多播组,我们建议您使用控制台添加多播组。如果要管理多播组并在组中添加或删除设备时,可以使用 CLI。
在与添加的终端设备交换信令之后,Amazon IoT Core for LoRaWAN 与终端设备建立共享密钥并设置数据传输的参数。
先决条件
在创建多播组并将设备添加到组之前,请执行以下操作:
-
通过指定 FUOTA 配置参数
GenAppKey
和FPorts
,为设备多播和 FUOTA 设置做好准备。有关更多信息,请参阅为多播和 FUOTA 配置准备设备: -
检查设备是否支持 B 类或 C 类操作模式。根据您的设备支持的设备类别,选择支持 B 类或支持 C 类或两者都支持的的设备配置文件。有关设备配置文件的更多信息,请参阅 将配置文件添加到 Amazon IoT Core for LoRaWAN。
在多播会话开始时,使用 B 类或 C 类分发窗口向组中的设备发送下行链路消息。
使用控制台查创建多播组
要使用控制台创建多播组,请转至 Amazon IoT 控制台的 Multicast groups
-
创建多播组
要创建您的多播组,请为组指定多播属性和标签。
-
指定多播属性
要指定多播属性,请为多播组输入下列信息。
-
名称:为您的多播组输入唯一的名称。名称只能包含字母、数字、连字符和下划线。它不能包含空格。
-
说明:您可以为多播组提供可选描述。描述的长度最多为 2,048 个字符。
-
-
多播组的标签
您可以选择提供任何键值作为多播组的 标签。要继续创建多播组,请选择 Next(下一步)。
-
-
将设备添加到多播组
您可以将单个设备或一组设备添加到多播组中。要添加设备:
-
指定 RFRegion
为您的多播组指定RfRegion或频段。的您的多播组RfRegion必须匹配您在多播组中添加设备的 RfRegion。有关 RfRegion 的更多信息,请参阅 考虑选择LoRa网关和设备连接的频段。
-
选择多播设备类别
在多播会话开始时,选择您希望多播组中的设备切换到 B 类还是 C 类模式。B 类会话可以在常规的下行链路槽接收下行链路消息,C 类会话可以随时接收下行链路消息。
-
选择您想要添加在组中的设备。
选择您要在多播组中单独添加设备还是批量添加设备。
-
要单独添加设备,请输入要添加到组的每台设备的无线设备 ID。
-
要批量添加设备,您可以按设备配置文件或标签筛选要添加的设备。对于设备配置文件,您可以添加带支持 B 类、C 类或支持两者的配置文件的设备。
-
-
要创建多播组,请选择 Create (创建)。
组 中出现多播组详细信息和您添加的设备 。有关多播组和设备的状态以及对任何问题的故障排除信息,请参阅 监控多播组和组中设备的状态并对进行故障排除。
-
创建多播组后,您可以选择 Action(操作)编辑、删除或将设备添加到多播组中。添加设备后,您可以调度会话,将下行链路负载发送到组中的设备。
使用 API 创建多播组
要使用 API 创建多播组并将设备添加到组中,请执行以下操作:
-
创建多播组
要创建多播组,请使用
CreateMulticastGroup
API 操作或create-multicast-group
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 updates.", "LoRaWAN": { "DlClass": "ClassB", "RfRegion": "US915" }, "Name": "MC_group_FUOTA" }
创建多播组后,您可以使用下列 API 操作或 CLI 命令来更新、删除或获取有关多播组的信息。
-
将设备添加到多播组
您可以将设备单独添加或批量添加到多播组。
-
要将设备批量添加到多播组,请使用
StartBulkAssociateWirelessDeviceWithMulticastGroup
API 操作或start-bulk-associate-wireless-device-with-multicast-group
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。 -
要将设备单独添加到多播组中,请使用
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 命令获取有关多播组的信息或取消设备的关联。
-
DisassociateWirelessDeviceFromMulticastGroup
或者disassociate-wireless-device-from-multicast-group
-
StartBulkDisassociateWirelessDeviceFromMulticastGroup
或者start-bulk-disassociate-wireless-device-from-multicast-group
-
ListWirelessDevices
或者list-wireless-devices
注意
ListWirelessDevices
API 操作可用于列出一般的无线设备,以及与多播组或 FUOTA 任务关联的无线设备。-
要列出与多播组关联的无线设备,请将
ListWirelessDevices
API 操作和MulticastGroupID
用作筛选器。 -
要列出与 FUOTA 任务关联的无线设备,请将
ListWirelessDevices
API 操作和FuotaTaskID
用作筛选器。
-
-
后续步骤
创建多播组并添加设备后,您可以继续添加设备并监控多播组和设备的状态。如果您的设备已成功添加到组中,可以配置并调度向设备发送下行链路消息。在发送下行链路消息之前,设备的状态必须为多播设置已就绪。调度下行链路消息后,状态将变为尝试会话。有关更多信息,请参阅调度向多播组中的设备发送下行链路消息:
如果要更新多播组中设备的固件,可以通过以下方式用 Amazon IoT Core for LoRaWAN 执行无线固件更新 (FUOTA)。有关更多信息,请参阅Amazon IoT Core for LoRaWAN 设备的无线固件更新 (FUOTA):
如果没有添加设备,或如果在多播组或设备状态中看到错误,可以将鼠标悬停在错误上获取更多信息并解决问题。如果错误仍然存在,有关如何排查和解决问题的信息,请参阅 监控多播组和组中设备的状态并对进行故障排除。