新增您的裝置設定檔和 Sidewalk 終端裝置 - AWS IoT Wireless
新增您的 Sidewalk 裝置 (主控台)新增您的 Sidewalk 裝置 (CLI)

新增您的裝置設定檔和 Sidewalk 終端裝置

本節展示如何建立裝置設定檔。此外也將說明如何使用 AWS IoT 主控台和 AWS CLI，將 Sidewalk 終端裝置新增至適用於 Amazon Sidewalk 的 AWS IoT Core。

新增您的 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 Resource Name (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 裝置新增至適用於 Amazon Sidewalk 的 AWS IoT Core 帳戶，請使用 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 Resource Name (ARN) 作為輸出。

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