Lezen in het Engels

Delen via

Zelfstudie: Telemetrie verzenden van een IoT-Plug en Play-apparaat naar Azure IoT Hub

  • Artikel
Een programmeertaal kiezen

Code zoeken

In deze quickstart leert u een eenvoudige werkstroom voor het ontwikkelen van Azure IoT-toepassingen. U gebruikt azure CLI en IoT Explorer om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT Device SDK-voorbeeld om een temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden. De voorbeeldtoepassing voor de temperatuurcontroller wordt uitgevoerd op uw lokale computer en genereert gesimuleerde sensorgegevens die naar IoT Hub moeten worden verzonden.

Vereisten

Deze quickstart wordt uitgevoerd op Windows, Linux en Raspberry Pi. Het is getest op de volgende besturingssysteem- en apparaatversies:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) versie 10, uitgevoerd op een Raspberry Pi 3 Model B+

Installeer de volgende vereisten op uw ontwikkelcomputer, behalve waar vermeld voor Raspberry Pi:

  • Als u geen Azure-abonnement hebt, kunt u er gratis een maken voordat u begint.
  • Git.
  • Azure IoT Explorer: platformoverschrijdend, gui-gebaseerd hulpprogramma voor het bewaken en beheren van Azure IoT. Als u Raspberry Pi als uw ontwikkelplatform gebruikt, raden we u aan IoT Explorer op een andere computer te installeren. Als u IoT Explorer niet wilt installeren, kunt u Azure CLI gebruiken om dezelfde stappen uit te voeren.
  • Azure CLI. U hebt twee opties voor het uitvoeren van Azure CLI-opdrachten in deze quickstart:
    • Gebruik De Azure Cloud Shell, een interactieve shell waarmee CLI-opdrachten in uw browser worden uitgevoerd. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u Cloud Shell voor het eerst gebruikt, meldt u zich aan bij Azure Portal. Volg de stappen in Aan de slag met Azure Cloud Shell om Cloud Shell te starten en selecteer de Bash-omgeving.
    • Voer desgewenst Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, voert u een az upgrade upgrade uit van de CLI en extensies naar de huidige versie. Zie Azure CLI installeren om Azure CLI te installeren. Als u Raspberry Pi als ontwikkelplatform gebruikt, raden we u aan Azure Cloud Shell te gebruiken of Azure CLI op een andere computer te installeren.

Installeer de resterende vereisten voor uw besturingssysteem.

Linux- of Raspberry Pi-besturingssysteem

Installeer de volgende software om deze quickstart op Linux of Raspberry Pi te voltooien:

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

sh 
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 3.13 of hoger is en of de versie van GCC 4.4.7 of hoger is.

sh 
cmake --version
gcc --version

Windows

Als u deze quickstart in Windows wilt voltooien, installeert u Visual Studio 2022 en voegt u de vereiste onderdelen toe voor C- en C++-ontwikkeling.

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

    Notitie

    Voor bestaande Visual Studio 2022-gebruikers selecteert u Windows Start, typt u Visual Studio Installer, voert u het installatieprogramma uit en selecteert u Vervolgens Wijzigen.

  2. Selecteer op het tabblad Workloads van het installatieprogramma de desktopontwikkeling met C++-werkbelasting.
  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 bidirectionele communicatie tussen uw IoT-toepassing en -apparaten.

Een IoT-hub en een resourcegroep maken:

  1. Azure CLI starten:

    • Als u Cloud Shell gebruikt, selecteert u de knop Uitproberen in de CLI-opdrachten om Cloud Shell te starten in een gesplitst browservenster. U kunt de Cloud Shell ook openen in een afzonderlijk browsertabblad.
    • Als u Azure CLI lokaal gebruikt, opent u een console zoals Windows CMD, PowerShell of Bash en meldt u zich aan bij Azure CLI.

    Als u de CLI-opdrachten in de rest van deze quickstart wilt uitvoeren: kopieer de syntaxis van de opdracht, plak deze in uw Cloud Shell-venster of CLI-console, bewerk variabelewaarden en druk op Enter.

  2. Voer az extension add uit om de azure-iot-extensie te installeren of bij te werken naar de huidige versie.

    Azure CLI 
    az extension add --upgrade --name azure-iot

  3. Voer 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 desgewenst een alternatieve locatie instellen. Als u de beschikbare locaties wilt zien, voert u de opdracht uit az account list-locations. In deze zelfstudie wordt gebruikgemaakt van eastus , zoals wordt weergegeven in de voorbeeldopdracht.

    Azure CLI 
    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 omringende 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.

    Azure CLI 
    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 desgewenst 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 and Play-modellen te lezen vanuit de openbare modelopslagplaats.

Notitie

U kunt ook de Azure CLI gebruiken om een apparaat te registreren. Gebruik de opdracht az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} 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 verbindingsreeks voor het apparaat op te halen. Zodra u het apparaat hebt genoteerd verbindingsreeks, kunt u verdergaan met het voorbeeld van het apparaat uitvoeren.

Ga als volgende te werk om een verbinding met uw IoT-hub toe te voegen:

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

    Azure CLI 
    az iot hub connection-string  show --hub-name {YourIoTHubName}

  2. Kopieer de verbindingsreeks zonder de omringende aanhalingstekens.

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

  4. Plak de verbindingsreeks in het vak Verbindingsreeks.

  5. Selecteer Opslaan.

    Schermopname van het toevoegen van een verbinding in IoT Explorer

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

Ga als volgende te werk om de openbare modelopslagplaats toe te voegen:

  1. In IoT Explorer selecteert u Start om terug te keren naar de startweergave.

  2. Selecteer in het linkermenu IoT Plug en Play Instellingen en selecteer vervolgens +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 apparaatexemplaren en registreert u dit bij de IoT-hub die u hebt gemaakt. U gebruikt de verbindingsgegevens voor het zojuist geregistreerde apparaat om uw apparaat veilig te verbinden in een latere sectie.

