sphings-dev.de

Energie & Speicher

Marstek Modbus Register

Doku

Community-Dokumentation der Modbus-TCP-Register der Marstek Venus D (30000–49999): gescannte Werte, Skalierungen und undokumentierte Register, abgeglichen mit der ViperRNMC-Integration. Zweisprachig, als CSV und Markdown.

Repository (öffnet in neuem Tab)

Steckbrief

Lizenz
MIT
Projektstart

Marstek Modbus Register dokumentiert die Ergebnisse eines vollständigen Modbus-TCP-Scans der Marstek Venus D. Gescannt wurden alle Registerbereiche von 30000 bis 49999 an einem Gerät mit zwei Packs zu je 16 LFP-Zellen, die Werte wurden mit der Registertabelle der Home-Assistant-Integration ViperRNMC/marstek_venus_modbus abgeglichen. Daraus ist eine Referenz mit interpretierten Werten, Skalierungsfaktoren, Quellspalten und Hinweisen auf Register entstanden, die in der bestehenden Dokumentation fehlen oder falsch zugeordnet sind. Das Repository wird derzeit neu aufgebaut und ist im Moment nicht öffentlich.

Inhalt

  • Der 30000er-Block (Messwerte): 278 Register mit gültigen Daten, dazu ein Fehler bei Register 32085.
  • Der 40000er-Block (Steuerung und Konfiguration): 93 Register mit gültigen Daten.
  • Je Block eine zweisprachige Analyse (Deutsch/Englisch) als Markdown sowie CSV-Dateien für bekannte („matched“) und unbekannte Register mit Best-Guess-Interpretation.

Was bisher fehlte

Der Scan förderte Register zutage, die in der Tabelle der Integration nicht oder nicht vollständig stehen: Header-Register der Packs mit Gesamtspannung, minimaler und maximaler Zellspannung sowie Temperaturen, die Netzwerkkonfiguration des Kommunikationsmoduls in den Registern 30400–30403 und ASCII-Strings in 41500–41515. Außerdem sind Register, die laut Tabelle nur für das Modell e_v12 gelten (32100 Batteriespannung und 32104 SoC), auf der Venus D aktiv. Die Deutung der unbekannten Register steht jeweils als Best Guess in den CSV-Dateien.

Zur Venus-D-Architektur

Die ViperRNMC-Integration unterscheidet vier Geräte-Varianten mit unterschiedlichen Registerlayouts. Für die Venus D gilt die Suchreihenfolge d → e_v3 → a, niemals e_v12, dessen Registermodell völlig abweicht. Die Packs liegen im Abstand von 100 Registern (Pack 1 ab 34000, Pack 2 ab 34100, Erweiterungen bis 34600 im Scan leer). Das Venus-D-Modell hat 16 Zellen je Pack (34018–34033), das A-Modell nur 13. Schreibzugriffe auf die Steuerregister 42010–42021 klappen nur im RS485-Steuermodus: 42000 = 0x55AA aktiv, 0x55BB inaktiv.

Alle Deutungen unbekannter Register sind Vermutungen aus Scans eines einzelnen Geräts und nicht offiziell bestätigt. Schreibzugriffe erfolgen auf eigenes Risiko. Beiträge zu Venus A, D und E sind ausdrücklich erwünscht, am besten mit Modell, Pack-Anzahl und Scan-Ausgabe.

Die später aus der Firmware abgeleitete, vollständige Registerkarte steht im Reverse-Engineering-Repository; die Marstek Modbus Suite setzt sie als Home-Assistant-Integration um.