添加设备配置文件和 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. 指定设备名称和可选描述。描述长度最多为 2048 个字符。创建设备后，可以编辑这些字段。

    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 资源名称（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 设备添加到您的账户中，请使用 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 资源名称（ARN）作为输出。

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