Marstek CT002 / CT003 emulator

Marstek-Akkus (Venus, Jupiter, B2500) brauchen einen Zähler, damit sie wissen, wie viel Strom dein Haus gerade braucht. Marstek verkauft dafür ein eigenes Gerät, das CT002 / CT003. Dieses Programm macht aus deinem Lesekopf so ein Gerät: Es liest deinen Stromzähler aus und antwortet den Akkus genau wie ein echtes CT. So kann dein Akku genau so viel einspeisen, wie dein Haus braucht (Nulleinspeisung).

Es gibt drei Wege, einen Akku mit einem nachgebildeten Zähler zu verbinden: Shelly Pro 3EM, EcoTracker und dieses CT002. Der große Vorteil des CT002: Es stimmt mehrere Akkus aufeinander ab. Jeder Akku meldet dem CT seine Leistung und seine Phase, und das CT sagt jedem Akku, wie viele Akkus sich seine Phase teilen. So arbeiten zwei Akkus auf derselben Phase nicht mehr gegeneinander. Auch Phase D wird unterstützt: Der Akku nimmt dann die Summe aller drei Phasen, was bei einem normalen (saldierenden) Zähler meistens richtig ist.

Ist Aktive Regelung aus, gibt das Programm den Zählerwert einfach weiter und jeder Akku regelt selbst. Ist sie an, hilft das Programm den Akkus, ruhiger und genauer zu regeln (siehe Akku).

Du brauchst: einen ESP32 (keinen ESP8266), mein Tasmota-Image mit TinyC 1.6.64 oder neuer und einen Lesekopf (Beispiele auf meinem Blog). Eine ältere Firmware lädt das Programm nicht und sagt dir das auch.

ESP8266: Dafür gibt es ein eigenes Script für bis zu 4 Marstek-Akkus, 2_CT002_Emulator.tas (von next145), ohne die hier beschriebene zusätzliche Regelung. Es braucht das Image tasmota1m_ct002_ottelo_tas (für ein OTA-Update vorher das Minimal-Image laden). Darin gibt es die Seite Marstek CT002 (/ctreg, unter Tools), um das CT einmalig in der Marstek-Cloud anzumelden.

1. SML + Marstek CT002 (oder SML Chart + Marstek CT002, wenn du Diagramme willst) in Slot 0 laden. Wie das geht, steht Schritt für Schritt unter Installation.
2. In der Zeile des Slots A einschalten, damit das Programm nach einem Neustart von selbst startet.
3. Zuerst deinen Zähler einrichten (siehe Zähler). Ohne Zählerwerte meldet das CT 0 W.
4. Das CT in deinem Marstek-Konto anlegen und in der Marstek-App auswählen.

Nur in Slot 0. Die Anmeldeseite /ctreg funktioniert nur dort.

Alle CT- und Akku-Einstellungen findest du auf einer eigenen Seite: Knopf 🔋 CT im Tasmota-Hauptmenü, oder der Link oben auf der Einstellungsseite.

Unter den Einstellungen siehst du drei Zähler: rx = empfangene Anfragen, tx = gesendete Antworten, bad = kaputte Anfragen. bad sollte bei 0 bleiben.

Offset und Trim zusammen: Der Offset ist der Abstand, den du willst, der Trim sorgt dafür, dass er auch wirklich erreicht wird. Mit Offset 50 und Trim 15 bekommst du 50 W Bezug und nicht 65.

Was die Aktive Regelung außerdem macht (ohne Einstellungen, nach dem bewährten Vorbild von AstraMeter):

• Sie berücksichtigt, was die Akkus schon geändert haben, der Zähler aber noch nicht zeigt. Ohne das würde eine Korrektur doppelt gemacht, und die Akkus würden hoch und runter schwingen.
• Wechseln die Korrekturen ständig die Richtung, bremst sie sie ab. Eine echte Änderung deines Verbrauchs kommt trotzdem voll durch.
• Sie überspringt einen Zählerwert, der sich seit dem letzten Mal nicht geändert hat. So wird ein langsamer Zähler nicht doppelt gezählt.

3 Phasen stellst du auf der Haupt-Einstellungsseite unter Zähler ein. Ist es aus, liegt die ganze Leistung auf L1, und L2/L3 bleiben 0. Stelle dann alle Akkus auf Phase A oder D, sonst sieht ein Akku auf B oder C immer 0 W.

Phase wählen

Die Phase stellst du am Akku in der Marstek-App ein, nicht hier:

