Der MQTT-Treiber unterstützt einen Modus, mit welchem Datenpunkte über MQTT an den Azure IoT Hub übertragen werden können.

Zuweisung von Nachrichten zu Datenpunkten
Zur Zuweisung von Datenpunkten und Nachrichten können entweder, wie beim MQTT-Treiber, Templates genutzt werden, oder aber Nachrichten-Properties. Jede Nachricht, die vom Gateway an den Azure IoT-Hub gesendet wird, enthält ein Adress-Property, dessen Wert die Adresse des Datenpunkts enspricht. Entsprechend muss auch jede Nachricht, die vom Azure IoT Hub an das Gateway geschickt wird, dieses Property nutzen. Per Default ist der Key des Adress-Properties “adr”.

Konfiguration
Folgende Einstellungen in den entsprechenden Abschnitten müssen gesetzt sein.

User

TLS

Internal

Datenpunkte
Alle MQTT-Datenpunkte und alle Optionen werden auch im Azure-Modus unterstützt. Anstatt dass die Datenpunkt-Adresse einen Topic entspricht, entspricht die Adresse jedoch den Wert eines “Adressen”-Propertys, welcher bei Device-to-Cloud-Nachrichten vom Gateway gesetzt wird und entsprechend bei Cloud-to-Device-Nachrichten gesetzt sein muss.

Weitere Properties
Beim Versenden können weitere Properties angegeben werden. Die Properties können im format-String über ‘properties:““’ gesetzt werden. Die Properties haben das Format”key[=value]“. Es können mehrere Properties genutzt werden, indem die Properties mit’&’ getrennt werden.

Beispiele
Mit den Datenpunkt

könnte der freie Speicher des Gateways an den Azure IoT Hub gesendet werden. Die Nachricht wird immer mit den Property “adr=freemem” verschickt und es werden zusätzlich die Properties “system” und “unit=kb” genutzt.

Mit den Datenpunkt

können Cloud to Device Nachrichten empfangen werden, die das Property “adr=speed” gesetzt haben.

System-Kommandos
Alle Systemkommandos, die der MQTT-Treiber unterstützt, werden auch im Azure-Modus unterstützt. Auch hier werden die Topics jedoch in Nachrichten- Properties umgewandelt.

Im Folgenden sind die Key-Value-Paare für die Sys-Kommandos aufgelistet. Kursive Values müssen entsprechend eingesetzt werden. Bei eingeklammerte Values muss sich für eines der Values, die durch “|” getrennt sind, entschieden werden.

Herunterladen/Hochladen von Konfigurationsdateien

• cmd=(get|set)

• type=file

• file=(config|dispatch|datapoints)

• route=route

Datenpunkte konfigurieren

• cmd=set

• type=datapoints

Neustart des Gateways

• cmd=gateway

• action=restart

BACnet-Scan

• cmd=scan

• driver=bacnet

Empfangen und Senden großer Nachrichten
Größere Nachrichten, wie zum Beispiel Scan-Ergebnisse, werden vom Treiber automatisch in mehrere Nachrichten, so genannte “Chunks” aufgeteilt, wenn die Nachricht zu groß wird.

Jede Nachricht, die in Chunks aufgeteilt wird, hat eine eindeutige ID. Jeder Chunk enthält diese ID und zusätzlich die Anzahl der Chunks, aus den die Nachricht besteht und den aktuellen Chunk Index.

Die Nachrichten IDs, die das Gateway erstellt, besteht aus 34 Hexzahlen, die jeweils aus 2 Zeichen bestehen. Ingesamt ist die ID also 68 Zeichen lang. Die letzten 32 Hex-Zahlen der ID sind ein SHA-3 256 Hash des Payloads der Nachricht. Dieser Hash kann dazu genutzt werden, um zu überprüfen, ob die Nachricht richtig empfangen und zusammen gebaut wurde. Die ersten 2 Hex-Zeichen sind zur Unterscheidung von gleichen Payloads vorhanden. Es handelt sich dabei aktuell um einen 4-Byte großen Counter, der für jede Nachricht hochgezählt wird. Die IDs von eingehenden Nachrichten können beliebig gewählt werden. Das Gateway nutzt die ID ausschließlich zur Identifizierung der Chunks und verarbeitet die ID nicht weiter.

Der Chunk Index startet bei 0.

Es kann in der Treiber-Konfiguration unter INTERNAL ein Timeout in Sekunden für das Empfangen von Chunks mit ChunkTimeout konfiguriert werden. Dieser Timeout wird bei jedem empfangenen Chunk zurückgesetzt. Wenn der Timeout erreicht ist, wird die entsprechende Nachricht verworfen.

Wenn ein Chunk nicht verarbeitet werden kann, erfolgt kein Feedback über mqtt aber es wird eine Fehlermeldung in den Log geschrieben.

Die maximale Nachrichtengröße wird automatisch auf 256.000 Bytes gesetzt, kann aber überschrieben werden.

Im Azure-Modus wird die ID, der Index und die Anzahl an chunks in das Property-Bag geschrieben. Alle Zahlen werden als Hexzahlen dargestellt. Der Property-Name des Chunk-Indexs ist ‘chunk_index’, der Chunk-Anzahl ist ‘chunk_count’ und der Name der ID ist ‘msg_id’.

Ein Beispiel-Property-Bag einer ausgehenden Nachricht des Gateways für den ersten Chunk wäre: