Use as Ferramentas IoT do Azure para Visual Studio Code para gerenciar dispositivos Hub IoT do Azure

Diagrama de ponta a ponta

Neste artigo, você aprenderá a usar o Azure IoT Tools para Visual Studio Code com várias opções de gerenciamento em sua máquina de desenvolvimento. As Ferramentas IoT do Azure são uma extensão útil do Visual Studio Code que facilitam o gerenciamento do Hub IoT e o desenvolvimento de aplicativos para IoT. Ela é fornecida com opções de gerenciamento que podem ser usadas para executar várias tarefas.

Observação

Os recursos descritos neste artigo estão disponíveis apenas na camada padrão do Hub IoT. Para obter mais informações sobre as camadas básica e padrão/gratuita do Hub IoT, confira Escolher a camada certa do Hub IoT para a sua solução.

Opção de gerenciamento Tarefa
Métodos diretos Faça com que um dispositivo comece ou pare de enviar mensagens ou seja reinicializado.
Leitura de dispositivo gêmeo Obtenha o estado relatado de um dispositivo. Por exemplo, o dispositivo relata que o LED está piscando no momento.
Atualizar dispositivo gêmeo Coloque um dispositivo em alguns estados, como definir um LED como verde ou definir o intervalo de envio de telemetria como 30 minutos.
Mensagens da nuvem para o dispositivo Envie notificações para um dispositivo. Por exemplo, “É muito provável que chova hoje. Não se esqueça de levar um guarda-chuva”.

Para obter explicações mais detalhadas sobre as diferenças e diretrizes sobre como usar essas opções, consulte Diretrizes de comunicação do dispositivo para a nuvem e Diretrizes de comunicação da nuvem para o dispositivo.

Dispositivos gêmeos são documentos JSON que armazenam informações do estado do dispositivo (metadados, configurações e condições). O Hub IoT persiste um dispositivo gêmeo para cada dispositivo que você conecta a ele. Para obter mais informações sobre dispositivos gêmeos, consulte Introdução aos dispositivos gêmeos.

Observação

Recomendamos que você use o módulo Az PowerShell do Azure para interagir com o Azure. Confira Instalar o Azure PowerShell para começar. Para saber como migrar para o módulo Az PowerShell, confira Migrar o Azure PowerShell do AzureRM para o Az.

Pré-requisitos

Entre para acessar o Hub IoT

  1. Na exibição do Explorer do VS Code, expanda a seção Dispositivos do Hub IoT do Azure no canto inferior esquerdo.

  2. Clique no menu de contexto Selecionar Hub IoT.

  3. Um pop-up aparecerá no canto inferior direito para permitir que você entre no Azure pela primeira vez.

  4. Depois de entrar, sua lista de Assinatura do Azure será mostrada, então selecione a Assinatura do Azure e o Hub IoT.

  5. A lista de dispositivos será mostrada na guia Dispositivos do Hub IoT do Azure em poucos segundos.

    Observação

    Você também pode concluir a configuração escolhendo Definir cadeia de conexão do Hub IoT. Insira a cadeia de conexão da política iothubowner para o hub IoT ao qual seu dispositivo IoT se conecta na janela pop-up.

Métodos diretos

  1. Clique com o botão direito no seu dispositivo e selecione Invocação de Método Direto.

  2. Insira o nome do método e a carga na caixa de entrada.

  3. Os resultados serão mostrados na exibição SAÍDA>Kit de Ferramentas do Hub IoT do Azure.

Leitura de dispositivo gêmeo

  1. Clique com o botão direito e selecione Editar Gêmeo de Dispositivo.

  2. Um arquivo azure-iot-dispositivo-twin.json será aberto com o conteúdo do dispositivo gêmeo.

Atualizar dispositivo gêmeo

  1. Faça algumas edições de marcas ou campo properties.desired.

  2. Clique com botão direito no arquivo azure-iot-dispositivo-twin.json.

  3. Selecione Atualizar Dispositivo Gêmeo para atualizar o dispositivo gêmeo.

Envie mensagens da nuvem para o dispositivo

Para enviar uma mensagem do Hub IoT para o dispositivo, siga estas etapas:

  1. Clique com o botão direito do mouse no seu dispositivo e selecione Enviar Mensagem de C2D para Dispositivo.

  2. Insira a mensagem na caixa de entrada.

  3. Os resultados serão mostrados na exibição SAÍDA>Kit de Ferramentas do Hub IoT do Azure.

Próximas etapas

Você aprendeu como usar a extensão Ferramentas IoT do Azure para Visual Studio Code com várias opções de gerenciamento.

Para continuar a introdução ao Hub IoT do Azure e explorar todos os outros cenários de IoT estendidos, confira: