Skip to content

Setup

The WattWächter USB needs no configuration: you attach it to the meter, plug it into your computer and check that data arrives. Then you set up the software that evaluates the data.

Prepare the meter first

Without unlocking, many meters only send the meter readings but not the current power. First enter your grid operator's PIN on the meter, set PIN to Off and Inf to On, see Meter preparation.

1. Attach the reading head

Place the WattWächter USB with its ring magnet centred on the meter's optical interface, the metal ring around the two infrared diodes. The USB cable must point upwards.

PIN activation required

For your meter to transmit measurement data via infrared, the extended data display must be enabled on the meter. To do this you need the PIN code from your grid operator. Enter it directly on the meter, then set PIN to Off and Inf to On in the meter menu.

2. Connect it to the computer

Plug the USB-C cable into the reading head and the other end into a free USB port on your computer. This also powers the head. You do not need to install a driver: Linux and macOS include it, and Windows 10/11 downloads it automatically the first time you plug the head in.

If the meter sends on its own (almost all SML meters do), the green LED now flashes in time with the telegrams, usually every 1–2 seconds. Meters with the IEC 62056-21 protocol (marked with footnote ⁴ in the Supported meters table) stay silent until your software sends a request.

Green LED stays dark?

Check that the head sits centred on the interface with the USB cable pointing upwards. If an SML meter does not send, it has often not been unlocked yet, or Inf is set to Off.

3. Find the serial port

The head shows up as a serial port. Your software needs its name.

ls -l /dev/serial/by-id/

You will see an entry with Silicon Labs CP2102N and the head's serial number, for example:

usb-Silicon_Labs_CP2102N_USB_to_UART_Bridge_Controller_<serial>-if00-port0 -> ../../ttyUSB0

In your software, use the full path under /dev/serial/by-id/. It stays the same even if the number of /dev/ttyUSB0 changes after a reboot or when a second USB device is added.

To allow your user to read the port, add it to the dialout group once and log in again:

sudo usermod -aG dialout $USER

Open Device Manager and expand Ports (COM & LPT). The head appears as Silicon Labs CP210x USB to UART Bridge (COM3); the number may differ on your computer.

The COM number stays the same for the same head on the same computer, even on a different USB port, because Windows ties it to the serial number.

ls /dev/cu.*

The head appears as /dev/cu.usbserial-<number>, e.g. /dev/cu.usbserial-10. Use the name starting with cu., not tty..

The number depends on the USB port, not on the head: on a different port or hub the same head gets a different name. With several heads, tell them apart by the serial number, see Python → Find the serial port.

4. Check that data arrives

Before you set up your actual software, a quick test is worthwhile. This Python script reads for up to five seconds and tells you whether an SML or a D0 telegram arrives. It runs on Linux, Windows and macOS and only needs pyserial (pip install pyserial):

import serial

PORT = "/dev/ttyUSB0"   # Windows: "COM3", macOS: "/dev/cu.usbserial-XXXX"

with serial.Serial(PORT, 9600, timeout=5) as ser:
    data = ser.read(512)

print(f"{len(data)} bytes received")
text = bytes(b & 0x7F for b in data)   # D0 text arrives as 7E1, the 8th bit is the parity
if b"\x1b\x1b\x1b\x1b\x01\x01\x01\x01" in data:
    print("SML telegram detected")
elif b"/" in text and b"!" in text:
    start = text.index(b"/")
    print("D0 telegram detected:", text[start:].split(b"\r\n")[0].decode("ascii", "replace"))
else:
    print(data[:64].hex(" "))
Result Meaning
SML telegram detected All good, the meter sends SML at 9600 baud.
D0 telegram detected: /EBZ5DD3… All good, the meter sends D0 text on its own at 9600 baud, 7E1. It is followed by the meter's identification (manufacturer and type).
Hex bytes only The meter sends at a different baud rate. Read the values from your software, see Supported meters.
0 bytes received The head is not positioned correctly, the meter is not unlocked, or it is a meter that has to be asked first (footnote ⁴).

Only one program at a time

A serial port can only be opened by one program at a time. Stop the test before you let Home Assistant, vzlogger or ioBroker access the head.

5. Set up the software

Now connect the head to the software of your choice: