Zum Inhalt

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)