Quickstart: Enviar telemetria de um dispositivo IoT Plug and Play para Hub IoT do Azure

Aplica-se a: Desenvolvedores de aplicações de dispositivos

Browse code

Neste arranque rápido, você aprende um fluxo básico de desenvolvimento de aplicações Azure IoT. Você usa o Azure CLI e IoT Explorer para criar um hub Azure IoT e um dispositivo. Em seguida, utilize uma amostra SDK do dispositivo Azure IoT para executar um controlador de temperatura, conectá-la de forma segura ao centro e enviar telemetria. A aplicação da amostra do controlador de temperatura funciona na sua máquina local e gera dados simulados do sensor para enviar para Hub IoT.

Pré-requisitos

Este quickstart corre em Windows, Linux, e Raspberry Pi. Foi testado nas seguintes versões de sistema operativo e sistema:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) versão 10, correndo em um Raspberry Pi 3 Model B+

Instale os seguintes pré-requisitos na sua máquina de desenvolvimento, exceto quando se nota para Raspberry Pi:

  • Se não tiver uma subscrição do Azure, crie uma gratuitamente antes de começar.
  • O Git.
  • Azure IoT Explorer: Cross-platform, utilitário baseado em GUI para monitorizar e gerir a Azure IoT. Se estiver a utilizar raspberry Pi como plataforma de desenvolvimento, recomendamos que instale o IoT Explorer noutro computador. Se não quiser instalar o IoT Explorer, pode utilizar o Azure CLI para executar os mesmos passos.
  • CLI do Azure. Tem duas opções para executar comandos Azure CLI neste arranque rápido:
    • Utilize o Azure Cloud Shell, uma concha interativa que executa comandos CLI no seu navegador. Esta opção é recomendada porque não precisa de instalar nada. Se estiver a usar Cloud Shell pela primeira vez, inicie sessão no portal do Azure. Siga os passos em Cloud Shell arranque rápido para iniciar Cloud Shell e selecione o ambiente Bash.
    • Opcionalmente, coloque o Azure CLI na sua máquina local. Se o Azure CLI já estiver instalado, corra az upgrade para atualizar o CLI e as extensões para a versão atual. Para instalar o Azure CLI, consulte a Instalação Azure CLI. Se estiver a utilizar raspberry Pi como plataforma de desenvolvimento, recomendamos que utilize o Azure Cloud Shell ou instale o Azure CLI noutro computador.

Instale os restantes pré-requisitos para o seu sistema operativo.

Linux ou Raspberry Pi OS

Para completar este arranque rápido no Linux ou Raspberry Pi OS, instale o seguinte software:

Instale GCC, Git, cmake e as dependências necessárias utilizando o apt-get comando:

sudo apt-get update
sudo apt-get install -y git cmake build-essential curl libcurl4-openssl-dev libssl-dev uuid-dev

Verifique se a versão é cmake superior a 2.8.12 e a versão de GCC é superior a 4.4.7.

cmake --version
gcc --version

Windows

Para completar este quickstart em Windows, instale Visual Studio 2019 e adicione os componentes necessários para o desenvolvimento de C e C++.

  1. Para novos utilizadores, instale Visual Studio (Comunidade, Profissional ou Empresa) 2019. Faça o download da edição que pretende instalar e inicie o instalador.

    Nota

    Para os utilizadores existentes Visual Studio 2019, selecione Windows Start, tipo Visual Studio Instalador e ligue o instalador.

  2. No separador de trabalhos de trabalho do instalador, selecione o Desenvolvimento do Ambiente de Trabalho com carga de trabalho C++ .
  3. Execute a instalação.

Criar um hub IoT

Nesta secção, você usa Azure CLI para criar um hub IoT e um grupo de recursos. Um grupo de recursos do Azure é um contentor lógico no qual os recursos do Azure são implementados e geridos. Um hub IoT funciona como um centro de mensagens central para comunicação bidis entre a sua aplicação IoT e dispositivos.

Para criar um hub IoT e um grupo de recursos:

  1. Lançamento Azure CLI:

    • Se estiver a utilizar Cloud Shell, selecione o botão Try It nos comandos CLI para lançar Cloud Shell numa janela do navegador dividida. Ou pode abrir o Cloud Shell num separador de navegador.
    • Se estiver a utilizar o Azure CLI localmente, abra uma consola como Windows CMD, PowerShell ou Bash e inscreva-se no Azure CLI.

    Para executar os comandos CLI no resto deste arranque rápido: copiar a sintaxe de comando, colá-la na sua janela Cloud Shell ou consola CLI, editar valores variáveis e pressionar Enter.

  2. Executar extensão az adicionar para instalar ou atualizar a extensão azure-iot para a versão atual.

    az extension add --upgrade --name azure-iot
    
  3. Executar o grupo az criar comando para criar um grupo de recursos. O seguinte comando cria um grupo de recursos chamado MyResourceGroup na localização leste .

    Nota

    Pode configurar opcionalmente uma localização alternativa. Para ver os locais disponíveis, corra az account list-locations. Este tutorial usa eastus como mostrado no comando exemplo.

    az group create --name MyResourceGroup --location eastus
    
  4. Executar o hub az iot criar comando para criar um hub IoT. Pode levar alguns minutos para criar um hub IoT.

    Seu Nome De TeiotHub. Substitua este espaço reservado e os aparelhos circundantes no seguinte comando, utilizando o nome que escolheu para o seu hub IoT. Um nome de hub IoT deve ser globalmente único em Azure. Use o seu nome de hub IoT no resto deste quickstart onde quer que veja o espaço reservado.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
    

    Dica

    Depois de criar um hub IoT, você usará o Azure IoT Explorer para interagir com o seu hub IoT no resto deste arranque rápido. O IoT Explorer é uma aplicação GUI que permite ligar-se a um Hub IoT existente e adicionar, gerir e monitorizar dispositivos. Para saber mais, consulte instalar e utilizar o explorador Azure IoT. Opcionalmente, pode continuar a utilizar comandos CLI.

Configure IoT Explorer

No resto deste arranque rápido, você usará o IoT Explorer para registar um dispositivo no seu hub IoT e para visualizar a telemetria do dispositivo. Nesta secção, configura o IoT Explorer para ligar ao hub IoT que acabou de criar e ler modelos plug e play a partir do repositório de modelos públicos.

Nota

Também pode utilizar o CLI Azure para registar um dispositivo. Utilize o comando az iot hub-iot dispositivo-identidade criar --device id mydevice --hub-name {YourIoTHubName} para registar um novo dispositivo e o az iot hub dispositivo-identidade-série de ligação-corda - -device id mydevice --hub-name {YourIoTHubName} para obter o comando de ligação primária para o dispositivo. Uma vez anotada a cadeia de ligação do dispositivo, pode passar à frente para executar a amostra do dispositivo.

Para adicionar uma ligação ao seu hub IoT:

  1. Executar o comando de programa de ligação az iot hub para obter a cadeia de ligação para o seu hub IoT.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Copie a cadeia de ligação sem os caracteres de citação circundante.

  3. No Azure IoT Explorer, selecione os hubs IoT no menu esquerdo e, em seguida, selecione + Adicione a ligação.

  4. Cole o fio de ligação na caixa de cordas Connection .

  5. Selecione Guardar.

    Screenshot of adding a connection in IoT Explorer

  6. Se a ligação for bem sucedida, o IoT Explorer muda para a vista dispositivos .

Para adicionar o repositório de modelo público:

  1. No IoT Explorer, selecione Home para voltar à vista de casa.

  2. No menu esquerdo, selecione IoT Plug and Play Definições, em seguida, selecione +Adicionar e selecione repositório público a partir do menu suspenso.

  3. Aparece uma entrada para o repositório de modelos públicos em https://devicemodels.azure.com.

    Screenshot of adding the public model repository in IoT Explorer

  4. Selecione Guardar.

Registar um dispositivo

Nesta secção, cria-se uma nova instância do dispositivo e regista-a com o hub IoT que criou. Utilizará as informações de ligação para o dispositivo recentemente registado para ligar o seu dispositivo de forma segura numa secção posterior.

Para registar um dispositivo:

  1. A partir da vista para casa no IoT Explorer, selecione hubs IoT.

  2. A ligação que adicionou anteriormente deve aparecer. Selecione Ver os dispositivos neste centro abaixo das propriedades de ligação.

  3. Selecione + Novo e introduza um ID do dispositivo para o seu dispositivo; por exemplo, mydevice. Deixe todas as outras propriedades iguais.

  4. Selecione Criar.

    Screenshot of Azure IoT Explorer device identity

  5. Utilize os botões de cópia para copiar e anotar o campo de cordas de ligação primária . Vai precisar desta ligação mais tarde.