Een apparaat registreren:

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

  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 azure IoT Explorer-apparaat-id

  5. Gebruik de kopieerknoppen om het veld Primaire verbindingsreeks te kopiëren en te noteren. U hebt deze verbindingsreeks later nodig.

Het apparaatvoorbeeld uitvoeren

In deze sectie gebruikt u de C SDK om berichten van een apparaat naar uw IoT-hub te verzenden. U voert een voorbeeld uit waarmee een temperatuurregelaar met twee thermostaatsensoren wordt geïmplementeerd.

Bouw het sample

  1. Open een nieuwe console om de Azure IoT C device SDK te installeren en het codevoorbeeld uit te voeren. Voor Windows selecteert u Start, typt u de opdrachtprompt voor ontwikkelaars voor VS 2019 en opent u de console. Open een terminal voor Bash-opdrachten voor Linux en Raspberry Pi.

    Notitie

    Als u een lokale installatie van Azure CLI gebruikt, zijn er mogelijk twee consolevensters geopend. Zorg ervoor dat u de opdrachten in deze sectie invoert in de console die u zojuist hebt geopend, niet degene die u voor de CLI hebt gebruikt.

  2. Navigeer naar een lokale map waar u de voorbeeldopslagplaats wilt klonen.

  3. Kloon de Azure IoT C-apparaat-SDK naar uw lokale computer:

    Console 
    git clone https://github.com/Azure/azure-iot-sdk-c.git

  4. Navigeer naar de hoofdmap van de SDK en voer de volgende opdracht uit om afhankelijkheden bij te werken:

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

    Deze bewerking duurt enkele minuten.

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

    Console 
    cmake -Bcmake -Duse_prov_client=ON -Dhsm_type_symm_key=ON -Drun_e2e_tests=OFF
cmake --build cmake

  6. Stel de volgende omgevingsvariabelen in om uw apparaat in staat te stellen verbinding te maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING. Gebruik voor de waarde van de variabele het apparaat verbindingsreeks dat 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

    Console 
    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

    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

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

    Bash

    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 kunt integreren in uw oplossingen 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 PnP en cases voor het gebruik ervan of niet.

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 uw console.

Telemetrie bekijken

U kunt de telemetrie van het apparaat weergeven met IoT Explorer. U kunt desgewenst telemetrie bekijken 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 linkermenu voor uw apparaat.

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

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

    Schermopname van apparaattelemetrie in IoT Explorer

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

Als u telemetrie wilt lezen die door afzonderlijke apparaatonderdelen wordt verzonden, kunt u de plug-and-play-functies in IoT Explorer gebruiken. De temperatuurregelaar in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostaat1 en thermostaat2. De temperatuur die door thermostaat1 is gerapporteerd, bekijken:

  1. Selecteer op uw apparaat in IoT Explorer IoT Plug en Play onderdelen in het linkermenu. Selecteer vervolgens thermostaat1 in de lijst met onderdelen.

  2. Selecteer in het deelvenster thermostaat1 de optie Telemetrie in het bovenste menu.

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

Apparaattelemetrie weergeven met Azure CLI:

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

    Azure CLI 
    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}

  2. Bekijk de verbindingsgegevens en telemetrie-uitvoer in de console.

    Output 
    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 azure CLI en IoT Explorer om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT Device SDK-voorbeeld om een temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden. De voorbeeldtoepassing voor de temperatuurcontroller wordt uitgevoerd op uw lokale computer en genereert gesimuleerde sensorgegevens die naar IoT Hub moeten worden verzonden.

Vereisten

Deze quickstart wordt uitgevoerd op Windows, Linux en Raspberry Pi. Het is getest op de volgende besturingssysteem- en apparaatversies:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) versie 10, uitgevoerd op een Raspberry Pi 3 Model B+

Installeer de volgende vereisten op uw ontwikkelcomputer, behalve waar vermeld voor Raspberry Pi:

  • Als u geen Azure-abonnement hebt, kunt u er gratis een maken voordat u begint.

  • Git.

  • .NET Core SDK 3.1. Zorg ervoor dat u de .NET SDK installeert, niet alleen de runtime. Als u de versie van de .NET SDK en runtime wilt controleren die op uw computer is geïnstalleerd, voert u het volgende uit dotnet --info.

    • Voor Windows en Linux (met uitzondering van Raspberry Pi) volgt u de instructies voor het installeren van de .NET Core SDK 3.1 op uw platform.
    • Voor Raspberry Pi moet u de instructies volgen om de SDK handmatig te installeren. Dit komt doordat op Debian pakketbeheer-installaties van de .NET SDK alleen worden ondersteund voor de x64-architectuur.

  • Azure IoT Explorer: platformoverschrijdend, gui-gebaseerd hulpprogramma voor het bewaken en beheren van Azure IoT. Als u Raspberry Pi als uw ontwikkelplatform gebruikt, raden we u aan IoT Explorer op een andere computer te installeren. Als u IoT Explorer niet wilt installeren, kunt u Azure CLI gebruiken om dezelfde stappen uit te voeren.

  • Azure CLI. U hebt twee opties voor het uitvoeren van Azure CLI-opdrachten in deze quickstart:

    • Gebruik De Azure Cloud Shell, een interactieve shell waarmee CLI-opdrachten in uw browser worden uitgevoerd. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u Cloud Shell voor het eerst gebruikt, meldt u zich aan bij Azure Portal. Volg de stappen in Aan de slag met Azure Cloud Shell om Cloud Shell te starten en selecteer de Bash-omgeving.
    • Voer desgewenst Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, voert u een az upgrade upgrade uit van de CLI en extensies naar de huidige versie. Zie Azure CLI installeren om Azure CLI te installeren. Als u Raspberry Pi als ontwikkelplatform gebruikt, raden we u aan Azure Cloud Shell te gebruiken of Azure CLI op een andere computer te installeren.

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 bidirectionele communicatie tussen uw IoT-toepassing en -apparaten.

