Permalink

Marstek Power Meter: den CT in Home Assistant lesen, ohne mitzuspeichern

11/17/2026

Der CT002 und der CT003 von Marstek messen die Netzleistung, nach der ein Speicher wie die Venus regelt. Dieselbe Messung will ich in Home Assistant: Gesamtleistung, die drei Phasen und den WLAN-Pegel. Neuere Zähler liefern zusätzlich die Tarifzähler für Bezug und Einspeisung. Die Abfrage bleibt im LAN, über UDP, ohne Cloud.

Eine Abfrage an diesen Zähler hat die Form einer Speichermeldung. Der CT führt pro MAC einen Slot. Eine echte Akku-MAC mit einer Leistung ungleich null ginge in die Aggregation ein. Die Integration schickt deshalb eine eigene Poller-MAC, Phase 0, 0 W und participate=0.

Warum ein eigenes Projekt

hass_marstek-smart-meter hat den CT bereits nach Home Assistant gebracht. Der Autor pflegt das Repository nicht mehr und hat auf Pull Requests nicht geantwortet. Marstek Power Meter ist deshalb ein eigenständiges Projekt auf dieser Grundlage. Domain marstek_power_meter, Version 1.0.1, Lizenz MPL-2.0.

Der zweite Grund ist die Abfrage selbst. Die Identität des Polls liegt nicht auf einer Akku-MAC. Beim Einrichten schlägt die Integration eine lokal administrierte Unicast-MAC vor. Die Vorgabe kann bleiben, solange kein zweiter Poller dieselbe Adresse benutzt. 000000000000 ist als CT-MAC erlaubt. Die Integration speichert danach die MAC aus der Antwort des Zählers.

Die ursprüngliche Integration nennt als Protokollgrundlage die Firmware-Notizen von R. Weijnen.

Was ankommt

CTKennung im Protokoll
CT002HME-4
CT002, neuere FirmwareTPM2-0
CT003HME-3

Die Anfrage nennt zusätzlich den Speicher, damit der Zähler den Dialog annimmt:

PräfixGerätBeispiel
HMGVenusHMG-50, das ist die Vorgabe
HMBB2500, Version 1
HMAB2500, Version 2
HMKGreensolar, Version 3

Sofort nach dem Setup sichtbar: Gesamtleistung, Phase A, Phase B, Phase C in Watt, WLAN-RSSI in dBm.

Die Tarifregister legt die Integration nur an, wenn dieser Zähler sie schickt. Das tun der CT003 und der neuere CT002 (TPM2-0). Ein CT002 mit HME-4 lässt die Felder weg. Jeder Rohwert ist ein Vielfaches von 0,1 Wh. Die Sensoren rechnen auf Wattstunden um: Schwachlast Bezug, Hochtarif Bezug, Schwachlast Einspeisung, Hochtarif Einspeisung. Die Entitäten sind total_increasing.

Gerätetyp, beide MACs und der Info-Index liegen als Diagnose-Sensoren an und sind standardmäßig deaktiviert.

Wie die Abfrage aussieht

Alle fünf Sekunden geht ein UDP-Datagramm an Port 12345. Der Rahmen ist kurz: SOH, STX, die Länge als ASCII, die Felder durch | getrennt, ETX, danach die XOR-Prüfsumme über den bisherigen Rahmen als zwei Hex-Zeichen.

Die sieben Felder:

|HMG-50|<Poller-MAC>|<CT-Typ>|<CT-MAC>|0|0|0

Phase 0 und 0 W lassen die Aggregate unverändert. participate=0 ist das siebte Feld. Firmware, die es auswertet, bleibt damit außen vor. Ältere Firmware ignoriert das Feld und sieht weiterhin Phase 0 und 0 W.

Die Antwort trägt dieselben Größen in fester Reihenfolge: Gerätetypen und MACs als Text, Leistungen als Ganzzahl in Watt, WLAN-RSSI, und bei den neueren Zählern danach die vier Energiezähler. Eine MAC bleibt Text. Ein rein numerischer Wert darf an dieser Stelle nicht zur Zahl werden, sonst stimmt der spätere Vergleich nicht. Der CT vergleicht die MAC Byte für Byte, einschließlich der Groß- und Kleinschreibung. Doppelpunkte passen nicht hinein. Das Feld ist 13 Zeichen breit. Gespeichert werden zwölf Hex-Zeichen.

Beim Einrichten geht eine echte Abfrage hinaus. Antwortet der Zähler, übernimmt der Eintrag die gemeldete CT-MAC und, wenn sie zu den bekannten Typen gehört, den CT-Typ. Die eindeutige ID des Eintrags ist diese MAC. Denselben Zähler ein zweites Mal anzulegen beendet der Flow.

Ein verlorenes UDP-Paket soll nicht jede Entität auf nicht verfügbar setzen. Der Timeout liegt bei 3 Sekunden, es gibt bis zu drei Versuche mit 0,3 Sekunden Pause. Der Coordinator wartet die ganze Schleife ab. Erst danach gilt die Runde als fehlgeschlagen. Home Assistant führt den blockierenden Socket im Executor aus.

Einrichtung

In HACS unter Integrationen ein eigenes Repository hinzufügen: https://github.com/cbrandlehner/marstek-power-meter, Kategorie Integration. Danach Marstek Power Meter installieren, Home Assistant neu starten und unter Einstellungen, Geräte und Dienste die Integration hinzufügen. Ab Home Assistant 2026.11 liegt HACS im Marketplace. Das eigene Repository kommt dort auf demselben Weg dazu.

Manuell genügt es, den Ordner custom_components/marstek_power_meter nach <config>/custom_components/marstek_power_meter zu kopieren und neu zu starten.

Die CT-MAC steht in der Marstek-App unter Geräteverwaltung. Zwölf Hex-Zeichen, mit oder ohne Doppelpunkte.

FeldBedeutung
IP-AdresseAdresse des CT im LAN
Poller-MACKennung dieser Abfrage, keine Akku-MAC
CT-MACDer Zähler selbst, aus der App
Speicher-TypHMG, HMB, HMA oder HMK
Speicher-NummerTypnummer, Vorgabe 50, zum Beispiel HMG-50
CT-TypHME-4, TPM2-0 oder HME-3

Hinweis

Marstek Power Meter ist ein unabhängiges Open-Source-Projekt ohne Herstellersupport. Es steht in keiner Verbindung zu Marstek und wird von Marstek nicht unterstützt. Nutzung auf eigene Gefahr. Produktnamen beschreiben die Geräte, die die Integration abfragt.

Fazit

Die Netzleistung des CT gehört in Home Assistant. Die Abfrage gehört nicht in die Speicheraggregation. Eine eigene Poller-MAC, Phase 0, 0 W und participate=0 halten den Poll außen vor. Gesamtleistung, Phasen und RSSI kommen alle fünf Sekunden. Die Tarifzähler kommen von den Zählern, die sie senden.

Quellcode: github.com/cbrandlehner/marstek-power-meter. Ausgangsprojekt: hass_marstek-smart-meter.


1 Aufrufe .
Hinweis
Das Weblog gibt meine persönlichen Ansichten und Kommentare wieder und entspricht nicht den Positionen meiner aktuellen oder früheren Arbeitgeber oder Kunden.
Über mich
Nach Kategorie
Meine Seiten
netcraft Linux host Blog Admin OpenNTF
Monatsarchiv