Executar a amostra do dispositivo

Nesta secção, utiliza o C SDK para enviar mensagens de um dispositivo para o seu hub IoT. Vais executar uma amostra que implementa um controlador de temperatura com dois sensores termostatos.

Construa a amostra

  1. Abra uma nova consola para instalar o dispositivo Azure IoT C SDK e executar a amostra de código. Para Windows, selecione Iniciar, digite o Pedido de Comando do Desenvolvedor para VS 2019 e abra a consola. Para Linux e Raspberry Pi OS, abra um terminal para comandos Bash.

    Nota

    Se estiver a utilizar uma instalação local do Azure CLI, pode agora ter duas janelas de consola abertas. Certifique-se de introduzir os comandos nesta secção na consola que acabou de abrir, não a que tem usado para o CLI.

  2. Navegue para uma pasta local onde pretende clonar a amostra de repo.

  3. Clone o dispositivo Azure IoT C SDK para a sua máquina local:

    git clone https://github.com/Azure/azure-iot-sdk-c.git
    
  4. Navegue para a pasta raiz do SDK e executar o seguinte comando para atualizar as dependências:

    cd azure-iot-sdk-c
    git submodule update --init
    

    Esta operação poderá demorar alguns minutos.

  5. Para construir o SDK e as amostras, executar os seguintes comandos:

    cmake -Bcmake -Duse_prov_client=ON -Dhsm_type_symm_key=ON -Drun_e2e_tests=OFF
    cmake --build cmake
    
  6. Desaprote as seguintes variáveis ambientais, para permitir que o seu dispositivo se conecte ao Azure IoT.

    • Desaprova uma variável ambiental chamada IOTHUB_DEVICE_CONNECTION_STRING. Para o valor variável, utilize a cadeia de ligação do dispositivo que guardou na secção anterior.
    • Desaprova uma variável ambiental chamada IOTHUB_DEVICE_SECURITY_TYPE. Para a variável, use o valor connectionStringliteral da corda.

    CMD

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
    set IOTHUB_DEVICE_SECURITY_TYPE=connectionString
    

    Nota

    Para Windows CMD não existem marcas de aspas em torno dos valores de cadeia para cada variável.

    Bash

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    

Executar o código

  1. Executar o código de amostra, utilizando o comando apropriado para a sua consola.

    CMD

    cmake\iothub_client\samples\pnp\pnp_temperature_controller\Debug\pnp_temperature_controller.exe
    

    Bash

    cmake/iothub_client/samples/pnp/pnp_temperature_controller/pnp_temperature_controller
    

    Nota

    Esta amostra de código utiliza Plug and Play Azure IoT, que permite integrar dispositivos inteligentes nas suas soluções sem qualquer configuração manual. Por padrão, a maioria das amostras desta documentação utilizam IoT Plug and Play. Para saber mais sobre as vantagens do IoT PnP, e os casos para usá-lo ou não, veja o que é IoT Plug and Play?.

A amostra conecta-se seguramente ao seu hub IoT como o dispositivo que registou e começa a enviar mensagens de telemetria. A saída da amostra aparece na sua consola.

Ver telemetria

Pode ver a telemetria do dispositivo com o IoT Explorer. Opcionalmente, pode ver a telemetria utilizando o Azure CLI.

Para ver telemetria no Azure IoT Explorer:

  1. A partir do seu hub Iot no IoT Explorer, selecione Ver dispositivos neste hub e, em seguida, selecione o seu dispositivo da lista.

  2. No menu esquerdo para o seu dispositivo, selecione Telemetria.

  3. Confirme que o hub de evento incorporado está definido para Sim e, em seguida, selecione Start.

  4. Veja a telemetria à medida que o dispositivo envia mensagens para a nuvem.

    Screenshot of device telemetry in IoT Explorer

  5. Selecione Parar para terminar a receber eventos.

Para ler telemetria enviada por componentes individuais do dispositivo, pode utilizar as funcionalidades de ficha e reprodução no IoT Explorer. Por exemplo, o controlador de temperatura neste arranque rápido tem dois termostatos: termostato1 e termostato2. Para ver a temperatura reportada pelo termóstato1:

  1. No seu dispositivo no IoT Explorer, selecione componentes de Plug and Play IoT do menu esquerdo. Em seguida, selecione o termóstato1 da lista de componentes.

  2. No painel de componentes do termóstato1 , selecione Telemetria no menu superior.

  3. No painel de telemetria , siga os mesmos passos que fez anteriormente. Certifique-se de que o hub de eventos incorporado está definido para Sim e, em seguida, selecione Start.

Para ver telemetria do dispositivo com Azure CLI:

  1. Executar o comando de monitor-eventos do hub az iot para monitorizar os eventos enviados do dispositivo para o seu hub IoT. Utilize os nomes que criou anteriormente em Azure IoT para o seu dispositivo e hub IoT.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Ver os detalhes de ligação e a saída de telemetria na consola.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
    event:
      component: ''
      interface: dtmi:com:example:TemperatureController;1
      module: ''
      origin: mydevice
      payload: '{"workingSet":1251}'
    
    event:
      component: thermostat1
      interface: dtmi:com:example:TemperatureController;1
      module: ''
      origin: mydevice
      payload: '{"temperature":22.00}'
    

Browse code

Neste arranque rápido, você aprende um fluxo básico de desenvolvimento de aplicações Azure IoT. Você usa o Azure CLI e IoT Explorer para criar um hub Azure IoT e um dispositivo. Em seguida, utilize uma amostra SDK do dispositivo Azure IoT para executar um controlador de temperatura, conectá-la de forma segura ao centro e enviar telemetria. A aplicação da amostra do controlador de temperatura funciona na sua máquina local e gera dados simulados do sensor para enviar para Hub IoT.

Pré-requisitos

Este quickstart corre em Windows, Linux, e Raspberry Pi. Foi testado nas seguintes versões de sistema operativo e sistema:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) versão 10, correndo em um Raspberry Pi 3 Model B+

Instale os seguintes pré-requisitos na sua máquina de desenvolvimento, exceto quando se nota para Raspberry Pi:

  • Se não tiver uma subscrição do Azure, crie uma gratuitamente antes de começar.

  • O Git.

  • .NET Core SDK 3.1. Certifique-se de que instala o .NET SDK, e não apenas o tempo de execução. Para verificar a versão do .NET SDK e tempo de execução instalados na sua máquina, corra dotnet --info.

    • Para Windows e Linux (exceto Raspberry Pi), siga as instruções para instalar o .NET Core SDK 3.1 na sua plataforma.
    • Para Raspberry Pi, terá de seguir as instruções para instalar manualmente o SDK. Isto porque na Debian, as instalações do gestor de pacotes do .NET SDK são apenas suportadas para a arquitetura x64.
  • Azure IoT Explorer: Cross-platform, utilitário baseado em GUI para monitorizar e gerir a Azure IoT. Se estiver a utilizar raspberry Pi como plataforma de desenvolvimento, recomendamos que instale o IoT Explorer noutro computador. Se não quiser instalar o IoT Explorer, pode utilizar o Azure CLI para executar os mesmos passos.

  • CLI do Azure. Tem duas opções para executar comandos Azure CLI neste arranque rápido:

    • Utilize o Azure Cloud Shell, uma concha interativa que executa comandos CLI no seu navegador. Esta opção é recomendada porque não precisa de instalar nada. Se estiver a usar Cloud Shell pela primeira vez, inicie sessão no portal do Azure. Siga os passos em Cloud Shell arranque rápido para iniciar Cloud Shell e selecione o ambiente Bash.
    • Opcionalmente, coloque o Azure CLI na sua máquina local. Se o Azure CLI já estiver instalado, corra az upgrade para atualizar o CLI e as extensões para a versão atual. Para instalar o Azure CLI, consulte a Instalação Azure CLI. Se estiver a utilizar raspberry Pi como plataforma de desenvolvimento, recomendamos que utilize o Azure Cloud Shell ou instale o Azure CLI noutro computador.

Criar um hub IoT

Nesta secção, você usa Azure CLI para criar um hub IoT e um grupo de recursos. Um grupo de recursos do Azure é um contentor lógico no qual os recursos do Azure são implementados e geridos. Um hub IoT funciona como um centro de mensagens central para comunicação bidis entre a sua aplicação IoT e dispositivos.

