Quickstart: Telemetrie vanaf een apparaat verzenden naar Azure IoT Hub

Van toepassing op: Ontwikkelaars van apparaattoepassing

Code zoeken

In deze quickstart leert u een eenvoudige werkstroom voor het ontwikkelen van Azure IoT-toepassingen. U gebruikt de Azure CLI om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT Device SDK-voorbeeld om een gesimuleerde temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden.

Vereisten

Deze quickstart wordt uitgevoerd op Windows, Linux en Raspberry Pi. Het is getest op de volgende versies van het besturingssysteem en apparaat:

  • Windows 10
  • Ubuntu 20.04 LTS uitgevoerd op Windows-subsysteem voor Linux (WSL)
  • Raspberry Pi OS versie 10 (sturingssystemen) die wordt uitgevoerd op een Raspberry Pi 3 Model B+

Installeer de volgende vereisten op uw ontwikkelmachine, behalve voor Raspberry Pi:

  • Als u geen Azure-abonnement hebt, kunt u er gratis een maken voordat u begint.
  • Git.
  • Azure IoT Explorer:platformoverschrijdend hulpprogramma voor het bewaken en beheren van Azure IoT. Als u Raspberry Pi als ontwikkelplatform gebruikt, installeert u IoT Explorer op een andere computer. U kunt ook Azure CLI gebruiken om de stappen uit te voeren die gebruikmaken van IoT Explorer.
  • Azure CLI. U hebt twee opties voor het uitvoeren van Azure CLI-opdrachten in deze quickstart:
    • Gebruik de Azure Cloud Shell, een interactieve shell die CLI-opdrachten in uw browser wordt uitgevoerd. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u de Cloud Shell gebruikt, meld u zich aan bij de Azure Portal. Volg de stappen in Cloud Shell quickstart naar Start Cloud Shell en Selecteer de Bash-omgeving.
    • Voer azure CLI uit op uw lokale computer (optioneel). Als Azure CLI al is geïnstalleerd, moet u uitvoeren om de CLI en az upgrade extensies bij te werken naar de huidige versie. Zie Azure CLI installeren voor het installeren van Azure CLI. Als u Raspberry Pi als uw ontwikkelplatform gebruikt, installeert u Azure CLI op een andere computer of gebruikt u Azure Cloud Shell CLI-opdrachten uit te voeren.

Installeer de resterende vereisten voor uw besturingssysteem.

Linux

Installeer de volgende software om deze quickstart voor Linux en Raspberry Pi OS te voltooien:

Installeer GCC, Git, cmake en de vereiste afhankelijkheden met behulp van de apt-get opdracht :

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

Controleer of de versie van cmake hoger is dan 2.8.12 en of de versie van GCC hoger dan 4.4.7.

cmake --version
gcc --version

Windows

Voor het voltooien van deze quickstart op Windows installeert u Visual Studio 2019 en voegt u de vereiste onderdelen toe voor C- en C++-ontwikkeling.

  1. Voor nieuwe gebruikers installeert Visual Studio (Community, Professional of Enterprise) 2019. Download de editie die u wilt installeren en start het installatieprogramma.

    Notitie

    Voor bestaande Visual Studio 2019 selecteert u Windows Start, typt u Visual Studio Installer en start u het installatieprogramma.

  2. Selecteer op het tabblad Workloads van het installatieprogramma de workload Desktopontwikkeling met C++.
  3. Voer de installatie uit.

Een IoT-hub maken

In deze sectie gebruikt u Azure CLI om een IoT-hub en een resourcegroep te maken. Een Azure-resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd. Een IoT-hub fungeert als een centrale berichtenhub voor bi-directionele communicatie tussen uw IoT-toepassing en apparaten.

Een IoT-hub en een resourcegroep maken:

  1. Start uw CLI-app. Als u de CLI-opdrachten in de rest van deze quickstart wilt uitvoeren, kopieert u de opdrachtsyntaxis, plakt u deze in uw CLI-app, bewerkt u variabele waarden en drukt u op Enter.

    • Als u een Cloud Shell, selecteert u de knop Uitproberen in de CLI-opdrachten om de Cloud Shell starten in een gesplitst browservenster. U kunt de Cloud Shell ook openen in een afzonderlijk browsertabblad.
    • Als u Azure CLI lokaal gebruikt, start u de CLI-console-app en meld u zich aan bij Azure CLI.
  2. Voer az extension add uit om de azure-iot-extensie te installeren of te upgraden naar de huidige versie.

    az extension add --upgrade --name azure-iot
    
  3. Voer in uw CLI-app de opdracht az group create uit om een resourcegroep te maken. Met de volgende opdracht wordt een resourcegroep met de naam MyResourceGroup gemaakt op de locatie VS - oost.

    Notitie

    U kunt eventueel een alternatieve locatie instellen. Voer uit om de beschikbare locaties te az account list-locations bekijken. In deze zelfstudie wordt eastus gebruikt, zoals wordt weergegeven in de voorbeeldopdracht.

    az group create --name MyResourceGroup --location eastus
    
  4. Voer de opdracht az iot hub create uit om een IoT-hub te maken. Het kan enkele minuten duren voordat een IoT-hub is gemaakt.

    YourIotHubName. Vervang deze tijdelijke aanduiding en de omliggende accolades in de volgende opdracht met behulp van de naam die u hebt gekozen voor uw IoT-hub. De naam van de IoT-hub moet wereldwijd uniek zijn in Azure. Gebruik de naam van uw IoT-hub in de rest van deze quickstart, waar u de tijdelijke aanduiding ook ziet.

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

    Tip

    Nadat u een IoT-hub hebt gemaakt, gebruikt u Azure IoT Explorer om in de rest van deze quickstart te communiceren met uw IoT-hub. IoT Explorer is een GUI-toepassing waarmee u verbinding kunt maken met een bestaande IoT Hub en apparaten kunt toevoegen, beheren en bewaken. Zie Azure IoT Explorer installeren en gebruiken voor meer informatie. U kunt eventueel CLI-opdrachten blijven gebruiken.

IoT Explorer configureren

In de rest van deze quickstart gebruikt u IoT Explorer om een apparaat te registreren bij uw IoT-hub en om de telemetrie van het apparaat weer te geven. In deze sectie configureert u IoT Explorer om verbinding te maken met de IoT-hub die u zojuist hebt gemaakt en om Plug en Play-modellen te lezen uit de openbare modelopslagplaats.

Een verbinding toevoegen aan uw IoT-hub:

  1. Voer in uw CLI-app de opdracht az iot hub connection-string show uit om de connection string voor uw IoT-hub op te halen.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Kopieer de connection string zonder de omliggende aanhalingstekens.

  3. Selecteer in Azure IoT Explorer IoT-hubs in het menu links en selecteer vervolgens + Verbinding toevoegen.

  4. Plak de connection string in het vak Verbindingsreeks.

  5. Selecteer Opslaan.

    Schermopname van het toevoegen van een verbinding in IoT Explorer

  6. Als de verbinding slaagt, schakelt IoT Explorer over naar de weergave Apparaten.

De openbare modelopslagplaats toevoegen:

  1. Selecteer in IoT Explorer Start om terug te keren naar de startweergave.

  2. Selecteer in het menu links IoT Plug en Play Instellingen, selecteer + Toevoegen en selecteer Openbare opslagplaats in de vervolgkeuzelijst.

  3. Er wordt een vermelding weergegeven voor de openbare modelopslagplaats op https://devicemodels.azure.com .

    Schermopname van het toevoegen van de openbare modelopslagplaats in IoT Explorer

  4. Selecteer Opslaan.