• A / B / C: Der Akku regelt auf diese eine Phase und teilt sie sich mit anderen Akkus auf derselben Phase.
• D: Der Akku nimmt die Summe aller drei Phasen. Bei einem normalen (saldierenden) Zähler meistens die richtige Wahl.
• x auf der Webseite heißt: Der Akku sucht noch seine Phase. Er ändert dazu seine eigene Leistung und schaut, welche Phase sich mitbewegt. Mit einem Simulator, der immer dieselben Werte schickt, wird er nie fertig. Stelle die Phase dann in der App fest ein.
• Solange ein Akku sucht, bekommt er den unveränderten Zählerwert, ohne Offset und ohne Regelung, sonst würde die Suche nicht funktionieren. Im Log steht zu Beginn ph? und am Ende ph A (oder B, C, D), danach reseed: Die Regelung fängt frisch an. Eine Venus mit Firmware 1.50 wiederholt diese Suche etwa alle 35 Minuten.
• Die anderen Akkus dürfen den Suchschritt nicht wegregeln. Auf D werden sie geregelt, als wäre der suchende Akku nicht da. Auf A/B/C halten sie ihre Leistung, solange der suchende Akku Leistung schiebt, denn auf welcher Phase er hängt, weiß noch keiner. Das dauert höchstens etwa 40 Sekunden.
• Direkt nach einem Neustart, bevor der Zähler seinen ersten Wert geliefert hat, bekommt ein suchender Akku keine Antwort. Er wartet und versucht es erneut, statt eine falsche Phase zu speichern.

Dieser Abschnitt ist nur wichtig, wenn zwei oder mehr Akkus auf derselben Phase hängen. Bei einem Akku kannst du hier alles ausgeschaltet lassen.

Bei mehreren Akkus Last verteilen einschalten. Sonst bekommt jeder Akku den ganzen Unterschied seiner Phase gemeldet. Zwei Akkus liefern dann beide den vollen Betrag und schießen zusammen um das Doppelte übers Ziel.

B2500: mindestens 80 W

Ein B2500 (Gerätetypen HMA, HMJ, HMK) kann nicht weniger als etwa 80 W liefern. Teilen sich zwei davon einen Bedarf von 100 W, bekäme jeder 50 W gemeldet, und beide blieben aus.

Das CT erkennt einen B2500 an seinem Gerätetyp und regelt das selbst, du musst nichts einstellen:

• Es gibt jedem aktiven B2500 mindestens 80 W, statt den Bedarf zu fein aufzuteilen. Ein zweiter kommt erst bei etwa 190 W dazu.
• Wird nur einer gebraucht, wechselt der aktive alle 15 Minuten, damit alle gleich abgenutzt werden. Der alte fährt dabei langsam herunter, so entsteht keine Lücke.
• Ist der aktive voll, leer oder an seiner Grenze, übernimmt sofort ein anderer, nicht erst beim nächsten Wechsel. Dafür muss Sättigung an sein.
• Es bewertet einen B2500 unter 80 W nicht als „reagiert nicht“, weil er das gar nicht kann.
• Min DC gilt nur für einen B2500. Eine Venus oder ein Jupiter kann nicht einschlafen.
• Auf einer Phase mit B2500 ist Schritt mindestens 80 W, sonst würde der Akku nie anlaufen.

Hintergrund

Die Regelung folgt AstraMeter und nutzt dessen bewährte Werte. Ein paar Dinge, die früher einstellbar waren, sind jetzt fest, auf Rat des AstraMeter-Autors: Zu viele Stellschrauben machen es schwerer, und ohne Messungen kann sie niemand gut einstellen.

Zwei Dinge sind bewusst anders, wegen offener Meldungen dort: Sehr kleine Korrekturen werden gar nicht erst gesendet, weil ein Marstek-Akku sie sowieso ignoriert (Meldung 600). Und Min DC gilt für jeden Akku einzeln, nicht für die ganze Phase (Meldung 624).

Der Zähler wird auf der Haupt-Einstellungsseite eingerichtet, genau wie in allen meinen Programmen. Alles dazu steht auf der SML-Hilfeseite. Kurz gesagt:

Das CT braucht Wert 1 = Leistung. Für 3 Phasen muss der Zähler zusätzlich die Leistung jeder Phase als Wert 4, 5 und 6 liefern.

