WattWächter Plus¶
Der WattWächter Plus liest Energiedaten über einen IR-Lesekopf vom Smart Meter aus und stellt sie lokal sowie über die Cloud bereit.
Features¶
-
Echtzeit-Monitoring
Aktuelle Leistung (W) und Zählerstände (kWh) direkt vom Smart Meter
-
WiFi & Bluetooth 5.0
Kabellose Verbindung ins Heimnetz und einfache Einrichtung per App
-
REST API
Voller Zugriff auf alle Daten über lokale Endpunkte
-
Cloud-Portal
Fernzugriff über das Cloud-Portal
-
MQTT
Integration in Home Assistant, ioBroker und andere Smart-Home-Systeme
-
OTA-Updates
Automatische Firmware-Updates über die Cloud
Funktionsweise¶
flowchart LR
SM["Smart Meter"] -- IR --> WW["⚡ WattWächter"]
WW -- WiFi --> API["🌐 REST API"]
WW -- WiFi --> MQTT["<span style='display:inline-flex;align-items:center;gap:4px;white-space:nowrap'><img src='/assets/images/mqtt-logo.svg?v=2' style='width:14px;height:14px'/>MQTT</span>"]
WW -- WiFi --> Cloud["☁️ Cloud-Portal"]
- Der WattWächter empfängt SML-Telegramme vom Smart Meter
- Der WattWächter parst die OBIS-Kennzahlen (z.B.
1-0:1.8.0für Gesamtbezug) - Daten werden intern gespeichert (15-Min-Auflösung: 30 Tage, Tageswerte: 2 Jahre)
- Bereitstellung über REST API, MQTT und/oder Cloud-Portal
Technische Daten¶
| Eigenschaft | Wert |
|---|---|
| Konnektivität | WiFi 802.11 b/g/n, Bluetooth 5.0 LE |
| Schnittstelle | IR-Lesekopf (SML/OBIS-Protokoll, D0-Schnittstelle) |
| Stromversorgung | USB-C, 5V (min. 500mA) |
| Speicher | 15-Min-Auflösung (30 Tage) + Tageswerte (2 Jahre) |
| Statusanzeige | RGB-LED (Bedeutung) |
| Hostname | wattwaechter-XXXXXXXXXXXX.local (mDNS) |
Datenerfassung¶
OBIS-Kennzahlen¶
Folgende OBIS-Codes werden nach Freischaltung von nahezu allen modernen Zählern geliefert:
| OBIS-Code | Beschreibung | Einheit |
|---|---|---|
1-0:1.8.0 |
Gesamtbezug (Import) | kWh |
1-0:2.8.0 |
Gesamteinspeisung (Export) | kWh |
1-0:16.7.0 |
Aktuelle Leistung | W |
Weitere OBIS-Kennzahlen
Welche zusätzlichen OBIS-Codes dein Zähler liefert, hängt von der Konfiguration des Herstellers bzw. Netzbetreibers ab und kann nicht geändert werden — auch dann nicht, wenn das Display des Zählers weitere Werte anzeigt. Der WattWächter stellt alle Werte bereit, die er vom Zähler empfängt. Welche das sind, siehst du im Web-UI unter Live-Dashboard → Alle Zählerwerte oder per API unter /api/v1/history/latest.
Tarife
| OBIS-Code | Beschreibung | Einheit |
|---|---|---|
1-0:1.8.1 |
Bezug Tarif 1 | kWh |
1-0:1.8.2 |
Bezug Tarif 2 | kWh |
1-0:1.8.3 |
Bezug Tarif 3 | kWh |
1-0:1.8.4 |
Bezug Tarif 4 | kWh |
1-0:2.8.1 |
Einspeisung Tarif 1 | kWh |
1-0:2.8.2 |
Einspeisung Tarif 2 | kWh |
1-0:2.8.3 |
Einspeisung Tarif 3 | kWh |
1-0:2.8.4 |
Einspeisung Tarif 4 | kWh |
Spannung, Strom & Leistung
| OBIS-Code | Beschreibung | Einheit |
|---|---|---|
1-0:14.7.0 |
Frequenz | Hz |
1-0:32.7.0 |
Spannung L1 | V |
1-0:52.7.0 |
Spannung L2 | V |
1-0:72.7.0 |
Spannung L3 | V |
1-0:31.7.0 |
Strom L1 | A |
1-0:51.7.0 |
Strom L2 | A |
1-0:71.7.0 |
Strom L3 | A |
1-0:21.7.0 |
Leistung L1 | W |
1-0:41.7.0 |
Leistung L2 | W |
1-0:61.7.0 |
Leistung L3 | W |
Phasenwinkel
| OBIS-Code | Beschreibung |
|---|---|
1-0:81.7.1 |
Phasenwinkel U L2/L1 |
1-0:81.7.2 |
Phasenwinkel U L3/L1 |
1-0:81.7.4 |
Phasenwinkel I/U L1 |
1-0:81.7.15 |
Phasenwinkel I/U L2 |
1-0:81.7.26 |
Phasenwinkel I/U L3 |
Geräteinformationen
| OBIS-Code | Beschreibung |
|---|---|
1-0:0.2.0 |
Firmware-Version |
1-0:0.9.1 |
Uhrzeit |
1-0:96.50.1 |
Herstellercode |
1-0:96.1.0 |
Zählernummer |
Authentifizierung¶
Die API ist ab Werk ohne Authentifizierung zugänglich. Für gemeinsam genutzte Netzwerke empfehlen wir, die Token-basierte Authentifizierung zu aktivieren.
| Token | Berechtigung |
|---|---|
| READ Token | Daten abrufen, Status prüfen |
| WRITE Token | Einstellungen ändern, OTA starten, Reboot |
→ Aktivierung und Token-Verwaltung: Einstellungen → API-Authentifizierung. HTTP-Details und Token-Rotation: REST-API.
MQTT-Integration¶
Der WattWächter kann Telemetriedaten per MQTT an einen Broker senden — ideal für Home Assistant, ioBroker und andere Smart-Home-Systeme. Topic-Struktur, Payload-Format und Home-Assistant-Auto-Discovery sind unter Schnittstellen → MQTT dokumentiert.
→ Broker, Port, Sendeintervall und CA-Zertifikat konfigurieren: Einstellungen → MQTT.
Home Assistant
Für Home Assistant gibt es eine dedizierte Integration mit Auto-Discovery — siehe Integrationen → Home Assistant.
Fehlerbehebung¶
Gerät nicht erreichbar
- LED-Status prüfen
- Ping testen:
ping wattwaechter-XXXXXXXXXXXX.local - IP-Adresse ermitteln
- Bei dauerhaft roter LED: Gerät neu starten (USB trennen/verbinden)
Keine Zählerdaten
- IR-Lesekopf sitzt korrekt auf der optischen Schnittstelle?
- Smart Meter freigeschaltet? → Zähler vorbereiten
- Werte prüfen:
curl http://wattwaechter-XXXXXXXXXXXX.local/api/v1/history/latest
Factory Reset
Funktionstaster 7 Sekunden gedrückt halten. Alle Daten werden gelöscht.