Een apparaat registreren

In deze sectie maakt u een nieuw apparaat-exemplaar en registreert u dit bij de IoT-hub die u hebt gemaakt. U gebruikt de verbindingsgegevens voor het zojuist geregistreerde apparaat om uw gesimuleerde apparaat veilig te verbinden in een latere sectie.

Een apparaat registreren:

  1. Selecteer in de startweergave in IoT Explorer de optie IoT-hubs.

  2. De verbinding die u eerder hebt toegevoegd, moet worden weergegeven. Selecteer Apparaten weergeven in deze hub onder de verbindingseigenschappen.

  3. Selecteer + Nieuw en voer een apparaat-id in voor uw apparaat; bijvoorbeeld mydevice. Laat alle andere eigenschappen hetzelfde.

  4. Selecteer Maken.

    Schermopname van de apparaat-id van Azure IoT Explorer

  5. Gebruik de kopieerknoppen om het veld Primaire connection string kopiëren en noteren. U hebt deze connection string nodig.

Notitie

Als u liever Azure CLI gebruikt, kunt u de opdracht az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} gebruiken om een nieuw apparaat te registreren en de opdracht az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} om de primaire connection string voor het apparaat op te halen.

Een gesimuleerd apparaat uitvoeren

In deze sectie gebruikt u de C SDK om berichten van een gesimuleerd apparaat naar uw IoT-hub te verzenden. U voert een voorbeeld uit dat een temperatuurcontroller met twee thermostaatsensoren implementeert.

Het voorbeeld bouwen

  1. Open een console om de Apparaat-SDK voor Azure IoT C te installeren en voer het codevoorbeeld uit. Selecteer Windows start, typ Developer Command Prompt voor VS 2019 en open de console. Open voor Linux en Raspberry Pi OS een terminal voor Bash-opdrachten.

    Notitie

    Als u een lokale installatie van Azure CLI gebruikt, hebt u mogelijk nu twee consolevensters geopend. Voer de opdrachten in deze sectie in de console die u zojuist hebt geopend in, niet de opdracht die u voor de CLI hebt gebruikt.

  2. Kloon in de C-console de Apparaat-SDK van Azure IoT C naar uw lokale computer:

    git clone https://github.com/Azure/azure-iot-sdk-c.git
    
  3. Navigeer naar de hoofdmap van de SDK en voer de volgende opdracht uit om afhankelijkheden bij te werken:

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

    Deze bewerking duurt enkele minuten.

  4. Voer de volgende opdrachten uit om de SDK en voorbeelden te bouwen:

    cmake -Bcmake -Duse_prov_client=ON -Dhsm_type_symm_key=ON -Drun_e2e_tests=OFF
    cmake --build cmake
    
  5. Stel de volgende omgevingsvariabelen in, zodat uw gesimuleerde apparaat verbinding kan maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING . Gebruik voor de variabele waarde de apparaat-connection string u in de vorige sectie hebt opgeslagen.
    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_SECURITY_TYPE . Gebruik voor de variabele de letterlijke tekenreekswaarde connectionString .

    CMD

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

    Notitie

    Voor Windows CMD staan er geen aanhalingstekens rond de tekenreekswaarden voor elke variabele.

    Bash

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

De code uitvoeren

  1. Voer de voorbeeldcode uit met behulp van de juiste opdracht voor uw console.

    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
    

    Notitie

    In dit codevoorbeeld wordt gebruikgemaakt van Azure IoT Plug en Play, waarmee u slimme apparaten in uw oplossingen kunt integreren zonder handmatige configuratie. De meeste voorbeelden in deze documentatie gebruiken standaard IoT-Plug en Play. Zie Wat is IoTPnP? voor meer informatie over de voordelen van Io Plug en Play T PnP en cases voor het al dan niet gebruiken ervan.

Het voorbeeld maakt veilig verbinding met uw IoT-hub als het apparaat dat u hebt geregistreerd en begint met het verzenden van telemetrieberichten. De voorbeelduitvoer wordt weergegeven in de console.

Telemetrie bekijken

U kunt de telemetrie van het apparaat weergeven met IoT Explorer. U kunt eventueel telemetrie weergeven met behulp van Azure CLI.

Telemetrie weergeven in Azure IoT Explorer:

  1. Selecteer in uw IoT-hub in IoT Explorer apparaten weergeven in deze hub en selecteer vervolgens uw apparaat in de lijst.

  2. Selecteer Telemetrie in het menu links voor uw apparaat.

  3. Controleer of Ingebouwde Event Hub gebruiken is ingesteld op Ja en selecteer vervolgens Starten.

  4. Bekijk de telemetrie terwijl het apparaat berichten naar de cloud verzendt.

    Schermopname van apparaat-telemetrie in IoT Explorer

  5. Selecteer Stoppen om het ontvangen van gebeurtenissen te beëindigen.

Als u telemetrie wilt lezen die is verzonden door afzonderlijke apparaatonderdelen, kunt u de plug en play-functies in IoT Explorer gebruiken. De temperatuurcontroller in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostat1 en thermostat2. De door thermostat1 gerapporteerde temperatuur bekijken:

  1. Selecteer op uw apparaat in IoT Explorer de optie IoT Plug en Play onderdelen in het menu links. Selecteer vervolgens thermostat1 in de lijst met onderdelen.

  2. Selecteer in het deelvenster thermostat1-onderdeel Telemetrie in het bovenste menu.

  3. Volg in het deelvenster Telemetrie dezelfde stappen die u eerder hebt gedaan. Zorg ervoor dat Ingebouwde Event Hub gebruiken is ingesteld op Ja en selecteer vervolgens Starten.

Telemetrie van apparaten weergeven met Azure CLI:

  1. Voer in uw CLI-app de opdracht az iot hub monitor-events uit om gebeurtenissen te bewaken die vanaf het gesimuleerde apparaat naar uw IoT-hub worden verzonden. Gebruik de namen die u eerder hebt gemaakt in Azure IoT voor uw apparaat en IoT-hub.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Bekijk de verbindingsgegevens en telemetrie-uitvoer in de console.

    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}'
    

Code zoeken

In deze quickstart leert u een eenvoudige werkstroom voor het ontwikkelen van Azure IoT-toepassingen. U gebruikt de Azure CLI om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT Device SDK-voorbeeld om een gesimuleerde temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden.

Vereisten

Een IoT-hub maken

In deze sectie gebruikt u Azure CLI om een IoT-hub en een resourcegroep te maken. Een Azure-resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd. Een IoT-hub fungeert als een centrale berichtenhub voor bi-directionele communicatie tussen uw IoT-toepassing en apparaten.

