Home Assistant¶
Die WattWächter Plus Integration für Home Assistant ermöglicht die nahtlose Einbindung deines WattWächter Plus in dein Smart Home. Alle Sensordaten werden automatisch erkannt und als Entitäten in Home Assistant bereitgestellt.
Aktuell über HACS verfügbar
Die Integration wird derzeit als benutzerdefiniertes Repository über HACS installiert. Sobald wir in Home Assistant Core aufgenommen sind, wird diese Anleitung aktualisiert.
Voraussetzungen¶
- WattWächter Plus eingerichtet und mit dem WLAN verbunden — falls noch nicht geschehen, folge zunächst der Anleitung unter Erste Schritte
- Home Assistant 2024.1 oder neuer
- HACS (Home Assistant Community Store) installiert
- WattWächter Plus im selben Netzwerk wie Home Assistant
Installation über HACS¶
Schritt 1: Benutzerdefiniertes Repository hinzufügen¶
Öffne in Home Assistant die Seitenleiste und navigiere zu HACS. Klicke oben rechts auf das Drei-Punkte-Menü () und wähle Benutzerdefinierte Repositories.
Schritt 2: Repository-URL eingeben¶
Gib im Dialog folgende Daten ein:
- Repository:
https://github.com/SmartCircuits-GmbH/WattWaechter_HA_Integration - Typ:
Integration
Klicke anschließend auf Hinzufügen.
Schritt 3: Repository bestätigen¶
Das Repository WattWächter Plus wird erkannt und angezeigt. Klicke erneut auf Hinzufügen, um es deinem HACS Store hinzuzufügen. Danach erscheint die Integration wie jede andere HACS-Integration in deiner lokalen HACS-Übersicht und kann von dort heruntergeladen und aktualisiert werden.
Schritt 4: Integration herunterladen¶
Suche in HACS nach WattWächter. Du findest die Integration unter Zum Download verfügbar. Klicke auf das Drei-Punkte-Menü () und wähle Herunterladen.
Schritt 5: Version auswählen und herunterladen¶
Wähle die gewünschte Version aus (standardmäßig die neueste) und klicke auf Herunterladen. Die Integration wird nach /config/custom_components/wattwaechter heruntergeladen.
Schritt 6: Home Assistant neu starten¶
Neustart erforderlich
Nach dem Herunterladen der Integration muss Home Assistant neu gestartet werden, damit die Integration geladen wird. Gehe dazu auf Einstellungen > System > Neustart.
Einrichtung der Integration¶
Automatische Erkennung (Zeroconf)¶
Nach dem Neustart erkennt Home Assistant automatisch alle WattWächter Plus Geräte im Netzwerk. Du findest die erkannten Geräte unter Einstellungen > Geräte & Dienste im Bereich Erkannt. Klicke auf Hinzufügen, um ein Gerät einzurichten.
Gerät konfigurieren¶
Im Konfigurationsdialog werden die Geräteinformationen angezeigt:
- Modell: WW-Plus
- Firmware: aktuelle Version
- Host: IP-Adresse des Geräts
- Geräte-ID: eindeutige Kennung
Optional kannst du einen API-Token eingeben, um authentifizierten Zugriff zu ermöglichen. Klicke auf OK, um die Einrichtung abzuschließen.
Gerät benennen¶
Nach der Konfiguration kannst du dem Gerät einen Namen und einen Bereich zuweisen (z.B. "WattWächter Einspeisung" im Bereich "Keller"). Klicke auf Überspringen und abschließen, wenn du dies später einrichten möchtest.
Verfügbare Sensoren¶
Die Integration erstellt automatisch Sensoren basierend auf den vom Stromzähler gelieferten OBIS-Codes. Welche Sensoren verfügbar sind, hängt von deinem Stromzähler ab.
Energie-Sensoren¶
| Sensor | OBIS-Code | Einheit | Beschreibung |
|---|---|---|---|
| Gesamtverbrauch | 1.8.0 | kWh | Gesamter Strombezug |
| Gesamteinspeisung | 2.8.0 | kWh | Gesamte Einspeisung |
| Verbrauch Tarif 1 | 1.8.1 | kWh | Strombezug Tarif 1 (HT) |
| Verbrauch Tarif 2 | 1.8.2 | kWh | Strombezug Tarif 2 (NT) |
| Einspeisung Tarif 1 | 2.8.1 | kWh | Einspeisung Tarif 1 |
| Einspeisung Tarif 2 | 2.8.2 | kWh | Einspeisung Tarif 2 |
Leistungs-Sensoren¶
| Sensor | OBIS-Code | Einheit | Beschreibung |
|---|---|---|---|
| Aktive Leistung | 16.7.0 | W | Momentane Gesamtleistung |
| Leistung L1 | 36.7.0 | W | Leistung Phase 1 |
| Leistung L2 | 56.7.0 | W | Leistung Phase 2 |
| Leistung L3 | 76.7.0 | W | Leistung Phase 3 |
Spannungs- & Strom-Sensoren¶
| Sensor | OBIS-Code | Einheit | Beschreibung |
|---|---|---|---|
| Spannung L1/L2/L3 | 32/52/72.7.0 | V | Spannung pro Phase |
| Strom L1/L2/L3 | 31/51/71.7.0 | A | Strom pro Phase |
| Frequenz | 14.7.0 | Hz | Netzfrequenz |
| Leistungsfaktor | 13.7.0 | — | Gesamt und pro Phase |
Diagnose-Sensoren¶
| Sensor | Beschreibung |
|---|---|
| WiFi-Signalstärke | Empfangsstärke in dBm |
| WiFi SSID | Verbundenes Netzwerk |
| IP-Adresse | Aktuelle IP-Adresse |
| mDNS-Name | Netzwerkname des Geräts |
| Firmware-Version | Installierte Firmware |
Dynamische Sensoren
Liefert dein Stromzähler OBIS-Codes, die nicht in den obigen Tabellen aufgeführt sind, werden diese automatisch als zusätzliche Sensoren mit passender Einheit und Geräteklasse angelegt.
Optionen¶
Nach der Einrichtung kannst du die Integration über Einstellungen > Geräte & Dienste > WattWächter Plus > Konfigurieren anpassen:
| Option | Standard | Bereich | Beschreibung |
|---|---|---|---|
| Abfrageintervall | 120 s | 3–900 s | Wie oft Messdaten vom Gerät abgerufen werden |
Firmware-Updates¶
Die Integration erstellt automatisch eine Update-Entität. Darüber kannst du Firmware-Updates direkt aus Home Assistant heraus installieren — inklusive Fortschrittsanzeige.
Fehlerbehebung¶
Gerät wird nicht automatisch erkannt
Stelle sicher, dass:
- Der WattWächter Plus eingeschaltet und mit dem WLAN verbunden ist
- Home Assistant und der WattWächter im selben Netzwerk/Subnetz sind
- mDNS/Zeroconf im Netzwerk nicht blockiert wird (z.B. durch VLAN-Isolation oder Firewall)
- Das Gerät nicht in einem Gast-WLAN betrieben wird — in Gast-Netzwerken ist die Kommunikation zwischen Geräten in der Regel unterbunden (Client Isolation)
Du kannst das Gerät auch manuell hinzufügen: Einstellungen > Geräte & Dienste > Integration hinzufügen > WattWächter und die IP-Adresse eingeben.
MQTT-Konflikt
Wenn auf dem WattWächter die MQTT-Auto-Discovery aktiv ist, erkennt die Integration dies und weist darauf hin. Deaktiviere in diesem Fall entweder die MQTT-Auto-Discovery auf dem Gerät oder nutze die MQTT-Integration statt der lokalen API-Integration. Beide gleichzeitig zu verwenden kann zu doppelten Entitäten führen.
Authentifizierungsfehler
Wenn sich der API-Token geändert hat, kannst du ihn über Einstellungen > Geräte & Dienste > WattWächter Plus > Erneut authentifizieren aktualisieren.