Dokumentation des Elvis-Pakets „MQTT“
Übersicht
MQTT ist ein Kommunikationsprotokoll aus dem IoT-Bereich. Siehe auch https://de.wikipedia.org/wiki/MQTT und http://mqtt.org/.
Vorgehensweise
Nach dem Einfügen des Pakets über den Paket-Manager (ab Elvis 3.3.114) in das Server-Projekt steht der neue Anschluss-Treiber „MQTTDriver“ zur Verfügung.
Als Nächstes ist im Server-Projekt ein neuer Datenpunkt-Anschluss zu erstellen: Rechtsklick auf das Serverprojekt -> Hinzufügen -> Serverdaten hinzufügen -> Anschluss mit Datenpunkten. Die zugehörige *.elvissc-Datei sollte dabei gleich einen entsprechenden Namen erhalten.
Anschließend erstellt man in dieser Datei durch Klick auf das grüne Kreuz einen ersten Tabelleneintrag, d.h. eine neue Port-Instanz, und wählt dazu in der Spalte „Treibertyp“ die Option „MQTTDriver“ aus. Die Konfiguration dieses neuen Ports erfolgt im Eigenschaftsfenster; es muss mindestens der Hostname des MQTT-Brokers angegeben werden.
Nun kann man Datenpunkte für diesen Anschluss für die einzelnen zu übertragenden Daten anlegen. Als Adresse gibt man den MQTT-Topicnamen an.
Details
Persistente Session
Der Anschluss benutzt eine persistente Session, wenn es empfangende Datenpunkte gibt. Wird an den zugeordneten Datenpunkten im Designer etwas geändert, erzeugt das eine neue Session ID, so dass eine evtl. in einem früheren Lauf schon erzeigte persistente Session verworfen wird.
Quality Of Service (QOS)
Standardmäßig wird für Wert-Datenpunkte „At least once“ (1), für Befehlsdatenpunkte „Exactly once“ (2) benutzt. Ein abweichender QOS-Level kann in der Server-Info des Datenpunkttyps als „Q=0“, „Q=1“ oder „Q=2“ angegeben werden.
Retain
Das Retain-Flag wird für Wert-Datenpunkte gesetzt, für Befehls-Datenpunkte nicht gesetzt.
Releasenotes mit Versionsinformationen (PDF)
