Quickstart: Telemetrie verzenden vanaf een IoT-Plug en Play-apparaat naar Azure IoT Hub

Van toepassing op: ontwikkelaars van apparaattoepassingen

Code zoeken

In deze quickstart leert u een eenvoudige werkstroom voor het ontwikkelen van Azure IoT-toepassingen. U gebruikt de Azure CLI en IoT Explorer om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een azure IoT-apparaat-SDK-voorbeeld om een temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden. De voorbeeldtoepassing voor de temperatuurregelaar wordt uitgevoerd op uw lokale computer en genereert gesimuleerde sensorgegevens die naar IoT Hub 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 hulpprogramma op basis van gui 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. In deze quickstart hebt u twee opties voor het uitvoeren van Azure CLI-opdrachten:
    • 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 de Azure Portal. Volg de stappen in Cloud Shell quickstart naar Start Cloud Shell en Selecteer de Bash-omgeving.
    • Voer optioneel Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, voert u uit az upgrade om de CLI en extensies te upgraden naar de huidige versie. Zie Azure CLI installeren om Azure CLI te installeren. Als u Raspberry Pi als uw ontwikkelplatform gebruikt, raden we u aan Azure Cloud Shell te gebruiken of Azure CLI op een andere computer te installeren.

Installeer de overige vereisten voor uw besturingssysteem.

Linux- of Raspberry Pi-besturingssysteem

Installeer de volgende software om deze quickstart op Linux of 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

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

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

    Notitie

    Voor bestaande gebruikers van 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 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, kopieert u de syntaxis van de opdracht, plakt u deze in het Cloud Shell-venster of de CLI-console, bewerkt u variabelewaarden en drukt u op Enter.

  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 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 beschikbare locaties weer te geven az account list-locations. 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 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 ziet.

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

    Tip

    Nadat u een IoT-hub hebt gemaakt, gebruikt u Azure IoT Explorer om te communiceren met uw IoT-hub in de rest van deze quickstart. 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 uit 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 connection string voor het apparaat op te halen. Zodra u de connection string van het apparaat hebt genoteerd, kunt u verdergaan met Het apparaatvoorbeeld uitvoeren.

Een verbinding toevoegen aan uw IoT-hub:

  1. Voer 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 omringende 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 tot stand is gebracht, schakelt IoT Explorer over naar de weergave Apparaten .

Ga als volgende te werk om de opslagplaats voor openbare modellen toe te voegen:

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

  2. Selecteer in het linkermenu IoT Plug en Play Instellingen, 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 apparaatexemplaar 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 weergave Start in IoT Explorer.

  2. De verbinding die u eerder hebt toegevoegd, wordt weergegeven. Selecteer Apparaten in deze hub weergeven 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 connection string te kopiëren en te noteren. U hebt deze connection string 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-apparaat-SDK te installeren en voer het codevoorbeeld uit. Voor Windows selecteert u Start, typt u Opdrachtprompt voor ontwikkelaars voor VS 2019 en opent u de console. Voor Linux en Raspberry Pi OS opent u een terminal voor Bash-opdrachten.

    Notitie

    Als u een lokale installatie van Azure CLI gebruikt, hebt u nu mogelijk twee consolevensters geopend. Zorg ervoor dat u de opdrachten in deze sectie invoert in de console die u zojuist hebt geopend, niet de opdrachten 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:

    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:

    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:

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

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

    Dit codevoorbeeld maakt gebruik 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 PnP en cases voor het wel of niet gebruiken ervan.

Het voorbeeld maakt veilig verbinding met uw IoT-hub wanneer 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. Optioneel kunt u 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 linkermenu van 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 apparaattelemetrie in IoT Explorer

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

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

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

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

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

