IoT Plug and Play in Aggiornamento di Azure per i dispositivi di IoT Hub

Aggiornamento dei dispositivi per hub IoT usa Plug and Play IoT per individuare e gestire i dispositivi che supportano l'aggiornamento over-the-air. Questo articolo descrive come il servizio Aggiornamento dispositivi invia e riceve proprietà e messaggi da e verso i dispositivi usando interfacce Plug and Play IoT.

Per altre informazioni, vedere la guida per gli sviluppatori di dispositivi Plug and Play IoT e Come compilare l'agente di aggiornamento dispositivi.

Modelli di aggiornamento dei dispositivi

I dispositivi intelligenti usano ID modello Plug and Play IoT per pubblicizzare le proprie funzionalità alle applicazioni IoT di Azure. Aggiornamento dispositivi richiede che il Plug and Play IoT smart device annunci un ID modello come parte della connessione del dispositivo. Per ulteriori informazioni, vedere Annuncio dell'ID modello.

Aggiornamento dei dispositivi include diversi modelli IoT Plug and Play definiti che supportano le funzionalità di Aggiornamento dei dispositivi. Il modello **dtmi:azure:iot:deviceUpdateContractModel;3** Aggiornamento dispositivi supporta la funzionalità di aggiornamento dei dispositivi di base e usa l'interfaccia principale di Aggiornamento dispositivi per inviare azioni di aggiornamento e metadati ai dispositivi e ricevere lo stato di aggiornamento dai dispositivi.

L'altro modello supportato è **dtmi:azure:iot:deviceUpdateModel;3**, che estende **deviceUpdateContractModel;3** e usa anche interfacce Plug and Play IoT che inviano informazioni sulle proprietà del dispositivo e abilitano le funzionalità di diagnostica. Per queste e altre versioni, vedere Modelli di aggiornamento dei dispositivi di Azure Plug and Play IoT.

L'agente di Aggiornamento dispositivi usa **dtmi:azure:iot:deviceUpdateModel;3** che supporta tutte le funzionalità più recenti nella versione Device Update 1.1.0. Questo modello supporta l'importazione del manifesto versione 5.0. I manifesti meno recenti funzionano con gli agenti più recenti, ma le nuove funzionalità richiedono la versione più recente del manifesto.

Metadati dell'agente

L'agente Device Update usa i seguenti campi di metadati per inviare informazioni ai servizi Device Update.

esempio di dispositivo gemello hub IoT:

"deviceUpdate": {
                "__t": "c",
                "agent": {
                    "deviceProperties": {
                        "manufacturer": "contoso",
                        "model": "virtual-vacuum-v1",
                        "contractModelId": "dtmi:azure:iot:deviceUpdateContractModel;3",
                        "aduVer": "DU;agent/1.1.0",
                        },
                    "compatPropertyNames": "manufacturer,model",
                    "lastInstallResult": {
                        "resultCode": 700,
                        "extendedResultCode": 0,
                        "resultDetails": "",
                        "stepResults": {
                            "step_0": {
                                "resultCode": 700,
                                "extendedResultCode": 0,
                                "resultDetails": ""
                            }
                        }
                    },
                    "state": 0,
                    "workflow": {
                        "action": 3,
                        "id": "11b6a7c3-6956-4b33-b5a9-87fdd79d2f01",
                        "retryTimestamp": "2022-01-26T11:33:29.9680598Z"
                    },
                    "installedUpdateId": "{\"provider\":\"Contoso\",\"name\":\"Virtual-Vacuum\",\"version\":\"5.0\"}"
                },

Proprietà dei dispositivi

Il campo deviceProperties contiene le informazioni sul produttore e sul modello per un dispositivo.

Stato

Il campo stato indica lo stato segnalato dall'agente di aggiornamento dispositivi in risposta a un'Azione inviata all'agente di aggiornamento dispositivi dal servizio Aggiornamento Dispositivi. Per altre informazioni sulle richieste che passano tra il servizio Aggiornamento dispositivi e l'agente di Aggiornamento dispositivi, vedere il flusso di lavoro dell'agente.

Azione

Il campo azione rappresenta l'azione che l'agente di Aggiornamento dispositivi deve eseguire come indicato dal servizio Aggiornamento dispositivi. L'agente di aggiornamento del dispositivo segnala uno stato per l'elaborazione dell'azione che riceve. Per altre informazioni sulle richieste che passano tra il servizio Aggiornamento dispositivi e l'agente di Aggiornamento dispositivi, vedere il flusso di lavoro dell'agente.

Metadati del servizio

I metadati del servizio contengono campi usati dal servizio Aggiornamento dispositivi per comunicare azioni e dati all'agente di Aggiornamento dispositivi.

Interfaccia delle informazioni sul dispositivo

L'interfaccia delle informazioni sul dispositivo è un concetto usato all'interno dell'architettura Plug and Play IoT. L'interfaccia contiene proprietà da dispositivo a cloud che forniscono informazioni sull'hardware del dispositivo e sul sistema operativo. Device Update usa le proprietà DeviceInformation.manufacturer e DeviceInformation.model per la telemetria e la diagnostica. Per un esempio dell'interfaccia delle informazioni sul dispositivo, vedere https://devicemodels.azure.com/dtmi/azure/devicemanagement/deviceinformation-1.json.

Quando si implementa questa interfaccia, il nome del componente previsto nel modello è deviceInformation. Per ulteriori informazioni, vedere la guida alla modellazione IoT Plug and Play.

Contenuto correlato

• File di configurazione Aggiornamento Dispositivi
• Panoramica dell'aggiornamento dei dispositivi per l'agente di IoT Hub