Een IoT-hub en een resourcegroep maken:

  1. Azure CLI starten:

    • Als u Cloud Shell gebruikt, selecteert u de knop Uitproberen in de CLI-opdrachten om Cloud Shell te starten in een gesplitst browservenster. U kunt de Cloud Shell ook openen in een afzonderlijk browsertabblad.
    • Als u Azure CLI lokaal gebruikt, opent u een console zoals Windows CMD, PowerShell of Bash en meldt u zich aan bij Azure CLI.

    Als u de CLI-opdrachten in de rest van deze quickstart wilt uitvoeren: kopieer de syntaxis van de opdracht, plak deze in uw Cloud Shell-venster of CLI-console, bewerk variabelewaarden en druk op Enter.

  2. Voer az extension add uit om de azure-iot-extensie te installeren of bij te werken naar de huidige versie.

    Azure CLI 
    az extension add --upgrade --name azure-iot

  3. Voer 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 desgewenst een alternatieve locatie instellen. Als u de beschikbare locaties wilt zien, voert u de opdracht uit az account list-locations. In deze zelfstudie wordt gebruikgemaakt van eastus , zoals wordt weergegeven in de voorbeeldopdracht.

    Azure CLI 
    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 omringende 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.

    Azure CLI 
    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 desgewenst 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 and Play-modellen te lezen vanuit de openbare modelopslagplaats.

Notitie

U kunt ook de Azure CLI gebruiken om een apparaat te registreren. Gebruik de opdracht az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} 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 verbindingsreeks voor het apparaat op te halen. Zodra u het apparaat hebt genoteerd verbindingsreeks, kunt u verdergaan met het voorbeeld van het apparaat uitvoeren.

Ga als volgende te werk om een verbinding met uw IoT-hub toe te voegen:

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

    Azure CLI 
    az iot hub connection-string  show --hub-name {YourIoTHubName}

  2. Kopieer de verbindingsreeks zonder de omringende aanhalingstekens.

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

  4. Plak de verbindingsreeks in het vak Verbindingsreeks.

  5. Selecteer Opslaan.

    Schermopname van het toevoegen van een verbinding in IoT Explorer

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

Ga als volgende te werk om de openbare modelopslagplaats toe te voegen:

  1. In IoT Explorer selecteert u Start om terug te keren naar de startweergave.

  2. Selecteer in het linkermenu IoT Plug en Play Instellingen en selecteer vervolgens +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 apparaatexemplaren en registreert u dit bij de IoT-hub die u hebt gemaakt. U gebruikt de verbindingsgegevens voor het zojuist geregistreerde apparaat om uw apparaat veilig te verbinden in een latere sectie.

Een apparaat registreren:

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

  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 azure IoT Explorer-apparaat-id

  5. Gebruik de kopieerknoppen om het veld Primaire verbindingsreeks te kopiëren en te noteren. U hebt deze verbindingsreeks later nodig.

Het apparaatvoorbeeld uitvoeren

In deze sectie gebruikt u de C#SDK om berichten van een apparaat naar uw IoT-hub te verzenden. U voert een voorbeeld uit waarmee een temperatuurregelaar met twee thermostaatsensoren wordt geïmplementeerd.

  1. Open een nieuwe console, zoals Windows CMD, PowerShell of Bash. In de volgende stappen gebruikt u deze console om de Node.js SDK te installeren en te werken met Node.js voorbeeldcode.

    Notitie

    Als u een lokale installatie van Azure CLI gebruikt, zijn er mogelijk twee consolevensters geopend. Zorg ervoor dat u de opdrachten in deze sectie invoert in de console die u zojuist hebt geopend, niet degene die u voor de CLI hebt gebruikt.

  2. Kloon de Microsoft Azure IoT SDK voor C# (.NET) naar uw lokale computer:

    Console 
    git clone https://github.com/Azure/azure-iot-sdk-csharp.git

  3. Navigeer naar de voorbeeldmap:

    Windows

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

    Linux- of Raspberry Pi-besturingssysteem

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

  4. Installeer de Azure IoT C#-SDK en de benodigde afhankelijkheden:

    Console 
    dotnet restore

    Met deze opdracht worden de juiste afhankelijkheden geïnstalleerd zoals opgegeven in het bestand TemperatureController.csproj .

  5. Stel beide omgevingsvariabelen in om uw apparaat in staat te stellen verbinding te maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING. Gebruik voor de waarde van de variabele het apparaat verbindingsreeks dat 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 (Windows)

    Console 
    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

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

    Bash

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

  6. Voer het codevoorbeeld uit:

    Console 
    dotnet run

    Notitie

    In dit codevoorbeeld wordt Gebruikgemaakt van Azure IoT Plug en Play, waarmee u slimme apparaten kunt integreren in uw oplossingen 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 PnP en cases voor het gebruik ervan of niet.

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 uw console.

Telemetrie bekijken

U kunt de telemetrie van het apparaat weergeven met IoT Explorer. U kunt desgewenst telemetrie bekijken 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 linkermenu voor uw apparaat.

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

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

    Schermopname van apparaattelemetrie in IoT Explorer

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

Als u telemetrie wilt lezen die door afzonderlijke apparaatonderdelen wordt verzonden, kunt u de plug-and-play-functies in IoT Explorer gebruiken. De temperatuurregelaar in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostaat1 en thermostaat2. De temperatuur die door thermostaat1 is gerapporteerd, bekijken:

  1. Selecteer op uw apparaat in IoT Explorer IoT Plug en Play onderdelen in het linkermenu. Selecteer vervolgens thermostaat1 in de lijst met onderdelen.

  2. Selecteer in het deelvenster thermostaat1 de optie Telemetrie in het bovenste menu.

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

Apparaattelemetrie weergeven met Azure CLI:

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

    Azure CLI 
    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}

  2. Bekijk de verbindingsgegevens en telemetrie-uitvoer in de console.

    Output 
    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 azure CLI en IoT Explorer om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT Device SDK-voorbeeld om een temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden. De voorbeeldtoepassing voor de temperatuurcontroller wordt uitgevoerd op uw lokale computer en genereert gesimuleerde sensorgegevens die naar IoT Hub moeten worden verzonden.

Vereisten

Deze quickstart wordt uitgevoerd op Windows, Linux en Raspberry Pi. Het is getest op de volgende besturingssysteem- en apparaatversies:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) versie 10, uitgevoerd op een Raspberry Pi 3 Model B+

Installeer de volgende vereisten op uw ontwikkelcomputer, behalve waar vermeld voor Raspberry Pi:

  • Als u geen Azure-abonnement hebt, kunt u er gratis een maken voordat u begint.
  • Git.
  • Azure IoT Explorer: platformoverschrijdend, gui-gebaseerd hulpprogramma voor het bewaken en beheren van Azure IoT. Als u Raspberry Pi als uw ontwikkelplatform gebruikt, raden we u aan IoT Explorer op een andere computer te installeren. Als u IoT Explorer niet wilt installeren, kunt u Azure CLI gebruiken om dezelfde stappen uit te voeren.
  • Azure CLI. U hebt twee opties voor het uitvoeren van Azure CLI-opdrachten in deze quickstart:
    • Gebruik De Azure Cloud Shell, een interactieve shell waarmee CLI-opdrachten in uw browser worden uitgevoerd. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u Cloud Shell voor het eerst gebruikt, meldt u zich aan bij Azure Portal. Volg de stappen in Aan de slag met Azure Cloud Shell om Cloud Shell te starten en selecteer de Bash-omgeving.
    • Voer desgewenst Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, voert u een az upgrade upgrade uit van de CLI en extensies naar de huidige versie. Zie Azure CLI installeren om Azure CLI te installeren. Als u Raspberry Pi als ontwikkelplatform gebruikt, raden we u aan Azure Cloud Shell te gebruiken of Azure CLI op een andere computer te installeren.

Installeer de resterende vereisten voor uw besturingssysteem.

Windows

Installeer de volgende software om deze quickstart in Windows te voltooien:

  • Java SE Development Kit 8 of hoger. U kunt de JDK (Java 8) (LTS) voor meerdere platforms downloaden via Zulu-builds van OpenJDK downloaden. Selecteer in het installatieprogramma de optie Toevoegen aan pad .

  • Apache Maven 3. Nadat u het downloaden hebt geëxtraheerd naar een lokale map, voegt u het volledige pad toe aan de map Maven /bin aan de Windows-omgevingsvariabele PATH .

Linux- of Raspberry Pi-besturingssysteem

Installeer de volgende software om deze quickstart op Linux of Raspberry Pi te voltooien:

Notitie

Stappen in deze sectie zijn gebaseerd op Linux Ubuntu/Debian-distributies. (Raspberry Pi OS is gebaseerd op Debian.) Als u een andere Linux-distributie gebruikt, moet u de stappen dienovereenkomstig wijzigen.

  • OpenJDK (Open Java Development Kit) 8 of hoger. U kunt de java -version opdracht gebruiken om te controleren of de versie van Java op uw systeem is geïnstalleerd. Zorg ervoor dat de JDK is geïnstalleerd, niet alleen de Java-runtime (JRE).

    1. Voer de volgende opdrachten in om de OpenJDK voor uw systeem te installeren:

      De standaardversie van OpenJDK voor uw systeem installeren (OpenJDK 11 voor Ubuntu 20.04 en Raspberry Pi OS 10 op het moment van schrijven):

      Bash 
      sudo apt update
sudo apt install default-jdk

      U kunt ook een versie van de JDK opgeven die moet worden geïnstalleerd. Voorbeeld:

      Bash 
      sudo apt update
sudo apt install openjdk-8-jdk

    2. Als op uw systeem meerdere versies van Java zijn geïnstalleerd, kunt u de volgende opdrachten gebruiken om de standaardversies van Java en de Java-compiler te configureren.

      Bash 
      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. Stel de JAVA_HOME omgevingsvariabele in op het pad van uw JDK-installatie. (Dit is doorgaans een submap met versiebeheer in de map /usr/lib/jvm .)

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

      Belangrijk

      Met deze opdracht stelt u de JAVA_HOME variabele in uw huidige shell-omgeving in. U wordt aangeraden de opdracht aan uw ~/.bashrc of /etc/profile bestand toe te voegen om deze beschikbaar te maken wanneer u een nieuwe shell opent.

    4. Controleer of de versie van de Java JDK (en JRE) is geïnstalleerd, of uw Java-compilerversie overeenkomt met de JDK-versie en of de JAVA_HOME omgevingsvariabele correct is ingesteld.

      Bash 
      java -version
javac -version
echo $JAVA_HOME

  • Apache Maven 3. U kunt de mvn --version opdracht gebruiken om te controleren of de versie van Maven op uw systeem is geïnstalleerd.

    1. Voer de volgende opdrachten in om Maven te installeren:

      Bash 
      sudo apt-get update
sudo apt-get install maven

    2. Voer de volgende opdracht in om de installatie te controleren.

      Bash 
      mvn --version

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 bidirectionele communicatie tussen uw IoT-toepassing en -apparaten.

