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:
-
Effettua l'onboarding di un dispositivo hub nell'hub di integrazioni gestite.
-
Installa la versione più recente di AWS CLI dal Managed AWS CLI Integrations Command Reference
-
Iscriviti alle notifiche degli eventi DEVICE_DISCOVERY-STATUS.
Fasi di configurazione guidate dall'utente
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-identifierHUB_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-idC2C_ASSOCIATION_ID
\ #For Custom aws iot-managed-thing start-device-discovery --discovery-type CUSTOM \ --controller-identifierHUB_MANAGED_THING_ID
\ --custom-protocol-detailNAME : 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 è impostatoACTIVATED
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 aldelete-managed-thing
comando.Nota
Per i dispositivi Z-wave, è necessario mettere il dispositivo in modalità di associazione dopo aver eseguito il comando.