使用匯入任務佈建 Sidewalk 裝置 - AWS IoT Wireless
Sidewalk 大量佈建的運作方式Sidewalk 大量佈建的關鍵注意事項CSV 檔案格式Sidewalk 大量佈建的使用方式

使用匯入任務佈建 Sidewalk 裝置

本節將說明如何使用 AWS IoT 主控台、適用於 Amazon Sidewalk 的 AWS IoT Core API 操作，或 AWS CLI 大量佈建 Sidewalk 裝置。下列各節說明如何大量佈建您的 Sidewalk 裝置。

主題

Sidewalk 大量佈建的運作方式

下列步驟說明大量佈建的運作方式。

  1. 啟動無線裝置匯入任務

    如要大量佈建 Sidewalk 裝置，您必須建立匯入任務，並將要加入裝置的 Sidewalk 製造序號 (SMSN) 提供給適用於 Amazon Sidewalk 的 AWS IoT Core。製造商將控制日誌上傳至 Amazon Sidewalk 後，您在電子郵件中以 CSV 檔案的形式取得裝置的 Sidewalk 製造序號 (SMSN)。如需此工作流程及取得控制日誌方法的相關詳細資訊，請參閱《Amazon Sidewalk 文件》中的製造 Amazon Sidewalk 裝置。

  2. 在背景中執行匯入程序

    當適用於 Amazon Sidewalk 的 AWS IoT Core 收到匯入任務請求時，便會開始進行設定，並啟動經常輪詢系統的背景處理程序。一旦背景處理程序收到匯入任務指示，便會開始讀取 CSV 檔案。適用於 Amazon Sidewalk 的 AWS IoT Core 會同時檢查是否已從 Amazon Sidewalk 收到控制日誌。

  3. 建立無線裝置記錄

    從 Amazon Sidewalk 收到控制日誌時，適用於 Amazon Sidewalk 的 AWS IoT Core 會檢查控制日誌中的序號是否與 CSV 檔案中的 SMSN 值相符。若序號相符，適用於 Amazon Sidewalk 的 AWS IoT Core 將會開始為與這些序號對應的 Sidewalk 裝置建立無線裝置記錄。加入所有裝置之後，匯入任務會標示為已完成。

Sidewalk 大量佈建的關鍵注意事項

將 Sidewalk 裝置大量佈建至適用於 Amazon Sidewalk 的 AWS IoT Core 時，以下是一些主要考量事項。

  • 您必須在建立裝置設定檔的相同 AWS 帳戶 位置，使用 AWS IoT 主控台或適用於 Amazon Sidewalk 的 AWS IoT Core API 操作執行大量佈建。

  • 在大量佈建 Sidewalk 裝置之前，您的裝置設定檔必須已包含表示原廠支援的 DAK 資訊。否則，使用 AWS IoT 主控台或大量佈建 API 操作的大量佈建可能會失敗。

  • 開始匯入任務後，處理 CSV 檔案、匯入無線裝置並將其加入適用於 Amazon Sidewalk 的 AWS IoT Core 至少需要 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 檔案，或等待裝置準備好加入任務時，則此方法很有用。

    • 透過提供包含要在 CSV 檔案中所佈建裝置之 SMSN 的 Amazon S3 儲存貯體 URL，來大量佈建裝置。當您有大量要加入的裝置時，此種方法特別有用。於此狀況下，單獨加入每個裝置可能會很繁瑣。相反地，您只需要提供已上傳到 Amazon S3 儲存貯體之 CSV 檔案的路徑，和 IAM 角色即可存取檔案。

  2. 取得匯入任務和裝置加入狀態

    對於您建立的每個匯入任務，您可擷取有關任務加入狀態和新增至該任務裝置之上線狀態的資訊。您還可查看其他狀態資訊，例如任務或裝置加入失敗的原因。如需詳細資訊，請參閱

  3. (選用) 更新或刪除匯入任務

    您可以更新或刪除已建立的匯入任務。

    • 在已新增的裝置上開始匯入任務之前，您可隨時更新任務並將其他裝置新增至該任務。適用於 Amazon Sidewalk 的 AWS IoT Core 擔任的 IAM 角色與您建立匯入任務時使用的角色相同。當您建立任務時，請指定包含要新增至任務之裝置序號的新 CSV 檔案。

      注意

      當您更新現有的匯入任務時，您僅可將裝置新增至任務。適用於 Amazon Sidewalk 的 AWS IoT Core 會在匯入任務中已有的裝置與您嘗試新增至任務的裝置之間執行聯集操作。若新檔案包含匯入任務中已存在的裝置序號，則會忽略這些序號。

    • 您可刪除已順利完成的匯入任務，或在諸如 IAM 角色資訊不正確，或建立或更新任務時無法使用 S3 儲存貯體檔案等況下，更新失敗的匯入任務。

主題