Volkszähler (vzlogger)¶
Volkszähler ist eine freie Software zum Erfassen und Darstellen von Verbrauchsdaten. Den Zähler liest dabei vzlogger aus, ein kleines Programm, das auf demselben Rechner läuft, an dem der WattWächter USB steckt, und die Werte an die Volkszähler-Middleware, per MQTT oder an einen lokalen Webserver weitergibt. vzlogger kann SML- und D0-Zähler lesen.
Voraussetzungen¶
- WattWächter USB ist eingerichtet, und du kennst seinen Pfad unter
/dev/serial/by-id/ - vzlogger ist installiert, siehe Volkszähler-Wiki → vzlogger. Auf dem fertigen Volkszähler-Image für den Raspberry Pi ist er schon dabei.
- Für die Darstellung: eine Volkszähler-Middleware mit je einem angelegten Kanal pro Messwert. Die UUID jedes Kanals zeigt dir die Volkszähler-Oberfläche.
Die Konfiguration steht in /etc/vzlogger.conf. Ersetze in den Beispielen <pfad> durch den Pfad deines Kopfes, also etwa /dev/serial/by-id/usb-Silicon_Labs_CP2102N_USB_to_UART_Bridge_Controller_<Seriennummer>-if00-port0.
SML-Zähler¶
Fast alle modernen Zähler senden SML mit 9600 Baud von sich aus:
{
"verbosity": 0,
"log": "/var/log/vzlogger.log",
"meters": [
{
"enabled": true,
"allowskip": false,
"protocol": "sml",
"device": "<pfad>",
"baudrate": 9600,
"parity": "8n1",
"aggtime": -1,
"channels": [
{
"uuid": "<uuid-bezug>",
"middleware": "http://localhost/middleware.php",
"identifier": "1-0:1.8.0"
},
{
"uuid": "<uuid-einspeisung>",
"middleware": "http://localhost/middleware.php",
"identifier": "1-0:2.8.0"
},
{
"uuid": "<uuid-leistung>",
"middleware": "http://localhost/middleware.php",
"identifier": "1-0:16.7.0"
}
]
}
]
}
| Kennzahl | Bedeutung |
|---|---|
1-0:1.8.0 |
Bezug gesamt (Wh) |
1-0:2.8.0 |
Einspeisung gesamt (Wh) |
1-0:16.7.0 |
Aktuelle Wirkleistung (W), negativ bei Einspeisung |
Weitere Kennzahlen (Phasenleistungen, Spannungen …) findest du unter Messwerte.
D0-Zähler, die von selbst senden¶
Manche Zähler senden D0-Text ohne Anfrage, meist mit 9600 Baud, 7E1 (z. B. eBZ DD3, EasyMeter Q3D). Der Test in der Einrichtung meldet dann D0-Telegramm erkannt. Für sie nimmst du "protocol": "d0" ohne pullseq:
{
"enabled": true,
"protocol": "d0",
"device": "<pfad>",
"baudrate": 9600,
"parity": "7e1",
"channels": [
{
"uuid": "<uuid-bezug>",
"middleware": "http://localhost/middleware.php",
"identifier": "1-0:1.8.0"
}
]
}
Dieser Block ersetzt den Eintrag unter "meters" aus dem SML-Beispiel oben.
D0-Zähler mit Anfrage¶
Zähler mit IEC-62056-21-Protokoll (in der Tabelle Unterstützte Zähler mit Fußnote ⁴) senden erst, wenn vzlogger sie fragt. Die Anfrage geht mit 300 Baud, 7E1 hinaus; mit "ackseq": "auto" schaltet vzlogger danach selbst auf die höchste Baudrate um, die der Zähler anbietet:
{
"verbosity": 0,
"log": "/var/log/vzlogger.log",
"meters": [
{
"enabled": true,
"protocol": "d0",
"device": "<pfad>",
"baudrate": 300,
"parity": "7e1",
"pullseq": "2F3F210D0A",
"ackseq": "auto",
"interval": 60,
"channels": [
{
"uuid": "<uuid-bezug>",
"middleware": "http://localhost/middleware.php",
"identifier": "1-0:1.8.0"
}
]
}
]
}
pullseq ist die Anfrage /?! mit Zeilenende, interval der Abstand zwischen zwei Abfragen in Sekunden. Beim Abfragen leuchtet am Kopf kurz die gelbe LED, danach blinkt die grüne, während der Zähler antwortet.
Welche Kennzahlen sendet mein Zähler?
Setze "verbosity": 15 und starte vzlogger im Vordergrund (vzlogger -f). Er schreibt dann jede empfangene Kennzahl ins Log. Trage genau diese Schreibweise bei identifier ein und stelle verbosity danach wieder auf 0.
Ohne Middleware: lokaler Webserver¶
Zum Ausprobieren oder wenn die Werte woanders weiterverarbeitet werden sollen, braucht vzlogger keine Middleware. Setze bei den Kanälen "api": "null" und schalte den eingebauten Webserver ein:
{
"local": {
"enabled": true,
"port": 8080,
"index": true
},
"meters": [
{
"enabled": true,
"protocol": "sml",
"device": "<pfad>",
"baudrate": 9600,
"parity": "8n1",
"channels": [
{ "api": "null", "uuid": "00000000-0000-0000-0000-000000000001", "identifier": "1-0:1.8.0" },
{ "api": "null", "uuid": "00000000-0000-0000-0000-000000000002", "identifier": "1-0:16.7.0" }
]
}
]
}
Unter http://<rechner>:8080/ liefert vzlogger dann die aktuellen Werte als JSON. Die UUIDs sind hier frei gewählt, sie müssen nur verschieden sein.
MQTT
vzlogger kann die Werte auch an einen MQTT-Broker senden (Abschnitt "mqtt" in der Konfiguration). Die fertigen Pakete enthalten MQTT; die Einstellungen beschreibt das Volkszähler-Wiki.
vzlogger starten¶
sudo systemctl restart vzlogger
sudo systemctl status vzlogger
Läuft vzlogger, kommen die Werte nach wenigen Sekunden in der Volkszähler-Oberfläche an.
Fehlerbehebung¶
| Problem | Lösung |
|---|---|
Permission denied beim Öffnen der Schnittstelle |
Der Benutzer, unter dem vzlogger läuft, muss in der Gruppe dialout sein |
Device or resource busy |
Ein anderes Programm (Home Assistant, ein Testskript) hat die Schnittstelle offen. Nur ein Programm gleichzeitig. |
| Keine Werte, grüne LED blinkt | identifier passt nicht zur Schreibweise des Zählers, mit "verbosity": 15 nachsehen |
| D0-Zähler antwortet nicht, gelbe LED blinkt | Kopf sitzt nicht mittig; testweise "ackseq" weglassen, dann bleibt die Verbindung bei 300 Baud |
Weiterführend: vzlogger-Konfigurationsparameter