Een IoT-hub en een resourcegroep maken:

  1. Azure CLI starten:

    • Als u Cloud Shell gebruikt, selecteert u de knop Uitproberen in de CLI-opdrachten om Cloud Shell te starten in een gesplitst browservenster. U kunt de Cloud Shell ook openen in een afzonderlijk browsertabblad.
    • Als u Azure CLI lokaal gebruikt, opent u een console zoals Windows CMD, PowerShell of Bash en meldt u zich aan bij Azure CLI.

    Als u de CLI-opdrachten in de rest van deze quickstart wilt uitvoeren: kopieer de syntaxis van de opdracht, plak deze in uw Cloud Shell-venster of CLI-console, bewerk variabelewaarden en druk op Enter.

  2. Voer az extension add uit om de azure-iot-extensie te installeren of bij te werken naar de huidige versie.

    Azure CLI 
    az extension add --upgrade --name azure-iot

  3. Voer 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 desgewenst een alternatieve locatie instellen. Als u de beschikbare locaties wilt zien, voert u de opdracht uit az account list-locations. In deze zelfstudie wordt gebruikgemaakt van eastus , zoals wordt weergegeven in de voorbeeldopdracht.

    Azure CLI 
    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 omringende 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.

    Azure CLI 
    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 desgewenst 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 and Play-modellen te lezen vanuit de openbare modelopslagplaats.

Notitie

U kunt ook de Azure CLI gebruiken om een apparaat te registreren. Gebruik de opdracht az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} 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 verbindingsreeks voor het apparaat op te halen. Zodra u het apparaat hebt genoteerd verbindingsreeks, kunt u verdergaan met het voorbeeld van het apparaat uitvoeren.

Ga als volgende te werk om een verbinding met uw IoT-hub toe te voegen:

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

    Azure CLI 
    az iot hub connection-string  show --hub-name {YourIoTHubName}

  2. Kopieer de verbindingsreeks zonder de omringende aanhalingstekens.

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

  4. Plak de verbindingsreeks in het vak Verbindingsreeks.

  5. Selecteer Opslaan.

    Schermopname van het toevoegen van een verbinding in IoT Explorer

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

Ga als volgende te werk om de openbare modelopslagplaats toe te voegen:

  1. In IoT Explorer selecteert u Start om terug te keren naar de startweergave.

  2. Selecteer in het linkermenu IoT Plug en Play Instellingen en selecteer vervolgens +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 apparaatexemplaren en registreert u dit bij de IoT-hub die u hebt gemaakt. U gebruikt de verbindingsgegevens voor het zojuist geregistreerde apparaat om uw apparaat veilig te verbinden in een latere sectie.

Een apparaat registreren:

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

  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 azure IoT Explorer-apparaat-id

  5. Gebruik de kopieerknoppen om het veld Primaire verbindingsreeks te kopiëren en te noteren. U hebt deze verbindingsreeks later nodig.

Het apparaatvoorbeeld uitvoeren

In deze sectie gebruikt u de Java SDK om berichten van een apparaat naar uw IoT-hub te verzenden. U voert een voorbeeld uit waarmee een temperatuurregelaar met twee thermostaatsensoren wordt geïmplementeerd.

  1. Open een console om de Azure IoT Java-apparaat-SDK te installeren, het codevoorbeeld te bouwen en uit te voeren. U gebruikt deze console in de volgende stappen.

    Notitie

    Als u een lokale installatie van Azure CLI gebruikt, zijn er mogelijk twee consolevensters geopend. Zorg ervoor dat u de opdrachten in deze sectie invoert in de console die u zojuist hebt geopend, niet degene die u voor de CLI hebt gebruikt.

    Linux- en Raspberry Pi-besturingssysteem

    Controleer of de omgevingsvariabele JAVA_HOME (echo $JAVA_HOME) is ingesteld. Zie Vereisten voor Linux/Raspberry Pi voor meer informatie over het instellen van JAVA_HOME.

  2. Kloon de Azure IoT Java-apparaat-SDK naar uw lokale computer:

    Console 
    git clone https://github.com/Azure/azure-iot-sdk-java.git

  3. Navigeer naar de hoofdmap van de SDK en voer de volgende opdracht uit om de SDK te bouwen en de voorbeelden bij te werken.

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

    Deze bewerking duurt enkele minuten.

  4. Stel de volgende omgevingsvariabelen in om uw apparaat in staat te stellen verbinding te maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING. Gebruik voor de waarde van de variabele het apparaat verbindingsreeks dat 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

    Console 
    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

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

  5. Navigeer naar de voorbeeldmap.

    CMD

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

    Bash

    Bash 
    cd device/iot-device-samples/pnp-device-sample/temperature-controller-device-sample

  6. Voer het codevoorbeeld uit.

    Console 
    java -jar -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 kunt integreren in uw oplossingen 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 PnP en cases voor het gebruik ervan of niet.

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 uw console.

Telemetrie bekijken

U kunt de telemetrie van het apparaat weergeven met IoT Explorer. U kunt desgewenst telemetrie bekijken 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 linkermenu voor uw apparaat.

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

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

    Schermopname van apparaattelemetrie in IoT Explorer

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

Als u telemetrie wilt lezen die door afzonderlijke apparaatonderdelen wordt verzonden, kunt u de plug-and-play-functies in IoT Explorer gebruiken. De temperatuurregelaar in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostaat1 en thermostaat2. De temperatuur die door thermostaat1 is gerapporteerd, bekijken:

  1. Selecteer op uw apparaat in IoT Explorer IoT Plug en Play onderdelen in het linkermenu. Selecteer vervolgens thermostaat1 in de lijst met onderdelen.

  2. Selecteer in het deelvenster thermostaat1 de optie Telemetrie in het bovenste menu.

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

