Zum Inhalt

Home Assistant (MQTT)

Statt über die native Integration lässt sich der WattWächter Gas auch per MQTT in Home Assistant einbinden. Das Gerät veröffentlicht seine Messwerte dann selbst an einen Broker und meldet sich dort per Auto-Discovery an — Home Assistant legt die Sensoren ohne YAML-Konfiguration automatisch an.

Zwei Wege zu Home Assistant

  • Native Integration — seit Home Assistant 2026.11 in Home Assistant Core enthalten, Einrichtung in zwei Klicks, aber festes Abfrageintervall von 120 Sekunden. Siehe Home Assistant (Integration).
  • MQTT (diese Seite) — etwas mehr Aufwand (Broker nötig), dafür bestimmst du das Sendeintervall selbst, bis hinunter zu 1 Sekunde.

Verwende nur einen der beiden Wege gleichzeitig, sonst entstehen doppelte Entitäten. Ab Home Assistant 2026.12 bietet Home Assistant ein per MQTT eingebundenes Gerät nicht mehr für die native Integration an.

Voraussetzungen


Schritt 1 — Broker in Home Assistant einrichten

Hast du noch keinen MQTT-Broker, richte ihn zuerst ein — die Anleitung gilt für alle WattWächter-Modelle:

➜ MQTT-Broker in Home Assistant einrichten

Danach hast du drei Angaben, die du gleich brauchst: IP-Adresse des Home-Assistant-Servers, Benutzername und Passwort.


Schritt 2 — MQTT am WattWächter aktivieren

MQTT ist ab Werk deaktiviert. Du aktivierst es über die Weboberfläche, das Cloud-Portal oder die REST-API — siehe Einstellungen → MQTT.

Für einen Broker in Home Assistant trägst du ein:

Feld Eintrag
MQTT ein
MQTT Host IP-Adresse des Home-Assistant-Servers, z. B. 192.168.178.22
MQTT Port 1883
TLS (Verschlüsselung) aus — der Mosquitto-Broker nimmt in der Standardkonfiguration unverschlüsselte Verbindungen auf Port 1883 an
Benutzername / Passwort die Zugangsdaten aus dem Broker-Guide
Aktualisierungsintervall nach Bedarf, z. B. 5 Sekunden für Live-Anzeigen (Standard: 60)
Topic-Prefix / Client-ID weiter unten in der Liste — unverändert lassen

Die Änderungen greifen ohne Neustart — das Gerät verbindet sich unmittelbar neu. Ob die Verbindung steht, zeigt der MQTT-Status.

Port und TLS umstellen — sonst keine Verbindung

Ab Werk ist der WattWächter auf eine verschlüsselte Verbindung eingestellt: Port 8883 mit TLS. Der Mosquitto-Broker in Home Assistant nimmt in seiner Standardeinstellung aber nur unverschlüsselte Verbindungen auf Port 1883 an.

Stell deshalb beide Werte um:

  • MQTT Port → 1883
  • TLS (Verschlüsselung) → aus

Änderst du nur einen der beiden Werte, kommt keine Verbindung zum Broker zustande.

Willst du verschlüsselt übertragen, musst du TLS zuerst im Mosquitto-Broker einrichten. Wie das geht und wie du ein eigenes CA-Zertifikat hochlädst, steht unter MQTT → TLS-Verbindung.


Schritt 3 — Gerät in Home Assistant prüfen

Rund zwei Sekunden nach dem Verbindungsaufbau veröffentlicht der WattWächter seine Discovery-Nachrichten. Home Assistant legt daraufhin automatisch ein Gerät WattWächter Gas mit einem Sensor pro Messwert an.

Du findest es unter Einstellungen → Geräte & Dienste → MQTT → Geräte.

Der Zählerstand (7-0:3.0.0) ist als total mit last_reset und device_class: gas ausgezeichnet und lässt sich damit direkt im Energie-Dashboard von Home Assistant als Gasverbrauch verwenden. Den Durchfluss (7-0:43.0.0) meldet das Gerät als volume_flow_rate, die daraus berechnete Leistung (7-0:16.7.0) als power in kW.

Sprache der Entitätsnamen

Die Namen der Sensoren erzeugt das Gerät selbst — sie folgen der Sprache aus den Geräteeinstellungen. Nach einem Sprachwechsel gelten die neuen Namen ab der nächsten MQTT-Verbindung; bereits angelegte Entitäten behalten ihren Namen in Home Assistant.


Umstieg von der Integration

Läuft bislang die native Integration, entferne sie vor dem Umstieg, sonst hast du jeden Messwert doppelt:

  1. Einstellungen → Geräte & Dienste → WattWächter
  2. Über das Drei-Punkte-Menü Löschen
  3. Danach MQTT wie oben einrichten

In die Gegenrichtung ist zusätzlich Handarbeit nötig: Die Discovery-Topics sind retained und werden beim Deaktivieren von MQTT nicht automatisch gelöscht — das Gerät bliebe sonst als Karteileiche in Home Assistant stehen. Wie du sie entfernst, steht unter Schnittstellen → MQTT → Home Assistant Auto-Discovery. Ab Home Assistant 2026.12 bietet Home Assistant den WattWächter Gas erst wieder zur Einrichtung an, wenn sein MQTT-Gerät gelöscht ist, spätestens nach dem nächsten Neustart von Home Assistant. Du kannst ihn auch gleich manuell hinzufügen.


Fehlersuche

Symptom Ursache und Lösung
Kein Gerät in Home Assistant, Broker aber erreichbar Läuft die MQTT-Integration? Prüfe unter Einstellungen → Geräte & Dienste → MQTT, ob der Dienst Online meldet.
Der WattWächter verbindet sich nicht Meist TLS: Port 1883 verlangt TLS aus. Den aktuellen Zustand liefert GET /api/v1/mqtt/status — siehe Status & Diagnose.
Not authorized im Broker-Protokoll Benutzername oder Passwort falsch, oder der Home-Assistant-Benutzer wurde ohne Anmeldung erlauben angelegt. Siehe Fehlersuche im Broker-Guide.
Werte kommen an, aber nur alle 60 Sekunden Das ist das Standard-Sendeintervall. Anpassen unter Sendeintervall.
Jeder Messwert doppelt vorhanden Die native Integration läuft parallel — siehe Umstieg von der Integration.
Zum Mitlesen der Rohdaten eignet sich mosquitto_sub; ein fertiges Beispiel steht unter Schnittstellen → MQTT.

Weiterführend

Topic-Struktur, Payload-Format, TLS mit eigenem CA-Zertifikat, Reconnect-Verhalten und die Diagnose-Endpunkte sind vollständig unter MQTT dokumentiert.