Para criar um hub IoT e um grupo de recursos:

  1. Lançamento Azure CLI:

    • Se estiver a utilizar Cloud Shell, selecione o botão Try It nos comandos CLI para lançar Cloud Shell numa janela do navegador dividida. Ou pode abrir o Cloud Shell num separador de navegador.
    • Se estiver a utilizar o Azure CLI localmente, abra uma consola como Windows CMD, PowerShell ou Bash e inscreva-se no Azure CLI.

    Para executar os comandos CLI no resto deste arranque rápido: copiar a sintaxe de comando, colá-la na sua janela Cloud Shell ou consola CLI, editar valores variáveis e pressionar Enter.

  2. Executar extensão az adicionar para instalar ou atualizar a extensão azure-iot para a versão atual.

    az extension add --upgrade --name azure-iot
    
  3. Executar o grupo az criar comando para criar um grupo de recursos. O seguinte comando cria um grupo de recursos chamado MyResourceGroup na localização leste .

    Nota

    Pode configurar opcionalmente uma localização alternativa. Para ver os locais disponíveis, corra az account list-locations. Este tutorial usa eastus como mostrado no comando exemplo.

    az group create --name MyResourceGroup --location eastus
    
  4. Executar o hub az iot criar comando para criar um hub IoT. Pode levar alguns minutos para criar um hub IoT.

    Seu Nome De TeiotHub. Substitua este espaço reservado e os aparelhos circundantes no seguinte comando, utilizando o nome que escolheu para o seu hub IoT. Um nome de hub IoT deve ser globalmente único em Azure. Use o seu nome de hub IoT no resto deste quickstart onde quer que veja o espaço reservado.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
    

    Dica

    Depois de criar um hub IoT, você usará o Azure IoT Explorer para interagir com o seu hub IoT no resto deste arranque rápido. O IoT Explorer é uma aplicação GUI que permite ligar-se a um Hub IoT existente e adicionar, gerir e monitorizar dispositivos. Para saber mais, consulte instalar e utilizar o explorador Azure IoT. Opcionalmente, pode continuar a utilizar comandos CLI.

Configure IoT Explorer

No resto deste arranque rápido, você usará o IoT Explorer para registar um dispositivo no seu hub IoT e para visualizar a telemetria do dispositivo. Nesta secção, configura o IoT Explorer para ligar ao hub IoT que acabou de criar e ler modelos plug e play a partir do repositório de modelos públicos.

Nota

Também pode utilizar o CLI Azure para registar um dispositivo. Utilize o comando az iot hub-iot dispositivo-identidade criar --device id mydevice --hub-name {YourIoTHubName} para registar um novo dispositivo e o az iot hub dispositivo-identidade-série de ligação-corda - -device id mydevice --hub-name {YourIoTHubName} para obter o comando de ligação primária para o dispositivo. Uma vez anotada a cadeia de ligação do dispositivo, pode passar à frente para executar a amostra do dispositivo.

Para adicionar uma ligação ao seu hub IoT:

  1. Executar o comando de programa de ligação az iot hub para obter a cadeia de ligação para o seu hub IoT.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Copie a cadeia de ligação sem os caracteres de citação circundante.

  3. No Azure IoT Explorer, selecione os hubs IoT no menu esquerdo e, em seguida, selecione + Adicione a ligação.

  4. Cole o fio de ligação na caixa de cordas Connection .

  5. Selecione Guardar.

    Screenshot of adding a connection in IoT Explorer

  6. Se a ligação for bem sucedida, o IoT Explorer muda para a vista dispositivos .

Para adicionar o repositório de modelo público:

  1. No IoT Explorer, selecione Home para voltar à vista de casa.

  2. No menu esquerdo, selecione IoT Plug and Play Definições, em seguida, selecione +Adicionar e selecione repositório público a partir do menu suspenso.

  3. Aparece uma entrada para o repositório de modelos públicos em https://devicemodels.azure.com.

    Screenshot of adding the public model repository in IoT Explorer

  4. Selecione Guardar.

Registar um dispositivo

Nesta secção, cria-se uma nova instância do dispositivo e regista-a com o hub IoT que criou. Utilizará as informações de ligação para o dispositivo recentemente registado para ligar o seu dispositivo de forma segura numa secção posterior.

Para registar um dispositivo:

  1. A partir da vista para casa no IoT Explorer, selecione hubs IoT.

  2. A ligação que adicionou anteriormente deve aparecer. Selecione Ver os dispositivos neste centro abaixo das propriedades de ligação.

  3. Selecione + Novo e introduza um ID do dispositivo para o seu dispositivo; por exemplo, mydevice. Deixe todas as outras propriedades iguais.

  4. Selecione Criar.

    Screenshot of Azure IoT Explorer device identity

  5. Utilize os botões de cópia para copiar e anotar o campo de cordas de ligação primária . Vai precisar desta ligação mais tarde.

Executar a amostra do dispositivo

Nesta secção, utilizará o C# SDK para enviar mensagens de um dispositivo para o seu hub IoT. Vais executar uma amostra que implementa um controlador de temperatura com dois sensores termostatos.

  1. Abra uma nova consola como Windows CMD, PowerShell ou Bash. Nos passos seguintes, utilizará esta consola para instalar o SDK Node.js e trabalhar com Node.js código de amostra.

    Nota

    Se estiver a utilizar uma instalação local do Azure CLI, pode agora ter duas janelas de consola abertas. Certifique-se de introduzir os comandos nesta secção na consola que acabou de abrir, não a que tem usado para o CLI.

  2. Clone as amostras de IoT Microsoft Azure para C# (.NET) para a sua máquina local:

    git clone https://github.com/Azure-Samples/azure-iot-samples-csharp.git
    
  3. Navegue para o diretório de amostras:

    Windows

    cd azure-iot-samples-csharp\iot-hub\Samples\device\PnpDeviceSamples\TemperatureController
    

    Linux ou Raspberry Pi OS

    cd azure-iot-samples-csharp/iot-hub/Samples/device/PnpDeviceSamples/TemperatureController
    
  4. Instale o Azure IoT C# SDK e as dependências necessárias:

    dotnet restore
    

    Este comando instala as dependências adequadas, conforme especificado no ficheiro TemperatureController.csproj .

  5. Desaprote ambas as seguintes variáveis ambientais, para permitir que o seu dispositivo se conecte ao Azure IoT.

    • Desaprova uma variável ambiental chamada IOTHUB_DEVICE_CONNECTION_STRING. Para o valor variável, utilize a cadeia de ligação do dispositivo que guardou na secção anterior.
    • Desaprova uma variável ambiental chamada IOTHUB_DEVICE_SECURITY_TYPE. Para a variável, use o valor connectionStringliteral da corda.

    CMD (Windows)

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
    set IOTHUB_DEVICE_SECURITY_TYPE=connectionString
    

    Nota

    Para Windows CMD não existem marcas de aspas em torno dos valores de cadeia para cada variável.

    PowerShell

    $env:IOTHUB_DEVICE_CONNECTION_STRING='<your connection string here>'
    $env:IOTHUB_DEVICE_SECURITY_TYPE='connectionString'
    

    Bash

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  6. Executar a amostra de código:

    dotnet run
    

    Nota

    Esta amostra de código utiliza Plug and Play Azure IoT, que permite integrar dispositivos inteligentes nas suas soluções sem qualquer configuração manual. Por padrão, a maioria das amostras desta documentação utilizam IoT Plug and Play. Para saber mais sobre as vantagens do IoT PnP, e os casos para usá-lo ou não, veja o que é IoT Plug and Play?.

A amostra conecta-se seguramente ao seu hub IoT como o dispositivo que registou e começa a enviar mensagens de telemetria. A saída da amostra aparece na sua consola.

Ver telemetria

Pode ver a telemetria do dispositivo com o IoT Explorer. Opcionalmente, pode ver a telemetria utilizando o Azure CLI.

Para ver telemetria no Azure IoT Explorer:

  1. A partir do seu hub Iot no IoT Explorer, selecione Ver dispositivos neste hub e, em seguida, selecione o seu dispositivo da lista.

  2. No menu esquerdo para o seu dispositivo, selecione Telemetria.

  3. Confirme que o hub de evento incorporado está definido para Sim e, em seguida, selecione Start.

  4. Veja a telemetria à medida que o dispositivo envia mensagens para a nuvem.

    Screenshot of device telemetry in IoT Explorer

  5. Selecione Parar para terminar a receber eventos.