PwrAvg / PwrSP (MQTT) schickt alle 5 Sekunden zwei Werte per MQTT: PwrAvg, die geglättete Netzleistung, und PwrSP, das, was dieses CT den Akkus meldet (mit Offset). Beide stehen auch unter dem Schalter. /pwr liefert sie immer, auch wenn der Schalter aus ist.

MQTT

stat/<topic>/script/PwrAvg
stat/<topic>/script/PwrSP

Das sind dieselben Topics wie in den alten Scripten, vorhandene Home-Assistant-Sensoren laufen also weiter. Im MQTT Explorer: stat → <topic> → script, zum Beispiel stat/tasmota_31F8D4/script/PwrSP.

HTTP

http://<ip>/pwr
{"sml1":-440,"sml2":26714.950,"sml3":659.775,"sml4":-440,"sml5":0,"sml6":0,"PwrAvg":-217,"PwrSP":-180}

Für einen zweiten Akku, der die Netzleistung übers Netzwerk abfragt (z.B. opendtu-onbattery): diese Adresse eintragen und PwrAvg verwenden. Ein Passwort brauchst du nicht.

PwrAvg reagiert absichtlich langsam (es braucht etwa eine Minute, um einer Änderung zu folgen). Es ist für etwas gedacht, das nicht jeder kurzen Spitze folgen soll. Für den aktuellen Wert nimm PwrSP oder sml1.

Mit jeder Telemetrie (tele/<topic>/SENSOR, alle TelePeriod) hängt das Programm einen Block CT002 an: Power und L1–L3 sind das, was das CT meldet, dazu Slaves, Offset und Limit. Jeder Akku bekommt einen eigenen Eintrag Bat1, Bat2 … mit MAC, Phase, Power (was der Akku nach eigener Angabe liefert, + = Entladen), daneben Bat1Target … mit dem, was das CT diesem Akku zuletzt gemeldet hat. Jeder Wattwert heißt Power, damit die Tasmota-Integration in Home Assistant ihn in W anzeigt (z. B. CT002 L1 Power). Bis 14.10.2026 waren L1–L3, Offset und Limit einfache Zahlen. Sensoren, die darauf eingerichtet sind, musst du neu einrichten. Die schnellen Meldungen des SML-Treibers enthalten nur den Zählerwert. Schau im MQTT Explorer deshalb in den Verlauf, oder gib in der Konsole Status 10 ein.

"CT002":{"Power":-180,"L1":{"Power":-180},"L2":{"Power":0},"L3":{"Power":0},
         "Slaves":1,"Offset":{"Power":0},"Limit":{"Power":0},
         "Bat1":{"MAC":"aabbccddeeff","Phase":"A","Power":300},"Bat1Target":{"Power":-180}}

Offset aus Home Assistant

Automatisch: Das Programm meldet Offset und Max DC selbst bei Home Assistant an (MQTT-Discovery). Sie erscheinen als Zahlenfelder am Tasmota-Gerät, du musst nichts einrichten. Dafür muss in Home Assistant die MQTT-Discovery an sein (ist sie standardmäßig) und Tasmota das Standard-FullTopic nutzen.

Du kannst den Offset auch mit dem Befehl CTOffset <W> ändern. CTOffset ohne Wert zeigt den aktuellen an. Per MQTT: cmnd/<topic>/CTOffset, per HTTP: /cm?cmnd=CTOffset%20-50. Der aktuelle Wert steht außerdem in tele/<topic>/SENSOR als "CT002":{…,"Offset":-50}. Kleinster Wert −200 W.

Ein so gesetzter Wert gilt nur bis zum nächsten Neustart. Eine Automation darf ihn also beliebig oft ändern, ohne den Flash-Speicher abzunutzen. Nach einem Neustart gilt wieder der auf der Seite gespeicherte Wert. Das Feld auf der Seite zeigt den gespeicherten Wert, rechts daneben steht der gerade benutzte. Soll ein Wert bleiben, trag ihn ins Feld ein und drücke Speichern.

Ohne Discovery kannst du das Feld selbst in der configuration.yaml anlegen (<topic> durch das MQTT-Topic deines Geräts ersetzen):

mqtt:
  number:
    - name: "CT002 Offset"
      unique_id: ct002_offset
      command_topic: "cmnd/<topic>/CTOffset"
      state_topic: "tele/<topic>/SENSOR"
      value_template: >-
        {% if value_json.CT002 is defined %}{{ value_json.CT002.Offset.Power }}
        {% else %}{{ states('number.ct002_offset') }}{% endif %}
      optimistic: true
      min: -200
      max: 2000
      step: 5
      mode: box
      unit_of_measurement: "W"

