Atualização de dispositivo para o Hub IoT do Azure usando o Eclipse ThreadX

  • Artigo

Este artigo mostra como criar a Atualização de Dispositivo para o agente do Hub IoT do Azure no Eclipse ThreadX NetX Duo. Ele também fornece APIs simples para os desenvolvedores integrarem o recurso de Atualização de Dispositivo em seus aplicativos. Explore exemplos das principais placas de avaliação de semicondutores que incluem os guias de introdução para aprender a configurar, criar e implantar atualizações over-the-air nos dispositivos.

Se não tiver uma subscrição 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 (Padrão) ou superior.
  • Uma instância e uma conta de Atualização de Dispositivo vinculadas ao seu hub IoT. Siga o guia para criar e vincular uma conta de atualização de dispositivo, caso não tenha feito isso anteriormente.

Começar agora

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

  1. Baixe os arquivos de exemplo específicos da placa dos exemplos do Eclipse ThreadX e do Device Update.
  2. Encontre a pasta docs no exemplo baixado.
  3. Nos documentos, siga as etapas para preparar recursos do Azure e uma conta e registrar dispositivos IoT nela.
  4. Siga os documentos para criar uma nova imagem de firmware e importar manifesto para a sua placa.
  5. Publique a imagem e o manifesto do firmware na Atualização de Dispositivo para o Hub IoT.
  6. Transfira e execute o projeto no seu dispositivo.

Saiba mais sobre o Eclipse ThreadX.

Marcar o dispositivo

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

  2. Entre no portal do Azure e vá para o hub IoT.

  3. No painel esquerdo, selecione Devices (Dispositivos). Encontre seu dispositivo IoT e vá para o dispositivo gêmeo.

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

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

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

Ver grupos de dispositivos

A Atualização de Dispositivo usa grupos para organizar dispositivos. A Atualização de Dispositivo classifica automaticamente os dispositivos em grupos com base nas etiquetas atribuídas e nas propriedades de compatibilidade. Cada dispositivo pertence a apenas um grupo, mas os grupos podem ter vários subgrupos para classificar diferentes classes de dispositivos.

  1. Vá para a guia Grupos e implantações na parte superior da página.

    Captura de ecrã que mostra dispositivos não agrupados.

  2. Exiba a lista de grupos e o gráfico de conformidade de atualização. O gráfico de conformidade de atualização mostra a contagem de dispositivos em vários estados de conformidade: Na última atualização, 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 de atualização.

  3. Você verá um grupo de dispositivos que contém o dispositivo simulado configurado neste tutorial, juntamente com quaisquer atualizações disponíveis para os dispositivos no novo grupo. Se houver dispositivos que não atendam 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 a partir desse modo de exibição, selecione Implantar ao lado do grupo.

Para obter mais informações sobre tags e grupos, consulte Gerenciar grupos de dispositivos.

Implantar novo firmware

  1. Depois que o grupo for criado, você verá uma nova atualização disponível para seu grupo de dispositivos com um link para a atualização em Melhor atualização. Talvez seja necessário atualizar uma vez. Saiba mais sobre a conformidade de atualização.

  2. Selecione o grupo-alvo selecionando o nome do grupo. Você será direcionado para os detalhes do grupo em Noções básicas do grupo.

    Captura de ecrã que mostra os detalhes do Grupo.

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

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

  4. Agende sua implantação para começar imediatamente ou no futuro. Depois, selecione Criar.

    Gorjeta

    Por padrão, a data e a hora de início são 24 horas a partir da hora atual. Certifique-se de selecionar uma data e hora diferentes se quiser que a implantação comece mais cedo.

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

  5. Em Detalhes da implantação, Status se transforma em Ativo. A atualização implantada está marcada com (implantação).

    Captura de tela que mostra a implantação como Ativa.

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

  7. Depois que o dispositivo for atualizado com êxito, você verá que o gráfico de conformidade e os detalhes de implantação foram atualizados para refletir o mesmo.

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

Monitorar a implantação da atualização

  1. Selecione a guia Histórico de implantação na parte superior da página.

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

  2. Selecione Detalhes ao lado da implantação que você criou.

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

  3. Selecione Atualizar para visualizar os detalhes de status mais recentes.

Agora você concluiu uma atualização de imagem de ponta a ponta bem-sucedida usando a Atualização de Dispositivo para o Hub IoT em um dispositivo incorporado Eclipse ThreadX.

Próximos passos

Para saber mais sobre o Eclipse ThreadX e como ele funciona com o Hub IoT, consulte Eclipse ThreadX.