Para ler telemetria enviada por componentes individuais do dispositivo, pode utilizar as funcionalidades de ficha e reprodução no IoT Explorer. Por exemplo, o controlador de temperatura neste arranque rápido tem dois termostatos: termostato1 e termostato2. Para ver a temperatura reportada pelo termóstato1:

  1. No seu dispositivo no IoT Explorer, selecione componentes de Plug and Play IoT do menu esquerdo. Em seguida, selecione o termóstato1 da lista de componentes.

  2. No painel de componentes do termóstato1 , selecione Telemetria no menu superior.

  3. No painel de telemetria , siga os mesmos passos que fez anteriormente. Certifique-se de que o hub de eventos incorporado está definido para Sim e, em seguida, selecione Start.

Para ver telemetria do dispositivo com Azure CLI:

  1. Executar o comando de monitor-eventos do hub az iot para monitorizar os eventos enviados do dispositivo para o seu hub IoT. Utilize os nomes que criou anteriormente em Azure IoT para o seu dispositivo e hub IoT.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Ver os detalhes de ligação e a saída de telemetria na consola.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
    event:
      component: thermostat1
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 39.8
    
    event:
      component: thermostat2
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 36.7
    
  3. Selecione CTRL+C para terminar a monitorização.

Browse code

Neste arranque rápido, você aprende um fluxo básico de desenvolvimento de aplicações Azure IoT. Você usa o Azure CLI e IoT Explorer para criar um hub Azure IoT e um dispositivo. Em seguida, utilize uma amostra SDK do dispositivo Azure IoT para executar um controlador de temperatura, conectá-la de forma segura ao centro e enviar telemetria. A aplicação da amostra do controlador de temperatura funciona na sua máquina local e gera dados simulados do sensor para enviar para Hub IoT.

Pré-requisitos

Este quickstart corre em Windows, Linux, e Raspberry Pi. Foi testado nas seguintes versões de sistema operativo e sistema:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) versão 10, correndo em um Raspberry Pi 3 Model B+

Instale os seguintes pré-requisitos na sua máquina de desenvolvimento, exceto quando se nota para Raspberry Pi:

  • Se não tiver uma subscrição do Azure, crie uma gratuitamente antes de começar.
  • O Git.
  • Azure IoT Explorer: Cross-platform, utilitário baseado em GUI para monitorizar e gerir a Azure IoT. Se estiver a utilizar raspberry Pi como plataforma de desenvolvimento, recomendamos que instale o IoT Explorer noutro computador. Se não quiser instalar o IoT Explorer, pode utilizar o Azure CLI para executar os mesmos passos.
  • CLI do Azure. Tem duas opções para executar comandos Azure CLI neste arranque rápido:
    • Utilize o Azure Cloud Shell, uma concha interativa que executa comandos CLI no seu navegador. Esta opção é recomendada porque não precisa de instalar nada. Se estiver a usar Cloud Shell pela primeira vez, inicie sessão no portal do Azure. Siga os passos em Cloud Shell arranque rápido para iniciar Cloud Shell e selecione o ambiente Bash.
    • Opcionalmente, coloque o Azure CLI na sua máquina local. Se o Azure CLI já estiver instalado, corra az upgrade para atualizar o CLI e as extensões para a versão atual. Para instalar o Azure CLI, consulte a Instalação Azure CLI. Se estiver a utilizar raspberry Pi como plataforma de desenvolvimento, recomendamos que utilize o Azure Cloud Shell ou instale o Azure CLI noutro computador.

Instale os restantes pré-requisitos para o seu sistema operativo.

Windows

Para completar este arranque rápido no Windows, instale o seguinte software:

  • Java SE Kit de Desenvolvimento 8 ou mais tarde. Você pode baixar o JDK Java 8 (LTS) para várias plataformas a partir de Download Zulu Builds of OpenJDK. No instalador, selecione a opção Adicionar ao Caminho .

  • Apache Maven 3. Depois de extrair o download para uma pasta local, adicione o caminho completo à pasta Maven /bin à variável ambiente WindowsPATH.

Linux ou Raspberry Pi OS

Para completar este arranque rápido no Linux ou Raspberry Pi OS, instale o seguinte software:

Nota

Os passos nesta secção baseiam-se nas distribuições Linux Ubuntu/Debian. (Raspberry Pi OS é baseado em Debian.) Se estiver a utilizar uma distribuição Linux diferente, terá de modificar os passos em conformidade.

  • OpenJDK (Open Java Development Kit) 8 ou mais tarde. Pode utilizar o java -version comando para verificar a versão de Java instalada no seu sistema. Certifique-se de que o JDK está instalado, e não apenas o tempo de execução java (JRE).

    1. Para instalar o OpenJDK para o seu sistema, insira os seguintes comandos:

      Para instalar a versão padrão do OpenJDK para o seu sistema (OpenJDK 11 para Ubuntu 20.04 e Raspberry Pi OS 10 no momento da escrita):

      sudo apt update
      sudo apt install default-jdk
      

      Em alternativa, pode especificar uma versão do JDK para instalar. Por exemplo:

      sudo apt update
      sudo apt install openjdk-8-jdk
      
    2. Se o seu sistema tiver várias versões de Java instaladas, pode utilizar os seguintes comandos para configurar as versões padrão (auto) de Java e do compilador Java.

      update-java-alternatives --list          #list the Java versions installed
      sudo update-alternatives --config java   #set the default Java version
      sudo  update-alternatives --config javac #set the default Java compiler version
      
    3. Desaprova a JAVA_HOME variável ambiente no caminho da sua instalação JDK. (Trata-se geralmente de um subdiretório versado no diretório /usr/lib/jvm .)

      export JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::")
      

      Importante

      Este comando define a JAVA_HOME variável no seu ambiente atual de concha. Recomendamos adicionar o comando ao seu ~/.bashrc ou /etc/profile ficheiro para o disponibilizar sempre que abrir uma nova concha.

    4. Verifique a versão do Java JDK (e JRE) instalada, que a versão do compilador Java corresponde à versão JDK e que a variável ambiente JAVA_HOME está devidamente definida.

      java -version
      javac -version
      echo $JAVA_HOME
      
  • Apache Maven 3. Pode utilizar o mvn --version comando para verificar a versão do Maven instalada no seu sistema.

    1. Para instalar o Maven, insira os seguintes comandos:

      sudo apt-get update
      sudo apt-get install maven
      
    2. Introduza o seguinte comando para verificar a sua instalação.

      mvn --version
      

Criar um hub IoT

Nesta secção, você usa Azure CLI para criar um hub IoT e um grupo de recursos. Um grupo de recursos do Azure é um contentor lógico no qual os recursos do Azure são implementados e geridos. Um hub IoT funciona como um centro de mensagens central para comunicação bidis entre a sua aplicação IoT e dispositivos.

Para criar um hub IoT e um grupo de recursos:

  1. Lançamento Azure CLI:

    • Se estiver a utilizar Cloud Shell, selecione o botão Try It nos comandos CLI para lançar Cloud Shell numa janela do navegador dividida. Ou pode abrir o Cloud Shell num separador de navegador.
    • Se estiver a utilizar o Azure CLI localmente, abra uma consola como Windows CMD, PowerShell ou Bash e inscreva-se no Azure CLI.

    Para executar os comandos CLI no resto deste arranque rápido: copiar a sintaxe de comando, colá-la na sua janela Cloud Shell ou consola CLI, editar valores variáveis e pressionar Enter.

  2. Executar extensão az adicionar para instalar ou atualizar a extensão azure-iot para a versão atual.

    az extension add --upgrade --name azure-iot
    
  3. Executar o grupo az criar comando para criar um grupo de recursos. O seguinte comando cria um grupo de recursos chamado MyResourceGroup na localização leste .

    Nota

    Pode configurar opcionalmente uma localização alternativa. Para ver os locais disponíveis, corra az account list-locations. Este tutorial usa eastus como mostrado no comando exemplo.

    az group create --name MyResourceGroup --location eastus
    
  4. Executar o hub az iot criar comando para criar um hub IoT. Pode levar alguns minutos para criar um hub IoT.

    Seu Nome De TeiotHub. Substitua este espaço reservado e os aparelhos circundantes no seguinte comando, utilizando o nome que escolheu para o seu hub IoT. Um nome de hub IoT deve ser globalmente único em Azure. Use o seu nome de hub IoT no resto deste quickstart onde quer que veja o espaço reservado.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
    

    Dica

    Depois de criar um hub IoT, você usará o Azure IoT Explorer para interagir com o seu hub IoT no resto deste arranque rápido. O IoT Explorer é uma aplicação GUI que permite ligar-se a um Hub IoT existente e adicionar, gerir e monitorizar dispositivos. Para saber mais, consulte instalar e utilizar o explorador Azure IoT. Opcionalmente, pode continuar a utilizar comandos CLI.

