# 添加设备配置文件和 Sidewalk 终端设备
本节向您介绍如何创建设备配置文件。它还演示如何使用 AWS IoT 控制台和 AWS CLI 将 Sidewalk 终端设备添加到适用于 Amazon Sidewalk 的 AWS IoT Core。
## 添加 Sidewalk 设备（控制台）
要使用 AWS IoT 控制台添加 Sidewalk 设备，请转到[设备中心的 Sidewalk 选项卡](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk)，选择**预置设备**，然后执行以下步骤。
1.
**指定设备详细信息**
指定 Sidewalk 设备的配置信息。您也可以创建新的设备配置文件，或者为 Sidewalk 设备选择现有的配置文件。
1. 指定设备名称和可选描述。描述长度最多为 2048 个字符。创建设备后，可以编辑这些字段。
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）
要添加 Sidewalk 设备并下载将用于预置 Sidewalk 设备的 JSON 文件，请执行以下 API 操作。
**Topics**
+ [步骤 1：创建设备配置文件](#iot-sidewalk-profile-create)
+ [步骤 2：添加 Sidewalk 设备](#iot-sidewalk-device-create)
### 步骤 1：创建设备配置文件
要在 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 资源名称（ARN）和设备配置文件的 ID 作为输出。
```
{
"DeviceProfileArn": "arn:aws:iotwireless:{{us-east-1}}:{{123456789012}}:DeviceProfile/{{12345678-a1b2-3c45-67d8-e90fa1b2c34d}}",
"DeviceProfileId": "{{12345678-a1b2-3c45-67d8-e90fa1b2c34d}}"
}
```
### 步骤 2：添加 Sidewalk 设备
要针对适用于 Amazon Sidewalk 的 AWS IoT Core 将 Sidewalk 设备添加到您的账户中，请使用 [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 资源名称（ARN）作为输出。
```
{
"Arn": "arn:aws:iotwireless:{{us-east-1}}:{{123456789012}}:WirelessDevice/{{23456789-abcd-0123-bcde-fabc012345678}}",
"Id": {{"23456789-abcd-0123-bcde-fabc012345678"}}
}
```