Instalar e usar o Azure IoT ExplorerInstall and use Azure IoT explorer

O Azure IoT Explorer é uma ferramenta gráfica para interagir com dispositivos conectados ao Hub IoT.The Azure IoT explorer is a graphical tool for interacting with and devices connected to your IoT hub. Este artigo se concentra em usar a ferramenta para testar seus dispositivos de Plug and Play de IoT.This article focuses on using the tool to test your IoT Plug and Play devices. Depois de instalar a ferramenta em seu computador local, você pode usá-la para se conectar a um Hub.After installing the tool on your local machine, you can use it to connect to a hub. Você pode usar a ferramenta para exibir a telemetria que os dispositivos estão enviando, trabalhar com propriedades de dispositivo e invocar comandos.You can use the tool to view the telemetry the devices are sending, work with device properties, and invoke commands.

Este artigo mostra como:This article shows you how to:

  • Instale e configure a ferramenta do Azure IoT Explorer.Install and configure the Azure IoT explorer tool.
  • Use a ferramenta para interagir com e testar seus dispositivos IoT Plug and Play.Use the tool to interact with and test your IoT Plug and Play devices.

Para obter mais informações gerais sobre como usar a ferramenta, consulte o Leiamedo github.For more general information about using the tool, see the GitHub readme.

Para usar a ferramenta do Azure IoT Explorer, você precisa de:To use the Azure IoT explorer tool, you need:

  • Um Hub IoT do Azure.An Azure IoT hub. Há várias maneiras de adicionar um hub IoT à sua assinatura do Azure, como a criação de um hub IOT usando o CLI do Azure.There are many ways to add an IoT hub to your Azure subscription, such as Creating an IoT hub by using the Azure CLI. Você precisa da cadeia de conexão do Hub IoT para executar a ferramenta do Azure IoT Explorer.You need the IoT hub connection string to run the Azure IoT explorer tool. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.
  • Um dispositivo registrado em seu hub IoT.A device registered in your IoT hub. Você pode usar o Gerenciador IoT para criar e gerenciar registros de dispositivos no Hub IoT.You can use IoT Explorer to create and manage device registrations in your IoT Hub.

Instalar o Azure IoT ExplorerInstall Azure IoT explorer

Vá para versões do Azure IOT Explorer e expanda a lista de ativos para a versão mais recente.Go to Azure IoT explorer releases and expand the list of assets for the most recent release. Baixe e instale a versão mais recente do aplicativo.Download and install the most recent version of the application.

Importante

Atualize para a versão 0,13. x para resolver modelos de qualquer repositório com base em https://github.com/Azure/iot-plugandplay-modelsUpdate to version 0.13.x to resolve models from any repository based on https://github.com/Azure/iot-plugandplay-models

Usar o Azure IoT ExplorerUse Azure IoT explorer

Para um dispositivo, você pode conectar seu próprio dispositivo ou usar um dos dispositivos simulados de exemplo.For a device, you can either connect your own device, or use one of the sample simulated devices. Para alguns exemplos de dispositivos simulados escritos em linguagens diferentes, consulte o início rápido conectar um aplicativo de dispositivo de plug and Play IOT para o Hub IOT .For some example simulated devices written in different languages, see the Connect a sample IoT Plug and Play device application to IoT Hub quickstart.

Conectar-se ao seu hubConnect to your hub

Na primeira vez que você executar o Azure IoT Explorer, sua cadeia de conexão do Hub IoT será solicitada.The first time you run Azure IoT explorer, you're prompted for your IoT hub's connection string. Depois de adicionar a cadeia de conexão, selecione conectar.After you add the connection string, select Connect. Você pode usar as configurações da ferramenta para alternar para outro hub IoT atualizando a cadeia de conexão.You can use the tool's settings to switch to another IoT hub by updating the connection string.

A definição de modelo para um dispositivo de Plug and Play IoT é armazenada no repositório público, no dispositivo conectado ou em uma pasta local.The model definition for an IoT Plug and Play device is stored in either the public repository, the connected device, or a local folder. Por padrão, a ferramenta procura a definição do modelo no repositório público e no dispositivo conectado.By default, the tool looks for your model definition in the public repository and your connected device. Você pode adicionar e remover fontes ou configurar a prioridade das fontes em configurações:You can add and remove sources, or configure the priority of the sources in Settings:

Para adicionar uma fonte:To add a source:

  1. Ir para configurações de plug and Play doméstica/IOTGo to Home/IoT Plug and Play Settings
  2. Selecione Adicionar e escolha sua origem, de um repositório ou pasta local.Select Add and choose your source, from a repository or local folder.

Para remover uma fonte:To remove a source:

  1. Ir para configurações de plug and Play doméstica/IOTGo to Home/IoT Plug and Play Settings
  2. Localize a origem que você deseja remover.Find the source you want to remove.
  3. Selecione X para removê-lo.Select X to remove it.

Alterar as prioridades de origem:Change the source priorities:

Você pode arrastar e soltar uma das fontes de definição de modelo para uma classificação diferente na lista.You can drag and drop one of the model definition sources to a different ranking in the list.

Exibir dispositivosView devices

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 com o Hub IOT.After the tool connects to your IoT hub, it displays the Devices list page that lists the device identities registered with your IoT hub. Você pode selecionar qualquer entrada na lista para ver mais informações.You can select any entry in the list to see more information.

