Usa una configurazione semplice per integrare e utilizzare i dispositivi - Integrazioni gestite per AWS IoT Device Management
Prerequisiti

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Usa una configurazione semplice per integrare e utilizzare i dispositivi

Configura i tuoi dispositivi per l'onboarding nel tuo hub di integrazioni gestite creando un oggetto gestito e collegandolo al tuo hub. Questa sezione descrive i passaggi per completare il processo di onboarding del dispositivo utilizzando una configurazione semplice.

Prerequisiti

Completa questi passaggi prima di tentare l'onboard di un dispositivo:

Passaggio 1: creare un armadietto per le credenziali

Crea un blocco delle credenziali per il tuo dispositivo.

Per creare un armadietto per le credenziali

  • Utilizza il comando create-credential-locker. L'esecuzione di questo comando attiverà la creazione di tutte le risorse di produzione, tra cui la key pair di configurazione Wi-Fi e il certificato del dispositivo.

    Esempio create-credential-locker

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

    Risposta:

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

    Per ulteriori informazioni, consulta il create-credential-lockercomando nel Command Reference delle integrazioni AWS CLI gestite.

Passaggio 2: aggiungi l'armadietto delle credenziali al tuo hub

Aggiungi l'armadietto delle credenziali al tuo hub.

Per aggiungere un armadietto per le credenziali al tuo hub

  • Usa il seguente comando per aggiungere un armadietto per le credenziali al tuo hub.

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

Fase 3: Creare un oggetto gestito con credenziali.

Crea un oggetto gestito con credenziali per il tuo dispositivo. Ogni dispositivo richiede la propria funzionalità gestita.

Per creare un oggetto gestito

  • Usa il create-managed-thing comando per creare un oggetto gestito per il tuo dispositivo.

    Esempio 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}
    Nota

    Esistono comandi separati per i dispositivi Z-wave e Zigbee.

    Risposta:

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

    Per ulteriori informazioni, consulta il create-managed-thingcomando nel Command Reference delle integrazioni AWS CLI gestite.

Passaggio 4: Collega il dispositivo e verificane lo stato.

Collega il dispositivo e controllane lo stato.

  • Usa il get-managed-thing comando per controllare lo stato del tuo dispositivo.

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

    Risposta:

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

    Per ulteriori informazioni, consulta il get-managed-thingcomando nella Guida ai comandi delle integrazioni AWS CLI gestite.

Passaggio 5: Ottieni le funzionalità del dispositivo

Utilizza il get-managed-thing-capabilities comando per ottenere l'ID dell'endpoint e visualizzare un elenco di azioni possibili per il tuo dispositivo.

Per ottenere le funzionalità di un dispositivo

  • Usa il get-managed-thing-capabilities comando e annota l'ID dell'endpoint.

    Esempio get-managed-thing-capabilties

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

    Risposta:

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

    Per ulteriori informazioni, consulta il get-managed-thing-capabilitiescomando nella Guida ai comandi delle integrazioni AWS CLI gestite.

Passaggio 6: inviare un comando all'oggetto gestito

Usa il send-managed-thing-command comando per inviare un comando di attivazione/disattivazione all'oggetto gestito.

Per inviare un comando alla cosa gestita

  • Usa il send-managed-thing-command comando per inviare un comando alla tua cosa gestita.

    Esempio 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"
    Nota

    Questo esempio usa jq cli to ma puoi anche passare l'intera stringa endpointId

    Risposta:

    {    
"TraceId": "TRACE_ID"
}

    Per ulteriori informazioni, consulta il send-managed-thing-commandcomando nel Command Reference delle integrazioni AWS CLI gestite.

Passaggio 7: rimuovi l'elemento gestito dal tuo hub

Pulisci l'hub rimuovendo l'elemento gestito.

Per eliminare un oggetto gestito

  • Usa il delete-managed-thing comando per rimuovere un elemento gestito dall'hub del dispositivo.

    Esempio delete-managed-thing

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

    Per ulteriori informazioni, consulta il delete-managed-thingcomando nel Command Reference delle integrazioni AWS CLI gestite.

    Nota

    Se il dispositivo è bloccato in uno DELETE_IN_PROGRESS stato, aggiungi la --force bandiera al. delete-managed-thing command

    Nota

    Per i dispositivi Z-wave, è necessario mettere il dispositivo in modalità di associazione dopo aver eseguito il comando.