Apparaattelemetrie weergeven met Azure CLI:

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

    Azure CLI 
    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}

  2. Bekijk de verbindingsgegevens en telemetrie-uitvoer in de console.

    Output 
    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 azure CLI en IoT Explorer om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT Device SDK-voorbeeld om een temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden. De voorbeeldtoepassing voor de temperatuurcontroller wordt uitgevoerd op uw lokale computer en genereert gesimuleerde sensorgegevens die naar IoT Hub moeten worden verzonden.

Vereisten

Deze quickstart wordt uitgevoerd op Windows, Linux en Raspberry Pi. Het is getest op de volgende besturingssysteem- en apparaatversies:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) versie 10, uitgevoerd op een Raspberry Pi 3 Model B+

Installeer de volgende vereisten op uw ontwikkelcomputer, behalve waar vermeld voor Raspberry Pi:

  • Als u geen Azure-abonnement hebt, kunt u er gratis een maken voordat u begint.
  • Git.
  • Node.js versie 12 of hoger. De uitvoering van de knooppuntversie node --versioncontroleren.
  • Azure IoT Explorer: platformoverschrijdend, gui-gebaseerd hulpprogramma voor het bewaken en beheren van Azure IoT. Als u Raspberry Pi als uw ontwikkelplatform gebruikt, raden we u aan IoT Explorer op een andere computer te installeren. Als u IoT Explorer niet wilt installeren, kunt u Azure CLI gebruiken om dezelfde stappen uit te voeren.
  • Azure CLI. U hebt twee opties voor het uitvoeren van Azure CLI-opdrachten in deze quickstart:
    • Gebruik De Azure Cloud Shell, een interactieve shell waarmee CLI-opdrachten in uw browser worden uitgevoerd. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u Cloud Shell voor het eerst gebruikt, meldt u zich aan bij Azure Portal. Volg de stappen in Aan de slag met Azure Cloud Shell om Cloud Shell te starten en selecteer de Bash-omgeving.
    • Voer desgewenst Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, voert u een az upgrade upgrade uit van de CLI en extensies naar de huidige versie. Zie Azure CLI installeren om Azure CLI te installeren. Als u Raspberry Pi als ontwikkelplatform gebruikt, raden we u aan Azure Cloud Shell te gebruiken of Azure CLI op een andere computer te installeren.

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 bidirectionele communicatie tussen uw IoT-toepassing en -apparaten.

Een IoT-hub en een resourcegroep maken:

  1. Azure CLI starten:

    • Als u Cloud Shell gebruikt, selecteert u de knop Uitproberen in de CLI-opdrachten om Cloud Shell te starten in een gesplitst browservenster. U kunt de Cloud Shell ook openen in een afzonderlijk browsertabblad.
    • Als u Azure CLI lokaal gebruikt, opent u een console zoals Windows CMD, PowerShell of Bash en meldt u zich aan bij Azure CLI.

    Als u de CLI-opdrachten in de rest van deze quickstart wilt uitvoeren: kopieer de syntaxis van de opdracht, plak deze in uw Cloud Shell-venster of CLI-console, bewerk variabelewaarden en druk op Enter.

  2. Voer az extension add uit om de azure-iot-extensie te installeren of bij te werken naar de huidige versie.

    Azure CLI 
    az extension add --upgrade --name azure-iot

  3. Voer 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 desgewenst een alternatieve locatie instellen. Als u de beschikbare locaties wilt zien, voert u de opdracht uit az account list-locations. In deze zelfstudie wordt gebruikgemaakt van eastus , zoals wordt weergegeven in de voorbeeldopdracht.

    Azure CLI 
    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 omringende 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.

    Azure CLI 
    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 desgewenst 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 and Play-modellen te lezen vanuit de openbare modelopslagplaats.

Notitie

U kunt ook de Azure CLI gebruiken om een apparaat te registreren. Gebruik de opdracht az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} 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 verbindingsreeks voor het apparaat op te halen. Zodra u het apparaat hebt genoteerd verbindingsreeks, kunt u verdergaan met het voorbeeld van het apparaat uitvoeren.

Ga als volgende te werk om een verbinding met uw IoT-hub toe te voegen:

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

    Azure CLI 
    az iot hub connection-string  show --hub-name {YourIoTHubName}

  2. Kopieer de verbindingsreeks zonder de omringende aanhalingstekens.

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

  4. Plak de verbindingsreeks in het vak Verbindingsreeks.

  5. Selecteer Opslaan.

    Schermopname van het toevoegen van een verbinding in IoT Explorer

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

Ga als volgende te werk om de openbare modelopslagplaats toe te voegen:

  1. In IoT Explorer selecteert u Start om terug te keren naar de startweergave.

  2. Selecteer in het linkermenu IoT Plug en Play Instellingen en selecteer vervolgens +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 apparaatexemplaren en registreert u dit bij de IoT-hub die u hebt gemaakt. U gebruikt de verbindingsgegevens voor het zojuist geregistreerde apparaat om uw apparaat veilig te verbinden in een latere sectie.

Een apparaat registreren:

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

  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 azure IoT Explorer-apparaat-id

  5. Gebruik de kopieerknoppen om het veld Primaire verbindingsreeks te kopiëren en te noteren. U hebt deze verbindingsreeks later nodig.

Het apparaatvoorbeeld uitvoeren