Een IoT-hub en een resourcegroep maken:

  1. Start uw CLI-app. Als u de CLI-opdrachten in de rest van deze quickstart wilt uitvoeren, kopieert u de opdrachtsyntaxis, plakt u deze in uw CLI-app, bewerkt u variabele waarden en drukt u op Enter.

    • Als u een Cloud Shell, selecteert u de knop Uitproberen in de CLI-opdrachten om de Cloud Shell starten in een gesplitst browservenster. U kunt de Cloud Shell ook openen in een afzonderlijk browsertabblad.
    • Als u Azure CLI lokaal gebruikt, start u de CLI-console-app en meld u zich aan bij Azure CLI.
  2. Voer az extension add uit om de azure-iot-extensie te installeren of te upgraden naar de huidige versie.

    az extension add --upgrade --name azure-iot
    
  3. Voer in uw CLI-app de opdracht az group create uit om een resourcegroep te maken. Met de volgende opdracht wordt een resourcegroep met de naam MyResourceGroup gemaakt op de locatie VS - oost.

    Notitie

    U kunt eventueel een alternatieve locatie instellen. Voer uit om de beschikbare locaties te az account list-locations bekijken. In deze zelfstudie wordt eastus gebruikt, zoals wordt weergegeven in de voorbeeldopdracht.

    az group create --name MyResourceGroup --location eastus
    
  4. Voer de opdracht az iot hub create uit om een IoT-hub te maken. Het kan enkele minuten duren voordat een IoT-hub is gemaakt.

    YourIotHubName. Vervang deze tijdelijke aanduiding en de omliggende accolades in de volgende opdracht met behulp van de naam die u hebt gekozen voor uw IoT-hub. De naam van de IoT-hub moet wereldwijd uniek zijn in Azure. Gebruik de naam van uw IoT-hub in de rest van deze quickstart, waar u de tijdelijke aanduiding ook ziet.

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

    Tip

    Nadat u een IoT-hub hebt gemaakt, gebruikt u Azure IoT Explorer om in de rest van deze quickstart te communiceren met uw IoT-hub. IoT Explorer is een GUI-toepassing waarmee u verbinding kunt maken met een bestaande IoT Hub en apparaten kunt toevoegen, beheren en bewaken. Zie Azure IoT Explorer installeren en gebruiken voor meer informatie. U kunt eventueel CLI-opdrachten blijven gebruiken.

IoT Explorer configureren

In de rest van deze quickstart gebruikt u IoT Explorer om een apparaat te registreren bij uw IoT-hub en om de telemetrie van het apparaat weer te geven. In deze sectie configureert u IoT Explorer om verbinding te maken met de IoT-hub die u zojuist hebt gemaakt en om Plug en Play-modellen te lezen uit de openbare modelopslagplaats.

Een verbinding toevoegen aan uw IoT-hub:

  1. Voer in uw CLI-app de opdracht az iot hub connection-string show uit om de connection string voor uw IoT-hub op te halen.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Kopieer de connection string zonder de omliggende aanhalingstekens.

  3. Selecteer in Azure IoT Explorer IoT-hubs in het menu links en selecteer vervolgens + Verbinding toevoegen.

  4. Plak de connection string in het vak Verbindingsreeks.

  5. Selecteer Opslaan.

    Schermopname van het toevoegen van een verbinding in IoT Explorer

  6. Als de verbinding slaagt, schakelt IoT Explorer over naar de weergave Apparaten.

De openbare modelopslagplaats toevoegen:

  1. Selecteer in IoT Explorer Start om terug te keren naar de startweergave.

  2. Selecteer in het menu links IoT Plug en Play Instellingen, selecteer + Toevoegen en selecteer Openbare opslagplaats in de vervolgkeuzelijst.

  3. Er wordt een vermelding weergegeven voor de openbare modelopslagplaats op https://devicemodels.azure.com .

    Schermopname van het toevoegen van de openbare modelopslagplaats in IoT Explorer

  4. Selecteer Opslaan.

Een apparaat registreren

In deze sectie maakt u een nieuw apparaat-exemplaar en registreert u dit bij de IoT-hub die u hebt gemaakt. U gebruikt de verbindingsgegevens voor het zojuist geregistreerde apparaat om uw gesimuleerde apparaat veilig te verbinden in een latere sectie.

Een apparaat registreren:

  1. Selecteer in de startweergave in IoT Explorer de optie IoT-hubs.

  2. De verbinding die u eerder hebt toegevoegd, moet worden weergegeven. Selecteer Apparaten weergeven in deze hub onder de verbindingseigenschappen.

  3. Selecteer + Nieuw en voer een apparaat-id in voor uw apparaat; bijvoorbeeld mydevice. Laat alle andere eigenschappen hetzelfde.

  4. Selecteer Maken.

    Schermopname van de apparaat-id van Azure IoT Explorer

  5. Gebruik de kopieerknoppen om het veld Primaire connection string kopiëren en noteren. U hebt deze connection string nodig.

Notitie

Als u liever Azure CLI gebruikt, kunt u de opdracht az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} gebruiken om een nieuw apparaat te registreren en de opdracht az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} om de primaire connection string voor het apparaat op te halen.

Een gesimuleerd apparaat uitvoeren

In deze sectie gebruikt u de C# SDK om berichten van een gesimuleerd apparaat naar uw IoT-hub te verzenden. U voert een voorbeeld uit dat een temperatuurcontroller met twee thermostaatsensoren implementeert.

De voorbeeldtoepassing uitvoeren in Visual Studio:

  1. Open in de map waar u de Azure IoT-voorbeelden voor C# hebt uitgepakt het oplossingsbestand azure-iot-samples-csharp-master\iot-hub\Samples\device\IoTHubDeviceSamples.sln in Visual Studio.

  2. Selecteer Solution Explorer het projectbestand PnpDeviceSamples > TemperatureController, klik er met de rechtermuisknop op en selecteer Instellen als opstartbestand Project.

  3. Klik met de rechtermuisknop op het project TemperatureController, selecteer Eigenschappen, selecteer het tabblad Fouten opsporen en voeg de volgende omgevingsvariabelen toe aan het project:

    Name Waarde
    IOTHUB_DEVICE_SECURITY_TYPE connectionString
    IOTHUB_DEVICE_CONNECTION_STRING De connection string u eerder hebt opgeslagen.
  4. Sla het bijgewerkte Projectbestand TemperatureController op.

  5. Druk Visual Studio op CTRL + F5 om het voorbeeld uit te voeren.

Er wordt een consolevenster geopend. Het voorbeeld maakt veilig verbinding met uw IoT-hub als het apparaat dat u hebt geregistreerd en begint met het verzenden van telemetrieberichten. De voorbeelduitvoer wordt weergegeven in de console.

Telemetrie bekijken

U kunt de telemetrie van het apparaat weergeven met IoT Explorer. U kunt eventueel telemetrie weergeven met behulp van Azure CLI.

Telemetrie weergeven in Azure IoT Explorer:

  1. Selecteer vanuit uw IoT-hub in IoT Explorer de optie Apparaten in deze hub weergeven en selecteer vervolgens uw apparaat in de lijst.

  2. Selecteer telemetrie in het menu links voor uw apparaat.

  3. Controleer of Ingebouwde Event Hub gebruiken is ingesteld op Ja en selecteer vervolgens Starten.

  4. Bekijk de telemetrie terwijl het apparaat berichten naar de cloud verzendt.

    Schermopname van telemetrie van apparaten in IoT Explorer

  5. Selecteer Stoppen om het ontvangen van gebeurtenissen te beëindigen.

