# マルチキャストグループを作成しグループにデバイスを追加する マルチキャストグループを作成してデバイスを追加する コンソールまたは CLI を使用して、マルチキャストグループを作成できます。初めてマルチキャストグループを作成する場合は、コンソールを使用してマルチキャストグループを追加することをお勧めします。マルチキャストグループの管理、グループからのデバイスの追加または削除には、CLI を使用できます。 追加したエンドデバイスとシグナリングを交換すると、AWS IoT Core for LoRaWAN によりエンドデバイスとの共有キーが確立され、データ転送のパラメータが設定されます。 ## 前提条件 マルチキャストグループを作成しグループにデバイスを追加するには、次の操作を実行します。 + FUOTA の設定パラメータ `GenAppKey` および `FPorts` を指定して、マルチキャストおよび FUOTA の設定用にデバイスを準備します。詳細については、「[マルチキャストおよび FUOTA 設定用のデバイスを準備する](lorawan-prepare-devices-multicast.md)」を参照してください。 + デバイスがクラス B またはクラス C のオペレーションモードをサポートしているかどうかを確認します。デバイスがサポートするデバイスクラスに応じて、**[Supports Class B]** (クラス B をサポート) または **[Supports Class C]** (クラス C をサポート) モードの一方または両方が有効なデバイスプロファイルを選択します。デバイスプロファイルの詳細については、「[プロファイルを AWS IoT Core for LoRaWAN に追加する](lorawan-define-profiles.md)」を参照してください。 マルチキャストセッションの開始時、グループ内のデバイスへのダウンリンクメッセージの送信に、クラス B またはクラス C の配信ウィンドウが使用されます。 ## コンソールを使用してマルチキャストグループを作成する コンソールを使用してマルチキャストグループを作成するには、AWS IoT コンソールの [[Multicast groups]](https://console.aws.amazon.com/iot/home#/wireless/multicastGroups) (マルチキャストグループ) ページに移動して、**[Create multicast group]** (マルチキャストグループの作成) を選択します。 1. **マルチキャストグループの作成** マルチキャストグループを作成するには、グループのマルチキャストプロパティおよびタグを指定します。 1. **マルチキャストプロパティの指定** マルチキャストプロパティを指定するには、マルチキャストグループについての次の情報を入力します。 + **Name** (名前): マルチキャストグループの一意の名前を入力します。名前には、文字、数字、ハイフン、またはアンダースコアのみを使用できます。スペースを含めることはできません。 + **Description** (説明): マルチキャストグループの説明をオプションで提供できます。説明の長さは最大 2,048 文字です。 1. **マルチキャストグループのタグ** オプションで、マルチキャストグループの **Tags** (タグ) として任意のキーと値の組み合わせを指定できます。マルチキャストグループの作成を続行するには、**[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 コマンドを使用します。`create-multicast-group` コマンドへの入力として `input.json` ファイルを指定できます。 ``` 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 タスクに関連付けられているワイヤレスデバイスを一覧表示するために使用できます。 マルチキャストグループに関連付けられているワイヤレスデバイスを一覧表示するには、フィルタとして `MulticastGroupID` を持つ `ListWirelessDevices` API オペレーションを使用します。 FUOTA タスクに関連付けられているワイヤレスデバイスを一覧表示するには、フィルタとして `ListWirelessDevices` を持つ `FuotaTaskID` API オペレーションを使用します。 ## 次のステップ マルチキャストグループを作成してデバイスを追加したら、デバイスの追加を続行したり、マルチキャストグループとデバイスのステータスをモニタリングできます。デバイスがグループに正常に追加されている場合、ダウンリンクメッセージがデバイスに送信されるように設定およびスケジュールできます。ダウンリンクメッセージを送信するには、デバイスのステータスが **[Multicast setup ready]** (マルチキャストのセットアップの準備が完了しました) である必要があります。ダウンリンクメッセージをスケジュールすると、ステータスは **[Session attempting]** (セッションの試行中) に変わります。詳細については、「[マルチキャストグループ内のデバイスに送信するダウンリンクメッセージをスケジュールする](lorawan-multicast-schedule-downlink.md)」を参照してください。 マルチキャストグループ内のデバイスのファームウェアを更新する場合、AWS IoT Core for LoRaWAN で Firmware Updates Over-The-Air (FUOTA) を実行できます。詳細については、「[AWS IoT Core for LoRaWAN デバイス用の Firmware Updates Over-The-Air (FUOTA)](lorawan-mc-fuota-overview.md)」を参照してください。 デバイスが追加されなかった場合、またはマルチキャストグループやデバイスのステータスにエラーが表示された場合は、エラーにカーソルを合わせると詳細情報を取得でき、解決することができます。それでもエラーが表示される場合は、問題のトラブルシューティングと解決方法の詳細について、「[マルチキャストグループおよびグループ内のデバイスのステータスのモニタリングとトラブルシューティング](lorawan-multicast-status.md)」を参照してください。