Usa la configurazione guidata dall'utente per integrare e utilizzare i dispositivi - Integrazioni gestite per AWS IoT Device Management

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 la configurazione guidata dall'utente 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 la configurazione guidata dall'utente.

Prerequisiti

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

Prerequisito: abilitare la modalità di associazione sul dispositivo Z Wave

Abilita la modalità di associazione sul dispositivo Z-wave. La modalità di associazione può variare per ogni dispositivo Z-Wave, quindi consulta le istruzioni del dispositivo per configurare correttamente la modalità di associazione. Di solito è un pulsante che l'utente deve premere.

Passaggio 1: avvia l'individuazione del dispositivo

Avvia il rilevamento dei dispositivi per l'hub per ottenere un Discovery Job ID da utilizzare per effettuare l'onboard del dispositivo.

Per avviare l'individuazione dei dispositivi
  • Utilizzare il start-device-discoverycomando per ottenere l'ID del processo di rilevamento.

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

    Risposta:

    { "Id": DISCOVERY_JOB_ID, "StartedAt": "2025-06-03T14:43:12.726000-07:00" }
    Nota

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

    Per ulteriori informazioni, consulta l'start-device-discoveryAPI nella sezione Command Reference delle integrazioni AWS CLI gestite.

Passaggio 2: interrogare l'ID del processo di rilevamento

Usa il list-discovered-devices comando per ottenere il materiale di autenticazione del tuo dispositivo.

Per interrogare il tuo Discovery Job ID
  • Utilizza il discovery job ID con il list-discovered-devices comando per ottenere il materiale di autenticazione del tuo dispositivo.

    aws iot-managed-integrations list-discovered-devices --identifier DISCOVERY_JOB_ID

Risposta:

"Items": [ { "DeviceTypes": [], "DiscoveredAt": "2025-06-03T14:43:37.619000-07:00", "AuthenticationMaterial": AUTHENTICATION_MATERIAL } ]

Passaggio 3: crea un oggetto gestito per il tuo dispositivo

Usa il create-managed-thing comando per creare un oggetto gestito 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

    aws iot-managed-integrations create-managed-thing \ --role DEVICE --authentication-material-type DISCOVERED_DEVICE \ --authentication-material "AUTHENTICATION_MATERIAL"

    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 nella Guida ai comandi delle integrazioni AWS CLI gestite.

Passaggio 4: interroga la cosa gestita

È possibile verificare se una cosa gestita è attivata utilizzando il get-managed-thing comando.

Per interrogare una cosa gestita
  • Usa il get-managed-thing comando per verificare se lo stato di provisioning dell'oggetto gestito è impostato ACTIVATED su.

    Esempio get-managed-thing

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

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

Fase 5: Ottieni funzionalità gestite

È possibile visualizzare un elenco delle azioni disponibili di un oggetto gestito utilizzandoget-managed-thing-capabiltiies.

Per sfruttare le funzionalità di un dispositivo
  • Usa il get-managed-thing-capabilities comando per ottenere l'ID dell'endpoint. Nota anche l'elenco delle azioni possibili.

    Esempio get-managed-thing-capabilities

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

    Risposta:

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

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

Passaggio 6: inviare un comando all'oggetto gestito

È possibile utilizzare il send-managed-thing-command comando per inviare un comando di attivazione e disattivazione all'oggetto gestito.

Invia un comando all'oggetto gestito utilizzando un'azione di commutazione.
  • Usa il send-managed-thing-command comando per inviare un comando di toggle action.

    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: verifica lo stato dell'oggetto gestito

Controlla lo stato dell'oggetto gestito per confermare che l'azione di attivazione è riuscita.

Per controllare lo stato del dispositivo di un oggetto gestito
  • Usa il get-managed-thing-state comando per confermare che l'azione di attivazione è riuscita.

    Esempio get-managed-thing-state

    aws iot-managed-integrations get-managed-thing-state --managed-thing-id DEVICE_MANAGED_THING_ID

    Risposta:

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

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

Passaggio 8: rimuovi la cosa gestita dal tuo hub

Pulisci l'hub rimuovendo l'elemento gestito.

Per eliminare un oggetto gestito
  • Usa il delete-managed-thingcomando per rimuovere una cosa gestita.

    Esempio delete-managed-thing

    aws iot-managed-integrations delete-managed-thing \ --identifier MANAGED_THING_ID

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

    Nota

    Se il dispositivo è bloccato in uno DELETE_IN_PROGRESS stato, aggiungi il --force flag al delete-managed-thing comando.

    Nota

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