Use uma configuração simples para integrar e operar dispositivos

Configure seus dispositivos para serem integrados ao seu hub de integrações gerenciadas criando uma coisa gerenciada e conectando-a ao seu hub. Esta seção descreve as etapas para concluir o processo de integração do dispositivo usando uma configuração simples.

Pré-requisitos

Conclua estas etapas antes de tentar integrar um dispositivo:

Integre um dispositivo de hub ao hub de integrações gerenciadas.
Instale a versão mais recente do a AWS CLI partir da Referência de AWS CLI Comandos de Integrações Gerenciadas
Inscreva-se para receber notificações de eventos do DEVICE_LIFE_CYCLE.

Etapas de configuração

Etapa 1: criar um armário de credenciais
Etapa 2: adicione o armário de credenciais ao seu hub
Etapa 3: Crie uma coisa gerenciada com credenciais.
Etapa 4: conecte o dispositivo e verifique seu status.
Etapa 5: Obtenha os recursos do dispositivo
Etapa 6: enviar um comando para a coisa gerenciada
Etapa 7: remover a coisa gerenciada do seu hub

Etapa 1: criar um armário de credenciais

Crie um armário de credenciais para seu dispositivo.

Para criar um armário de credenciais

Use o comando create-credential-locker. A execução desse comando acionará a criação de todos os recursos de fabricação, incluindo o key pair de configuração Wi-Fi e o certificado do dispositivo.

create-credential-locker exemplo
```
aws iot-managed-integrations create-credential-locker \
  --name "DEVICE_NAME"
```
Resposta:
```
{    
  "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"
}
```
Para obter mais informações, consulte o create-credential-lockercomando na Referência de AWS CLI comandos de integrações gerenciadas.

Etapa 2: adicione o armário de credenciais ao seu hub

Adicione o armário de credenciais ao seu hub.

Para adicionar um armário de credenciais ao seu hub

Use o comando a seguir para adicionar um armário de credenciais ao seu hub.


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

Etapa 3: Crie uma coisa gerenciada com credenciais.

Crie uma coisa gerenciada com credenciais para seu dispositivo. Cada dispositivo requer sua própria coisa gerenciada.

Para criar uma coisa gerenciada

Use o create-managed-thing comando para criar uma coisa gerenciada para o seu dispositivo.

create-managed-thing exemplo


#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}

nota

Existem comandos separados para dispositivos Z-wave e Zigbee.

Resposta:


{    
  "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"
}

Para obter mais informações, consulte o create-managed-thingcomando na Referência de AWS CLI comandos de integrações gerenciadas.

Etapa 4: conecte o dispositivo e verifique seu status.

Conecte o dispositivo e verifique seu status.

Use o get-managed-thing comando para verificar o status do seu dispositivo.

get-managed-thing exemplo


#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"

Resposta:


{    
  "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"
}

Para obter mais informações, consulte o get-managed-thingcomando na Referência de AWS CLI comandos de integrações gerenciadas.

Etapa 5: Obtenha os recursos do dispositivo

Use o get-managed-thing-capabilities comando para obter seu ID de endpoint e ver uma lista de ações possíveis para seu dispositivo.

Para obter os recursos de um dispositivo

Use o get-managed-thing-capabilities comando e anote o ID do endpoint.

get-managed-thing-capabilties exemplo


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

Resposta:


{    
    "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": []
                    }
                    ...
}

Para obter mais informações, consulte o get-managed-thing-capabilitiescomando na Referência de AWS CLI comandos de integrações gerenciadas.

Etapa 6: enviar um comando para a coisa gerenciada

Use o send-managed-thing-command comando para enviar um comando de ação de alternância para sua coisa gerenciada.

Para enviar um comando para sua coisa gerenciada

Use o send-managed-thing-command comando para enviar um comando para sua coisa gerenciada.

send-managed-thing-command exemplo


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"

nota

Este exemplo usa jq cli para, mas você também pode passar a string inteira endpointId

Resposta:


{    
"TraceId": "TRACE_ID"
}

Para obter mais informações, consulte o send-managed-thing-commandcomando na Referência de AWS CLI comandos de integrações gerenciadas.

Etapa 7: remover a coisa gerenciada do seu hub

Limpe seu hub removendo a coisa gerenciada.

Para excluir uma coisa gerenciada

Use o delete-managed-thing comando para remover uma coisa gerenciada do hub do seu dispositivo.

delete-managed-thing exemplo
```
aws iot-managed-integrations delete-managed-thing \
--identifier "DEVICE_MANAGED_THING_ID"
```
Para obter mais informações, consulte o delete-managed-thingcomando na Referência de AWS CLI comandos de integrações gerenciadas.

nota
Se o dispositivo estiver preso em um DELETE_IN_PROGRESS estado, anexe a --force bandeira ao. delete-managed-thing command

nota
Para dispositivos Z-wave, você precisa colocar o dispositivo no modo de emparelhamento após executar o comando.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Integre dispositivos e opere-os no hub

Use a configuração guiada pelo usuário para integrar e operar dispositivos