Als u telemetrie wilt lezen die is verzonden door afzonderlijke apparaatonderdelen, kunt u de plug en play-functies in IoT Explorer gebruiken. De temperatuurcontroller in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostat1 en thermostat2. De door thermostat1 gerapporteerde temperatuur bekijken:

  1. Selecteer op uw apparaat in IoT Explorer IoT Plug en Play onderdelen in het menu links. Selecteer vervolgens thermostat1 in de lijst met onderdelen.

  2. Selecteer in het deelvenster thermostat1 telemetrie in het bovenste menu.

  3. Volg in het deelvenster Telemetrie dezelfde stappen die u eerder hebt gedaan. Zorg ervoor dat Ingebouwde Event Hub gebruiken is ingesteld op Ja en selecteer vervolgens Starten.

Telemetrie van apparaten weergeven met Azure CLI:

  1. Voer in uw CLI-app de opdracht az iot hub monitor-events uit om gebeurtenissen te bewaken die vanaf het gesimuleerde apparaat naar uw IoT-hub worden verzonden. Gebruik de namen die u eerder hebt gemaakt in Azure IoT voor uw apparaat en IoT-hub.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Bekijk de verbindingsgegevens en telemetrie-uitvoer in de console.

    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. Selecteer Ctrl+C om de bewaking te beëindigen.

Code zoeken

In deze quickstart leert u een eenvoudige werkstroom voor het ontwikkelen van Azure IoT-toepassingen. U gebruikt de Azure CLI om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT Device SDK-voorbeeld om een gesimuleerde temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden.

Vereisten

  • Als u geen Azure-abonnement hebt, kunt u er gratis een maken voordat u begint.
  • Git.
  • Een ontwikkelmachine met Java SE Development Kit 8 of hoger. U kunt de Java 8 (LTS) JDK voor meerdere platforms downloaden van Zulu-builds van OpenJDK downloaden. Selecteer in het installatieprogramma de optie Toevoegen aan pad.
  • Apache Maven 3. Nadat u het downloaden naar een lokale map hebt uitgepakt, voegt u het volledige pad naar de map Maven /bin toe aan de variabele Windows PATH.
  • Azure IoT Explorer:platformoverschrijdend hulpprogramma voor het bewaken en beheren van Azure IoT
  • Azure CLI. U hebt twee opties voor het uitvoeren van Azure CLI-opdrachten in deze quickstart:
    • Gebruik de Azure Cloud Shell, een interactieve shell waarin CLI-opdrachten in uw browser worden uitgevoerd. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u de Cloud Shell gebruikt, meld u zich aan bij de Azure Portal. Volg de stappen in Cloud Shell quickstart naar Start Cloud Shell en Selecteer de Bash-omgeving.
    • Voer azure CLI op uw lokale computer uit (optioneel). Als Azure CLI al is geïnstalleerd, voer dan uit om de CLI en az upgrade extensies bij te werken naar de huidige versie. Zie Azure CLI installeren voor het installeren van Azure CLI.

Een IoT-hub maken

In deze sectie gebruikt u Azure CLI om een IoT-hub en een resourcegroep te maken. Een Azure-resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd. Een IoT-hub fungeert als een centrale berichtenhub voor bi-directionele communicatie tussen uw IoT-toepassing en apparaten.

Een IoT-hub en een resourcegroep maken:

  1. Start uw CLI-app. Als u de CLI-opdrachten in de rest van deze quickstart wilt uitvoeren, kopieert u de opdrachtsyntaxis, plakt u deze in uw CLI-app, bewerkt u variabele waarden en drukt u op Enter.

    • Als u een Cloud Shell, selecteert u de knop Uitproberen in de CLI-opdrachten om de Cloud Shell starten in een gesplitst browservenster. U kunt de Cloud Shell ook openen in een afzonderlijk browsertabblad.
    • Als u Azure CLI lokaal gebruikt, start u de CLI-console-app en meld u zich aan bij Azure CLI.
  2. Voer az extension add uit om de azure-iot-extensie te installeren of te upgraden naar de huidige versie.

    az extension add --upgrade --name azure-iot
    
  3. Voer in uw CLI-app de opdracht az group create uit om een resourcegroep te maken. Met de volgende opdracht wordt een resourcegroep met de naam MyResourceGroup gemaakt op de locatie VS - oost.

    Notitie

    U kunt eventueel een alternatieve locatie instellen. Voer uit om de beschikbare locaties te az account list-locations bekijken. In deze zelfstudie wordt eastus gebruikt, zoals wordt weergegeven in de voorbeeldopdracht.

    az group create --name MyResourceGroup --location eastus
    
  4. Voer de opdracht az iot hub create uit om een IoT-hub te maken. Het kan enkele minuten duren voordat een IoT-hub is gemaakt.

    YourIotHubName. Vervang deze tijdelijke aanduiding en de omliggende accolades in de volgende opdracht met behulp van de naam die u hebt gekozen voor uw IoT-hub. De naam van de IoT-hub moet wereldwijd uniek zijn in Azure. Gebruik de naam van uw IoT-hub in de rest van deze quickstart, waar u de tijdelijke aanduiding ook ziet.

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

    Tip

    Nadat u een IoT-hub hebt gemaakt, gebruikt u Azure IoT Explorer om in de rest van deze quickstart te communiceren met uw IoT-hub. IoT Explorer is een GUI-toepassing waarmee u verbinding kunt maken met een bestaande IoT Hub en apparaten kunt toevoegen, beheren en bewaken. Zie Azure IoT Explorer installeren en gebruiken voor meer informatie. U kunt eventueel CLI-opdrachten blijven gebruiken.

IoT Explorer configureren

In de rest van deze quickstart gebruikt u IoT Explorer om een apparaat te registreren bij uw IoT-hub en om de telemetrie van het apparaat weer te geven. In deze sectie configureert u IoT Explorer om verbinding te maken met de IoT-hub die u zojuist hebt gemaakt en om Plug en Play-modellen te lezen uit de openbare modelopslagplaats.

Een verbinding toevoegen aan uw IoT-hub:

  1. Voer in uw CLI-app de opdracht az iot hub connection-string show uit om de connection string voor uw IoT-hub op te halen.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Kopieer de connection string zonder de omliggende aanhalingstekens.

  3. Selecteer in Azure IoT Explorer IoT-hubs in het menu links en selecteer vervolgens + Verbinding toevoegen.

  4. Plak de connection string in het vak Verbindingsreeks.

  5. Selecteer Opslaan.

    Schermopname van het toevoegen van een verbinding in IoT Explorer

  6. Als de verbinding slaagt, schakelt IoT Explorer over naar de weergave Apparaten.

De openbare modelopslagplaats toevoegen:

  1. Selecteer in IoT Explorer Start om terug te keren naar de startweergave.

  2. Selecteer in het menu links IoT Plug en Play Instellingen, selecteer + Toevoegen en selecteer Openbare opslagplaats in de vervolgkeuzelijst.

  3. Er wordt een vermelding weergegeven voor de openbare modelopslagplaats op https://devicemodels.azure.com .

    Schermopname van het toevoegen van de openbare modelopslagplaats in IoT Explorer

  4. Selecteer Opslaan.

Een apparaat registreren

In deze sectie maakt u een nieuw apparaat-exemplaar en registreert u dit bij de IoT-hub die u hebt gemaakt. U gebruikt de verbindingsgegevens voor het zojuist geregistreerde apparaat om uw gesimuleerde apparaat veilig te verbinden in een latere sectie.

