Atualização de Dispositivo para Hub IoT do Azure usando o Azure RTOS

Este artigo mostra como criar o agente da Atualização de Dispositivo para Hub IoT do Azure no Azure RTOS NetX Duo. Também fornece APIs simples para que os desenvolvedores integrem a funcionalidade de Atualização de Dispositivo aos aplicativos. Explore os exemplos dos principais painéis de avaliação de semicondutores, que incluem os guias de introdução para saber como configurar, criar e implantar as atualizações over-the-air em dispositivos.

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Pré-requisitos

  • Acesso a uma instância do Hub IoT. Recomendamos que você use uma camada S1 (Standard) ou superior.
  • Uma instância da Atualização de Dispositivo e uma conta vinculada ao hub IoT. Siga o guia para criar e vincular uma conta de atualização de dispositivo, caso não tenha feito isso anteriormente.

Introdução

Cada exemplo de projeto do Azure RTOS (sistema operacional em tempo real) específico do painel contém o código e a documentação sobre como usar a Atualização de Dispositivo para Hub IoT. Você vai:

  1. Baixe os arquivos de exemplo específicos do painel nos Exemplos do Azure RTOS e da Atualização de Dispositivo.
  2. Localize a pasta de documentação do exemplo baixado.
  3. Na documentação, siga as etapas para preparar os recursos do Azure uma conta e registrar os dispositivos IoT.
  4. Siga a documentação para criar uma imagem de firmware e importar o manifesto no painel.
  5. Publique a imagem de firmware e o manifesto na Atualização de Dispositivo para Hub IoT.
  6. Baixe e execute o projeto no dispositivo.

Saiba mais sobre o Azure RTOS.

Marcar seu dispositivo

  1. Mantenha o aplicativo do dispositivo em execução como na etapa anterior.

  2. Entre no portal do Azure e acesse o hub IoT.

  3. No painel esquerdo, selecione Dispositivos. Encontre o dispositivo IoT e acesse o dispositivo gêmeo.

  4. No dispositivo gêmeo, exclua todos os valores de marca existentes da Atualização de Dispositivo definindo-os como nulo.

  5. Adicione um novo valor de marca da Atualização de Dispositivo ao objeto JSON raiz, conforme mostrado:

        "tags": {
                "ADUGroup": "<CustomTagValue>"
                }
    

Criar um grupo de atualizações

  1. Acesse a guia Grupos e Implantações na parte superior da página.

    Captura de tela que mostra dispositivos desagrupados.

  2. Selecione Adicionar grupo para criar um novo grupo.

    Captura de tela que mostra a adição do grupo de dispositivos.

  3. Selecione uma marca do Hub IoT e a Classe de dispositivo na lista. Em seguida, selecione Criar grupo.

    Captura de tela que mostra a seleção de marcas.

  4. Depois que o grupo for criado, você verá que a lista de gráficos e grupos de conformidade de atualização será atualizada. O gráfico de conformidade da atualização mostra a contagem de dispositivos em vários estados de conformidade: Com a atualização mais recente, Novas atualizações disponíveis e Atualizações em andamento. Saiba mais sobre a conformidade de atualizações.

    Captura de tela que mostra a exibição de conformidade da atualização.

  5. Você deve ver o grupo recém-criado e todas as atualizações disponíveis para os dispositivos do novo grupo. Se houver dispositivos que não atendem aos requisitos de classe de dispositivo do grupo, eles aparecerão em um grupo inválido correspondente. Para implantar a melhor atualização disponível para o novo grupo definido pelo usuário deste modo de exibição, selecione Implantar ao lado do grupo.

Saiba mais sobre como adicionar marcas e criar grupos de atualização.

Implantar um novo firmware

  1. Depois que o grupo for criado, você verá uma nova atualização disponível para o grupo de dispositivos, juntamente com um link para a atualização em Melhor atualização. Talvez você precise atualizar novamente. Saiba mais sobre a conformidade das atualizações.

  2. Escolha o grupo de destino selecionando o nome do grupo. Você será direcionado para os detalhes do grupo em Noções básicas do grupo.

    Captura de tela que mostra detalhes do grupo.

  3. Para iniciar a implantação, acesse a guia Implantação atual. Selecione o link implantar ao lado da atualização desejada na seção de Atualizações disponíveis. A melhor atualização disponível para determinado grupo é indicada com a Melhor em destaque.

    Captura de tela que mostra a seleção de uma atualização.

  4. Agende sua implantação para iniciar imediatamente ou no futuro. Em seguida, selecione Criar.

    Dica

    Por padrão, a data e a hora de Início são 24 horas a partir do horário atual. Lembre-se de selecionar a data e a hora diferentes, caso deseje que a implantação comece mais cedo.

    Captura de tela que mostra a tela Criar tela de implantação.

  5. Em Detalhes da implantação, o Status se torna Ativo. A atualização implantada é marcada com (implantando).

    Captura de tela que mostra a implantação ativa.

  6. Exiba o gráfico de conformidade para ver se a atualização está em andamento.

  7. Depois de atualizar seu dispositivo com êxito, você verá que o gráfico de conformidade e os detalhes da implantação atualizados refletem as mesmas informações.

    Captura de tela que mostra a implantação bem-sucedida.

Monitorar a implantação da atualização

  1. Selecione a guia Histórico de Implantações na parte superior da página.

    Captura de tela que mostra o histórico da implantação.

  2. Selecione Detalhes ao lado da implantação criada.

    Captura de tela que mostra os detalhes da implantação.

  3. Selecione Atualizar para exibir os detalhes mais recentes do status.

Agora você concluiu com êxito uma atualização de imagem de ponta a ponta usando a Atualização de Dispositivo para Hub IoT em um dispositivo inserido do Azure RTOS.

Próximas etapas

Para saber mais sobre o Azure RTOS e como ele funciona com o Hub IoT, confira a página da Web do Azure RTOS.