Configure IoT Explorer

No resto deste arranque rápido, você usará o IoT Explorer para registar um dispositivo no seu hub IoT e para visualizar a telemetria do dispositivo. Nesta secção, configura o IoT Explorer para ligar ao hub IoT que acabou de criar e ler modelos plug e play a partir do repositório de modelos públicos.

Nota

Também pode utilizar o CLI Azure para registar um dispositivo. Utilize o comando az iot hub-iot dispositivo-identidade criar --device id mydevice --hub-name {YourIoTHubName} para registar um novo dispositivo e o az iot hub dispositivo-identidade-série de ligação-corda - -device id mydevice --hub-name {YourIoTHubName} para obter o comando de ligação primária para o dispositivo. Uma vez anotada a cadeia de ligação do dispositivo, pode passar à frente para executar a amostra do dispositivo.

Para adicionar uma ligação ao seu hub IoT:

  1. Executar o comando de programa de ligação az iot hub para obter a cadeia de ligação para o seu hub IoT.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Copie a cadeia de ligação sem os caracteres de citação circundante.

  3. No Azure IoT Explorer, selecione os hubs IoT no menu esquerdo e, em seguida, selecione + Adicione a ligação.

  4. Cole o fio de ligação na caixa de cordas Connection .

  5. Selecione Guardar.

    Screenshot of adding a connection in IoT Explorer

  6. Se a ligação for bem sucedida, o IoT Explorer muda para a vista dispositivos .

Para adicionar o repositório de modelo público:

  1. No IoT Explorer, selecione Home para voltar à vista de casa.

  2. No menu esquerdo, selecione IoT Plug and Play Definições, em seguida, selecione +Adicionar e selecione repositório público a partir do menu suspenso.

  3. Aparece uma entrada para o repositório de modelos públicos em https://devicemodels.azure.com.

    Screenshot of adding the public model repository in IoT Explorer

  4. Selecione Guardar.

Registar um dispositivo

Nesta secção, cria-se uma nova instância do dispositivo e regista-a com o hub IoT que criou. Utilizará as informações de ligação para o dispositivo recentemente registado para ligar o seu dispositivo de forma segura numa secção posterior.

Para registar um dispositivo:

  1. A partir da vista para casa no IoT Explorer, selecione hubs IoT.

  2. A ligação que adicionou anteriormente deve aparecer. Selecione Ver os dispositivos neste centro abaixo das propriedades de ligação.

  3. Selecione + Novo e introduza um ID do dispositivo para o seu dispositivo; por exemplo, mydevice. Deixe todas as outras propriedades iguais.

  4. Selecione Criar.

    Screenshot of Azure IoT Explorer device identity

  5. Utilize os botões de cópia para copiar e anotar o campo de cordas de ligação primária . Vai precisar desta ligação mais tarde.

Executar a amostra do dispositivo

Nesta secção, utilize o Java SDK para enviar mensagens de um dispositivo para o seu hub IoT. Vais executar uma amostra que implementa um controlador de temperatura com dois sensores termostatos.

  1. Abra uma consola para instalar o dispositivo Azure IoT Java SDK, construa e execute a amostra de código. Utilizará esta consola nos seguintes passos.

    Nota

    Se estiver a utilizar uma instalação local do Azure CLI, pode agora ter duas janelas de consola abertas. Certifique-se de introduzir os comandos nesta secção na consola que acabou de abrir, não a que tem usado para o CLI.

    Linux e Raspberry Pi OS

    Confirme que a variável ambiente JAVA_HOME (echo $JAVA_HOME) está definida. Para obter informações sobre a definição JAVA_HOME, consulte os pré-requisitos Linux/Raspberry Pi.

  2. Clone o dispositivo Azure IoT Java SDK para a sua máquina local:

    git clone https://github.com/Azure/azure-iot-sdk-java.git
    
  3. Navegue na pasta raiz do SDK e execute o seguinte comando para construir o SDK e atualizar as amostras.

    cd azure-iot-sdk-java
    mvn install -T 2C -DskipTests
    

    Esta operação leva vários minutos.

  4. Desaprote as seguintes variáveis ambientais, para permitir que o seu dispositivo se conecte ao Azure IoT.

    • Desaprova uma variável ambiental chamada IOTHUB_DEVICE_CONNECTION_STRING. Para o valor variável, utilize a cadeia de ligação do dispositivo que guardou na secção anterior.
    • Desaprova uma variável ambiental chamada IOTHUB_DEVICE_SECURITY_TYPE. Para a variável, use o valor connectionStringliteral da corda.

    CMD

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
    set IOTHUB_DEVICE_SECURITY_TYPE=connectionString
    

    Nota

    Para Windows CMD não existem marcas de aspas em torno dos valores de cadeia para cada variável.

    Bash

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  5. Navegue para o diretório de amostras.

    CMD

    cd device\iot-device-samples\pnp-device-sample\temperature-controller-device-sample
    

    Bash

    cd device/iot-device-samples/pnp-device-sample/temperature-controller-device-sample
    
  6. Executar a amostra de código.

    mvn exec:java -Dexec.mainClass="samples.com.microsoft.azure.sdk.iot.device.TemperatureController"
    

    Nota

    Esta amostra de código utiliza Plug and Play Azure IoT, que permite integrar dispositivos inteligentes nas suas soluções sem qualquer configuração manual. Por padrão, a maioria das amostras desta documentação utilizam IoT Plug and Play. Para saber mais sobre as vantagens do IoT PnP, e os casos para usá-lo ou não, veja o que é IoT Plug and Play?.

A amostra conecta-se seguramente ao seu hub IoT como o dispositivo que registou e começa a enviar mensagens de telemetria. A saída da amostra aparece na sua consola.

Ver telemetria

Pode ver a telemetria do dispositivo com o IoT Explorer. Opcionalmente, pode ver a telemetria utilizando o Azure CLI.

Para ver telemetria no Azure IoT Explorer:

  1. A partir do seu hub Iot no IoT Explorer, selecione Ver dispositivos neste hub e, em seguida, selecione o seu dispositivo da lista.

  2. No menu esquerdo para o seu dispositivo, selecione Telemetria.

  3. Confirme que o hub de evento incorporado está definido para Sim e, em seguida, selecione Start.

  4. Veja a telemetria à medida que o dispositivo envia mensagens para a nuvem.

    Screenshot of device telemetry in IoT Explorer

  5. Selecione Parar para terminar a receber eventos.

Para ler telemetria enviada por componentes individuais do dispositivo, pode utilizar as funcionalidades de ficha e reprodução no IoT Explorer. Por exemplo, o controlador de temperatura neste arranque rápido tem dois termostatos: termostato1 e termostato2. Para ver a temperatura reportada pelo termóstato1:

  1. No seu dispositivo no IoT Explorer, selecione componentes de Plug and Play IoT do menu esquerdo. Em seguida, selecione o termóstato1 da lista de componentes.

  2. No painel de componentes do termóstato1 , selecione Telemetria no menu superior.

  3. No painel de telemetria , siga os mesmos passos que fez anteriormente. Certifique-se de que o hub de eventos incorporado está definido para Sim e, em seguida, selecione Start.

Para ver telemetria do dispositivo com Azure CLI:

  1. Executar o comando de monitor-eventos do hub az iot para monitorizar os eventos enviados do dispositivo para o seu hub IoT. Utilize os nomes que criou anteriormente em Azure IoT para o seu dispositivo e hub IoT.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Ver os detalhes de ligação e a saída de telemetria na consola.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
    event:
      component: thermostat1
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 24.1
    
    event:
      component: thermostat2
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 33.3
    

Browse code

Neste arranque rápido, você aprende um fluxo básico de desenvolvimento de aplicações Azure IoT. Você usa o Azure CLI e IoT Explorer para criar um hub Azure IoT e um dispositivo. Em seguida, utilize uma amostra SDK do dispositivo Azure IoT para executar um controlador de temperatura, conectá-la de forma segura ao centro e enviar telemetria. A aplicação da amostra do controlador de temperatura funciona na sua máquina local e gera dados simulados do sensor para enviar para Hub IoT.

