インポートタスクを使用した Sidewalk デバイスのプロビジョニング - AWS IoT Wireless
Sidewalk の一括プロビジョニングの仕組みSidewalk 一括プロビジョニングに関する主な考慮事項CSV ファイル形式Sidewalk 一括プロビジョニングの使用方法

インポートタスクを使用した Sidewalk デバイスのプロビジョニング

このセクションでは、AWS IoT コンソール、AWS IoT Core for Amazon Sidewalk の API オペレーション、または AWS CLI を使用して Sidewalk デバイスを一括プロビジョニングする方法について説明します。以下のセクションでは、Sidewalk デバイスを一括プロビジョニングする方法について説明します。

トピック

Sidewalk の一括プロビジョニングの仕組み

次の手順は、一括プロビジョニングの仕組みを示しています。

  1. ワイヤレスデバイスのインポートタスクを開始する

    Sidewalk デバイスを一括でプロビジョニングするには、インポートタスクを作成し、AWS IoT Core for Amazon Sidewalk にオンボードするデバイスの Sidewalk 製造シリアル番号 (SMSN) を入力する必要があります。製造元が制御ログを Amazon Sidewalk にアップロードした後、デバイスの Sidewalk 製造シリアル番号 (SMSN) を CSV ファイルとして E メールで取得しました。ワークフローと制御ログの取得方法の詳細については、「Amazon Sidewalk ドキュメント」の「Amazon Sidewalk デバイスの製造」を参照してください。

  2. インポートプロセスをバックグラウンドで実行する

    AWS IoT Core for Amazon Sidewalk はインポートタスクのリクエストを受け取ると、セットアップを開始し、システムを頻繁にポーリングするバックグラウンドプロセスを開始します。バックグラウンドプロセスがインポートタスクの指示を受け取ると、CSV ファイルの読み取りを開始します。AWS IoT Core for Amazon Sidewalk は同時に、制御ログが Amazon Sidewalk から受信されたかどうかをチェックします。

  3. ワイヤレスデバイスレコードを作成する

    Amazon Sidewalk から制御ログを受け取ったら、AWS IoT Core for Amazon Sidewalk は制御ログのシリアル番号が CSV ファイルの SMSN 値と一致するかどうかをチェックします。シリアル番号が一致すると、AWS IoT Core for Amazon Sidewalk はこれらのシリアル番号に対応する Sidewalk デバイスのワイヤレスデバイスレコードの作成を開始します。すべてのデバイスのオンボードが完了すると、インポートタスクは完了とマークされます。

Sidewalk 一括プロビジョニングに関する主な考慮事項

Sidewalk デバイスを AWS IoT Core for Amazon Sidewalk に一括プロビジョニングする場合、次の主な考慮事項があります。

  • デバイスプロファイルを作成したときと同じ AWS アカウント で、AWS IoT コンソールまたは AWS IoT Core for Amazon Sidewalk の API オペレーションを使用して、一括プロビジョニングを実行する必要があります。

  • Sidewalk デバイスを一括プロビジョニングする前に、デバイスプロファイルにファクトリーサポートを示す DAK 情報が含まれている必要があります。そうしないと、AWS IoT コンソールを使用した一括プロビジョニングや、一括プロビジョニング API オペレーションが失敗する可能性があります。

  • インポートタスクを開始した後、CSV ファイルの処理、ワイヤレスデバイスのインポート、およびワイヤレスデバイスの AWS IoT Core for Amazon Sidewalk へのオンボードに少なくとも 10 分以上かかる場合があります。

  • ワイヤレスデバイスのインポートタスクは、開始後 90 日間実行されます。この間、Amazon Sidewalk から制御ログを受信したかどうかを確認します。90 日以内に Amazon Sidewalk から制御ログが届かない場合、タスクの詳細を表示すると、そのタスクは「完了」としてマークされ、有効期限が切れたことを示すメッセージが表示されます。インポートタスクで制御ログを待機していたデバイスのオンボーディングステータスが「失敗」としてマークされます。

  • 既に作成したインポートタスクを更新しようとすると、そのタスクには、他のデバイスのみを追加できます。インポートタスクを作成した後、インポートタスクに既に追加されているデバイスでタスクが開始される前であれば、いつでも新しいデバイスを追加できます。更新ファイルに、元のインポートタスクに既に存在するデバイスのシリアル番号が含まれている場合、これらのシリアル番号は無視されます。

  • 更新オペレーションをリクエストすると、インポートタスクの作成時に使用したものと同じ IAM ロールが Amazon S3 バケットの CSV ファイルにアクセスするとみなされます。

  • インポートタスクは、タスクが既に正常に完了しているか、タスクが更新に失敗した場合にのみ削除できます。正しくない IAM ロールが提供された場合や、Amazon S3 バケットファイルが見つからない場合など、タスクの更新に失敗することがあります。インポートタスクが PENDING 状態の場合、更新も削除もできません。

  • タスクにインポートする CSV ファイルは、次のセクションで説明する形式を使用する必要があります。

