IoT Plug and Play na atualização do Azure Device Update para o Hub IoT

A Atualização de Dispositivo para o Hub IoT usa o IoT Plug and Play para descobrir e gerir dispositivos com capacidade de atualização via transmissão remota. Este artigo descreve como o serviço de Atualização de Dispositivo envia e recebe propriedades e mensagens de e para dispositivos usando interfaces IoT Plug and Play.

Para obter mais informações, consulte o Guia do desenvolvedor de dispositivos IoT Plug and Play e Como criar o Device Update Agent.

Modelos de atualização de dispositivo

Os dispositivos inteligentes usam IDs de modelo IoT Plug and Play para anunciar seus recursos para aplicativos IoT do Azure. A Atualização de Dispositivo requer que o dispositivo inteligente IoT Plug and Play anuncie um ID de modelo como parte da conexão do dispositivo. Para mais informações, consulte o anúncio de ID do modelo.

O Device Update tem vários modelos IoT Plug and Play pré-definidos que suportam funcionalidades do Device Update. O modelo **dtmi:azure:iot:deviceUpdateContractModel;3** de Atualização de Dispositivo suporta a funcionalidade principal de Atualização de Dispositivo e usa a interface principal de Atualização de Dispositivo para enviar ações de atualização e metadados para dispositivos e receber status de atualização de dispositivos.

O outro modelo suportado é **dtmi:azure:iot:deviceUpdateModel;3**, que estende **deviceUpdateContractModel;3** e também usa interfaces IoT Plug and Play que enviam informações de propriedade do dispositivo e habilitam recursos de diagnóstico. Para essas e outras versões, consulte Modelos de atualização de dispositivo Plug and Play do Azure IoT.

Os agentes de Atualização de Dispositivo utilizam dtmi:azure:iot:deviceUpdateModel;3, que é suportado na versão 1.1.0 da implementação de referência do agente de Atualização de Dispositivo e versões posteriores. Este modelo suporta manifesto de importação versão 5.0. Manifestos mais antigos continuam a funcionar com versões mais recentes da implementação de referência, mas as novas funcionalidades exigem a versão mais recente do manifesto.

Metadados do agente

Os agentes de Atualização de Dispositivo reportam os seguintes campos de metadados ao serviço de Atualização de Dispositivo.

Exemplo de dispositivo gêmeo do 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\"}"
                },

Propriedades do dispositivo

O campo deviceProperties contém as informações do fabricante e do modelo de um dispositivo.

Estado

O campo de estado é o status relatado pelo agente de Atualização de Dispositivo em resposta a uma Ação enviada ao agente de Atualização de Dispositivo do serviço de Atualização de Dispositivo. Para obter mais informações sobre solicitações que fluem entre o serviço de Atualização de Dispositivo e o agente de Atualização de Dispositivo, consulte o fluxo de trabalho do Agente.

Ação

O campo de ação representa a ação que o agente de Atualização de Dispositivo deve executar conforme as instruções do serviço de Atualização de Dispositivo. O agente de Atualização de Dispositivo comunica um estado ao processar a ação que recebe. Para obter mais informações sobre solicitações que fluem entre o serviço de Atualização de Dispositivo e o agente de Atualização de Dispositivo, consulte o fluxo de trabalho do Agente.

Metadados do serviço

Os metadados do serviço contêm campos que o serviço de Atualização de Dispositivo usa para comunicar ações e dados ao agente de Atualização de Dispositivo.

Interface de informações do dispositivo

A interface de informações do dispositivo é um conceito usado dentro da arquitetura IoT Plug and Play. A interface contém propriedades de dispositivo para nuvem que fornecem informações sobre o hardware e o sistema operacional do dispositivo. A Atualização de Dispositivo usa as propriedades DeviceInformation.manufacturer e DeviceInformation.model para telemetria e diagnósticos. Para obter um exemplo da interface de informações do dispositivo, consulte https://devicemodels.azure.com/dtmi/azure/devicemanagement/deviceinformation-1.json.

Quando você implementa essa interface, o nome do componente esperado em seu modelo é deviceInformation. Para obter mais informações, consulte o guia de modelagem IoT Plug and Play.

Conteúdos relacionados

• Arquivo de configuração da Atualização de Dispositivo
• Visão geral do agente de Atualização de Dispositivo para Hub IoT