Pré-requisitos

Este quickstart corre em Windows, Linux, e Raspberry Pi. Foi testado nas seguintes versões de sistema operativo e sistema:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) versão 10, correndo em um Raspberry Pi 3 Model B+

Instale os seguintes pré-requisitos na sua máquina de desenvolvimento, exceto quando se nota para Raspberry Pi:

  • Se não tiver uma subscrição do Azure, crie uma gratuitamente antes de começar.
  • O Git.
  • Node.js versão 12 ou mais tarde. Para verificar a execução node --versionda versão do nó .
  • Azure IoT Explorer: Cross-platform, utilitário baseado em GUI para monitorizar e gerir a Azure IoT. Se estiver a utilizar raspberry Pi como plataforma de desenvolvimento, recomendamos que instale o IoT Explorer noutro computador. Se não quiser instalar o IoT Explorer, pode utilizar o Azure CLI para executar os mesmos passos.
  • CLI do Azure. Tem duas opções para executar comandos Azure CLI neste arranque rápido:
    • Utilize o Azure Cloud Shell, uma concha interativa que executa comandos CLI no seu navegador. Esta opção é recomendada porque não precisa de instalar nada. Se estiver a usar Cloud Shell pela primeira vez, inicie sessão no portal do Azure. Siga os passos em Cloud Shell arranque rápido para iniciar Cloud Shell e selecione o ambiente Bash.
    • Opcionalmente, coloque o Azure CLI na sua máquina local. Se o Azure CLI já estiver instalado, corra az upgrade para atualizar o CLI e as extensões para a versão atual. Para instalar o Azure CLI, consulte a Instalação Azure CLI. Se estiver a utilizar raspberry Pi como plataforma de desenvolvimento, recomendamos que utilize o Azure Cloud Shell ou instale o Azure CLI noutro computador.

Criar um hub IoT

Nesta secção, você usa Azure CLI para criar um hub IoT e um grupo de recursos. Um grupo de recursos do Azure é um contentor lógico no qual os recursos do Azure são implementados e geridos. Um hub IoT funciona como um centro de mensagens central para comunicação bidis entre a sua aplicação IoT e dispositivos.

Para criar um hub IoT e um grupo de recursos:

  1. Lançamento Azure CLI:

    • Se estiver a utilizar Cloud Shell, selecione o botão Try It nos comandos CLI para lançar Cloud Shell numa janela do navegador dividida. Ou pode abrir o Cloud Shell num separador de navegador.
    • Se estiver a utilizar o Azure CLI localmente, abra uma consola como Windows CMD, PowerShell ou Bash e inscreva-se no Azure CLI.

    Para executar os comandos CLI no resto deste arranque rápido: copiar a sintaxe de comando, colá-la na sua janela Cloud Shell ou consola CLI, editar valores variáveis e pressionar Enter.

  2. Executar extensão az adicionar para instalar ou atualizar a extensão azure-iot para a versão atual.

    az extension add --upgrade --name azure-iot
    
  3. Executar o grupo az criar comando para criar um grupo de recursos. O seguinte comando cria um grupo de recursos chamado MyResourceGroup na localização leste .

    Nota

    Pode configurar opcionalmente uma localização alternativa. Para ver os locais disponíveis, corra az account list-locations. Este tutorial usa eastus como mostrado no comando exemplo.

    az group create --name MyResourceGroup --location eastus
    
  4. Executar o hub az iot criar comando para criar um hub IoT. Pode levar alguns minutos para criar um hub IoT.

    Seu Nome De TeiotHub. Substitua este espaço reservado e os aparelhos circundantes no seguinte comando, utilizando o nome que escolheu para o seu hub IoT. Um nome de hub IoT deve ser globalmente único em Azure. Use o seu nome de hub IoT no resto deste quickstart onde quer que veja o espaço reservado.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
    

    Dica

    Depois de criar um hub IoT, você usará o Azure IoT Explorer para interagir com o seu hub IoT no resto deste arranque rápido. O IoT Explorer é uma aplicação GUI que permite ligar-se a um Hub IoT existente e adicionar, gerir e monitorizar dispositivos. Para saber mais, consulte instalar e utilizar o explorador Azure IoT. Opcionalmente, pode continuar a utilizar comandos CLI.

Configure IoT Explorer

No resto deste arranque rápido, você usará o IoT Explorer para registar um dispositivo no seu hub IoT e para visualizar a telemetria do dispositivo. Nesta secção, configura o IoT Explorer para ligar ao hub IoT que acabou de criar e ler modelos plug e play a partir do repositório de modelos públicos.

Nota

Também pode utilizar o CLI Azure para registar um dispositivo. Utilize o comando az iot hub-iot dispositivo-identidade criar --device id mydevice --hub-name {YourIoTHubName} para registar um novo dispositivo e o az iot hub dispositivo-identidade-série de ligação-corda - -device id mydevice --hub-name {YourIoTHubName} para obter o comando de ligação primária para o dispositivo. Uma vez anotada a cadeia de ligação do dispositivo, pode passar à frente para executar a amostra do dispositivo.

Para adicionar uma ligação ao seu hub IoT:

  1. Executar o comando de programa de ligação az iot hub para obter a cadeia de ligação para o seu hub IoT.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Copie a cadeia de ligação sem os caracteres de citação circundante.

  3. No Azure IoT Explorer, selecione os hubs IoT no menu esquerdo e, em seguida, selecione + Adicione a ligação.

  4. Cole o fio de ligação na caixa de cordas Connection .

  5. Selecione Guardar.

    Screenshot of adding a connection in IoT Explorer

  6. Se a ligação for bem sucedida, o IoT Explorer muda para a vista dispositivos .

Para adicionar o repositório de modelo público:

  1. No IoT Explorer, selecione Home para voltar à vista de casa.

  2. No menu esquerdo, selecione IoT Plug and Play Definições, em seguida, selecione +Adicionar e selecione repositório público a partir do menu suspenso.

  3. Aparece uma entrada para o repositório de modelos públicos em https://devicemodels.azure.com.

    Screenshot of adding the public model repository in IoT Explorer

  4. Selecione Guardar.

Registar um dispositivo

Nesta secção, cria-se uma nova instância do dispositivo e regista-a com o hub IoT que criou. Utilizará as informações de ligação para o dispositivo recentemente registado para ligar o seu dispositivo de forma segura numa secção posterior.

Para registar um dispositivo:

  1. A partir da vista para casa no IoT Explorer, selecione hubs IoT.

  2. A ligação que adicionou anteriormente deve aparecer. Selecione Ver os dispositivos neste centro abaixo das propriedades de ligação.

  3. Selecione + Novo e introduza um ID do dispositivo para o seu dispositivo; por exemplo, mydevice. Deixe todas as outras propriedades iguais.

  4. Selecione Criar.

    Screenshot of Azure IoT Explorer device identity

  5. Utilize os botões de cópia para copiar e anotar o campo de cordas de ligação primária . Vai precisar desta ligação mais tarde.

Executar a amostra do dispositivo

