使用简单的设置来加载和操作设备 - 的托管集成 AWS IoT Device Management
先决条件

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用简单的设置来加载和操作设备

通过创建托管设备并将其连接到集线器，将设备设置为加载到托管集成中心。本节介绍使用简单设置完成设备上线流程的步骤。

先决条件

在尝试加载设备之前，请完成以下步骤：

步骤 1：创建凭证柜

为您的设备创建一个凭证柜。

创建凭证柜

  • 使用 create-credential-locker 命令。执行此命令将触发所有制造资源的创建，包括 Wi-Fi 设置 key pair 和设备证书。

    create-credential-locker 示例

    aws iot-managed-integrations create-credential-locker \
  --name "DEVICE_NAME"

    响应：

    {    
  "Id": "LOCKER_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:credential-locker/LOCKER_ID
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    有关更多信息，请参阅《托管集成create-credential-locker命令参考》中的 AWS CLI 命令。

第 2 步：将凭证柜添加到您的中心

将凭证柜添加到您的中心。

向您的中心添加凭证柜

  • 使用以下命令将凭证储物柜添加到您的集线器。

    aws iotmi --region AWS_REGION --endpoint AWS_ENDPOINT update-managed-thing \
--identifier "HUB_MANAGED_THING_ID" --credential-locker-id "LOCKER_ID"

步骤 3：使用凭据创建托管事物。

使用设备凭据创建托管事物。每台设备都需要自己的托管设备。

创建托管事物

  • 使用create-managed-thing命令为您的设备创建托管事物。

    create-managed-thing 示例

    #ZWAVE: 
aws iot-managed-integrations create-managed-thing --role DEVICE \
--authentication-material '900137947003133...' \ #auth material from zwave qr code
--authentication-material-type ZWAVE_QR_BAR_CODE \
--credential-locker-id ${locker_id}

#ZIGBEE:
aws iot-managed-integrations create-managed-thing --role DEVICE \
--authentication-material 'Z:286...$I:A4DC00.' \ #auth material from zigbee qr code
--authentication-material-type ZIGBEE_QR_BAR_CODE \
--credential-locker-id ${locker_id}
    注意

    Z-Wave 和 Zigbee 设备有不同的命令。

    响应：

    {    
  "Id": "DEVICE_MANAGED_THING_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/DEVICE_MANAGED_THING_ID"
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    有关更多信息，请参阅《托管集成create-managed-thing命令参考》中的 AWS CLI 命令。

步骤 4：插入设备并检查其状态。

插入设备并检查其状态。

  • 使用get-managed-thing命令检查设备的状态。

    get-managed-thing 示例

    #KINESIS NOTIFICATION:
{
    "version": "1.0.0",
    "messageId": "4ac684bb7f4c41adbb2eecc1e7991xxx",
    "messageType": "DEVICE_LIFE_CYCLE",
    "source": "aws.iotmanagedintegrations",
    "customerAccountId": "12345678901",
    "timestamp": "2025-06-10T05:30:59.852659650Z",
    "region": "us-east-1",
    "resources": ["XXX"],
    "payload": {
        "deviceDetails": {
            "id": "1e84f61fa79a41219534b6fd57052XXX",
            "arn": "XXX",
            "createdAt": "2025-06-09T06:24:34.336120179Z",
            "updatedAt": "2025-06-10T05:30:59.784157019Z"
        },
        "status": "ACTIVATED"
    }
}
aws iot-managed-integrations get-managed-thing \
--identifier :"DEVICE_MANAGED_THING_ID"

    响应：

    {    
  "Id": "DEVICE_MANAGED_THING_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/MANAGED_THING_ID"
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    有关更多信息，请参阅《托管集成get-managed-thing命令参考》中的 AWS CLI 命令。

步骤 5：获取设备功能

使用get-managed-thing-capabilities命令获取您的终端节点 ID 并查看设备可能执行的操作列表。

获取设备的功能

  • 使用get-managed-thing-capabilities命令并记下端点 ID。

    get-managed-thing-capabilties 示例

    aws iotmi get-managed-thing-capabilities \
--identifier "DEVICE_MANAGED_THING_ID"

    响应：

    {    
    "ManagedThingId": "1e84f61fa79a41219534b6fd57052cbc",
    "CapabilityReport": {
        "version": "1.0.0",
        "nodeId": "zw.FCB10009+06",
        "endpoints": [
            {
                "id": "ENDPOINT_ID"
                "deviceTypes": [
                    "On/Off Switch"
                ],
                "capabilities": [
                    {
                        "id": "matter.OnOff@1.4",
                        "name": "On/Off",
                        "version": "6",
                        "properties": [
                            "OnOff"
                        ],
                        "actions": [
                            "Off",
                            "On"
                        ],
                        "events": []
                    }
                    ...
}

    有关更多信息，请参阅《托管集成get-managed-thing-capabilities命令参考》中的 AWS CLI 命令。

步骤 6：向托管事物发送命令

使用该send-managed-thing-command命令向您的托管事物发送切换操作命令。

向你的托管事物发送命令

  • 使用send-managed-thing-command命令向您的托管事物发送命令。

    send-managed-thing-command 示例

    json=$(jq -cr '.|@json') <<EOF
[
  {
    "endpointId": "1",
    "capabilities": [
      {
        "id": "matter.OnOff@1.4",
        "name": "On/Off",
        "version": "1",
        "actions": [
          {
            "name": "Toggle",
            "parameters": {}
          }
        ]
      }
    ]
  }
]
EOF
aws iot-managed-integrations send-managed-thing-command \
--managed-thing-id "DEVICE_MANAGED_THING_ID" --endpoints "ENDPOINT_ID"
    注意

    这个例子使用了 jq cli，但你也可以传递整个字符串 endpointId

    响应：

    {    
"TraceId": "TRACE_ID"
}

    有关更多信息，请参阅《托管集成send-managed-thing-command命令参考》中的 AWS CLI 命令。

第 7 步：从集线器中移除托管内容

通过移除托管的东西来清理集线器。

删除托管事物

  • 使用delete-managed-thing命令从设备中心移除托管内容。

    delete-managed-thing 示例

    aws iot-managed-integrations delete-managed-thing \
--identifier "DEVICE_MANAGED_THING_ID"

    有关更多信息，请参阅《托管集成delete-managed-thing命令参考》中的 AWS CLI 命令。

    注意

    如果设备处于某种DELETE_IN_PROGRESS状态，请将该--force标志附加到。delete-managed-thing command

    注意

    对于 Z-Wave 设备，您需要在执行命令后将设备置于配对模式。