pt-PT: Instale e utilize o Azure IoT explorer

O Azure IoT Explorer é uma ferramenta gráfica para interagir com dispositivos conectados ao seu hub IoT. Este artigo se concentra no uso da ferramenta para testar seus dispositivos IoT Plug and Play. Após instalar a ferramenta na sua máquina local, pode usá-la para se conectar a um hub. Pode usar a ferramenta para visualizar a telemetria que os dispositivos estão a enviar, trabalhar com as propriedades dos dispositivos e invocar comandos.

Este artigo mostra-lhe como:

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

Para mais informações gerais sobre o uso da ferramenta, consulte o readme no GitHub.

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

• Um hub IoT do Azure. Existem várias maneiras de adicionar um hub IoT à sua subscrição do Azure, como Criar um hub IoT usando a CLI do Azure. Precisamos da string de conexão do hub IoT para executar a ferramenta Azure IoT Explorer. Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.
• Um dispositivo registrado em seu hub IoT. Pode utilizar o IoT Explorer para criar e gerir registos de dispositivos no seu IoT Hub.

Instalar o Azure IoT Explorer

Vá para lançamentos do Azure IoT Explorer e expanda a lista de ativos para o lançamento mais recente. Transfira e instale a versão mais recente da aplicação. O pacote de instalação configura uma forma de iniciar a aplicação na sua plataforma. Por exemplo, no Windows, pode iniciar a aplicação a partir do menu Iniciar.

Utilize o Azure IoT explorer

Para um dispositivo, pode ligar o seu próprio dispositivo ou usar um dos dispositivos simulados de amostra.

Conecte-se ao seu hub

Na primeira vez que executar o Azure IoT Explorer, será solicitado a inserir a cadeia de ligação do seu hub IoT. Depois de adicionar a cadeia de conexão, selecione Ligar. Pode utilizar as definições da ferramenta para mudar para outro hub IoT atualizando a string de ligação.

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

Para adicionar uma fonte:

1. Vá para Home/IoT Plug and Play Settings
2. Selecione Adicionar e escolha a sua origem, de um repositório ou pasta local.

Para remover uma fonte:

1. Vá para Home/IoT Plug and Play Settings
2. Encontre a fonte que pretende remover.
3. Selecione X para removê-lo.

Altere as prioridades de origem:

Pode arrastar e soltar uma das fontes de definição do modelo para um ranking diferente na lista.

Ver dispositivos

Depois que a ferramenta se conecta ao seu hub IoT, ela exibe a página de listagem Dispositivos que lista as identidades de dispositivo registradas com seu hub IoT. Você pode selecionar qualquer entrada na lista para ver mais informações.

Na página de lista de Dispositivos, pode:

• Selecione Novo para registar um novo dispositivo no seu hub. Em seguida, insira um ID de dispositivo. Utilize as configurações padrão para gerar automaticamente chaves de autenticação e habilitar a conexão com o seu hub.
• Selecione um dispositivo e, em seguida, selecione Excluir para excluir uma identidade de dispositivo. Reveja os detalhes do dispositivo antes de completar esta ação para se certificar de que está a eliminar a identidade do dispositivo correta.

Interagir com um dispositivo

Na página de listagem Dispositivos , selecione um valor na coluna ID do dispositivo para exibir a página de detalhes do dispositivo registrado. Para cada dispositivo existem duas secções: Device e Digital Twin.

Dispositivo

Esta seção inclui as guias Identidade do dispositivo, Gêmeo do dispositivo, Telemetria, Método direto, Mensagem da nuvem para o dispositivo, Identidade do módulo .

• Você pode exibir e atualizar as informações de identidade do dispositivo na guia Identidade do dispositivo .
• Você pode acessar as informações do gêmeo do dispositivo na aba Gêmeo do Dispositivo.
• Se um dispositivo estiver conectado e enviando dados ativamente, você poderá exibir a telemetria na guia Telemetria .
• Você pode chamar um método direto no dispositivo na guia Método direto .
• Pode enviar uma mensagem da nuvem para o dispositivo no separador Mensagens da nuvem para o dispositivo .
• Você pode acessar as informações do módulo gêmeo .

Componentes IoT Plug and Play

Se o dispositivo estiver ligado ao hub através de um ID do Modelo, a ferramenta mostra o separador de componentes IoT Plug and Play onde pode ver o ID do Modelo.

Se o ID do Modelo estiver disponível em uma das fontes configuradas - Repositório Público ou Pasta Local, a lista de componentes será exibida. Selecionar um componente mostra as propriedades, comandos e telemetria disponíveis.

Na página Componente, pode visualizar as propriedades só de leitura, atualizar as propriedades editáveis, invocar comandos e ver as mensagens de telemetria produzidas por este componente.

Propriedades

Pode visualizar as propriedades de só leitura definidas numa interface no separador Propriedades (só leitura). Pode atualizar as propriedades de escrita definidas numa interface no separador Propriedades (escrita).

1. Vá para o separador Properties (writable).
2. Selecione a propriedade que deseja atualizar.
3. Insira o novo valor para a propriedade.
4. Pré-visualizar a carga a ser enviada para o dispositivo.
5. Enviar a alteração.

Depois de enviar uma alteração, você pode acompanhar o status da atualização: sincronização, êxito ou 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 que a sincronização seja concluída, a ferramenta ainda o notificará quando a atualização for concluída. Você também pode usar a central de notificações da ferramenta para ver o histórico de notificações.

Comandos

Para enviar um comando a um dispositivo, vá ao separador Comandos:

1. Expanda o comando que deseja acionar na lista de comandos.
2. Introduza os valores necessários para o comando.
3. Pré-visualizar a carga a ser enviada para o dispositivo.
4. Submete o comando.

Telemetria

Para visualizar a telemetria da interface selecionada, vá até ao separador Telemetria. Selecione Iniciar para começar a receber a telemetria.

Problemas conhecidos

Para uma lista das funcionalidades de IoT suportadas pela versão mais recente da ferramenta, veja Lista de funcionalidades.