Nesta secção, utilizará o Node.js SDK para enviar mensagens de um dispositivo para o seu hub IoT. Vais executar uma amostra que implementa um controlador de temperatura com dois sensores termostatos.

  1. Abra uma nova consola como Windows CMD, PowerShell ou Bash. Nos passos seguintes, utilizará esta consola para instalar o SDK Node.js e trabalhar com Node.js código de amostra.

    Nota

    Se estiver a utilizar uma instalação local do Azure CLI, pode agora ter duas janelas de consola abertas. Certifique-se de introduzir os comandos nesta secção na consola que acabou de abrir, não a que tem usado para o CLI.

  2. Clone as amostras de dispositivoS Azure IoT Node.js SDK para a sua máquina local:

    git clone https://github.com/Azure/azure-iot-sdk-node
    
  3. Navegue para o diretório de amostras:

    Windows

    cd azure-iot-sdk-node\device\samples\javascript
    

    Linux ou Raspberry Pi OS

    cd azure-iot-sdk-node/device/samples/javascript
    
  4. Instale o Azure IoT Node.js SDK e as dependências necessárias:

    npm install
    

    Este comando instala as dependências adequadas, conforme especificado no ficheiro package.json no diretório de amostras do dispositivo.

  5. Desaprote ambas as seguintes variáveis ambientais, para permitir que o seu dispositivo se conecte ao Azure IoT.

    • Desaprova uma variável ambiental chamada IOTHUB_DEVICE_CONNECTION_STRING. Para o valor variável, utilize a cadeia de ligação do dispositivo que guardou na secção anterior.
    • Desaprova uma variável ambiental chamada IOTHUB_DEVICE_SECURITY_TYPE. Para a variável, use o valor connectionStringliteral da corda.

    CMD (Windows)

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
    set IOTHUB_DEVICE_SECURITY_TYPE=connectionString
    

    Nota

    Para Windows CMD não existem marcas de aspas em torno dos valores de cadeia para cada variável.

    PowerShell

    $env:IOTHUB_DEVICE_CONNECTION_STRING='<your connection string here>'
    $env:IOTHUB_DEVICE_SECURITY_TYPE='connectionString'
    

    Bash

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  6. Executar a seguinte amostra de código:

    node pnp_temperature_controller.js
    

    Nota

    Esta amostra de código utiliza Plug and Play Azure IoT, que permite integrar dispositivos inteligentes nas suas soluções sem qualquer configuração manual. Por padrão, a maioria das amostras desta documentação utilizam IoT Plug and Play. Para saber mais sobre as vantagens do IoT PnP, e os casos para usá-lo ou não, veja o que é IoT Plug and Play?.

A amostra conecta-se seguramente ao seu hub IoT como o dispositivo que registou e começa a enviar mensagens de telemetria. A saída da amostra aparece na sua consola.

Ver telemetria

Pode ver a telemetria do dispositivo com o IoT Explorer. Opcionalmente, pode ver a telemetria utilizando o Azure CLI.

Para ver telemetria no Azure IoT Explorer:

  1. A partir do seu hub Iot no IoT Explorer, selecione Ver dispositivos neste hub e, em seguida, selecione o seu dispositivo da lista.

  2. No menu esquerdo para o seu dispositivo, selecione Telemetria.

  3. Confirme que o hub de evento incorporado está definido para Sim e, em seguida, selecione Start.

  4. Veja a telemetria à medida que o dispositivo envia mensagens para a nuvem.

    Screenshot of device telemetry in IoT Explorer

  5. Selecione Parar para terminar a receber eventos.

Para ler telemetria enviada por componentes individuais do dispositivo, pode utilizar as funcionalidades de ficha e reprodução no IoT Explorer. Por exemplo, o controlador de temperatura neste arranque rápido tem dois termostatos: termostato1 e termostato2. Para ver a temperatura reportada pelo termóstato1:

  1. No seu dispositivo no IoT Explorer, selecione componentes de Plug and Play IoT do menu esquerdo. Em seguida, selecione o termóstato1 da lista de componentes.

  2. No painel de componentes do termóstato1 , selecione Telemetria no menu superior.

  3. No painel de telemetria , siga os mesmos passos que fez anteriormente. Certifique-se de que o hub de eventos incorporado está definido para Sim e, em seguida, selecione Start.

Para ver telemetria do dispositivo com Azure CLI:

  1. Executar o comando de monitor-eventos do hub az iot para monitorizar os eventos enviados do dispositivo para o seu hub IoT. Utilize os nomes que criou anteriormente em Azure IoT para o seu dispositivo e hub IoT.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Ver os detalhes de ligação e a saída de telemetria na consola.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
    event:
      component: thermostat1
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 70.5897683228018
    
    event:
      component: thermostat2
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 52.87582619316418
    

Browse code

Neste arranque rápido, você aprende um fluxo básico de desenvolvimento de aplicações Azure IoT. Você usa o Azure CLI e IoT Explorer para criar um hub Azure IoT e um dispositivo. Em seguida, utilize uma amostra SDK do dispositivo Azure IoT para executar um controlador de temperatura, conectá-la de forma segura ao centro e enviar telemetria. A aplicação da amostra do controlador de temperatura funciona na sua máquina local e gera dados simulados do sensor para enviar para Hub IoT.

Pré-requisitos

Este quickstart corre em Windows, Linux, e Raspberry Pi. Foi testado nas seguintes versões de sistema operativo e sistema:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) versão 10, correndo em um Raspberry Pi 3 Model B+

Instale os seguintes pré-requisitos na sua máquina de desenvolvimento, exceto quando se nota para Raspberry Pi:

  • Se não tiver uma subscrição do Azure, crie uma gratuitamente antes de começar.
  • O Git.
  • Versão python 3.7 ou mais tarde. Para verificar a sua versão Python, corra python3 --version.
  • Azure IoT Explorer: Cross-platform, utilitário baseado em GUI para monitorizar e gerir a Azure IoT. Se estiver a utilizar raspberry Pi como plataforma de desenvolvimento, recomendamos que instale o IoT Explorer noutro computador. Se não quiser instalar o IoT Explorer, pode utilizar o Azure CLI para executar os mesmos passos.
  • CLI do Azure. Tem duas opções para executar comandos Azure CLI neste arranque rápido:
    • Utilize o Azure Cloud Shell, uma concha interativa que executa comandos CLI no seu navegador. Esta opção é recomendada porque não precisa de instalar nada. Se estiver a usar Cloud Shell pela primeira vez, inicie sessão no portal do Azure. Siga os passos em Cloud Shell arranque rápido para iniciar Cloud Shell e selecione o ambiente Bash.
    • Opcionalmente, coloque o Azure CLI na sua máquina local. Se o Azure CLI já estiver instalado, corra az upgrade para atualizar o CLI e as extensões para a versão atual. Para instalar o Azure CLI, consulte a Instalação Azure CLI. Se estiver a utilizar raspberry Pi como plataforma de desenvolvimento, recomendamos que utilize o Azure Cloud Shell ou instale o Azure CLI noutro computador.

Criar um hub IoT

Nesta secção, você usa Azure CLI para criar um hub IoT e um grupo de recursos. Um grupo de recursos do Azure é um contentor lógico no qual os recursos do Azure são implementados e geridos. Um hub IoT funciona como um centro de mensagens central para comunicação bidis entre a sua aplicação IoT e dispositivos.

Para criar um hub IoT e um grupo de recursos:

  1. Lançamento Azure CLI:

    • Se estiver a utilizar Cloud Shell, selecione o botão Try It nos comandos CLI para lançar Cloud Shell numa janela do navegador dividida. Ou pode abrir o Cloud Shell num separador de navegador.
    • Se estiver a utilizar o Azure CLI localmente, abra uma consola como Windows CMD, PowerShell ou Bash e inscreva-se no Azure CLI.

    Para executar os comandos CLI no resto deste arranque rápido: copiar a sintaxe de comando, colá-la na sua janela Cloud Shell ou consola CLI, editar valores variáveis e pressionar Enter.

  2. Executar extensão az adicionar para instalar ou atualizar a extensão azure-iot para a versão atual.

    az extension add --upgrade --name azure-iot
    
  3. Executar o grupo az criar comando para criar um grupo de recursos. O seguinte comando cria um grupo de recursos chamado MyResourceGroup na localização leste .

    Nota

    Pode configurar opcionalmente uma localização alternativa. Para ver os locais disponíveis, corra az account list-locations. Este tutorial usa eastus como mostrado no comando exemplo.

    az group create --name MyResourceGroup --location eastus
    
  4. Executar o hub az iot criar comando para criar um hub IoT. Pode levar alguns minutos para criar um hub IoT.

    Seu Nome De TeiotHub. Substitua este espaço reservado e os aparelhos circundantes no seguinte comando, utilizando o nome que escolheu para o seu hub IoT. Um nome de hub IoT deve ser globalmente único em Azure. Use o seu nome de hub IoT no resto deste quickstart onde quer que veja o espaço reservado.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
    

    Dica

    Depois de criar um hub IoT, você usará o Azure IoT Explorer para interagir com o seu hub IoT no resto deste arranque rápido. O IoT Explorer é uma aplicação GUI que permite ligar-se a um Hub IoT existente e adicionar, gerir e monitorizar dispositivos. Para saber mais, consulte instalar e utilizar o explorador Azure IoT. Opcionalmente, pode continuar a utilizar comandos CLI.

Configure IoT Explorer

No resto deste arranque rápido, você usará o IoT Explorer para registar um dispositivo no seu hub IoT e para visualizar a telemetria do dispositivo. Nesta secção, configura o IoT Explorer para ligar ao hub IoT que acabou de criar e ler modelos plug e play a partir do repositório de modelos públicos.

