Der Bereich MQTT veröffentlicht dieselben Werte an einen beliebigen Broker. Er richtet sich vor allem an alle, die neben Home Assistant andere Plattformen nutzen, etwa openHAB, Node-RED, Domoticz oder ThingsBoard, oder die Home Assistant lieber selbst über einen Broker versorgen.
Wie bei der nativen Integration gehen die Daten direkt vom Handy an Ihren Broker.
Den Broker eintragen
Tragen Sie Broker-Adresse und Port ein. Verlangt der Broker eine Anmeldung, tragen Sie auch Benutzer und Passwort ein.
Schalten Sie TLS (SSL) nutzen ein, wenn der Broker außerhalb Ihres Netzwerks erreichbar ist. WebSocket nutzen und Basispfad dienen Brokern hinter einem Proxy.
Adresse, Port, Verbindungsoptionen und Zugangsdaten werden nur auf diesem Handy gespeichert. Auf einem anderen Handy mit demselben Konto tragen Sie sie erneut ein.
Die Protokollversion wählen
Die Schaltflächen MQTT 3.1.1 und MQTT 5.0 wählen die Version. Im Zweifel wählen Sie 3.1.1, die breiter unterstützte.
Das Format wählen
MQTT-Format legt die Form der Topics und das Format jeder Nachricht fest. Es gibt fünf Optionen:
- Home Assistant Discovery: mit automatischer Erkennung entstehen die Entitäten von allein, mit Name, Einheit und Symbol.
- Homie 4.0: folgt der Homie-Konvention.
- Einfache Topics: ein Wert je Topic, ohne zusätzliche Struktur. Am leichtesten aus einem Skript zu verarbeiten.
- Einheitliches JSON: alles in einer einzigen Nachricht, auf dem Topic, das Sie festlegen.
- ThingsBoard: das Telemetrieformat von ThingsBoard.
Manche Formate haben eigene Einstellungen, etwa JSON-Payload (Wert + Zeitstempel) bei den einfachen Topics und Zeitstempel einschließen bei ThingsBoard.
Das Topic-Präfix setzen
Themenpräfix ist die Wurzel von allem, was die App veröffentlicht. Setzen Sie den Wert am Anfang und ändern Sie ihn danach möglichst nicht, weil die Änderung die alten Topics verwaist auf dem Broker zurücklässt.
Vor dem Verlassen testen
Tippen Sie auf Verbindung testen. Der Test bestätigt Adresse, Port, TLS und die Zugangsdaten, bevor Sie die Übertragung einschalten.
Die Übertragung einschalten und speichern
Schalten Sie Übertragung aktivieren ein, setzen Sie das Sendeintervall und speichern Sie mit der schwebenden Schaltfläche.
- Broker-Adresse und Port
- Wohin die App veröffentlicht. Jeder Broker taugt: Mosquitto, EMQX, das Add-on innerhalb von Home Assistant oder ein gehosteter Dienst.
- TLS (SSL) nutzen
- Verschlüsselt die Verbindung zum Broker. Empfohlen, sobald er außerhalb Ihres Netzwerks erreichbar ist.
- WebSocket nutzen und Basispfad
- Gedacht für Broker hinter einem Reverse Proxy.
- MQTT-Format
- Home Assistant Discovery, Homie 4.0, Einfache Topics, Einheitliches JSON oder ThingsBoard.
- Themenpräfix
- Die Wurzel der veröffentlichten Topics. Es später zu ändern lässt die alten Topics verwaist auf dem Broker zurück.
- Benutzer und Passwort
- Die Zugangsdaten des Brokers, wenn er eine Anmeldung verlangt.
- Verbindung testen
- Bestätigt Adresse, Port, TLS und die Zugangsdaten, bevor die Übertragung eingeschaltet wird.
- Sendeintervall
- Wie oft die Momentaufnahme der Live-Sensoren gesendet wird.
- Speichern-Schaltfläche
- Bewahrt die Einstellungen des aktiven Reiters und den Synchronisationsmodus.