# 新增您的裝置設定檔和 Sidewalk 終端裝置
<a name="iot-sidewalk-add-device"></a>

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

## 新增您的 Sidewalk 裝置 (主控台)
<a name="iot-sidewalk-add-device-console"></a>

如要使用 AWS IoT 主控台新增您的 Sidewalk 裝置，請移至[裝置中樞的 Sidewalk 索引標籤](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk)，選擇**佈建裝置**，然後執行下列步驟。

![](http://docs.aws.amazon.com/zh_tw/iot-wireless/latest/developerguide/images/iot-sidewalk-provision-device.PNG)


1. 

**指定裝置詳細資訊**

   指定您 Sidewalk 裝置的組態資訊。您還可建立新的裝置設定檔，或為您的 Sidewalk 裝置選擇現有的設定檔。

   1. 指定裝置名稱和選用說明。該說明的長度最多可達 2,048 個字元。您可在建立裝置後編輯這些欄位。

   1. 選擇要與 Sidewalk 裝置建立關聯的裝置設定檔。若您有任何現有的裝置設定檔，則可選擇您的設定檔。如要建立新的設定檔，請選擇**建立新設定檔**，接著輸入該設定檔的名稱。
**注意**  
如要將標籤附加至裝置設定檔，在建立設定檔之後，請移至[設定檔中樞](https://console.aws.amazon.com/iot/home#/wireless/profiles)，然後編輯您的設定檔以新增此資訊。

   1. 指定將訊息從您的裝置路由至其他 AWS 服務 的目的地名稱。若您尚未建立目的地，請移至[目的地中樞](https://console.aws.amazon.com/iot/home#/wireless/destinations)，來建立目的地。接著，您可選擇您 Sidewalk 裝置的目的地。如需詳細資訊，請參閱[為您的 Sidewalk 終端裝置新增目的地](iot-sidewalk-qsg-destination.md)。

   1. 選擇**下一步**，繼續新增您的 Sidewalk 裝置。

1. 

**將 Sidewalk 裝置與 AWS IoT 物件產生關聯 (選用)**

   您可選擇將 Sidewalk 裝置與 AWS IoT 物件產生關聯。IoT 物件是 AWS IoT 裝置登錄檔中的項目。物件可讓您更輕鬆地搜尋和管理您的裝置。將物件與您的裝置相關連可讓您的裝置存取其他 AWS IoT Core 功能。

   如要將裝置與物件建立關聯，請選擇**自動物件註冊**。

   1. 為您要與 Sidewalk 裝置建立關聯的 IoT 物件輸入唯一名稱。物件名稱區分大小寫，且在 AWS 帳戶 和 AWS 區域 中必須是唯一的。

   1. 為您的 IoT 物件提供任何其他組態，例如使用物件類型，或可用來從物件清單中篩選的可搜尋屬性。

   1. 選擇**下一步**，並驗證 Sidewalk 裝置的相關資訊，然後選擇**建立**。

## 新增您的 Sidewalk 裝置 (CLI)
<a name="iot-sidewalk-add-device-api"></a>

如要新增您的 Sidewalk 裝置，並下載將用來佈建您 Sidewalk 裝置的 JSON 檔案，請執行下列 API 操作。

**Topics**
+ [步驟 1：建立裝置設定檔](#iot-sidewalk-profile-create)
+ [步驟 2：新增您的 Sidewalk 裝置](#iot-sidewalk-device-create)

### 步驟 1：建立裝置設定檔
<a name="iot-sidewalk-profile-create"></a>

如要於 AWS 帳戶 中建立一個裝置設定檔，請使用 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) API 操作或 [https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html) 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 裝置
<a name="iot-sidewalk-device-create"></a>

如要將您的 Sidewalk 裝置新增至適用於 Amazon Sidewalk 的 AWS IoT Core 帳戶，請使用 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) API 操作或 [https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html) CLI 命令。當您建立裝置時，除了您 Sidewalk 裝置的選用名稱和描述之外，請指定下列參數。

**注意**  
若您想要建立 Sidewalk 裝置與 AWS IoT 物件的關聯，請使用 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html) API 操作或 [https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html](https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html) 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"}}
}
```