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["📡 MQTT"]
    WW -- WiFi --> Cloud["☁️ Cloud-Portal"]

Der IR-Lesekopf empfängt SML-Telegramme vom Smart Meter
Der WattWächter parst die OBIS-Kennzahlen (z.B. 1-0:1.8.0 fü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

Authentifizierung aktivieren

curl -X POST http://wattwaechter-XXXXXXXXXXXX.local/api/v1/settings \
  -H "Content-Type: application/json" \
  -d '{"api_auth_required": true}'

Tokens werden per Header übergeben:

Authorization: Bearer DEIN_TOKEN

MQTT-Integration¶

Der WattWächter kann Telemetriedaten per MQTT an einen Broker senden — ideal für Home Assistant, ioBroker und andere Smart-Home-Systeme.

MQTT konfigurieren

curl -X POST http://wattwaechter-XXXXXXXXXXXX.local/api/v1/settings \
  -H "Authorization: Bearer WRITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mqtt": {"enable": true, "host": "mqtt.example.com", "port": 8883}}'

TLS mit eigenem CA-Zertifikat

Für MQTT-Broker mit selbstsigniertem Zertifikat:

curl -X POST http://wattwaechter-XXXXXXXXXXXX.local/api/v1/mqtt/ca \
  -H "Authorization: Bearer WRITE_TOKEN" \
  -H "Content-Type: text/plain" \
  --data-binary @mein_broker_ca.pem

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.