CSV ファイル形式

インポートタスクに指定する Amazon S3 バケットに含まれる CSV ファイルは、次の形式を使用する必要があります。

  • 1 行目は smsn というキーワードを使用する必要があり、これはインポートする CSV ファイルにインポートするデバイスの SMSN が含まれていることを示しています。

  • 2 行目以降には、オンボードするデバイスの SMSN が含まれている必要があります。デバイスの SMSN は 64 進数文字形式である必要があります。

この JSON ファイルは、サンプル CSV ファイル形式を示します。

smsn
1C1A10B0AC0A200C012BBAC2CBB1B21CB12C0CA2AC1C1BB22CAA01C1B0B01122
B122C2B1121BACA2221001AC1B22012AAC11112C11C2A100C1C2B012A1100C10
02B222C110B0A210B0A0C2C112CCCAC21C1C0B0AA1221AB1022A2CC11B1B1122
C2C021CA1C111CCAB1221C0021C1C2AAA0AA1A2A01ABC10CBAACCA2A0121022A
0CB22C01BBC2CA2C0B11001121ACB2ABB0BB0121C2BA101C012CC2B20C011AC0

Sidewalk 一括プロビジョニングの使用方法

以下のステップで、Amazon Sidewalk 一括プロビジョニングの使用方法を示します。

  1. デバイスのシリアル番号を入力する

    Sidewalk デバイスをプロビジョニングするには、オンボードするデバイスのシリアル番号を入力する必要があります。デバイスをプロビジョニングするには、次のいずれかの方法を使用します。

    • Sidewalk の製造シリアル番号 (SMSN) を使用して、各デバイスを個別にプロビジョニングします。この方法は、適切な IAM ロールを持つ CSV ファイルをアップロードしたり、デバイスがタスクにオンボードされる準備が整うのを待ったりせずに、ワークフローをテストしてデバイスをより速くオンボードしたい場合に役立ちます。

    • プロビジョニングするデバイスの SMSN を含む Amazon S3 バケット URL を CSV ファイルで指定して、デバイスを一括でプロビジョニングします。この方法は、オンボードするデバイスが多数ある場合に特に役立ちます。この場合、各デバイスを個別にオンボードするのは手間がかかる場合があります。代わりに、Amazon S3 バケットにアップロードされた CSV ファイルへのパスと、ファイルにアクセスするための IAM ロールを指定するだけで済みます。

  2. インポートタスクとデバイスオンボーディングステータスを取得する

    作成したインポートタスクごとに、タスクのオンボーディングステータスと、タスクに追加されたデバイスのオンボーディングステータスに関する情報を取得できます。タスクやデバイスのオンボーディングが失敗した理由など、その他のステータス情報も確認できます。詳細については、以下を参照してください。

  3. (オプション) インポートタスクを更新または削除する

    既に作成したインポートタスクを更新または削除できます。

    • 既に追加されているデバイスでタスクが開始される前であれば、いつでもインポートタスクを更新したり、タスクにデバイスを追加したりできます。AWS IoT Core for Amazon Sidewalk は、インポートタスクの作成時に使用したものと同じ IAM ロールを引き受けます。タスクを作成するときは、タスクに追加するデバイスのシリアル番号を含む新しい CSV ファイルを指定します。

      注記

      既存のインポートタスクを更新する場合、タスクにデバイスを追加することのみ可能です。AWS IoT Core for Amazon Sidewalk は、インポートタスクに既にあるデバイスと、タスクに追加しようとしているデバイスとの間で、統合オペレーションを実行します。新しいファイルにインポートタスクに既に存在するデバイスのシリアル番号が含まれている場合、これらのシリアル番号は無視されます。

    • 既に正常に完了したインポートタスク、または IAM ロール情報が正しくない場合や、タスクの作成または更新時に S3 バケットファイルを使用できない場合などに更新に失敗したインポートタスクを削除できます。

トピック