Telemetrie van apparaten weergeven met Azure CLI:

  1. Voer de opdracht az iot hub monitor-events uit om gebeurtenissen te controleren die vanaf het apparaat naar uw IoT-hub worden verzonden. Gebruik de namen die u eerder in Azure IoT hebt gemaakt 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 en IoT Explorer om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een azure IoT-apparaat-SDK-voorbeeld om een temperatuurcontroller uit te voeren, deze veilig te verbinden met de hub en telemetrie te verzenden. De voorbeeldtoepassing voor de temperatuurregelaar wordt uitgevoerd op uw lokale computer en genereert gesimuleerde sensorgegevens die naar IoT Hub 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. Voer dotnet --infouit om de versie van de .NET SDK en runtime te controleren die op uw computer zijn geïnstalleerd.

    • Voor Windows en Linux (met uitzondering van Raspberry Pi) volgt u de instructies om de .NET Core SDK 3.1 op uw platform te installeren.
    • Voor Raspberry Pi moet u de instructies volgen om de SDK handmatig te installeren. Dit komt omdat op Debian, pakketbeheer installaties van de .NET SDK alleen worden ondersteund voor de x64-architectuur.
  • Azure IoT Explorer: platformoverschrijdend hulpprogramma op basis van gui 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. In deze quickstart hebt u twee opties voor het uitvoeren van Azure CLI-opdrachten:

    • 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 de Azure Portal. Volg de stappen in Cloud Shell quickstart naar Start Cloud Shell en Selecteer de Bash-omgeving.
    • Voer optioneel Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, voert u uit az upgrade om de CLI en extensies te upgraden naar de huidige versie. Zie Azure CLI installeren om Azure CLI te installeren. Als u Raspberry Pi als uw 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 te upgraden naar de huidige versie.

    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. Voer uit om beschikbare locaties te az account list-locationszien. 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 omringende accolades in de volgende opdracht met 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 overal waar u de tijdelijke aanduiding ziet.

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

    Tip

    Nadat u een IoT-hub hebt gemaakt, gebruikt u Azure IoT Explorer om te communiceren met uw IoT-hub in de rest van deze quickstart. 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 en play-modellen uit de openbare modelopslagplaats te lezen.

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 connection string voor het apparaat op te halen. Nadat u de connection string van het apparaat hebt genoteerd, kunt u verdergaan naar Het apparaatvoorbeeld uitvoeren.

Een verbinding toevoegen aan uw IoT-hub:

  1. Voer 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 omringende 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 tot stand is gebracht, 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 linkermenu IoT Plug en Play Instellingen, 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 deze 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 weergave Start in IoT Explorer.

  2. De verbinding die u eerder hebt toegevoegd, wordt weergegeven. Selecteer Apparaten in deze hub weergeven 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 connection string te kopiëren en te noteren. U hebt deze connection string 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 met Node.js voorbeeldcode te werken.

    Notitie

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

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

    git clone https://github.com/Azure/azure-iot-sdk-csharp.git
    
  3. Navigeer naar de voorbeeldmap:

    Windows

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

    Linux- of Raspberry Pi-besturingssysteem

    cd azure-iot-sdk-csharp/iothub/device/samples/solutions/PnpDeviceSamples/TemperatureController
    
  4. Installeer de Azure IoT C#-SDK en de benodigde afhankelijkheden:

    dotnet restore
    

    Met deze opdracht installeert u de juiste afhankelijkheden zoals opgegeven in het bestand TemperatureController.csproj .

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

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING. Gebruik voor de variabelewaarde de apparaat-connection string die 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)

    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

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  6. Voer het codevoorbeeld uit:

    dotnet run
    

    Notitie

    Dit codevoorbeeld maakt gebruik 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 PnP en cases voor het wel of 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 uw console.

Telemetrie bekijken

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

Telemetrie weergeven in Azure IoT Explorer:

  1. Selecteer in 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 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 telemetriegegevens wilt lezen die door afzonderlijke apparaatonderdelen zijn verzonden, kunt u de plug-and-play-functies in IoT Explorer gebruiken. De temperatuurregelaar in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostat1 en thermostat2. Ga als volgende te werk om de temperatuur te bekijken die door thermostat1 wordt gerapporteerd:

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

  2. Selecteer in het deelvenster thermostaat1 van het onderdeel 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.

