Sidewalk デバイスのオンボーディングの概要

デバイスプロファイルの作成

Sidewalk デバイスの共有設定を含むデバイスプロファイルを作成します。プロファイルを作成するときは、プロファイルの name を英数字の文字列で指定します。プロファイルを作成するには、AWS IoT コンソールの [プロファイル] ハブの Sidewalk] タブに移動して [プロファイルを作成] を選択するか、この例に示すように CreateDeviceProfile API オペレーションまたは create-device-profile CLI コマンドを使用します。

// Add your device profile using a name and the sidewalk object.
aws iotwireless create-device-profile --name sidewalk_profile --sidewalk {}

Sidewalk のエンドデバイスの作成

AWS IoT Core for Amazon Sidewalk で Sidewalk のエンドデバイスを作成します。送信先名と、前の手順で取得したデバイスプロファイルの ID を指定します。デバイスを追加するには、AWS IoT コンソールの [デバイス] ハブの Sidewalk タブに移動して [デバイスをプロビジョニング] を選択するか、この例に示すように CreateWirelessDevice API オペレーションまたは create-wireless-device CLI コマンドを使用します。

// Add your Sidewalk device by using the device profile ID. 
aws iotwireless create-wireless-device --type "Sidewalk" --name sidewalk_device \ 
    --destination-name SidewalkDestination \
    --sidewalk DeviceProfileId="12345678-234a-45bc-67de-e8901234f0a1"

デバイスプロファイルとワイヤレスデバイス情報を取得する

デバイスプロファイルとワイヤレスデバイス情報を JSON として取得します。JSON には、デバイスの詳細、デバイス証明書、プライベートキー、DeviceTypeId、および Sidewalk 製造シリアル番号 (SMSN) に関する情報が含まれます。

IAM ロールの作成

データを AWS IoT ルールに送信するための AWS IoT Core for Amazon Sidewalk アクセス許可を付与する IAM ロールを作成します。このロールを作成するには、CreateRole API オペレーションまたは create-role CLI コマンドを使用します。ロールには SidewalkRole という名前を付けることができます。

aws iam create-role --role-name lambda-ex \ 
    --assume-role-policy-document file://lambda-trust-policy.json

送信先のルールを作成する

デバイスのデータを処理し、メッセージを公開するトピックを指定する AWS IoT ルールを作成します。ハードウェアプラットフォームに接続すると、このトピックに関するメッセージが表示されます。AWS IoT Core API オペレーション CreateTopicRule、または AWS CLI コマンド create-topic-rule を使用して、送信先のルールを作成します。

aws iot create-topic-rule --rule-name Sidewalkrule \ 
    --topic-rule-payload file://myrule.json

送信先を作成する

Sidewalk デバイスを、他の AWS のサービス で使用できるように処理する IoT ルールに関連付ける送信先を作成します。AWS IoT コンソールの [送信先] ハブ、CreateDestination API オペレーション、または create-destination CLI コマンドを使用して送信先を追加できます。

aws iotwireless create-destination --name SidewalkDestination \
    --expression-type RuleName --expression SidewalkRule \
    --role-arn arn:aws:iam::123456789012:role/SidewalkRole

Sidewalk エンドデバイスの接続

HDK をコンピュータに接続し、ベンダーのマニュアルに記載されている指示に従って HDK に接続します。詳細については、「Amazon Sidewalk ドキュメント」の「エンドデバイスのプロビジョニングと登録」を参照してください。

メッセージの表示と交換

MQTT クライアントを使用して、ルールで指定されたトピックをサブスクライブし、受信したメッセージを表示します。SendDataToWirelessDevice API オペレーションまたは send-data-to-wireless-device CLI コマンドを使用して、デバイスにダウンリンクメッセージを送信し、接続ステータスを確認することもできます。

(オプション) メッセージ配信ステータスイベントを有効にして、ダウンリンクメッセージが正常に受信されたかどうかを確認できます。

aws iotwireless send-data-to-wireless-device \
    --id "<Wireless_Device_ID>" \
    --payload-data "SGVsbG8gVG8gRGV2c2lt" \
    --wireless-metadata Sidewalk={Seq=1,AckModeRetryDurationSecs=10}