Instalar e usar o Azure IoT Explorer

O Azure IoT Explorer é uma ferramenta gráfica para a interação com os dispositivos conectados ao Hub IoT. Este artigo enfoca o uso da ferramenta para testar seus dispositivos IoT Plug and Play. Depois de instalar a ferramenta no computador local, você poderá usá-la para se conectar a um hub. Você pode usar a ferramenta para exibir a telemetria que os dispositivos estão enviando, trabalhar com propriedades de dispositivo e invocar comandos.

Este artigo mostra como:

  • Instale e configure a ferramenta Azure IoT Explorer.
  • Use a ferramenta para interagir e testar os dispositivos IoT Plug and Play.

Para obter mais informações gerais sobre como usar a ferramenta, confira o Leiame do GitHub.

Para usar a ferramenta Azure IoT Explorer, você precisa:

  • Um Hub IoT do Azure. Há várias maneiras de adicionar um Hub IoT à sua assinatura do Azure, como Criar um hub IoT usando a CLI do Azure. Você precisa da cadeia de conexão do Hub IoT para executar a ferramenta Azure IoT Explorer. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
  • Um dispositivo registrado em seu hub IoT. Você pode usar o IoT Explorer para criar e gerenciar registros de dispositivos no Hub IoT.

Instalar o Azure IoT Explorer

Acesse as versões do Azure IoT Explorer e expanda a lista de ativos para a versão mais recente. Baixe e instale a versão mais recente do aplicativo. O pacote de instalação configura uma maneira de iniciar o aplicativo em sua plataforma. Por exemplo, no Windows, você pode iniciar o aplicativo no menu Iniciar.

Importante

Atualize para a versão 0.13.x ou superior para resolver modelos de qualquer repositório com base em https://github.com/Azure/iot-plugandplay-models

Usar o Azure IoT Explorer

Para um dispositivo, você pode conectar o próprio dispositivo ou usar um dos exemplos de dispositivos simulados. Para ver exemplos de dispositivos simulados escritos em linguagens diferentes, confira o tutorial Conectar um exemplo de aplicativo de dispositivo IoT Plug and Play ao Hub IoT.

Conectar-se ao hub

Na primeira vez que você executar o Azure IoT Explorer, a cadeia de conexão do hub IoT será solicitada. Depois de adicionar a cadeia de conexão, selecione Conectar. Você pode usar as configurações da ferramenta para alternar para outro Hub IoT através da atualização da cadeia de conexão.

A definição de modelo para um dispositivo IoT Plug and Play é armazenada no repositório público, no dispositivo conectado ou em uma pasta local. Por padrão, a ferramenta procura a definição do modelo no repositório público e no dispositivo conectado. Você pode adicionar e remover fontes ou configurar a prioridade das fontes em Configurações:

Para adicionar uma origem:

  1. Ir para Configurações do IoT Plug and Play/Home
  2. Selecione Adicionar e escolha a origem, de um repositório ou pasta local.

Para remover uma fonte:

  1. Ir para Configurações do IoT Plug and Play/Home
  2. Localize a fonte que você deseja remover.
  3. Selecione X para removê-la.

Alterar as prioridades de fonte:

Você pode arrastar e soltar uma das fontes de definição de modelo para uma classificação diferente na lista.

Exibir dispositivos

Depois que a ferramenta se conectar ao Hub IoT, ela exibirá a página de lista de Dispositivos que lista as identidades de dispositivo registradas no seu Hub IoT. Você pode selecionar qualquer entrada na lista para ver mais informações.

Na página da lista de dispositivos, você pode:

  • Selecione Novo para registrar um novo dispositivo no hub. Em seguida, insira uma ID do dispositivo. Use as configurações padrão para gerar automaticamente as chaves de autenticação e habilitar a conexão com o hub.
  • Escolha um dispositivo e selecione Excluir para excluir uma identificação do dispositivo. Examine os detalhes do dispositivo antes de concluir essa ação para certificar-se de que você está excluindo a identificação do dispositivo correta.

Interagir com um dispositivo

Na página da lista de Dispositivos, selecione um valor na coluna ID do dispositivo para exibir a página de detalhes do dispositivo registrado. Para cada dispositivo, há duas seções: Dispositivo e Gêmeo digital.

Dispositivo

Esta seção tem as guias Identificação do dispositivo, Dispositivo gêmeo, Telemetria, Método direto, Mensagem nuvem para dispositivo, Identidade do módulo.

Componentes de IoT Plug and Play

Se o dispositivo estiver conectado ao hub usando uma ID de modelo, a ferramenta mostrará a guia Componentes do IoT Plug and Play, onde você poderá ver a ID do modelo.

Se a ID do modelo estiver disponível em uma das fontes configuradas (repositório público ou pasta local), a lista de componentes será exibida. A seleção de um componente mostra as propriedades, os comandos e a telemetria disponíveis.

Na página Componente, você pode exibir as propriedades somente leitura, atualizar propriedades graváveis, invocar comandos e ver as mensagens de telemetria produzidas por esse componente.

View components in Azure IoT explorer

Propriedades

View properties in Azure IoT explorer

Você pode exibir as propriedades somente leitura definidas em uma interface na guia Propriedades (somente leitura). Você pode atualizar as propriedades graváveis definidas em uma interface na guia Propriedades (gravável):

  1. Vá para a guia Propriedades (gravável).
  2. Selecione a propriedade que você deseja atualizar.
  3. Insira o novo valor da propriedade.
  4. Visualize a carga a ser enviada para o dispositivo.
  5. Envie a alteração.

Depois de enviar uma alteração, você poderá acompanhar o status da atualização: sincronização, êxitoou erro. Quando a sincronização estiver concluída, você verá o novo valor da sua propriedade na coluna Valor Relatado. Se você navegar para outras páginas antes de a sincronização ser concluída, a ferramenta ainda fará uma notificação quando a atualização for concluída. Também é possível usar o centro de notificações da ferramenta para ver o histórico de notificações.

Comandos

Para enviar um comando para um dispositivo, vá para a guia Comandos:

  1. Na lista de comandos, expanda o comando que você deseja disparar.
  2. Insira os valores necessários para o comando.
  3. Visualize a carga a ser enviada para o dispositivo.
  4. Envie o comando.

Telemetria

Para exibir a telemetria da interface selecionada, vá para a guia Telemetria. Selecione Iniciar para começar a receber a telemetria.

Problemas conhecidos

Para obter uma lista dos recursos de IoT com suporte da versão mais recente da ferramenta, confira Lista de recursos.

Próximas etapas

Neste artigo de instruções, você aprendeu a instalar e a usar o Azure IoT Explorer a fim de interagir com seus dispositivos IoT Plug and Play. Uma próxima etapa sugerida é aprender a Gerenciar o gêmeos digitais de IoT plug and Play.