Een apparaat registreren:

  1. Selecteer in de startweergave in IoT Explorer de optie IoT-hubs.

  2. De verbinding die u eerder hebt toegevoegd, moet worden weergegeven. Selecteer Apparaten weergeven in deze hub onder de verbindingseigenschappen.

  3. Selecteer + Nieuw en voer een apparaat-id in voor uw apparaat; bijvoorbeeld mydevice. Laat alle andere eigenschappen hetzelfde.

  4. Selecteer Maken.

    Schermopname van de apparaat-id van Azure IoT Explorer

  5. Gebruik de kopieerknoppen om het veld Primaire connection string kopiëren en noteren. U hebt deze connection string nodig.

Notitie

Als u liever Azure CLI gebruikt, kunt u de opdracht az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} gebruiken om een nieuw apparaat te registreren en de opdracht az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} om de primaire connection string voor het apparaat op te halen.

Een gesimuleerd apparaat uitvoeren

In deze sectie gebruikt u de Java SDK om berichten van een gesimuleerd apparaat naar uw IoT-hub te verzenden. U voert een voorbeeld uit dat een temperatuurcontroller met twee thermostaatsensoren implementeert.

Uw omgeving configureren

  1. Open een console om de Azure IoT Java-apparaat-SDK te installeren, het codevoorbeeld te bouwen en uit te voeren.

    Notitie

    Als u een lokale installatie van Azure CLI gebruikt, hebt u mogelijk nu twee consolevensters geopend. Voer de opdrachten in deze sectie in de console in die u zojuist hebt geopend, niet de opdracht die u voor de CLI hebt gebruikt.

  2. Stel de volgende omgevingsvariabelen in, zodat uw gesimuleerde apparaat verbinding kan maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING . Gebruik voor de variabele waarde de apparaat-connection string u in de vorige sectie hebt opgeslagen.
    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_SECURITY_TYPE . Gebruik voor de variabele de letterlijke tekenreekswaarde connectionString .

    CMD

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

    Notitie

    Voor Windows CMD staan er geen aanhalingstekens rond de tekenreekswaarden voor elke variabele.

    Bash

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

Het voorbeeld bouwen

  1. Kloon in uw console de Azure IoT Java-apparaat-SDK naar uw lokale computer:
    git clone https://github.com/Azure/azure-iot-sdk-java.git
    
  2. Navigeer naar de hoofdmap van de SDK en voer de volgende opdracht uit om de SDK te bouwen en de voorbeelden bij te werken.
    cd azure-iot-sdk-java
    mvn install -T 2C -DskipTests
    
    Deze bewerking duurt enkele minuten.

De code uitvoeren

  1. Navigeer in de Java-console naar de map met voorbeelden.

    cd device/iot-device-samples/pnp-device-sample/temperature-controller-device-sample
    
  2. Voer in de Java-console het volgende codevoorbeeld uit.

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

    Notitie

    In dit codevoorbeeld wordt gebruikgemaakt van Azure IoT Plug en Play, waarmee u slimme apparaten in uw oplossingen kunt integreren zonder handmatige configuratie. De meeste voorbeelden in deze documentatie gebruiken standaard IoT-Plug en Play. Zie Wat is IoTPnP? voor meer informatie over de voordelen van Io Plug en Play T PnP en cases voor het al dan niet gebruiken ervan.

Het voorbeeld maakt veilig verbinding met uw IoT-hub als het apparaat dat u hebt geregistreerd en begint met het verzenden van telemetrieberichten. De voorbeelduitvoer wordt weergegeven in de console.

Telemetrie bekijken

U kunt de telemetrie van het apparaat weergeven met IoT Explorer. U kunt eventueel telemetrie weergeven met behulp van Azure CLI.

Telemetrie weergeven in Azure IoT Explorer:

  1. Selecteer in uw IoT-hub in IoT Explorer apparaten weergeven in deze hub en selecteer vervolgens uw apparaat in de lijst.

  2. Selecteer Telemetrie in het menu links voor uw apparaat.

  3. Controleer of Ingebouwde Event Hub gebruiken is ingesteld op Ja en selecteer vervolgens Starten.

  4. Bekijk de telemetrie terwijl het apparaat berichten naar de cloud verzendt.

    Schermopname van apparaat-telemetrie in IoT Explorer

  5. Selecteer Stoppen om het ontvangen van gebeurtenissen te beëindigen.

Als u telemetrie wilt lezen die is verzonden door afzonderlijke apparaatonderdelen, kunt u de plug en play-functies in IoT Explorer gebruiken. De temperatuurcontroller in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostat1 en thermostat2. De door thermostat1 gerapporteerde temperatuur bekijken:

  1. Selecteer op uw apparaat in IoT Explorer de optie IoT Plug en Play onderdelen in het menu links. Selecteer vervolgens thermostat1 in de lijst met onderdelen.

  2. Selecteer in het deelvenster thermostat1-onderdeel Telemetrie in het bovenste menu.

  3. Volg in het deelvenster Telemetrie dezelfde stappen die u eerder hebt gedaan. Zorg ervoor dat Ingebouwde Event Hub gebruiken is ingesteld op Ja en selecteer vervolgens Starten.

Telemetrie van apparaten weergeven met Azure CLI:

  1. Voer in uw CLI-app de opdracht az iot hub monitor-events uit om gebeurtenissen te bewaken die vanaf het gesimuleerde apparaat naar uw IoT-hub worden verzonden. Gebruik de namen die u eerder hebt gemaakt in Azure IoT voor uw apparaat en IoT-hub.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Bekijk de verbindingsgegevens en telemetrie-uitvoer in de console.

    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
    

Code zoeken

In deze quickstart leert u een eenvoudige werkstroom voor het ontwikkelen van Azure IoT-toepassingen. U gebruikt de Azure CLI om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT Device SDK-voorbeeld om een gesimuleerde temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden.

Vereisten

  • Als u geen Azure-abonnement hebt, kunt u er gratis een maken voordat u begint.
  • Git.
  • Node.js versie 10 of hoger. Voer uit om de versie van uw knooppunt te node --version controleren.
  • Azure IoT Explorer:platformoverschrijdend hulpprogramma voor het bewaken en beheren van Azure IoT
  • Azure CLI. U hebt twee opties voor het uitvoeren van Azure CLI-opdrachten in deze quickstart:
    • Gebruik de Azure Cloud Shell, een interactieve shell waarin CLI-opdrachten in uw browser worden uitgevoerd. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u de Cloud Shell gebruikt, meld u zich aan bij de Azure Portal. Volg de stappen in Cloud Shell quickstart naar Start Cloud Shell en Selecteer de Bash-omgeving.
    • Voer desgewenst Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, moet u uitvoeren om az upgrade de CLI en extensies bij te werken naar de huidige versie. Zie Azure CLI installeren voor het installeren van Azure CLI.

Een IoT-hub maken

In deze sectie gebruikt u Azure CLI om een IoT-hub en een resourcegroep te maken. Een Azure-resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd. Een IoT-hub fungeert als een centrale berichtenhub voor bi-directionele communicatie tussen uw IoT-toepassing en apparaten.

