Python¶
Mit Python liest du den WattWächter USB auf jedem Rechner aus, ob Raspberry Pi, Linux, Windows oder Mac. Wir verwenden pyserial für die serielle Schnittstelle und smllib zum Dekodieren der SML-Telegramme.
pip install pyserial smllib
Schnittstelle finden¶
Dieses Skript listet alle WattWächter USB auf, die gerade am Rechner stecken, mit Port und Seriennummer:
from serial.tools import list_ports
for port in list_ports.comports():
if (port.vid, port.pid) == (0x10C4, 0xEA60): # Silicon Labs CP210x
print(f"{port.device:40s} Seriennummer {port.serial_number}")
/dev/ttyUSB0 Seriennummer <Seriennummer>
Unter macOS ist das der einzige Weg, mehrere Köpfe auseinanderzuhalten, weil dort der Portname vom USB-Port abhängt. Die Abfrage erkennt jedes Gerät mit einem CP210x-Wandler. Steckt außer dem WattWächter noch ein solches Gerät am Rechner, unterscheidest du sie an der Seriennummer.
SML-Zähler¶
Fast alle modernen Zähler senden SML mit 9600 Baud, 8N1 von sich aus:
import serial
from smllib import SmlStreamReader
from smllib.errors import CrcError
# Linux: /dev/serial/by-id/usb-Silicon_Labs_CP2102N_..._<Seriennummer>-if00-port0
# macOS: /dev/cu.usbserial-<Nummer>, z. B. /dev/cu.usbserial-10
# Windows: COM3
PORT = "/dev/ttyUSB0"
# OBIS-Codes, die uns interessieren (Kurzform -> Bezeichnung)
OBIS = {
"1.8.0": "Bezug", # Wh, aus dem Netz bezogen
"2.8.0": "Einspeisung", # Wh, ins Netz eingespeist
"16.7.0": "Leistung", # W, aktuelle Wirkleistung (vorzeichenbehaftet)
}
ser = serial.Serial(PORT, baudrate=9600, bytesize=8,
parity="N", stopbits=1, timeout=2)
stream = SmlStreamReader()
print(f"Lese WattWächter USB an {PORT} ...")
while True:
data = ser.read(ser.in_waiting or 1)
if not data:
continue
stream.add(data)
try:
frame = stream.get_frame()
except CrcError:
continue # gestörtes Telegramm überspringen
if frame is None:
continue # Telegramm noch nicht vollständig
for entry in frame.get_obis():
name = OBIS.get(entry.obis.obis_short)
if name is None:
continue
value = entry.get_value() # bereits skaliert (Wert × 10^Scaler)
if entry.obis.obis_short in ("1.8.0", "2.8.0"):
print(f"{name:12s}: {value / 1000:.3f} kWh")
else:
print(f"{name:12s}: {value:.0f} W")
print("-" * 30)
Beispiel-Ausgabe:
Lese WattWächter USB an /dev/ttyUSB0 ...
Bezug : 12345.678 kWh
Einspeisung : 4321.000 kWh
Leistung : 437 W
------------------------------
Weitere Werte auslesen
Ergänze das OBIS-Dictionary um weitere Codes, z. B. 36.7.0, 56.7.0, 76.7.0 für die Phasenleistungen oder 32.7.0, 52.7.0, 72.7.0 für die Phasenspannungen. Eine Übersicht steht unter Messwerte.
D0-Zähler, die von selbst senden¶
Manche Zähler senden ihre Werte als D0-Text von sich aus, ohne Anfrage, meist mit 9600 Baud, 7E1, z. B. eBZ DD3, EasyMeter Q3D oder Hager EHZ161/EHZ361. Ob deiner dazugehört, zeigt der Test in der Einrichtung: Er meldet dann D0-Telegramm erkannt. Für diese Zähler genügt pyserial:
import re
import serial
PORT = "/dev/ttyUSB0" # Windows: "COM3", macOS: "/dev/cu.usbserial-XXXX"
# Bekannte Kennzahlen bekommen einen Namen, alle anderen werden mit Code ausgegeben
NAMES = {
"1.8.0": "Bezug",
"2.8.0": "Einspeisung",
"16.7.0": "Leistung",
"0.0.0": "Zählernummer",
}
# Datenzeilen wie 1-0:1.8.0*255(012345.678*kWh) oder 1.8.0(012345.678*kWh)
LINE = re.compile(r"^(?:\d+-\d+:)?([0-9A-Z]+(?:\.[0-9A-Z]+)+)(?:\*\d+)?\(([^)*]*)(?:\*([^)]*))?\)")
ser = serial.Serial(PORT, baudrate=9600, bytesize=serial.SEVENBITS,
parity=serial.PARITY_EVEN, stopbits=serial.STOPBITS_ONE, timeout=5)
print(f"Lese WattWächter USB an {PORT} (D0, 9600 Baud, 7E1) ...")
while True:
line = ser.readline().decode("ascii", "replace").strip()
if line.startswith("/"): # Kennung, beginnt jedes Telegramm
print(f"Zähler: {line}")
elif line.startswith("!"): # Ende des Telegramms
print("-" * 30)
else:
match = LINE.match(line)
if match:
code, value, unit = match.groups()
print(f"{NAMES.get(code, code):14s}: {value} {unit or ''}")
Beispiel-Ausgabe an einem eBZ DD3:
Lese WattWächter USB an /dev/ttyUSB0 (D0, 9600 Baud, 7E1) ...
Zähler: /EBZ5DD3LZ06ETA_107
Zählernummer : 1EBZ0101267463
96.1.0 : 1EBZ0101267463
Einspeisung : 000001 kWh
96.5.0 : 00050104
96.8.0 : 008250CD
------------------------------
Welche Kennzahlen kommen, hängt vom Zähler und seiner Freischaltung ab; dieser Zähler sendet ohne PIN nur die Einspeisung. Die Bedeutung der Kennzahlen steht unter Messwerte.
D0-Zähler mit Anfrage (IEC 62056-21)¶
Ältere Zähler (in der Tabelle Unterstützte Zähler mit Fußnote ⁴) senden erst, wenn man sie fragt: Anfrage mit 300 Baud, 7E1, danach Wechsel auf die Baudrate, die der Zähler anbietet. Das Skript dafür steht beim WattWächter TTL unter Python → Beispiel-Skript 2. Es funktioniert mit dem WattWächter USB unverändert; trage nur bei PORT den Port deines Kopfes ein. Beim Abfragen leuchtet kurz die gelbe LED.
Mehrere Zähler¶
Jeder WattWächter USB hat eine eigene Seriennummer. Mit mehreren Köpfen an einem Rechner, etwa für Haus- und Wärmepumpenzähler, öffnest du jeden über seinen festen Pfad:
ZAEHLER = {
"Haus": "/dev/serial/by-id/usb-Silicon_Labs_CP2102N_..._<Seriennummer-1>-if00-port0",
"Wärmepumpe": "/dev/serial/by-id/usb-Silicon_Labs_CP2102N_..._<Seriennummer-2>-if00-port0",
}
Unter Windows sind das die festen COM-Nummern der beiden Köpfe, unter macOS suchst du den Port beim Start über die Seriennummer (siehe Schnittstelle finden). So bleibt die Zuordnung auch nach einem Neustart oder Umstecken richtig.
Fehlerbehebung¶
| Problem | Mögliche Ursache / Lösung |
|---|---|
Permission denied auf /dev/... |
Benutzer zur Gruppe dialout hinzufügen: sudo usermod -aG dialout $USER, danach neu anmelden |
Device or resource busy / Zugriff verweigert (Windows) |
Ein anderes Programm hat die Schnittstelle offen |
Keine Daten / frame bleibt None |
Blinkt die grüne LED? Wenn nicht, sitzt der Kopf nicht mittig oder der Zähler sendet nicht. Wenn ja: falscher Port, oder der Zähler spricht D0 statt SML. |
| Nur Energiezähler, keine Leistung/Phasen | Am Zähler PIN deaktivieren und Inf → On setzen |
| Werte um Faktor 10/100 falsch | In seltenen Fällen get_obis() durch parse_frame() ersetzen (siehe smllib-Doku) |