In deze sectie gebruikt u de Node.js SDK om berichten van een apparaat naar uw IoT-hub te verzenden. U voert een voorbeeld uit waarmee een temperatuurregelaar met twee thermostaatsensoren wordt geïmplementeerd.

  1. Open een nieuwe console, zoals Windows CMD, PowerShell of Bash. In de volgende stappen gebruikt u deze console om de Node.js SDK te installeren en te werken met Node.js voorbeeldcode.

    Notitie

    Als u een lokale installatie van Azure CLI gebruikt, zijn er mogelijk twee consolevensters geopend. Zorg ervoor dat u de opdrachten in deze sectie invoert in de console die u zojuist hebt geopend, niet degene die u voor de CLI hebt gebruikt.

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

    Console 
    git clone https://github.com/Azure/azure-iot-sdk-node

  3. Navigeer naar de voorbeeldmap:

    Windows

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

    Linux- of Raspberry Pi-besturingssysteem

    Console 
    cd azure-iot-sdk-node/device/samples/javascript

  4. Installeer de Azure IoT Node.js SDK en de benodigde afhankelijkheden:

    Console 
    npm install

    Met deze opdracht worden de juiste afhankelijkheden geïnstalleerd zoals opgegeven in het package.json-bestand in de map met apparaatvoorbeelden.

  5. Stel beide omgevingsvariabelen in om uw apparaat in staat te stellen verbinding te maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING. Gebruik voor de waarde van de variabele het apparaat verbindingsreeks dat 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 (Windows)

    Console 
    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

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

    Bash

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

  6. Voer het volgende codevoorbeeld uit:

    Console 
    node pnp_temperature_controller.js

    Notitie

    In dit codevoorbeeld wordt Gebruikgemaakt van Azure IoT Plug en Play, waarmee u slimme apparaten kunt integreren in uw oplossingen 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 PnP en cases voor het gebruik ervan of niet.

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 uw console.

Telemetrie bekijken

U kunt de telemetrie van het apparaat weergeven met IoT Explorer. U kunt desgewenst telemetrie bekijken 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 linkermenu voor uw apparaat.

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

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

    Schermopname van apparaattelemetrie in IoT Explorer

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

Als u telemetrie wilt lezen die door afzonderlijke apparaatonderdelen wordt verzonden, kunt u de plug-and-play-functies in IoT Explorer gebruiken. De temperatuurregelaar in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostaat1 en thermostaat2. De temperatuur die door thermostaat1 is gerapporteerd, bekijken:

  1. Selecteer op uw apparaat in IoT Explorer IoT Plug en Play onderdelen in het linkermenu. Selecteer vervolgens thermostaat1 in de lijst met onderdelen.

  2. Selecteer in het deelvenster thermostaat1 de optie Telemetrie in het bovenste menu.

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

Apparaattelemetrie weergeven met Azure CLI:

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

    Azure CLI 
    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}

  2. Bekijk de verbindingsgegevens en telemetrie-uitvoer in de console.

    Output 
    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 azure CLI en IoT Explorer om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT Device SDK-voorbeeld om een temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden. De voorbeeldtoepassing voor de temperatuurcontroller wordt uitgevoerd op uw lokale computer en genereert gesimuleerde sensorgegevens die naar IoT Hub moeten worden verzonden.

Vereisten

Deze quickstart wordt uitgevoerd op Windows, Linux en Raspberry Pi. Het is getest op de volgende besturingssysteem- en apparaatversies:

  • Windows 10 of Windows 11
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) versie 10, uitgevoerd op een Raspberry Pi 3 Model B+

Installeer de volgende vereisten op uw ontwikkelcomputer, behalve waar vermeld voor Raspberry Pi:

  • Als u geen Azure-abonnement hebt, kunt u er gratis een maken voordat u begint.
  • Git.
  • Python. Controleer de Azure IoT Python SDK op de huidige python-versievereisten. Voer uit python3 --versionom uw Python-versie te controleren.
  • Azure IoT Explorer: platformoverschrijdend, gui-gebaseerd hulpprogramma voor het bewaken en beheren van Azure IoT. Als u Raspberry Pi als uw ontwikkelplatform gebruikt, raden we u aan IoT Explorer op een andere computer te installeren. Als u IoT Explorer niet wilt installeren, kunt u Azure CLI gebruiken om dezelfde stappen uit te voeren.
  • Azure CLI. U hebt twee opties voor het uitvoeren van Azure CLI-opdrachten in deze quickstart:
    • Gebruik De Azure Cloud Shell, een interactieve shell waarmee CLI-opdrachten in uw browser worden uitgevoerd. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u Cloud Shell voor het eerst gebruikt, meldt u zich aan bij Azure Portal. Volg de stappen in Aan de slag met Azure Cloud Shell om Cloud Shell te starten en selecteer de Bash-omgeving.
    • Voer desgewenst Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, voert u een az upgrade upgrade uit van de CLI en extensies naar de huidige versie. Zie Azure CLI installeren om Azure CLI te installeren. Als u Raspberry Pi als ontwikkelplatform gebruikt, raden we u aan Azure Cloud Shell te gebruiken of Azure CLI op een andere computer te installeren.

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 bidirectionele communicatie tussen uw IoT-toepassing en -apparaten.

Een IoT-hub en een resourcegroep maken:

  1. Azure CLI starten:

    • Als u Cloud Shell gebruikt, selecteert u de knop Uitproberen in de CLI-opdrachten om Cloud Shell te starten in een gesplitst browservenster. U kunt de Cloud Shell ook openen in een afzonderlijk browsertabblad.
    • Als u Azure CLI lokaal gebruikt, opent u een console zoals Windows CMD, PowerShell of Bash en meldt u zich aan bij Azure CLI.

    Als u de CLI-opdrachten in de rest van deze quickstart wilt uitvoeren: kopieer de syntaxis van de opdracht, plak deze in uw Cloud Shell-venster of CLI-console, bewerk variabelewaarden en druk op Enter.

  2. Voer az extension add uit om de azure-iot-extensie te installeren of bij te werken naar de huidige versie.

    Azure CLI 
    az extension add --upgrade --name azure-iot

  3. Voer 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 desgewenst een alternatieve locatie instellen. Als u de beschikbare locaties wilt zien, voert u de opdracht uit az account list-locations. In deze zelfstudie wordt gebruikgemaakt van eastus , zoals wordt weergegeven in de voorbeeldopdracht.

    Azure CLI 
    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 omringende 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.

    Azure CLI 
    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 desgewenst 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 and Play-modellen te lezen vanuit de openbare modelopslagplaats.