Nota

Também pode utilizar o CLI Azure para registar um dispositivo. Utilize o comando az iot hub-iot dispositivo-identidade criar --device id mydevice --hub-name {YourIoTHubName} para registar um novo dispositivo e o az iot hub dispositivo-identidade-série de ligação-corda - -device id mydevice --hub-name {YourIoTHubName} para obter o comando de ligação primária para o dispositivo. Uma vez anotada a cadeia de ligação do dispositivo, pode passar à frente para executar a amostra do dispositivo.

Para adicionar uma ligação ao seu hub IoT:

  1. Executar o comando de programa de ligação az iot hub para obter a cadeia de ligação para o seu hub IoT.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Copie a cadeia de ligação sem os caracteres de citação circundante.

  3. No Azure IoT Explorer, selecione os hubs IoT no menu esquerdo e, em seguida, selecione + Adicione a ligação.

  4. Cole o fio de ligação na caixa de cordas Connection .

  5. Selecione Guardar.

    Screenshot of adding a connection in IoT Explorer

  6. Se a ligação for bem sucedida, o IoT Explorer muda para a vista dispositivos .

Para adicionar o repositório de modelo público:

  1. No IoT Explorer, selecione Home para voltar à vista de casa.

  2. No menu esquerdo, selecione IoT Plug and Play Definições, em seguida, selecione +Adicionar e selecione repositório público a partir do menu suspenso.

  3. Aparece uma entrada para o repositório de modelos públicos em https://devicemodels.azure.com.

    Screenshot of adding the public model repository in IoT Explorer

  4. Selecione Guardar.

Registar um dispositivo

Nesta secção, cria-se uma nova instância do dispositivo e regista-a com o hub IoT que criou. Utilizará as informações de ligação para o dispositivo recentemente registado para ligar o seu dispositivo de forma segura numa secção posterior.

Para registar um dispositivo:

  1. A partir da vista para casa no IoT Explorer, selecione hubs IoT.

  2. A ligação que adicionou anteriormente deve aparecer. Selecione Ver os dispositivos neste centro abaixo das propriedades de ligação.

  3. Selecione + Novo e introduza um ID do dispositivo para o seu dispositivo; por exemplo, mydevice. Deixe todas as outras propriedades iguais.

  4. Selecione Criar.

    Screenshot of Azure IoT Explorer device identity

  5. Utilize os botões de cópia para copiar e anotar o campo de cordas de ligação primária . Vai precisar desta ligação mais tarde.

Executar a amostra do dispositivo

Nesta secção, utiliza o Python SDK para enviar mensagens de um dispositivo para o seu hub IoT. Vais executar uma amostra que implementa um controlador de temperatura com dois sensores termostatos.

  1. Abra uma nova consola como Windows CMD, PowerShell ou Bash. Nos passos seguintes, utilizará esta consola para instalar o Python SDK e trabalhar com o código de amostra Python.

    Nota

    Se estiver a utilizar uma instalação local do Azure CLI, pode agora ter duas janelas de consola abertas. Certifique-se de introduzir os comandos nesta secção na consola que acabou de abrir, não a que tem usado para o CLI.

  2. Clone as amostras do dispositivo Azure IoT Python SDK para a sua máquina local:

    git clone https://github.com/Azure/azure-iot-sdk-python
    
  3. Navegue para o diretório de amostras:

    Windows

    cd azure-iot-sdk-python\azure-iot-device\samples\pnp
    

    Linux ou Raspberry Pi OS

    cd azure-iot-sdk-python/azure-iot-device/samples/pnp
    
  4. Instale o Azure IoT Python SDK:

    pip3 install azure-iot-device
    
  5. Desaprote as seguintes variáveis ambientais, para permitir que o seu dispositivo se conecte ao Azure IoT.

    • Desaprova uma variável ambiental chamada IOTHUB_DEVICE_CONNECTION_STRING. Para o valor variável, utilize a cadeia de ligação do dispositivo que guardou na secção anterior.
    • Desaprova uma variável ambiental chamada IOTHUB_DEVICE_SECURITY_TYPE. Para a variável, use o valor connectionStringliteral da corda.

    CMD (Windows)

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
    set IOTHUB_DEVICE_SECURITY_TYPE=connectionString
    

    Nota

    Para Windows CMD não existem marcas de aspas em torno dos valores de cadeia para cada variável.

    PowerShell

    $env:IOTHUB_DEVICE_CONNECTION_STRING='<your connection string here>'
    $env:IOTHUB_DEVICE_SECURITY_TYPE='connectionString'
    

    Bash

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  6. Executar o código para o seguinte ficheiro de amostra.

    python3 temp_controller_with_thermostats.py
    

    Nota

    Esta amostra de código utiliza Plug and Play Azure IoT, que permite integrar dispositivos inteligentes nas suas soluções sem qualquer configuração manual. Por padrão, a maioria das amostras desta documentação utilizam IoT Plug and Play. Para saber mais sobre as vantagens da IoT Plug and Play, e casos para usá-lo ou não, veja O que é IoT Plug and Play?.

A amostra conecta-se seguramente ao seu hub IoT como o dispositivo que registou e começa a enviar mensagens de telemetria. A saída da amostra aparece na sua consola.

Ver telemetria

Pode ver a telemetria do dispositivo com o IoT Explorer. Opcionalmente, pode ver a telemetria utilizando o Azure CLI.

Para ver telemetria no Azure IoT Explorer:

  1. A partir do seu hub Iot no IoT Explorer, selecione Ver dispositivos neste hub e, em seguida, selecione o seu dispositivo da lista.

  2. No menu esquerdo para o seu dispositivo, selecione Telemetria.

  3. Confirme que o hub de evento incorporado está definido para Sim e, em seguida, selecione Start.

  4. Veja a telemetria à medida que o dispositivo envia mensagens para a nuvem.

    Screenshot of device telemetry in IoT Explorer

  5. Selecione Parar para terminar a receber eventos.

Para ler telemetria enviada por componentes individuais do dispositivo, pode utilizar as funcionalidades de ficha e reprodução no IoT Explorer. Por exemplo, o controlador de temperatura neste arranque rápido tem dois termostatos: termostato1 e termostato2. Para ver a temperatura reportada pelo termóstato1:

  1. No seu dispositivo no IoT Explorer, selecione componentes de Plug and Play IoT do menu esquerdo. Em seguida, selecione o termóstato1 da lista de componentes.

  2. No painel de componentes do termóstato1 , selecione Telemetria no menu superior.

  3. No painel de telemetria , siga os mesmos passos que fez anteriormente. Certifique-se de que o hub de eventos incorporado está definido para Sim e, em seguida, selecione Start.

Para ver telemetria do dispositivo com Azure CLI:

  1. Executar o comando de monitor-eventos do hub az iot para monitorizar os eventos enviados do dispositivo para o seu hub IoT. Utilize os nomes que criou anteriormente em Azure IoT para o seu dispositivo e hub IoT.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Ver os detalhes de ligação e a saída de telemetria na consola.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
    event:
      component: thermostat1
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 29
    
    event:
      component: thermostat2
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 48
    

Limpar os recursos

Se já não precisar dos recursos Azure criados neste arranque rápido, pode utilizar o CLI Azure para os eliminar.

Importante

A eliminação de um grupo de recursos é irreversível. O grupo de recursos e todos os recursos nele contidos são eliminados permanentemente. Confirme que não elimina acidentalmente o grupo de recursos ou recursos errados.

Para eliminar um grupo de recursos por nome:

  1. Executar o comando de eliminação do grupo AZ . Este comando remove o grupo de recursos, o Hub IoT e o registo do dispositivo que criou.

    az group delete --name MyResourceGroup
    
  2. Executar o comando da lista de grupos az para confirmar que o grupo de recursos é eliminado.

    az group list
    

Passos seguintes

Neste arranque rápido, aprendeu um fluxo básico de trabalho da aplicação Azure IoT para ligar um dispositivo de forma segura à nuvem e enviar telemetria de dispositivo para nuvem. Usou o Azure CLI para criar um hub Azure IoT e uma instância de dispositivo. Em seguida, usou um dispositivo Azure IoT SDK para criar um controlador de temperatura, conectá-lo ao hub e enviar telemetria. Também usou o Azure CLI para monitorizar a telemetria.

Como próximo passo, explore os seguintes artigos para saber mais sobre soluções de dispositivos de construção com Azure IoT.