MQTT

Die Messwerte an einen eigenen Broker veröffentlichen und unter den fünf Nachrichtenformaten wählen.

Der Reiter MQTT veröffentlicht dieselben Messwerte an jeden beliebigen Broker. Er dient allen, die ein anderes System als Home Assistant speisen, oder allen, die Home Assistant lieber über den eigenen Broker speisen.

Wie bei der nativen Integration geht die Verbindung von Ihrem Telefon direkt zu Ihrem Rechner, ohne über unsere Server zu laufen.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. Vor dem Verlassen testen

    Tippen Sie auf Verbindung testen. Der Test bestätigt Adresse, Port, TLS und die Zugangsdaten, bevor Sie die Übertragung einschalten.

  6. Die Übertragung einschalten und speichern

    Schalten Sie Übertragung aktivieren ein, setzen Sie das Sendeintervall und speichern Sie mit der schwebenden Schaltfläche.

Wenn etwas nicht klappt

Prüfen Sie in dieser Reihenfolge: Adresse und Port, ob das Telefon in einem Netz ist, das den Broker erreicht, ob TLS (SSL) nutzen zu dem passt, was der Broker erwartet, und ob Benutzer und Passwort stimmen.

Port 1883 läuft meist ohne TLS, 8883 mit TLS. TLS gegen einen Port einzuschalten, der es nicht nutzt, ergibt einen Fehlschlag ohne hilfreiche Meldung.

Wählen Sie das Format Home Assistant Discovery, das einzige mit automatischer Erkennung. Bei den anderen Formaten müssen die Entitäten von Hand angelegt werden.

Für Home Assistant sollten Sie die native Integration in Betracht ziehen: sie arbeitet in beide Richtungen, veröffentlicht Ereignisse auf dem Bus und braucht keinen Broker.

Die App fragt, ob Sie die Topics des vorherigen Formats aufräumen wollen. Lautete die Antwort, sie zu behalten, bleiben sie auf dem Broker, bis sie dort entfernt werden.

Für Home Assistant bietet die native Integration mehr: sie arbeitet in beide Richtungen, veröffentlicht Ereignisse auf dem Bus und braucht keinen Broker.

MQTT ist die richtige Wahl, wenn Sie schon einen Broker betreiben, wenn Sie ein System speisen, das nicht Home Assistant ist, oder wenn Sie die Daten an mehreren Stellen zugleich brauchen.

← Alle AnleitungenIn den FAQ: Home Assistant und MQTT →