IoT Export
Verbindungs Template

Azure IoT Core Client

5min

Verfügbar auf dem BSC-Pro ab Version 3.7.0

Einleitung

Das Export Modul "Azure IoT Core Client" stellt per MQTT eine Verbindung zu einer Azure IoT Hub Instanz her.

Die Gerätedaten werden nach Definition des Simple IoT Core Datenmodell übertragen.

Zur Verwaltung der Logikfunktionen wird das Datenmodell des IoT Logic Core verwendet.

Entsprechende Kommandos sind im IoT Command Core Datenmodell definiert.

Alle Objekte werden als Telemetrienachrichten übertragen. Kommandos können per C2D Nachricht an das Gateway übermittelt werden.

Konfiguration

Im Bereich IoT Export der Web Konfiguration oder der BSC Remote kann die Export Verbindung angelegt werden.

Parameter

Die Parameter werden mit den im "Connection String" enthaltenen Werten ausgefüllt.

Parameter

Standardwert

Mögliche Werte

Beschreibung

Host





Der Hostname der IoT Hub Instanz.

ID

<Hardware ID>



Die eindeutige Geräte ID welche im IoT Hub verwendet wird.

Key





Der Gerätekey aus dem IoT Hub.

Watchdog Timeout

Disabled

  • Disabled
  • 1 min
  • ...
  • 7 days

Wenn die Verbindung sich für diesen Zeitraum in einem fehlerhaften oder nicht verbundenem Zustand befindet, wird das System neugestartet.

Refresh all objects after connect

Disabled

  • Enabled
  • Disabled

Falls aktiviert, werden nach jedem erfolgreichen Verbindungsaufbau alle Objekte synchronisiert.

Nach einem Neustart des Gerätes werden unabhängig von dieser Einstellung, initial alle Objekte synchronisiert.

Send thing descriptions

Disabled

  • Enabled
  • Disabled

Steuerung ob Beschreibungen der unterstützten Geräte übertragen werden sollen.

Die Aktualisierung der Objektdaten kann auch manuell per Kommando aus dem IoT Command Core angestoßen werden.



Einrichtung im Detail

1

Gerät im Azure IoT Hub anlegen

Sie müssen eine Geräte ID festlegen. Diese kann freigewählt werden, wir empfehlen jedoch die Hardware ID des Systems zu verwenden. Als Authentifizierungstyp wird "Symetrischer Schlüssel" ausgewählt. Sie können das Gerät nun abspeichern.

Document image

Document image


Die Hardware ID Ihres Systems finden Sie in der Webkonfiguration unter System->Status.



2

Primäre Verbindungszeichenfolge kopieren

Öffnen Sie nun die Detailseite des Gerätes indem Sie dieses in der Übersicht anklicken. Kopieren Sie nun die "Primäre Verbindungszeichenfolge". Diese enthält die Informationen welche in der Konfiguration des IoT Export Moduls benötigt werden.

Document image

3

IoT Export anlegen

Folgende Felder aus der "Primären Verbindungszeichenfolge" werden benötigt. Den Namen können Sie frei vergeben.

Azure Connection String Feld

IoT Export Parameter

DeviceId

ID

HostName

Host

SharedAccessKey

Key

Sobald Sie alle Felder ausgefüllt haben können Sie die Verbindung abspeichern. Die Verbindung wird kurz danach als online angezeigt. Sollte dies nicht der Fall sein, kontrollieren Sie bitte ob Sie alle Parameter korrekt gesetzt haben.