Na página lista de dispositivos , você pode:On the Devices list page you can:

  • Selecione novo para registrar um novo dispositivo com o Hub.Select New to register a new device with your hub. Em seguida, insira uma ID do dispositivo.Then enter a device ID. Use as configurações padrão para gerar automaticamente chaves de autenticação e habilitar a conexão com o Hub.Use the default settings to automatically generate authentication keys and enable the connection to your hub.
  • Selecione um dispositivo e, em seguida, selecione excluir para excluir uma identidade de dispositivo.Select a device and then select Delete to delete a device identity. Examine os detalhes do dispositivo antes de concluir esta ação para certificar-se de que você está excluindo a identidade correta do dispositivo.Review the device details before you complete this action to be sure you're deleting the right device identity.

Interagir com um dispositivoInteract with a device

Na página lista de dispositivos , selecione um valor na coluna ID do dispositivo para exibir a página de detalhes do dispositivo registrado.On the Devices list page, select a value in the Device ID column to view the detail page for the registered device. Para cada dispositivo, há duas seções: dispositivo e e/ou digital.For each device there are two sections: Device and Digital Twin.

DispositivoDevice

Esta seção inclui a identidade do dispositivo, dispositivos de dispositivo, telemetria, método direto, mensagem da nuvem para o dispositivo, guias de identidade do módulo .This section includes the Device Identity, Device Twin, Telemetry, Direct method, Cloud-to-device message, Module Identity tabs.

  • Você pode exibir e atualizar as informações de identidade do dispositivo na guia identidade do dispositivo .You can view and update the device identity information on the Device identity tab.
  • Você pode acessar as informações de FileUp do dispositivo na guia de dispositivo de entrelaçamento .You can access the device twin information on the Device Twin tab.
  • Se um dispositivo estiver conectado e enviando dados ativamente, você poderá exibir a telemetria na guia telemetria .If a device is connected and actively sending data, you can view the telemetry on the Telemetry tab.
  • Você pode chamar um método direto no dispositivo na guia método direto .You can call a direct method on the device on the Direct method tab.
  • Você pode enviar uma mensagem da nuvem para o dispositivo na guia mensagens da nuvem para o dispositivo .You can send a cloud-to-device message on the Cloud-to-device messages tab.
  • Você pode acessar as informações do módulo .You can access the module twin information.

Componentes de Plug and Play de IoTIoT Plug and Play components

Se o dispositivo estiver conectado ao Hub usando uma ID de modelo, a ferramenta mostrará a guia componentes de plug and Play IOT , onde você poderá ver a ID do modelo.If the device is connected to the hub using a Model ID, the tool shows the IoT Plug and Play components tab where you can see the Model ID.

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.If the Model ID is available in one of the configured sources - Public Repo or Local Folder, the list of components is displayed. A seleção de um componente mostra as propriedades, os comandos e a telemetria disponíveis.Selecting a component shows the properties, commands, and telemetry available.

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.On the Component page, you can view the read-only properties, update writable properties, invoke commands, and see the telemetry messages produced by this component.

Exibir componentes no Azure IoT Explorer

PropriedadesProperties

Exibir Propriedades no 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) :You can view the read-only properties defined in an interface on the Properties (read-only) tab. You can update the writable properties defined in an interface on the Properties (writable) tab:

  1. Vá para a guia Propriedades (gravável) .Go to the Properties (writable) tab.
  2. Clique na propriedade que você deseja atualizar.Click the property you'd like to update.
  3. Insira o novo valor para a propriedade.Enter the new value for the property.
  4. Visualize o conteúdo a ser enviado para o dispositivo.Preview the payload to be sent to the device.
  5. Envie a alteração.Submit the change.

Depois de enviar uma alteração, você pode acompanhar o status da atualização: sincronização, êxito ou erro.After you submit a change, you can track the update status: synching, success, or error. Quando a sincronização estiver concluída, você verá o novo valor da propriedade na coluna Propriedade relatada .When the synching is complete, you see the new value of your property in the Reported Property column. Se você navegar para outras páginas antes de a sincronização ser concluída, a ferramenta ainda o notificará quando a atualização for concluída.If you navigate to other pages before the synching completes, the tool still notifies you when the update is complete. Você também pode usar o centro de notificações da ferramenta para ver o histórico de notificações.You can also use the tool's notification center to see the notification history.

ComandosCommands

Para enviar um comando para um dispositivo, vá para a guia comandos :To send a command to a device, go to the Commands tab:

  1. Na lista de comandos, expanda o comando que você deseja disparar.In the list of commands, expand the command you want to trigger.
  2. Insira os valores necessários para o comando.Enter any required values for the command.
  3. Visualize o conteúdo a ser enviado para o dispositivo.Preview the payload to be sent to the device.
  4. Envie o comando.Submit the command.

TelemetriaTelemetry

Para exibir a telemetria da interface selecionada, vá para a guia telemetria .To view the telemetry for the selected interface, go to its Telemetry tab.

Problemas conhecidosKnown Issues

Para obter uma lista dos recursos de IoT com suporte da versão mais recente da ferramenta, consulte lista de recursos.For a list of the IoT features supported by the latest version of the tool, see Feature list.

Próximas etapasNext steps

Neste artigo de instruções, você aprendeu a instalar e usar o Azure IoT Explorer para interagir com seus dispositivos de Plug and Play de IoT.In this how-to article, you learned how to install and use Azure IoT explorer to interact with your IoT Plug and Play devices. Uma próxima etapa sugerida é aprender a instalar e usar as ferramentas de criação do DTDL.A suggested next step is to learn how to Install and use the DTDL authoring tools.