Atualização de Dispositivo para Hub IoT e IoT Plug and Play

A Atualização de Dispositivo para Hub IoT usa o IoT Plug and Play para descobrir e gerenciar dispositivos com capacidade para atualização remota. O serviço de Atualização de Dispositivo envia e recebe propriedades e mensagens em dispositivos usando interfaces IoT Plug and Play.

Para mais informações:

• Entenda o cliente do dispositivo IoT Plug and Play.
• Veja como o agente de Atualização de Dispositivo é implementado.

Modelos de Atualização de Dispositivo

A ID do modelo é como os dispositivos inteligentes anunciam seus recursos para os aplicativos IoT do Azure com o IoT Plug and Play. Para saber mais sobre como criar dispositivos inteligentes para anunciar seus recursos aos aplicativos IoT do Azure, visite o Guia do desenvolvedor de dispositivos do IoT Plug and Play.

A Atualização de Dispositivo para Hub IoT exige que o dispositivo inteligente de IoT Plug and Play anuncie uma ID de modelo com parte da conexão do dispositivo. Saiba como anunciar uma ID de modelo.

A Atualização de Dispositivo tem vários modelos PnP definidos que dão suporte a recursos de DU. O modelo de Atualização de Dispositivo, "dtmi:azure:iot:deviceUpdateContractModel;3", dá suporte à funcionalidade principal e usa a interface principal de atualização do dispositivo para enviar ações de atualização e metadados para dispositivos e receber o status de atualização de dispositivos.

O outro modelo com suporte é dtmi:azure:iot:deviceUpdateModel;3, que estende deviceUpdateContractModel;3 e também usa outras interfaces PnP que enviam propriedades e informações do dispositivo e habilitam recursos de diagnóstico. Saiba mais sobre as [versões de interfaces e modelos de Atualização de Dispositivo] (https://github.com/Azure/iot-plugandplay-models/tree/main/dtmi/azure/iot).

O agente de Atualização de Dispositivo usa o dtmi:azure:iot:deviceUpdateModel;3, que dá suporte a todos os recursos mais recentes na versão 1.1.0. Este modelo dá suporte à versão do manifesto V5. Manifestos mais antigos funcionarão com os agentes mais recentes, mas novos recursos exigem o uso da versão mais recente do manifesto.

Metadados do agente

O agente de Atualização de Dispositivo usa campos de metadados do agente para enviar informações aos serviços de Atualização de Dispositivo.

Propriedades do dispositivo

O campo deviceProperties contém as informações do fabricante e do modelo para um 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\"}"
                },

Estado

O campo Status é o status relatado pelo agente de DU (Atualização de Dispositivo) após receber uma ação do serviço de Atualização de Dispositivo. O Status é relatado em resposta a uma Ação (confira a seção Ação para obter detalhes) enviada para o 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, confira o fluxo de trabalho de visão geral.

Metadados de serviço

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

Ação

O campo de ação representa as ações realizadas pelo agente de Atualização de Dispositivo, conforme instruído pelo serviço de Atualização de Dispositivo. O agente de Atualização de Dispositivo relatará um status para processar a ação recebida. 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, confira o fluxo de trabalho de visão geral.

Interface de informações do dispositivo

A interface de informações do dispositivo é um conceito usado na arquitetura de IoT Plug and Play. Ela 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 para Hub IoT usa as propriedades DeviceInformation.manufacturer e DeviceInformation.model para telemetria e diagnóstico. Para saber mais, confira este exemplo da interface de informações do dispositivo.

O nome do componente esperado em seu modelo é deviceInformation quando essa interface é implementada. Aprenda sobre os componentes IoT Plug and Play do Azure

Próximas etapas

• Entender o arquivo de configuração do agente de Atualização de Dispositivo

• Entenda a Atualização de Dispositivo para o Agente do Hub IoT do Azure