Telemetrie van apparaten weergeven met Azure CLI:

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

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Bekijk de verbindingsdetails 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 en IoT Explorer om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT-apparaat-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 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 hulpprogramma op basis van gui 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. In deze quickstart hebt u twee opties voor het uitvoeren van Azure CLI-opdrachten:
    • Gebruik de Azure Cloud Shell, een interactieve shell die CLI-opdrachten uitvoert in uw browser. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u Cloud Shell voor het eerst gebruikt, meldt u zich aan bij de Azure Portal. Volg de stappen in Cloud Shell quickstart naar Start Cloud Shell en Selecteer de Bash-omgeving.
    • Voer optioneel Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, voert u uit az upgrade om de CLI en extensies bij te werken naar de huidige versie. Zie Azure CLI installeren om Azure CLI te installeren. Als u Raspberry Pi als uw 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 van 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 de download naar een lokale map hebt uitpakken, voegt u het volledige pad naar de map Maven /bin toe aan de Windows-omgevingsvariabele PATH .

Linux- of Raspberry Pi-besturingssysteem

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

Notitie

De 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 de versie van Java te controleren die 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):

      sudo apt update
      sudo apt install default-jdk
      

      U kunt ook een versie van de JDK opgeven die u wilt installeren. Bijvoorbeeld:

      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 (automatisch) van Java en de Java-compiler te configureren.

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

      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 shellomgeving in. U wordt aangeraden de opdracht toe te voegen aan uw ~/.bashrc bestand of /etc/profile om deze beschikbaar te maken wanneer u een nieuwe shell opent.

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

      java -version
      javac -version
      echo $JAVA_HOME
      
  • Apache Maven 3. U kunt de mvn --version opdracht gebruiken om de versie van Maven te controleren die op uw systeem is geïnstalleerd.

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

      sudo apt-get update
      sudo apt-get install maven
      
    2. Voer de volgende opdracht in om uw installatie te controleren.

      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 te upgraden naar de huidige versie.

    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. Voer uit om beschikbare locaties te az account list-locationszien. 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 omringende accolades in de volgende opdracht met 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 overal waar u de tijdelijke aanduiding ziet.

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

    Tip

    Nadat u een IoT-hub hebt gemaakt, gebruikt u Azure IoT Explorer om te communiceren met uw IoT-hub in de rest van deze quickstart. 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 en play-modellen uit de openbare modelopslagplaats te lezen.

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 connection string voor het apparaat op te halen. Nadat u de connection string van het apparaat hebt genoteerd, kunt u verdergaan naar Het apparaatvoorbeeld uitvoeren.

Een verbinding toevoegen aan uw IoT-hub:

  1. Voer 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 omringende 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 tot stand is gebracht, 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 linkermenu IoT Plug en Play Instellingen, 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 deze 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 weergave Start in IoT Explorer.

  2. De verbinding die u eerder hebt toegevoegd, wordt weergegeven. Selecteer Apparaten in deze hub weergeven 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 connection string te kopiëren en te noteren. U hebt deze connection string 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, hebt u nu mogelijk twee consolevensters geopend. Zorg ervoor dat u de opdrachten in deze sectie invoert in de console die u zojuist hebt geopend, niet de console die u hebt gebruikt voor de CLI.

    Linux en Raspberry Pi OS

    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:

    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.

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

    Deze bewerking duurt enkele minuten.

  4. Stel de volgende omgevingsvariabelen in zodat uw apparaat verbinding kan maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING. Gebruik voor de variabelewaarde de apparaat-connection string die 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"
    
  5. Navigeer naar de voorbeeldmap.

    CMD

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

    Bash

    cd device/iot-device-samples/pnp-device-sample/temperature-controller-device-sample
    
  6. Voer het codevoorbeeld uit.

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

    Notitie

    Dit codevoorbeeld maakt gebruik 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 PnP en cases voor het wel of 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 uw console.