Een IoT-hub en een resourcegroep maken:

  1. Start uw CLI-app. Als u de CLI-opdrachten in de rest van deze quickstart wilt uitvoeren, kopieert u de opdrachtsyntaxis, plakt u deze in uw CLI-app, bewerkt u variabele waarden en drukt u op Enter.

    • Als u een Cloud Shell, selecteert u de knop Uitproberen in de CLI-opdrachten om de Cloud Shell starten in een gesplitst browservenster. U kunt de Cloud Shell ook openen in een afzonderlijk browsertabblad.
    • Als u Azure CLI lokaal gebruikt, start u de CLI-console-app en meld u zich aan bij Azure CLI.
  2. Voer az extension add uit om de azure-iot-extensie te installeren of te upgraden naar de huidige versie.

    az extension add --upgrade --name azure-iot
    
  3. Voer in uw CLI-app de opdracht az group create uit om een resourcegroep te maken. Met de volgende opdracht wordt een resourcegroep met de naam MyResourceGroup gemaakt op de locatie VS - oost.

    Notitie

    U kunt eventueel een alternatieve locatie instellen. Voer uit om de beschikbare locaties te az account list-locations bekijken. In deze zelfstudie wordt eastus gebruikt, zoals wordt weergegeven in de voorbeeldopdracht.

    az group create --name MyResourceGroup --location eastus
    
  4. Voer de opdracht az iot hub create uit om een IoT-hub te maken. Het kan enkele minuten duren voordat een IoT-hub is gemaakt.

    YourIotHubName. Vervang deze tijdelijke aanduiding en de omliggende accolades in de volgende opdracht met behulp van de naam die u hebt gekozen voor uw IoT-hub. De naam van de IoT-hub moet wereldwijd uniek zijn in Azure. Gebruik de naam van uw IoT-hub in de rest van deze quickstart, waar u de tijdelijke aanduiding ook ziet.

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

    Tip

    Nadat u een IoT-hub hebt gemaakt, gebruikt u Azure IoT Explorer om in de rest van deze quickstart te communiceren met uw IoT-hub. IoT Explorer is een GUI-toepassing waarmee u verbinding kunt maken met een bestaande IoT Hub en apparaten kunt toevoegen, beheren en bewaken. Zie Azure IoT Explorer installeren en gebruiken voor meer informatie. U kunt eventueel CLI-opdrachten blijven gebruiken.

IoT Explorer configureren

In de rest van deze quickstart gebruikt u IoT Explorer om een apparaat te registreren bij uw IoT-hub en om de telemetrie van het apparaat weer te geven. In deze sectie configureert u IoT Explorer om verbinding te maken met de IoT-hub die u zojuist hebt gemaakt en om Plug en Play-modellen te lezen uit de openbare modelopslagplaats.

Een verbinding toevoegen aan uw IoT-hub:

  1. Voer in uw CLI-app de opdracht az iot hub connection-string show uit om de connection string voor uw IoT-hub op te halen.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Kopieer de connection string zonder de omliggende aanhalingstekens.

  3. Selecteer in Azure IoT Explorer IoT-hubs in het menu links en selecteer vervolgens + Verbinding toevoegen.

  4. Plak de connection string in het vak Verbindingsreeks.

  5. Selecteer Opslaan.

    Schermopname van het toevoegen van een verbinding in IoT Explorer

  6. Als de verbinding slaagt, schakelt IoT Explorer over naar de weergave Apparaten.

De openbare modelopslagplaats toevoegen:

  1. Selecteer in IoT Explorer Start om terug te keren naar de startweergave.

  2. Selecteer in het menu links IoT Plug en Play Instellingen, selecteer + Toevoegen en selecteer Openbare opslagplaats in de vervolgkeuzelijst.

  3. Er wordt een vermelding weergegeven voor de openbare modelopslagplaats op https://devicemodels.azure.com .

    Schermopname van het toevoegen van de openbare modelopslagplaats in IoT Explorer

  4. Selecteer Opslaan.

Een apparaat registreren

In deze sectie maakt u een nieuw apparaat-exemplaar en registreert u dit bij de IoT-hub die u hebt gemaakt. U gebruikt de verbindingsgegevens voor het zojuist geregistreerde apparaat om uw gesimuleerde apparaat veilig te verbinden in een latere sectie.

Een apparaat registreren:

  1. Selecteer in de startweergave in IoT Explorer de optie IoT-hubs.

  2. De verbinding die u eerder hebt toegevoegd, moet worden weergegeven. Selecteer Apparaten weergeven in deze hub onder de verbindingseigenschappen.

  3. Selecteer + Nieuw en voer een apparaat-id in voor uw apparaat; bijvoorbeeld mydevice. Laat alle andere eigenschappen hetzelfde.

  4. Selecteer Maken.

    Schermopname van de apparaat-id van Azure IoT Explorer

  5. Gebruik de kopieerknoppen om het veld Primaire connection string kopiëren en noteren. U hebt deze connection string nodig.

Notitie

Als u liever Azure CLI gebruikt, kunt u de opdracht az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} gebruiken om een nieuw apparaat te registreren en de opdracht az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} om de primaire connection string voor het apparaat op te halen.

Een gesimuleerd apparaat uitvoeren

In deze sectie gebruikt u de SDK Node.js verzenden van berichten van een gesimuleerd apparaat naar uw IoT-hub. U voert een voorbeeld uit dat een temperatuurcontroller met twee thermostaatsensoren implementeert.

  1. Open een nieuw consolevenster. U gebruikt deze console om de SDK Node.js installeren en met de voorbeeldcode Node.js werken.

    Notitie

    Als u een lokale installatie van Azure CLI gebruikt, hebt u mogelijk nu twee consolevensters geopend. Voer de opdrachten in deze sectie in de console in die u zojuist hebt geopend, niet de opdrachten die u voor de CLI hebt gebruikt.

  2. Kloon in uw Node-console de Azure IoT Node.js SDK-apparaatvoorbeelden naar uw lokale computer:

    git clone https://github.com/Azure/azure-iot-sdk-node
    
  3. Navigeer naar de map azure-iot-sdk-node/device/samples/pnp:

    cd azure-iot-sdk-node/device/samples/pnp
    
  4. Installeer de Azure IoT Node.js SDK en de benodigde afhankelijkheden:

    npm install
    

    Met deze opdracht installeert u de juiste afhankelijkheden zoals opgegeven in de package.jsop bestand in de map met voorbeelden van apparaten.

  5. Stel beide van de volgende omgevingsvariabelen in, zodat uw gesimuleerde apparaat verbinding kan maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING . Gebruik voor de variabele waarde de apparaatwaarde connection string u in de vorige sectie hebt opgeslagen.
    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_SECURITY_TYPE . Gebruik voor de variabele de letterlijke tekenreekswaarde connectionString .

    Windows (cmd)

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

    Notitie

    Voor Windows CMD staan er geen aanhalingstekens rond de tekenreekswaarden voor elke variabele.

    PowerShell

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

    Bash (Linux of Windows)

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  6. Voer in uw Node-console de code uit voor het volgende voorbeeldbestand.

    U kunt het Node.js uitvoeren vanuit de terminal:

    node pnpTemperatureController.js
    

    Notitie

    In dit codevoorbeeld wordt gebruikgemaakt van Azure IoT Plug en Play, waarmee u slimme apparaten in uw oplossingen kunt integreren zonder handmatige configuratie. De meeste voorbeelden in deze documentatie maken standaard gebruik van IoT Plug en Play. Zie Wat is IoTPnP? voor meer informatie over de voordelen van Io Plug en Play T PnP en cases voor het al dan niet gebruiken ervan.

Het voorbeeld maakt veilig verbinding met uw IoT-hub als het apparaat dat u hebt geregistreerd en begint met het verzenden van telemetrieberichten. De voorbeelduitvoer wordt weergegeven in de console.

