本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 加载设备并在集线器中对其进行操作通过创建托管设备并将其连接到集线器，将设备设置为加载到托管集成中心。可以通过简单的设置或用户指导的设置将设备加载到集线器。 **Topics** + [设置简单，便于加载和操作设备](managedintegrations-sdk-v2-cookbook-ss.md) + [在用户指导下进行设备加载和操作的设置](managedintegrations-sdk-v2-cookbook-ugs.md) # 设置简单，便于加载和操作设备通过创建托管设备并将其连接到您的集线器，将您的设备设置为加载到托管集成中心。本节介绍使用简单设置完成设备上线流程的步骤。 ## 先决条件在尝试加载设备之前，请完成以下步骤： + 将集线器设备载入托管集成中心。 + AWS CLI 从《[托管集成 AWS CLI 命令](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/)参考》中安装最新版本的 + 订阅 DEVICE\$1L [IFE\$1CYCLE 事件通知](managedintegrations-notifications.md#managedintegrations-notification-setup)。 **Topics** + [先决条件](#managedintegrations-sdk-v2-cookbook-ss-prereq) + [步骤 1：创建凭证柜](#managedintegrations-sdk-v2-cookbook-credential-locker) + [第 2 步：将凭证柜添加到您的中心](#managedintegrations-sdk-v2-cookbook-add-to-hub) + [步骤 3：使用凭据创建托管事物。](#managedintegrations-sdk-v2-cookbook-ss-create-managed-thing) + [步骤 4：插入设备并检查其状态。](#managedintegrations-sdk-v2-cookbook-ss-check-device-status) + [步骤 5：获取设备功能](#managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities) + [步骤 6：向托管事物发送命令](#managedintegrations-sdk-v2-cookbook-ss-control-device) + [第 7 步：从集线器中移除托管内容](#managedintegrations-sdk-v2-cookbook-clean-up) ## 步骤 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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-credential-locker.html)命令*参考》中的 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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-managed-thing.html)命令*参考》中的 AWS CLI 命令*。 ## 步骤 4：插入设备并检查其状态。 **接通设备电源并检查其状态。** + 使用`get-managed-thing`命令检查设备的状态。必须激活您的托管事物。 ProvisioningStatus 有关的更多信息 ProvisioningStatus，请参阅[设备配置](https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html)。 **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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing.html)命令*参考》中的 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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing-capabilities.html)命令*参考》中的 AWS CLI 命令*。 ## 步骤 6：向托管事物发送命令使用该`send-managed-thing-command`命令向您的托管事物发送切换操作命令。 **向你的托管事物发送命令** + 使用`send-managed-thing-command`命令向您的托管事物发送命令。 **send-managed-thing-command 示例** ``` json=$(jq -cr '.|@json') < 通过移除托管的东西来清理集线器。 **删除托管事物** + 使用`delete-managed-thing`命令从设备中心移除托管内容。 **delete-managed-thing 示例** ``` aws iot-managed-integrations delete-managed-thing \ --identifier "DEVICE_MANAGED_THING_ID" ``` 有关更多信息，请参阅《托管集成[delete-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/delete-managed-thing.html)命令*参考》中的 AWS CLI 命令*。 **注意** 如果设备处于某种`DELETE_IN_PROGRESS`状态，请将该`--force`标志附加到。`delete-managed-thing command` **注意** 对于 Z-Wave 设备，您需要在执行命令后将设备置于配对模式。 # 在用户指导下进行设备加载和操作的设置通过创建托管设备并将其连接到集线器，将设备设置为加载到托管集成中心。本节介绍使用用户指导设置完成设备上线流程的步骤。 ## 先决条件在尝试加载设备之前，请完成以下步骤： + 将集线器设备载入托管集成中心。 + AWS CLI 从《[托管集成 AWS CLI 命令](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/)参考》中安装最新版本的 + 订阅[设备发现状态事件通知。](managedintegrations-notifications.md#managedintegrations-notification-setup) **Topics** + [先决条件](#managedintegrations-sdk-v2-cookbook-ugs-prereq) + [先决条件：在 Z Wave 设备上启用配对模式](#managedintegrations-sdk-v2-cookbook-pairing-mode) + [步骤 1：开始设备发现](#managedintegrations-sdk-v2-cookbook-device-discovery) + [步骤 2：查询发现任务 ID](#managedintegrations-sdk-v2-cookbook-query-discovery) + [第 3 步：为您的设备创建托管内容](#managedintegrations-sdk-v2-cookbook-ugs-managed-thing) + [步骤 4：查询托管事物](#managedintegrations-sdk-v2-cookbook-query-managed-thing) + [第 5 步：获取托管事物功能](#managedintegrations-sdk-v2-cookbook-check-device-capabilties) + [步骤 6：向托管事物发送命令](#managedintegrations-sdk-v2-cookbook-ugs-control-device) + [第 7 步：检查托管事物的状态](#managedintegrations-sdk-v2-cookbook-ugs-device-state) + [第 8 步：从集线器中移除托管内容](#managedintegrations-sdk-v2-cookbook-ugs-clean-up) ## 先决条件：在 Z Wave 设备上启用配对模式在 Z-Wave 设备上启用配对模式。每台 Z-Wave 设备的配对模式可能有所不同，因此请参阅设备的说明以正确设置配对模式。它通常是用户必须按下的按钮。 ## 步骤 1：开始设备发现为您的集线器启动设备发现，以获取用于加载设备的发现任务 ID。 **开始设备发现** + 使用[start-device-discovery](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/start-device-discovery.html)命令获取发现任务 ID。 **start-device-discovery 示例** ``` #For Zigbee aws iot-managed-integrations start-device-discovery --discovery-type ZIGBEE \ --controller-identifier HUB_MANAGED_THING_ID #For Zwave aws iot-managed-integrations start-device-discovery --discovery-type ZWAVE \ --controller-identifier HUB_MANAGED_THING \ --authentication-material-type ZWAVE_INSTALL_CODE \ --authentication-material 13333 #For Cloud aws iot-managed-integrations start-device-discovery --discovery-type CLOUD \ --account-association-id C2C_ASSOCIATION_ID \ #For Custom aws iot-managed-thing start-device-discovery --discovery-type CUSTOM \ --controller-identifier HUB_MANAGED_THING_ID \ --custom-protocol-detail NAME : NON_EMPTY_STRING \ ``` **响应：** ``` { "Id": DISCOVERY_JOB_ID, "StartedAt": "2025-06-03T14:43:12.726000-07:00" } ``` **注意** Z-Wave 和 Zigbee 设备有不同的命令。有关更多信息，请参阅《托管集成 AWS CLI *命令参考*》中的 [start-device-discovery](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/start-device-discovery.html)API。 ## 步骤 2：查询发现任务 ID 使用`list-discovered-devices`命令获取设备的身份验证材料。 **查询您的发现任务 ID** + 使用发现任务 ID 和 list-discovered-devices命令获取设备的身份验证材料。 ``` aws iot-managed-integrations list-discovered-devices --identifier DISCOVERY_JOB_ID ``` **响应：** ``` "Items": [ { "DeviceTypes": [], "DiscoveredAt": "2025-06-03T14:43:37.619000-07:00", "AuthenticationMaterial": AUTHENTICATION_MATERIAL } ] ``` ## 第 3 步：为您的设备创建托管内容使用`create-managed-thing`命令为您的设备创建托管事物。每台设备都需要自己的托管设备。 **创建托管事物** + 使用`create-managed-thing`命令为您的设备创建托管事物。 **create-managed-thing 示例** ``` aws iot-managed-integrations create-managed-thing \ --role DEVICE --authentication-material-type DISCOVERED_DEVICE \ --authentication-material "AUTHENTICATION_MATERIAL" ``` **响应：** ``` { "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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-managed-thing.html)命令*参考》中的 AWS CLI 命令*。 ## 步骤 4：查询托管事物您可以使用`get-managed-thing`命令检查托管事物是否已激活。 **查询托管事物** + 使用`get-managed-thing`命令检查托管事物的配置状态是否设置为`ACTIVATED`。有关配置状态的更多信息，请参阅[设备配置](https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html)。 **get-managed-thing 示例** ``` 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/DEVICE_MANAGED_THING_ID, "Role": "DEVICE", "ProvisioningStatus": "ACTIVATED", "MacAddress": "MAC_ADDRESS", "ParentControllerId": "PARENT_CONTROLLER_ID", "CreatedAt": "2025-06-03T14:46:35.149000-07:00", "UpdatedAt": "2025-06-03T14:46:37.500000-07:00", "Tags": {} } ``` 有关更多信息，请参阅《托管集成[get-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing.html)命令*参考》中的 AWS CLI 命令*。 ## 第 5 步：获取托管事物功能您可以使用查看托管事物的可用操作列表`get-managed-thing-capabiltiies`。 **获取设备的功能** + 使用`get-managed-thing-capabilities`命令获取端点 ID。另请注意可能的操作列表。 **get-managed-thing-capabilities 示例** ``` aws iot-managed-integrations get-managed-thing-capabilities \ --identifier "DEVICE_MANAGED_THING_ID" ``` **响应：** ``` { "ManagedThingId": "DEVICE_MANAGED_THING_ID", "CapabilityReport": { "version": "1.0.0", "nodeId": "zb.539D+4A1D", "endpoints": [ { "id": "1", "deviceTypes": [ "Unknown Device" ], "capabilities": [ { "id": "matter.OnOff@1.4", "name": "On/Off", "version": "6", "properties": [ "OnOff", "OnOff", "OnTime", "OffWaitTime" ], "actions": [ "Off", "On", "Toggle", "OffWithEffect", "OnWithRecallGlobalScene", "OnWithTimedOff" ], ... } ``` 有关更多信息，请参阅《托管集成[get-managed-thing-capabilities](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing-capabilities.html)命令*参考》中的 AWS CLI命令*。 ## 步骤 6：向托管事物发送命令您可以使用该 send-managed-thing-command命令向您的托管事物发送切换操作命令。 **使用切换操作向托管事物发送命令。** + 使用该`send-managed-thing-command`命令发送切换操作命令。 **send-managed-thing-command 示例** ``` json=$(jq -cr '.|@json') < 检查托管事物的状态以验证切换操作是否成功。 **检查托管事物的设备状态** + 使用`get-managed-thing-state`命令验证切换操作是否成功。 **get-managed-thing-state 示例** ``` aws iot-managed-integrations get-managed-thing-state --managed-thing-id DEVICE_MANAGED_THING_ID ``` **响应：** ``` { "Endpoints": [ { "endpointId": "1", "capabilities": [ { "id": "matter.OnOff@1.4", "name": "On/Off", "version": "1.4", "properties": [ { "name": "OnOff", "value": { "propertyValue": true, "lastChangedAt": "2025-06-03T21:50:39.886Z" } } ] } ] } ] } ``` 有关更多信息，请参阅《托管集成[get-managed-thing-state](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing-state.html)命令*参考》中的 AWS CLI命令*。 ## 第 8 步：从集线器中移除托管内容通过移除托管的东西来清理集线器。 **删除托管事物** + 使用[delete-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/delete-managed-thing.html)命令移除托管事物。 **delete-managed-thing 示例** ``` aws iot-managed-integrations delete-managed-thing \ --identifier MANAGED_THING_ID ``` 有关更多信息，请参阅《托管集成[delete-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/delete-managed-thing.html)命令*参考》中的 AWS CLI 命令*。 **注意** 如果设备停滞在`DELETE_IN_PROGRESS`状态，`delete-managed-thing`请在命令后面附加`--force`标志。 **注意** 对于 Z-Wave 设备，您需要在执行命令后将设备置于配对模式。