Notitie

U kunt ook de Azure CLI gebruiken om een apparaat te registreren. Gebruik de opdracht az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} 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 verbindingsreeks voor het apparaat op te halen. Zodra u het apparaat hebt genoteerd verbindingsreeks, kunt u verdergaan met het voorbeeld van het apparaat uitvoeren.

Ga als volgende te werk om een verbinding met uw IoT-hub toe te voegen:

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

    Azure CLI 
    az iot hub connection-string  show --hub-name {YourIoTHubName}

  2. Kopieer de verbindingsreeks zonder de omringende aanhalingstekens.

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

  4. Plak de verbindingsreeks in het vak Verbindingsreeks.

  5. Selecteer Opslaan.

    Schermopname van het toevoegen van een verbinding in IoT Explorer

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

Ga als volgende te werk om de openbare modelopslagplaats toe te voegen:

  1. In IoT Explorer selecteert u Start om terug te keren naar de startweergave.

  2. Selecteer in het linkermenu IoT Plug en Play Instellingen en selecteer vervolgens +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 apparaatexemplaren en registreert u dit bij de IoT-hub die u hebt gemaakt. U gebruikt de verbindingsgegevens voor het zojuist geregistreerde apparaat om uw apparaat veilig te verbinden in een latere sectie.

Een apparaat registreren:

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

  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 azure IoT Explorer-apparaat-id

  5. Gebruik de kopieerknoppen om het veld Primaire verbindingsreeks te kopiëren en te noteren. U hebt deze verbindingsreeks later nodig.

Het apparaatvoorbeeld uitvoeren

In deze sectie gebruikt u de Python SDK om berichten van een apparaat naar uw IoT-hub te verzenden. U voert een voorbeeld uit waarmee een temperatuurregelaar met twee thermostaatsensoren wordt geïmplementeerd.

  1. Open een nieuwe console, zoals Windows CMD, PowerShell of Bash. In de volgende stappen gebruikt u deze console om de Python SDK te installeren en te werken met de Python-voorbeeldcode.

    Notitie

    Als u een lokale installatie van Azure CLI gebruikt, zijn er mogelijk twee consolevensters geopend. Zorg ervoor dat u de opdrachten in deze sectie invoert in de console die u zojuist hebt geopend, niet degene die u voor de CLI hebt gebruikt.

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

    Console 
    git clone --branch v2 https://github.com/Azure/azure-iot-sdk-python

  3. Navigeer naar de voorbeeldmap:

    Windows

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

    Linux- of Raspberry Pi-besturingssysteem

    Console 
    cd azure-iot-sdk-python/samples/pnp

  4. Installeer de Azure IoT Python SDK:

    Console 
    pip3 install azure-iot-device

  5. Stel de volgende omgevingsvariabelen in om uw apparaat in staat te stellen verbinding te maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING. Gebruik voor de waarde van de variabele het apparaat verbindingsreeks dat 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 (Windows)

    Console 
    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

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

    Bash

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

  6. Voer de code uit voor het volgende voorbeeldbestand.

    Console 
    python temp_controller_with_thermostats.py

    Notitie

    In dit codevoorbeeld wordt Gebruikgemaakt van Azure IoT Plug en Play, waarmee u slimme apparaten kunt integreren in uw oplossingen 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 gebruik 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 uw console.

Telemetrie bekijken

U kunt de telemetrie van het apparaat weergeven met IoT Explorer. U kunt desgewenst telemetrie bekijken 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 linkermenu voor uw apparaat.

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

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

    Schermopname van apparaattelemetrie in IoT Explorer

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

Als u telemetrie wilt lezen die door afzonderlijke apparaatonderdelen wordt verzonden, kunt u de plug-and-play-functies in IoT Explorer gebruiken. De temperatuurregelaar in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostaat1 en thermostaat2. De temperatuur die door thermostaat1 is gerapporteerd, bekijken:

  1. Selecteer op uw apparaat in IoT Explorer IoT Plug en Play onderdelen in het linkermenu. Selecteer vervolgens thermostaat1 in de lijst met onderdelen.

  2. Selecteer in het deelvenster thermostaat1 de optie Telemetrie in het bovenste menu.

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

Apparaattelemetrie weergeven met Azure CLI:

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

    Azure CLI 
    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}

  2. Bekijk de verbindingsgegevens en telemetrie-uitvoer in de console.

    Output 
    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: 28

event:
  component: thermostat2
  interface: dtmi:com:example:TemperatureController;2
  module: ''
  origin: mydevice
  payload:
    temperature: 10

Resources opschonen

Als u de Azure-resources die u in deze zelfstudie 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.

    Azure CLI 
    az group delete --name MyResourceGroup

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

    Azure CLI 
    az group list

Volgende stappen

In deze zelfstudie 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 apparaatexemplaren te maken. Vervolgens hebt u een Azure IoT-apparaat-SDK gebruikt om een temperatuurcontroller te maken, deze te verbinden met de hub en telemetrie te verzenden. U hebt ook Azure CLI gebruikt om telemetrie te bewaken.

Bekijk als volgende stap de volgende artikelen voor meer informatie over het bouwen van apparaatoplossingen met Azure IoT.

Een apparaat beheren dat is verbonden met een IoT-hub

Een apparaatoplossing bouwen met IoT Hub