デバイスプロファイルと Sidewalk エンドデバイスを追加します - AWS IoT Wireless

デバイスプロファイルと Sidewalk エンドデバイスを追加します

このセクションでは、デバイスプロファイルを作成する方法を説明します。また、AWS IoT コンソールと AWS CLI を使用して Sidewalk エンドデバイスを AWS IoT Core for Amazon Sidewalk に追加する方法についても説明します。

Sidewalk デバイスを追加する (コンソール)

AWS IoT コンソールを使用して Sidewalk デバイスを追加するには、[デバイスハブの Sidewalk タブ] に移動し、[デバイスのプロビジョニング] を選択して、次の手順を実行します。

  1. デバイスの詳細を指定する

    Sidewalk デバイスの設定情報を指定します。新しいデバイスプロファイルを作成するか、Sidewalk デバイス用の既存のプロファイルを選択することもできます。

    1. デバイス名とオプションの説明を指定します。説明は最大 2,048 文字とすることができます。これらのフィールドは、デバイスの作成後に編集できます。

    2. Sidewalk デバイスに関連付けるデバイスプロファイルを選択します。既存のデバイスプロファイルがある場合は、プロファイルを選択できます。新しいプロファイルを作成する場合は、[プロファイルの作成] を選択し、プロファイルの名前を入力します。

      注記

      デバイスプロファイルにタグを付けるには、プロファイルを作成した後、[プロファイルハブ] に移動し、プロファイルを編集してこの情報を追加します。

    3. デバイスから他の AWS のサービス にメッセージをルーティングする送信先の名前を指定します。まだ送信先を作成していない場合は、[送信先ハブ] に移動して送信先を作成してください。その後、Sidewalk デバイスの送信先を選択できます。詳細については、「Sidewalk エンドデバイスの送信先を追加する」を参照してください。

    4. Sidewalk デバイスの追加を続行するには、[次へ] を選択します。

  2. Sidewalk デバイスを AWS IoT モノと関連付ける (オプション)

    オプションで Sidewalk デバイスを AWS IoT モノに関連付けることができます。IoT モノは、AWS IoT デバイスレジストリのエントリです。モノを使用すると、デバイスの検索と管理を簡単に行えるようになります。モノをデバイスに関連付けると、デバイスから他の AWS IoT Core 機能にアクセスできます。

    デバイスをモノに関連付けるには、[モノの自動登録] を選択します。

    1. Sidewalk デバイスに関連付けたい IoT モノの固有の名前を入力します。モノの名前は大文字と小文字が区別され、AWS アカウント と AWS リージョン で一意でなければなりません。

    2. モノの種類や、モノのリストから絞り込むために使用できる検索可能な属性など、IoT モノに追加の設定があれば提供してください。

    3. [次へ] を選択し、Sidewalk デバイスに関する情報を確認してから、[作成] を選択します。

Sidewalk デバイスを追加する (CLI)

Sidewalk デバイスを追加し、Sidewalk デバイスのプロビジョニングに使用する JSON ファイルをダウンロードするには、次の API オペレーションを実行します。

ステップ 1: デバイスプロファイルを作成する

AWS アカウント でデバイスプロファイルを作成するには、CreateDeviceProfile API オペレーションまたは create-device-profile CLI コマンドを使用します。デバイスプロファイルを作成するときは、名前を指定し、任意のタグを名前と値のペアとして指定します。

例えば、次のコマンドは Sidewalk デバイス用のデバイスプロファイルを作成します。

aws iotwireless create-device-profile \ --name sidewalk_profile --sidewalk {}

このコマンドを実行すると、Amazon リソースネーム (ARN) とデバイスプロファイルの ID が出力として返されます。

{ "DeviceProfileArn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" }

ステップ 2: Sidewalk デバイスを追加する

Sidewalk デバイスを AWS IoT Core for Amazon Sidewalk のアカウントに追加するには、CreateWirelessDevice API オペレーションまたは create-wireless-device CLI コマンドを使用します。デバイスを作成するときは、Sidewalk デバイスのオプションの名前と説明に加えて、次のパラメータを指定します。

注記

Sidewalk デバイスを AWS IoT モノと関連付ける場合は、AssociateWirelessDeviceWithThing API オペレーションまたは associate-wireless-device-with-thing CLI コマンドを使用してください。

以下のコマンドは、Sidewalk デバイスの作成例を示しています。

aws iotwireless create-wireless-device \ --cli-input-json "file://device.json"

以下は、device.json ファイルの内容を示しています。

device.json の内容

{ "Type": "Sidewalk", "Name": "SidewalkDevice", "DestinationName": "SidewalkDestination", "Sidewalk": { "DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } }

このコマンドを実行すると、デバイス ID と Amazon リソースネーム (ARN) が出力として返されます。

{ "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678", "Id": "23456789-abcd-0123-bcde-fabc012345678" }