Beispiel: Verwenden der Bibliothek Azure IoT Hub Client SL

Richten Sie das "Azure IoT Hub" ein und legen Sie Geräte im "Azure IoT Hub" an.

Generieren Sie "Shared Access Signatures" (SaS-Token).

Die Authentifizierung eines Gerätes erfolgt über "Shared Access Signatures" (SaS-Token).

Für den Zugriff via MQTT wird ein SaS-Token basierend auf der Geräterichtlinie "device" benötigt.

Für den Zugriff via HTTPS wird ein SaS-Token auf Basis der Geräterichtlinie "device" und ein SaS-Token auf Basis der Richtlinie "iothubowner" benötigt.

Die Generierung des SaS-Token kann über die Azure Cloud Shell (Azure Portal), über das Tool "Azure IoT Explorer" oder direkt über die Bibliotheksfunktion GenerateSasToken erfolgen.

Die Funktion GenerateSasToken benötigt 4 Eingangsparameter (URL-Adresse, Primary Key, Policy Name, Expiry) und liefert einen SaS-Token als WSTRING(255) zurück.

1. Starten Sie die Cloud Shell über das Azure Portal.

   

2. Generieren Sie einen SaS-Token device:

   az iot hub generate-sas-token -d YOUR_DEVICE_ID -n YOUR_IOT_HUB --du DURATION_IN_SECONDS --policy device

3. Generieren Sie den SaS-Token iothubowner:

   az iot hub generate-sas-token -n YOUR_IOT_HUB --du DURATION_IN_SECONDS

   Abbildung 10. Generierte SaS-Token

   
   
   

Setzen Sie im Beispielprojekt die Namen des IoT-Hubs, der DeviceId und der SaS-Token :

sSubDomainName: Name des "Azure IoT Hub"s ohne "azure-devices.net" (siehe Schritt 1)

sDeviceId: ID des Geräts

wsDeviceSaS: SaS-Token des Geräts (MQTT, HTTP) (siehe Schritt 2)

wsIoTHubOwnerSaS: SaS-Token des IoT Hub Owners (HTTP) (siehe Schritt 2)

Laden Sie das Projekt auf Ihre Steuerung und starten Sie die Applikationen.

1. Starten Sie Applikation AzureHTTPDemo.

   Über die Visualisierung können Sie folgende Funktionen ausführen:

   Send D2C Message

   Get C2D Message

   Get Device Twin

   Update Device Twin

2. Starten Sie Applikation AzureMQTTDemo.

   Über die Visualisierung können Sie folgende Funktionen ausführen:

   • Herstellen einer MQTT Verbindung

   • Send D2C Message

   • Get C2D Message

   • Get Device Twin

   • Update Device Twin

   • Methodenaufruf Direct method call

   • Subscribe Device Twin (desired)

Senden und empfangen Sie Nachrichten mit dem Tool Azure IoT Explorer.

Mit dem Tool Azure IoT Explorer können Nachrichten angezeigt und versendet werden. Den Download-Link dazu finden Sie unten.

Abbildung 11. Azure IoT Explorer: Monitoring von D2C-Nachrichten

Abbildung 12. Azure IoT Explorer: Senden von D2C-Nachrichten

Abbildung 13. Azure IoT Explorer: Entfernter Methodenaufruf