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

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

Procurar código

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 funciona 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:

Instalar GCC, Git, cmake e as dependências necessárias usando 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 do GCC é superior a 4.4.7.

cmake --version
gcc --version

Windows

Para completar este arranque rápido no Windows, instale o Visual Studio 2019 e adicione os componentes necessários para o desenvolvimento de C e C++.

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

    Nota

    Para os utilizadores do Visual Studio 2019 existentes, selecione Windows Start, digite Visual Studio Installer e inicie 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 o 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 de adicionar uma ligação no 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 de adicionar o repositório de modelo público no 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 da identidade do dispositivo Azure IoT Explorer

  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 o 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 da telemetria do dispositivo no 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}'
    

Procurar código

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 funciona 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 o 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 de adicionar uma ligação no 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 de adicionar o repositório de modelo público no 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 da identidade do dispositivo Azure IoT Explorer

  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 o 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 o Microsoft Azure IoT SDK para C# (.NET) para a sua máquina local:

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

    Windows

    cd azure-iot-sdk-csharp\iothub\device\samples\solutions\PnpDeviceSamples\TemperatureController
    

    Linux ou Raspberry Pi OS

    cd azure-iot-sdk-csharp/iothub/device/samples/solutions/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 o 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 da telemetria do dispositivo no 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.

Procurar código

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 funciona 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 Development Kit 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 Windows PATH .

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 o 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 de adicionar uma ligação no 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 de adicionar o repositório de modelo público no 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 da identidade do dispositivo Azure IoT Explorer

  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 o 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 da telemetria do dispositivo no 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
    

Procurar código

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 funciona 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 o 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 de adicionar uma ligação no 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 de adicionar o repositório de modelo público no 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 da identidade do dispositivo Azure IoT Explorer

  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 o 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 o 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 da telemetria do dispositivo no 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
    

Procurar código

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 funciona 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 o 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 de adicionar uma ligação no 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 de adicionar o repositório de modelo público no 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 da identidade do dispositivo Azure IoT Explorer

  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 o 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 o 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 da telemetria do dispositivo no 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.