Ohne MQTT dasselbe per HTTP:

rest_command:
  pv_offset:
    url: "http://<ip>/cm?cmnd=CTOffset%20{{ offset }}"

Dann rest_command.pv_offset mit offset: -50 aufrufen. Beispiel für eine Automation, die nachts einen größeren Abstand einstellt:

automation:
  - alias: "Offset 50 W at night"
    triggers:
      - trigger: time
        at: "22:00:00"
    actions:
      - action: number.set_value
        target:
          entity_id: number.ct002_offset
        data:
          value: 50

Entladelimit

CTLimit <W> begrenzt, wie viel jeder Akku entladen darf. CTLimit 0 schaltet die Begrenzung aus, CTLimit allein zeigt sie an. Ein negativer Wert dreht es um: CTLimit -300 lässt jeden Akku mit mindestens 300 W laden, ohne Überschuss aus dem Netz. Das geht nur mit Akkus, die aus dem Netz laden können, zum Beispiel dem Venus. Ein B2500 entlädt dann einfach nicht mehr. Wie der Offset gilt sie nur bis zum nächsten Neustart, danach gilt wieder der auf der Seite gespeicherte Wert Max DC. Solange eine Begrenzung aktiv ist, zeigt die Hauptseite eine Zeile Max DC.

Die Begrenzung gilt für jeden Akku einzeln, wirkt bei jeder Phaseneinstellung, und ein positiver Wert lässt das Laden in Ruhe. Während ein Akku seine Phase sucht, ist sie ausgesetzt. Den Rest deines Verbrauchs liefert das Netz.

mqtt:
  number:
    - name: "CT002 Limit"
      unique_id: ct002_limit
      command_topic: "cmnd/<topic>/CTLimit"
      state_topic: "tele/<topic>/SENSOR"
      value_template: >-
        {% if value_json.CT002 is defined %}{{ value_json.CT002.Limit.Power }}
        {% else %}{{ states('number.ct002_limit') }}{% endif %}
      optimistic: true
      min: -2500
      max: 2500
      step: 10
      mode: box
      unit_of_measurement: "W"

Ein Limit von 0 schaltet die Begrenzung aus, es hält den Akku nicht an. Um einen Akku bei null zu halten, nimm 1 W.

Ein Akku spricht nur mit einem CT, das in deinem Marstek-Konto existiert. Das Programm kann so ein CT für dich in deinem Konto anlegen (genau wie AstraMeter es macht).

1. Im Tasmota-Hauptmenü auf ☁️ Marstek drücken und deine Marstek-E-Mail und dein Passwort eintragen.
2. Log in + check account drücken. Gibt es schon ein so angelegtes CT, wird es übernommen.
3. Wurde keins gefunden: Create fake CT drücken und bestätigen. Die Statuszeile wird grün, wenn es geklappt hat.
4. In der Marstek-App die CT-Liste aktualisieren (notfalls ab- und wieder anmelden), das neue CT auswählen und den Akku auf Automatik stellen.

Create ist ausgegraut, solange eine CT MAC eingetragen ist. Clear CT MAC unten auf derselben Seite löscht sie. Das löscht nur die MAC auf dem Gerät. Das CT in deinem Marstek-Konto bleibt und muss in der App gelöscht werden.

Gut zu wissen

• Das CT steht in der App auf offline, und seine Werte zeigen --. Das ist normal und stört die Regelung nicht: Der Akku spricht direkt in deinem Heimnetz mit dem CT, die App holt ihre Anzeige aber aus der Marstek-Cloud, und mit der verbindet sich das Programm nie.
• Lege nur ein CT an. Gibt es mehrere, nutzt die App vielleicht ein anderes, als dein Gerät bedient.

Dein Passwort geht unverschlüsselt durch dein Heimnetz vom Browser zum Gerät. Es wird nicht auf dem Gerät gespeichert, bleibt 10 Minuten im Arbeitsspeicher und wird nach dem Anlegen gelöscht.

Das Anlegen nutzt eine nicht offizielle Marstek-Schnittstelle mit deinem eigenen Konto. Das kann gegen die Nutzungsbedingungen von Marstek verstoßen. Es ist dein Konto und dein Risiko. Im schlimmsten Fall entfernt Marstek das Gerät oder geht gegen das Konto vor.

Log-Meldungen sind immer englisch. So lassen sie sich leichter vergleichen, wenn du um Hilfe fragst.