Ü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 Adresse. Es können Adressgruppen 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 Adressen angegeben welche über MQTT gesendet und empfangen werden. Mehrere Hauptgruppen können durch Semikolon ";" getrennt angegeben werden. Bleibt der Filter leer, sendet der Baustein keine Adressen; empfangen werden dann wie bisher alle Adressen des Projekts. Den Filter deshalb immer ausfüllen.
Typ Bitadresse
Dieser Parameter legt fest wie Bitadressen gesendet werden:
  • 0/1: Adressen werden als 0 oder 1 gesendet.
  • on/off: Adressen werden als on/off gesendet, 0=off, 1=on
  • true/false: Adressen werden als true/false gesendet, 0=false, 1=true
Gilt nur ohne Home Assistant Auto Discovery, nur dann wird der Parameter angezeigt.
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.

Bausteine mit demselben Broker teilen sich eine Verbindung, auch MQTT Eingang und MQTT Ausgang mit externem Broker. Shelly Bausteine und MQTT Eingang/Ausgang mit Server Typ "Intern" verwenden diese Verbindung nicht, sondern immer den Broker der Steuerung.
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. Bleibt das Präfix leer, beginnt das Topic mit "/", z.B. "/1/2/3".
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. Mit "Nur schreiben" nimmt der Baustein keine Werte vom Broker an.
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 Adresse 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.