Telemetrie bekijken

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

Telemetrie weergeven in Azure IoT Explorer:

  1. Selecteer in 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 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 telemetriegegevens wilt lezen die door afzonderlijke apparaatonderdelen zijn verzonden, kunt u de plug-and-play-functies in IoT Explorer gebruiken. De temperatuurregelaar in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostat1 en thermostat2. Ga als volgende te werk om de temperatuur te bekijken die door thermostat1 wordt gerapporteerd:

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

  2. Selecteer in het deelvenster thermostaat1 van het onderdeel 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.

Telemetrie van apparaten weergeven met Azure CLI:

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

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Bekijk de verbindingsdetails 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 en IoT Explorer om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT-apparaat-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 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. Voer uit node --versionom de versie van uw knooppunt te controleren.
  • Azure IoT Explorer: platformoverschrijdend hulpprogramma op basis van gui 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. In deze quickstart hebt u twee opties voor het uitvoeren van Azure CLI-opdrachten:
    • 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 de Azure Portal. Volg de stappen in Cloud Shell quickstart naar Start Cloud Shell en Selecteer de Bash-omgeving.
    • Voer optioneel Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, voert u uit az upgrade om de CLI en extensies te upgraden naar de huidige versie. Zie Azure CLI installeren om Azure CLI te installeren. Als u Raspberry Pi als uw 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, kopieert u de syntaxis van de opdracht, plakt u deze in het Cloud Shell-venster of de CLI-console, bewerkt u variabelewaarden en drukt u op Enter.

  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 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 beschikbare locaties weer te geven az account list-locations. 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 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 ziet.

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

    Tip

    Nadat u een IoT-hub hebt gemaakt, gebruikt u Azure IoT Explorer om te communiceren met uw IoT-hub in de rest van deze quickstart. 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 uit 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 connection string voor het apparaat op te halen. Zodra u de connection string van het apparaat hebt genoteerd, kunt u verdergaan met Het apparaatvoorbeeld uitvoeren.

Een verbinding toevoegen aan uw IoT-hub:

  1. Voer 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 omringende 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 tot stand is gebracht, schakelt IoT Explorer over naar de weergave Apparaten .

Ga als volgende te werk om de opslagplaats voor openbare modellen toe te voegen:

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

  2. Selecteer in het linkermenu IoT Plug en Play Instellingen, 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 apparaatexemplaar 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 weergave Start in IoT Explorer.

  2. De verbinding die u eerder hebt toegevoegd, wordt weergegeven. Selecteer Apparaten in deze hub weergeven 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 connection string te kopiëren en te noteren. U hebt deze connection string 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, hebt u nu mogelijk twee consolevensters geopend. Zorg ervoor dat u de opdrachten in deze sectie invoert in de console die u zojuist hebt geopend, niet de opdrachten die u voor de CLI hebt gebruikt.

  2. Kloon 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 voorbeeldmap:

    Windows

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

    Linux- of Raspberry Pi-besturingssysteem

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

    npm install
    

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

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

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING. Gebruik voor de waarde van de variabele de apparaat-connection string die 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)

    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

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  6. Voer het volgende codevoorbeeld uit:

    node pnp_temperature_controller.js
    

    Notitie

    Dit codevoorbeeld maakt gebruik 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 PnP en cases voor het wel of 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 uw console.

Telemetrie bekijken

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

Telemetrie weergeven in Azure IoT Explorer:

  1. Selecteer in 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 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 telemetriegegevens wilt lezen die door afzonderlijke apparaatonderdelen zijn verzonden, kunt u de plug-and-play-functies in IoT Explorer gebruiken. De temperatuurregelaar in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostat1 en thermostat2. Ga als volgende te werk om de temperatuur te bekijken die door thermostat1 wordt gerapporteerd:

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

  2. Selecteer in het deelvenster thermostaat1 van het onderdeel 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.

