Übersicht MQTT  IO


Mit diesem Funktionsbaustein können Adressen als MQTT Nachrichten gesendet und empfangen werden. Das Topic ist hierbei die Adresse, beispielsweise "100/10/1", die Nachricht ist der Wert der Variable. Es können Variablen Gruppen durch Auswahl der Hauptgruppe übertragen werden, die Übertragung ist hierbei bidirektional.

Fremdsoftware wie z.B. IOBroker, Node-RED oder Home Assistant können über MQTT Clients mit der Runtime kommunizieren.

Eine ausführliche Schritt-für-Schritt-Anleitung mit Beispielen finden Sie unter Anbindung an Node-RED und Home Assistant.

Wichtig: Für diese Funktion muss die Steuerung eine Image Version 3.034 oder höher haben.

Siehe auch MQTT Allgemein.


Ausgänge
VB
 Verbunden
 Ausgang ist 1 wenn mit MQTT Broker verbunden.



Parameter
Filter Hauptgruppe
 In diesem Parameter werden die Hauptgruppen der Variablen angegeben welche über MQTT gesendet und empfangen werden. Mehrere Hauptgruppen können durch Semikolon ";" getrennt angegeben werden.
Typ Bitvariable
 Dieser Parameter legt fest wie Bitvariablen gesendet werden:
  • 0/1: Variablen werden als 0 oder 1 gesendet.
  • on/off: Variablen werden als on/off gesendet, 0=off, 1=on
  • true/false: Variablen werden als true/false gesendet, 0=false, 1=true
Server Typ
 Intern: Der in der Steuerung integrierte MQTT Broker wird verwendet, weitere Einstellungen sind nicht nötig. Extern: Ein externer MQTT Broker wird verwendet, dazu Server, Port und optional Benutzer/Passwort und TLS angeben.
Server
 IP Adresse des MQTT Brokers. Soll der integrierte Broker an der Steuerung verwendet werden muss als IP Adresse 127.0.0.1 angegeben werden. Als Adresse können auch Domain Namen verwendet werden.
Server Port
 Port, Standard ist 1883.
Benutzer/Passwort
 Optional Benutzer und Passwort falls vom MQTT Broker benötigt. Der interne MQTT Broker an der Steuerung verwendet keine Authentifizierung und Benutzer/Passwort können leer gelassen werden.
Topic Präfix
 Optionales Topic, dieses wird den Adressen vorangestellt. Standard ist "uniPRO", damit ergibt sich mit der Adresse "1/2/3" das Topic "uniPRO/1/2/3". Bei aktiviertem Home Assistant Auto Discovery muss der Standardwert "uniPRO" beibehalten werden.
Modus
 Lesen, Schreiben, Lesen/Schreiben. Damit kann eingestellt werden ob der Baustein nur empfängt, sendet oder bidirektional arbeitet. Es wird empfohlen für senden und empfangen zwei verschiedene Bausteine mit unterschiedlichen Hauptgruppen zu verwenden.
Beim Start aktualisieren
 Beim Start der Steuerung werden alle Adressen der eingestellten Hauptgruppen an den MQTT Broker gesendet.
Zyklisch aktualisieren
 Zeit in Sekunden. In diesem Intervall werden alle Adressen der eingestellten Hauptgruppen an den MQTT Broker gesendet. Bei 0 werden die Adressen nicht zyklisch gesendet.
Retain
 Der Broker speichert die letzte Nachricht jedes Topics und liefert diese an neue Abonnenten sofort aus. Empfohlen, damit Fremdsysteme nach einem Neustart sofort alle Werte kennen.
TLS / Zertifikat prüfen
 Verschlüsselte Verbindung zu einem externen MQTT Broker. Mit "Zertifikat prüfen" wird zusätzlich das Serverzertifikat geprüft.
Home Assistant Auto Discovery Mit diesem Parameter werden MQTT Nachrichten für das auto Discovery von Home Assistant für jede Variable erzeugt. Diese werden dann im Home Assistant automatisch als Entitäten angezeigt. Zurzeit werden nur Elemente mit "number" unterstützt. Das Topic Präfix muss dabei auf dem Standardwert "uniPRO" bleiben. Siehe auch Anbindung an Node-RED und Home Assistant.




Siehe auch allgemeine Parameter aller Funktionsbausteine.