Telemetrie bekijken

U kunt de telemetrie van het apparaat weergeven met IoT Explorer. U kunt eventueel telemetrie weergeven met behulp van Azure CLI.

Telemetrie weergeven in Azure IoT Explorer:

  1. Selecteer vanuit uw IoT-hub in IoT Explorer de optie Apparaten in deze hub weergeven en selecteer vervolgens uw apparaat in de lijst.

  2. Selecteer telemetrie in het menu links voor uw apparaat.

  3. Controleer of Ingebouwde Event Hub gebruiken is ingesteld op Ja en selecteer vervolgens Starten.

  4. Bekijk de telemetrie terwijl het apparaat berichten naar de cloud verzendt.

    Schermopname van telemetrie van apparaten in IoT Explorer

  5. Selecteer Stoppen om het ontvangen van gebeurtenissen te beëindigen.

Als u telemetrie wilt lezen die is verzonden door afzonderlijke apparaatonderdelen, kunt u de plug en play-functies in IoT Explorer gebruiken. De temperatuurcontroller in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostat1 en thermostat2. De door thermostat1 gerapporteerde temperatuur bekijken:

  1. Selecteer op uw apparaat in IoT Explorer IoT Plug en Play onderdelen in het menu links. Selecteer vervolgens thermostat1 in de lijst met onderdelen.

  2. Selecteer in het deelvenster thermostat1 telemetrie in het bovenste menu.

  3. Volg in het deelvenster Telemetrie dezelfde stappen die u eerder hebt gedaan. Zorg ervoor dat Ingebouwde Event Hub gebruiken is ingesteld op Ja en selecteer vervolgens Starten.

Telemetrie van apparaten weergeven met Azure CLI:

  1. Voer in uw CLI-app de opdracht az iot hub monitor-events uit om gebeurtenissen te bewaken die vanaf het gesimuleerde apparaat naar uw IoT-hub worden verzonden. Gebruik de namen die u eerder hebt gemaakt in Azure IoT voor uw apparaat en IoT-hub.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Bekijk de verbindingsgegevens en telemetrie-uitvoer in de console.

    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
    

Code zoeken

In deze quickstart leert u een eenvoudige werkstroom voor het ontwikkelen van Azure IoT-toepassingen. U gebruikt de Azure CLI om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT Device SDK-voorbeeld om een gesimuleerde temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden.

Vereisten

  • Als u geen Azure-abonnement hebt, kunt u er gratis een maken voordat u begint.
  • Git.
  • Python-versie 3.7 of hoger. Voer uit om uw Python-versie te python --version controleren.
  • Azure IoT Explorer:platformoverschrijdend hulpprogramma voor het bewaken en beheren van Azure IoT
  • Azure CLI. U hebt twee opties voor het uitvoeren van Azure CLI-opdrachten in deze quickstart:
    • Gebruik de Azure Cloud Shell, een interactieve shell waarin CLI-opdrachten in uw browser worden uitgevoerd. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u de Cloud Shell gebruikt, meld u zich aan bij de Azure Portal. Volg de stappen in Cloud Shell quickstart naar Start Cloud Shell en Selecteer de Bash-omgeving.
    • Voer desgewenst Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, moet u uitvoeren om az upgrade de CLI en extensies bij te werken naar de huidige versie. Zie Azure CLI installeren voor het installeren van Azure CLI.

Een IoT-hub maken

In deze sectie gebruikt u Azure CLI om een IoT-hub en een resourcegroep te maken. Een Azure-resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd. Een IoT-hub fungeert als een centrale berichtenhub voor bi-directionele communicatie tussen uw IoT-toepassing en apparaten.

Een IoT-hub en een resourcegroep maken:

  1. Start uw CLI-app. Als u de CLI-opdrachten in de rest van deze quickstart wilt uitvoeren, kopieert u de opdrachtsyntaxis, plakt u deze in uw CLI-app, bewerkt u variabele waarden en drukt u op Enter.

    • Als u een Cloud Shell, selecteert u de knop Uitproberen in de CLI-opdrachten om de Cloud Shell starten in een gesplitst browservenster. U kunt de Cloud Shell ook openen in een afzonderlijk browsertabblad.
    • Als u Azure CLI lokaal gebruikt, start u de CLI-console-app en meld u zich aan bij Azure CLI.
  2. Voer az extension add uit om de azure-iot-extensie te installeren of te upgraden naar de huidige versie.

    az extension add --upgrade --name azure-iot
    
  3. Voer in uw CLI-app de opdracht az group create uit om een resourcegroep te maken. Met de volgende opdracht wordt een resourcegroep met de naam MyResourceGroup gemaakt op de locatie VS - oost.

    Notitie

    U kunt eventueel een alternatieve locatie instellen. Voer uit om de beschikbare locaties te az account list-locations bekijken. In deze zelfstudie wordt eastus gebruikt, zoals wordt weergegeven in de voorbeeldopdracht.

    az group create --name MyResourceGroup --location eastus
    
  4. Voer de opdracht az iot hub create uit om een IoT-hub te maken. Het kan enkele minuten duren voordat een IoT-hub is gemaakt.

    YourIotHubName. Vervang deze tijdelijke aanduiding en de omliggende accolades in de volgende opdracht met behulp van de naam die u hebt gekozen voor uw IoT-hub. De naam van de IoT-hub moet wereldwijd uniek zijn in Azure. Gebruik de naam van uw IoT-hub in de rest van deze quickstart, waar u de tijdelijke aanduiding ook ziet.

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

    Tip

    Nadat u een IoT-hub hebt gemaakt, gebruikt u Azure IoT Explorer om in de rest van deze quickstart te communiceren met uw IoT-hub. IoT Explorer is een GUI-toepassing waarmee u verbinding kunt maken met een bestaande IoT Hub en apparaten kunt toevoegen, beheren en bewaken. Zie Azure IoT Explorer installeren en gebruiken voor meer informatie. U kunt eventueel CLI-opdrachten blijven gebruiken.

IoT Explorer configureren

In de rest van deze quickstart gebruikt u IoT Explorer om een apparaat te registreren bij uw IoT-hub en om de telemetrie van het apparaat weer te geven. In deze sectie configureert u IoT Explorer om verbinding te maken met de IoT-hub die u zojuist hebt gemaakt en om Plug en Play-modellen te lezen uit de openbare modelopslagplaats.

Een verbinding toevoegen aan uw IoT-hub:

  1. Voer in uw CLI-app de opdracht az iot hub connection-string show uit om de connection string voor uw IoT-hub op te halen.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Kopieer de connection string zonder de omliggende aanhalingstekens.

  3. Selecteer in Azure IoT Explorer IoT-hubs in het menu links en selecteer vervolgens + Verbinding toevoegen.

  4. Plak de connection string in het vak Verbindingsreeks.

  5. Selecteer Opslaan.

    Schermopname van het toevoegen van een verbinding in IoT Explorer

  6. Als de verbinding slaagt, schakelt IoT Explorer over naar de weergave Apparaten.

De openbare modelopslagplaats toevoegen:

  1. Selecteer in IoT Explorer Start om terug te keren naar de startweergave.

  2. Selecteer in het menu links IoT Plug en Play Instellingen, selecteer + Toevoegen en selecteer Openbare opslagplaats in de vervolgkeuzelijst.

  3. Er wordt een vermelding weergegeven voor de openbare modelopslagplaats op https://devicemodels.azure.com .

    Schermopname van het toevoegen van de openbare modelopslagplaats in IoT Explorer

  4. Selecteer Opslaan.

Een apparaat registreren

In deze sectie maakt u een nieuw apparaat-exemplaar en registreert u dit bij de IoT-hub die u hebt gemaakt. U gebruikt de verbindingsgegevens voor het zojuist geregistreerde apparaat om uw gesimuleerde apparaat veilig te verbinden in een latere sectie.

Een apparaat registreren:

  1. Selecteer in de startweergave in IoT Explorer de optie IoT-hubs.

  2. De verbinding die u eerder hebt toegevoegd, moet worden weergegeven. Selecteer Apparaten weergeven in deze hub onder de verbindingseigenschappen.

  3. Selecteer + Nieuw en voer een apparaat-id in voor uw apparaat; bijvoorbeeld mydevice. Laat alle andere eigenschappen hetzelfde.

  4. Selecteer Maken.

    Schermopname van de apparaat-id van Azure IoT Explorer

  5. Gebruik de kopieerknoppen om het veld Primaire connection string kopiëren en noteren. U hebt deze connection string nodig.

Notitie

Als u liever Azure CLI gebruikt, kunt u de opdracht az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} gebruiken om een nieuw apparaat te registreren en de opdracht az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} om de primaire connection string voor het apparaat op te halen.

Een gesimuleerd apparaat uitvoeren

In deze sectie gebruikt u de Python SDK om berichten van een gesimuleerd apparaat naar uw IoT-hub te verzenden. U voert een voorbeeld uit dat een temperatuurcontroller met twee thermostaatsensoren implementeert.

  1. Open een nieuw consolevenster. U gebruikt deze console om de Python-SDK te installeren en met Python-voorbeeldcode te werken.

    Notitie

    Als u een lokale installatie van Azure CLI gebruikt, hebt u mogelijk nu twee consolevensters geopend. Voer de opdrachten in deze sectie in de console in die u zojuist hebt geopend, niet de opdrachten die u voor de CLI hebt gebruikt.

  2. Kloon in uw Python-console de Azure IoT Python SDK-apparaatvoorbeelden naar uw lokale computer:

    git clone https://github.com/Azure/azure-iot-sdk-python
    
  3. Navigeer naar de map met voorbeelden:

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

    pip3 install azure-iot-device
    
  5. Stel de volgende omgevingsvariabelen in, zodat uw gesimuleerde apparaat verbinding kan maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING . Gebruik voor de variabele waarde de apparaatwaarde connection string u in de vorige sectie hebt opgeslagen.
    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_SECURITY_TYPE . Gebruik voor de variabele de letterlijke tekenreekswaarde connectionString .

    Windows (cmd)

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

    Notitie

    Voor Windows CMD staan er geen aanhalingstekens rond de tekenreekswaarden voor elke variabele.

    PowerShell

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

    Bash (Linux of Windows)

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  6. Voer in uw Python-console de code uit voor het volgende voorbeeldbestand.

    python temp_controller_with_thermostats.py
    

    Notitie

    In dit codevoorbeeld wordt gebruikgemaakt van Azure IoT Plug en Play, waarmee u slimme apparaten in uw oplossingen kunt integreren zonder handmatige configuratie. De meeste voorbeelden in deze documentatie maken standaard gebruik van IoT Plug en Play. Zie Wat is IoT Plug en Play?voor meer informatie over de voordelen van IoT-Plug en Play en cases voor het al dan niet gebruiken ervan.

Het voorbeeld maakt veilig verbinding met uw IoT-hub als het apparaat dat u hebt geregistreerd en begint met het verzenden van telemetrieberichten. De voorbeelduitvoer wordt weergegeven in de console.

Telemetrie bekijken

U kunt de telemetrie van het apparaat weergeven met IoT Explorer. U kunt eventueel telemetrie weergeven met behulp van Azure CLI.

Telemetrie weergeven in Azure IoT Explorer:

  1. Selecteer vanuit uw IoT-hub in IoT Explorer de optie Apparaten in deze hub weergeven en selecteer vervolgens uw apparaat in de lijst.

  2. Selecteer telemetrie in het menu links voor uw apparaat.

  3. Controleer of Ingebouwde Event Hub gebruiken is ingesteld op Ja en selecteer vervolgens Starten.

  4. Bekijk de telemetrie terwijl het apparaat berichten naar de cloud verzendt.

    Schermopname van telemetrie van apparaten in IoT Explorer

  5. Selecteer Stoppen om het ontvangen van gebeurtenissen te beëindigen.

Als u telemetrie wilt lezen die is verzonden door afzonderlijke apparaatonderdelen, kunt u de plug en play-functies in IoT Explorer gebruiken. De temperatuurcontroller in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostat1 en thermostat2. De door thermostat1 gerapporteerde temperatuur bekijken:

  1. Selecteer op uw apparaat in IoT Explorer IoT Plug en Play onderdelen in het menu links. Selecteer vervolgens thermostat1 in de lijst met onderdelen.

  2. Selecteer in het deelvenster thermostat1 telemetrie in het bovenste menu.

  3. Volg in het deelvenster Telemetrie dezelfde stappen die u eerder hebt gedaan. Zorg ervoor dat Ingebouwde Event Hub gebruiken is ingesteld op Ja en selecteer vervolgens Starten.

Telemetrie van apparaten weergeven met Azure CLI:

  1. Voer in uw CLI-app de opdracht az iot hub monitor-events uit om gebeurtenissen te bewaken die vanaf het gesimuleerde apparaat naar uw IoT-hub worden verzonden. Gebruik de namen die u eerder hebt gemaakt in Azure IoT voor uw apparaat en IoT-hub.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Bekijk de verbindingsgegevens en telemetrie-uitvoer in de console.

    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
    

Resources opschonen

Als u de Azure-resources die u in deze quickstart hebt gemaakt, niet meer nodig hebt, kunt u de Azure CLI gebruiken om ze te verwijderen.

Belangrijk

Het verwijderen van een resourcegroep kan niet ongedaan worden gemaakt. De resourcegroep en alle resources daarin worden permanent verwijderd. Zorg ervoor dat u niet per ongeluk de verkeerde resourcegroep of resources verwijdert.

Een resourcegroep verwijderen op naam:

  1. Voer de opdracht az group delete uit. Met deze opdracht verwijdert u de resourcegroep, de IoT Hub en de apparaatregistratie die u hebt gemaakt.

    az group delete --name MyResourceGroup
    
  2. Voer de opdracht az group list uit om te controleren of de resourcegroep is verwijderd.

    az group list
    

Volgende stappen

In deze quickstart hebt u een eenvoudige Azure IoT-toepassingswerkstroom geleerd voor het veilig verbinden van een apparaat met de cloud en het verzenden van apparaat-naar-cloud-telemetrie. U hebt Azure CLI gebruikt om een Azure IoT-hub en een apparaat-exemplaar te maken. Vervolgens hebt u een Azure IoT Device SDK gebruikt om een gesimuleerd apparaat te maken, het te verbinden met de hub en telemetrie te verzenden. U hebt ook Azure Portal om telemetrie te bewaken.

Als volgende stap kunt u de volgende artikelen bekijken voor meer informatie over het bouwen van apparaatoplossingen met Azure IoT.