Telemetrie van apparaten weergeven met Azure CLI:

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

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Bekijk de verbindingsdetails 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 en IoT Explorer om een Azure IoT-hub en een apparaat te maken. Vervolgens gebruikt u een Azure IoT-apparaat-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 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.
  • Python versie 3.7 of hoger. Voer uit python3 --versionom uw Python-versie te controleren.
  • Azure IoT Explorer: platformoverschrijdend hulpprogramma op basis van gui 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. In deze quickstart hebt u twee opties voor het uitvoeren van Azure CLI-opdrachten:
    • Gebruik de Azure Cloud Shell, een interactieve shell die CLI-opdrachten uitvoert in uw browser. Deze optie wordt aanbevolen omdat u niets hoeft te installeren. Als u Cloud Shell voor het eerst gebruikt, meldt u zich aan bij de Azure Portal. Volg de stappen in Cloud Shell quickstart naar Start Cloud Shell en Selecteer de Bash-omgeving.
    • Voer optioneel Azure CLI uit op uw lokale computer. Als Azure CLI al is geïnstalleerd, voert u uit az upgrade om de CLI en extensies bij te werken naar de huidige versie. Zie Azure CLI installeren om Azure CLI te installeren. Als u Raspberry Pi als uw 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 te upgraden naar de huidige versie.

    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. Voer uit om beschikbare locaties te az account list-locationszien. 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 omringende accolades in de volgende opdracht met 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 overal waar u de tijdelijke aanduiding ziet.

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

    Tip

    Nadat u een IoT-hub hebt gemaakt, gebruikt u Azure IoT Explorer om te communiceren met uw IoT-hub in de rest van deze quickstart. 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 en play-modellen uit de openbare modelopslagplaats te lezen.

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 connection string voor het apparaat op te halen. Nadat u de connection string van het apparaat hebt genoteerd, kunt u verdergaan naar Het apparaatvoorbeeld uitvoeren.

Een verbinding toevoegen aan uw IoT-hub:

  1. Voer 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 omringende 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 tot stand is gebracht, 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 linkermenu IoT Plug en Play Instellingen, 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 deze 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 weergave Start in IoT Explorer.

  2. De verbinding die u eerder hebt toegevoegd, wordt weergegeven. Selecteer Apparaten in deze hub weergeven 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 connection string te kopiëren en te noteren. U hebt deze connection string 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, hebt u nu mogelijk twee consolevensters geopend. Zorg ervoor dat u de opdrachten in deze sectie invoert in de console die u zojuist hebt geopend, niet de console die u hebt gebruikt voor de CLI.

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

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

    Windows

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

    Linux- of Raspberry Pi-besturingssysteem

    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 apparaat verbinding kan maken met Azure IoT.

    • Stel een omgevingsvariabele in met de naam IOTHUB_DEVICE_CONNECTION_STRING. Gebruik voor de variabelewaarde de apparaat-connection string die 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)

    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

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

    python3 temp_controller_with_thermostats.py
    

    Notitie

    Dit codevoorbeeld maakt gebruik 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 wel of 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 uw console.

Telemetrie bekijken

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

Telemetrie weergeven in Azure IoT Explorer:

  1. Selecteer in 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 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 telemetriegegevens wilt lezen die door afzonderlijke apparaatonderdelen zijn verzonden, kunt u de plug-and-play-functies in IoT Explorer gebruiken. De temperatuurregelaar in deze quickstart heeft bijvoorbeeld twee thermostaten: thermostat1 en thermostat2. Ga als volgende te werk om de temperatuur te bekijken die door thermostat1 wordt gerapporteerd:

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

  2. Selecteer in het deelvenster thermostaat1 van het onderdeel 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.

Telemetrie van apparaten weergeven met Azure CLI:

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

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Bekijk de verbindingsdetails 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 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.