Marstek Venus Energy Manager für Home Assistant (Marketplace-Integration)

Installationen: 79 teilen Analysedaten
GitHub-Sterne: 148
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v2.1.1, 14. Juli 2026
Kategorie: Energie, Solar und Batteriespeicher
Art: Marketplace-Integration
Marke: Marstek
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: marstek_venus_energy_manager
Quelle: github.com/ffunes/Marstek-Venus-Energy-Manager
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Screenshots Aus der README von ffunes/Marstek-Venus-Energy-Manager.

Überblick

Marstek Venus Energy Manager überwacht und steuert Marstek Venus E, A und D Batterien über lokales Modbus TCP. Es fügt einen Proportional-Differential-Regler hinzu, der die Batterieleistung anpasst, um Netzbezug und Netzeinspeisung nahe null zu halten, mit wählbaren Abstimmungsprofilen und einem Sensor für die Regelqualität. Die vorausschauende Netzladung nutzt einen Sensor für die Solarprognose, um aus dem Netz zu laden, wenn Prognose und Batterie den nächsten Tag nicht abdecken, und eine Ladeverzögerung hält dies zurück, solange die Solarenergie es noch abdecken kann. Zeitfenster pro Batterie legen fest, wann Laden oder Entladen erlaubt ist, mit optionalen Grenzen für Ladestand und Leistung, sowie einem manuellen Modus, der eine feste Leistung erzwingt. Weitere Funktionen sind Lastspitzenkappung, wöchentliche Vollladung für den Zellausgleich, Lastausschluss für Geräte mit hoher Leistung und Unterstützung für mehrere Batterien. Der Reparaturhinweis besagt, dass die Integration eingestellt wurde, und verweist auf Omnibattery, und die Einrichtung erfolgt in der Benutzeroberfläche.

Zusammenfassung der README und des Codes von ffunes/Marstek-Venus-Energy-Manager, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Schalter
Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Marstek Venus Energy Manager konfigurieren

NetzverbrauchssensorSensor, der importierte (+) oder exportierte (-) Leistung ins Netz anzeigt. Der Controller passt die Batterien an, um diesen Wert nahe 0W zu halten.
Solarprognose-Sensor (optional)Sensor, der die Solarproduktionsprognose in kWh liefert (z.B. Solcast). Wenn hier konfiguriert, wird er automatisch für prädiktive Ladung und Solarladungsverzögerung verwendet.
Solarproduktionssensor (optional)Echtzeit-PV-Produktionsleistungssensor (W/kW) von einem externen Wechselrichter, der nicht über die MPPT-Eingänge der Batterie geführt wird. Wird verwendet, um den Solar-Knoten im Energiefluss-Diagramm des Dashboards anzuzeigen. Leer lassen, wenn deine Module direkt den MPPT der Batterie speisen.
Zählervorzeichen invertiertAktivieren Sie diese Option, wenn Ihr Zähler die umgekehrte Konvention verwendet: positiv = Export, negativ = Import. Die Einheit (W/kW) wird automatisch erkannt.
Maximale Vertragsleistung (W)Gesamt-Vertragsleistung in Watt. Das System überschreitet dieses Limit beim Laden nicht, um ein Auslösen der Sicherung zu vermeiden

Anzahl der Batterien

Anzahl der Batterien

Schritt 3

NameBeschreibender Name zur Identifizierung dieser Batterie
IP-AdresseIP-Adresse der Batterie in Ihrem lokalen Netzwerk
Modbus-PortModbus-Port (normalerweise 502)
Modbus Slave IDModbus-Slave-/Unit-ID (Standard 1). Ändere sie nur, wenn ein Modbus-Proxy mehrere Batterien mit unterschiedlichen Slave-IDs auf eine IP:Port abbildet.
BatteriemodellWählen Sie die Modellversion Ihrer Batterie. Ev2 für ältere Modelle, Ev3 für neuere Modelle mit aktualisierter Registerkarte, A (Venus A) oder D (Venus D) für Hybrid-Wechselrichter-Modelle

Schritt 4

Maximale Ladeleistung (W)Maximal zulässige Leistung zum Laden der Batterie
Maximale Entladeleistung (W)Maximal zulässige Leistung zum Entladen der Batterie
Maximaler SOC (%)Maximaler Ladezustand - Batterie lädt nicht über diesen Wert
Minimaler SOC (%)Minimaler Ladezustand - Batterie entlädt nicht unter diesen Wert
Ladehysterese aktivierenVerhindert das Laden der Batterie, wenn der SOC nahe am Maximum ist
Hysterese-Prozentsatz (%)Batterie lädt nicht, bis der SOC auf (max_soc - Hysterese) fällt. Bsp.: Max SOC 100% mit 5% Hysterese = kein Laden bis 95%
Schwellenwert für Backup-Offgrid-Last (W)Eine Offgrid-Last über diesem Wert wird als aktives Backup-Ereignis behandelt und schließt die Batterie aus der PD-Regelung aus. Erhöhen, wenn dauerhafte Lasten (Router, Kameras) am Offgrid-Port angeschlossen sind.
100%-Ladung per Zellspannung reduzierenWenn das Ziel 100% ist, wird die Ladung ab 3.48 V maximaler Zellspannung auf 95 W begrenzt und bei 3.58 V gestoppt, um den Zellversatz nach 60 Sekunden zu messen.

Entladungs-Zeitfenster

Zeitfenster konfigurieren

Schritt 6

StartzeitStartzeit (24h). Mitternachtsübergang wird unterstützt.
EndzeitEndzeit (24h).
WochentageTage, an denen dieses Zeitfenster gilt.
Betroffene BatterieWählen Sie 'all' für alle Batterien oder eine bestimmte.
Laden erlaubenWenn aktiviert, ist Laden während des Fensters erlaubt. Wenn KEIN Fenster Laden erlaubt, ist Laden standardmäßig frei.
Entladen erlaubenWenn aktiviert, ist Entladen während des Fensters erlaubt. Wenn KEIN Fenster Entladen erlaubt, ist Entladen standardmäßig frei.
SOC max/min des Fensters steuernWenn aktiviert, überschreibt das Fenster den SOC max/min der Batterie.
Max. Lade-/Entladeleistung steuernWenn aktiviert, begrenzt oder erzwingt das Fenster die maximale Leistung.
BetriebsmodusPD: Der prädiktive Algorithmus regelt die Leistung mit dem Fenster-Limit. Manuell: Erzwungenes Entladen oder Laden bei der angegebenen Leistung.

Schritt 7

Batterie 1 — Min. SOC (%)
Batterie 1 — Max. SOC (%)
Batterie 1 — Max. Ladeleistung (W)
Batterie 1 — Max. Entladeleistung (W)
Batterie 2 — Min. SOC (%)
Batterie 2 — Max. SOC (%)
Batterie 2 — Max. Ladeleistung (W)
Batterie 2 — Max. Entladeleistung (W)
Batterie 3 — Min. SOC (%)
Batterie 3 — Max. SOC (%)
Batterie 3 — Max. Ladeleistung (W)
Batterie 3 — Max. Entladeleistung (W)
Batterie 4 — Min. SOC (%)
Batterie 4 — Max. SOC (%)
Batterie 4 — Max. Ladeleistung (W)

Weitere Zeitfenster hinzufügen

Weiteres Zeitfenster hinzufügen

Nach der Einrichtung

NetzverbrauchssensorSensor, der importierte (+) oder exportierte (-) Leistung ins Netz anzeigt.
Solarprognose-Sensor (optional)Sensor, der die Solarproduktionsprognose in kWh liefert (z.B. Solcast). Wenn hier konfiguriert, wird er automatisch für prädiktive Ladung und Solarladungsverzögerung verwendet.
Solarproduktionssensor (optional)Echtzeit-PV-Produktionsleistungssensor (W/kW) von einem externen Wechselrichter, der nicht über die MPPT-Eingänge der Batterie geführt wird. Wird verwendet, um den Solar-Knoten im Energiefluss-Diagramm des Dashboards anzuzeigen. Leer lassen, wenn deine Module direkt den MPPT der Batterie speisen.
Zählervorzeichen invertiertAktivieren Sie diese Option, wenn Ihr Zähler die umgekehrte Konvention verwendet: positiv = Export, negativ = Import. Die Einheit (W/kW) wird automatisch erkannt.
Maximale Vertragsleistung (W)Gesamt-Vertragsleistung in Watt. Das System überschreitet dieses Limit beim Laden nicht, um ein Auslösen der Sicherung zu vermeiden
Anzahl der Batterien
NameBeschreibender Name zur Identifizierung dieser Batterie
IP-AdresseIP-Adresse der Batterie in Ihrem lokalen Netzwerk
Modbus-PortModbus-Port (normalerweise 502)
Modbus Slave IDModbus-Slave-/Unit-ID (Standard 1). Ändere sie nur, wenn ein Modbus-Proxy mehrere Batterien mit unterschiedlichen Slave-IDs auf eine IP:Port abbildet.
BatteriemodellWählen Sie die Modellversion Ihrer Batterie. Ev2 für ältere Modelle, Ev3 für neuere Modelle mit aktualisierter Registerkarte, A (Venus A) oder D (Venus D) für Hybrid-Wechselrichter-Modelle
Maximale Ladeleistung (W)Maximal zulässige Leistung zum Laden der Batterie
Maximale Entladeleistung (W)Maximal zulässige Leistung zum Entladen der Batterie
Maximaler SOC (%)Maximaler Ladezustand
Minimaler SOC (%)Minimaler Ladezustand
Ladehysterese aktivierenVerhindert das Laden der Batterie, wenn der SOC nahe am Maximum ist
Hysterese-Prozentsatz (%)Batterie lädt nicht, bis der SOC auf (max_soc - Hysterese) fällt. Bsp.: Max SOC 100% mit 5% Hysterese = kein Laden bis 95%
Schwellenwert für Backup-Offgrid-Last (W)Eine Offgrid-Last über diesem Wert wird als aktives Backup-Ereignis behandelt und schließt die Batterie aus der PD-Regelung aus. Erhöhen, wenn dauerhafte Lasten (Router, Kameras) am Offgrid-Port angeschlossen sind.
100%-Ladung per Zellspannung reduzierenWenn das Ziel 100% ist, wird die Ladung ab 3.48 V maximaler Zellspannung auf 95 W begrenzt und bei 3.58 V gestoppt, um den Zellversatz nach 60 Sekunden zu messen.
Zeitfenster konfigurieren
StartzeitStartzeit (24h). Mitternachtsübergang wird unterstützt.
EndzeitEndzeit (24h).
WochentageTage, an denen dieses Zeitfenster gilt.
Betroffene BatterieWählen Sie 'all' für alle Batterien oder eine bestimmte.
Laden erlaubenWenn aktiviert, ist Laden während des Fensters erlaubt. Wenn KEIN Fenster Laden erlaubt, ist Laden standardmäßig frei.
Entladen erlaubenWenn aktiviert, ist Entladen während des Fensters erlaubt. Wenn KEIN Fenster Entladen erlaubt, ist Entladen standardmäßig frei.
SOC max/min des Fensters steuernWenn aktiviert, überschreibt das Fenster den SOC max/min der Batterie.
Max. Lade-/Entladeleistung steuernWenn aktiviert, begrenzt oder erzwingt das Fenster die maximale Leistung.
BetriebsmodusPD: Der prädiktive Algorithmus regelt die Leistung mit dem Fenster-Limit. Manuell: Erzwungenes Entladen oder Laden bei der angegebenen Leistung.
Batterie 1 — Min. SOC (%)
Batterie 1 — Max. SOC (%)
Batterie 1 — Max. Ladeleistung (W)
Batterie 1 — Max. Entladeleistung (W)
Batterie 2 — Min. SOC (%)
Batterie 2 — Max. SOC (%)
Batterie 2 — Max. Ladeleistung (W)
Batterie 2 — Max. Entladeleistung (W)
Batterie 3 — Min. SOC (%)
Batterie 3 — Max. SOC (%)
Batterie 3 — Max. Ladeleistung (W)
Batterie 3 — Max. Entladeleistung (W)
Batterie 4 — Min. SOC (%)
Batterie 4 — Max. SOC (%)
Batterie 4 — Max. Ladeleistung (W)
Weiteres Zeitfenster hinzufügen

Texte aus dem Code von ffunes/Marstek-Venus-Energy-Manager. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

BinärsensorenSpitzenlastkappung Aktiv, Prädiktives Laden Aktiv, WLAN-Status, Cloud-Status, Balancier-Modus, Ladehysterese
TastenGerät zurücksetzen
ZahlenLadeleistung, Entladeleistung, Max. Ladeleistung, Max. Entladeleistung, Lade-SOC-Grenzwert, Entlade-SOC-Grenzwert, Laden bis SOC, PD Kp, PD Kd, PD Totband, PD Max. Leistungsänderung, PD Richtungshysterese und 16 weitere
AuswahlfelderBetriebsmodus erzwingen, Arbeitsmodus, Tag der wöchentlichen Vollladung, PD-Tuning-Profil
SensorenEntladefenster, Aktive Batterien, System-Batteriezellenleistung, Gesamt-Solarleistung, Tägliche Solarproduktion, Täglicher Haushaltsverbrauch, PD-Regelqualität, Haushaltsverbrauch, Täglicher Netzbezug, Tägliche Netzeinspeisung, Nicht reagierende Batterien, Konfigurationsübersicht und 54 weitere
SchalterManueller Modus, Prädiktives Laden, Ladeverzögerung, Spitzenlastkappung, Backup-Funktion, RS485-Steuermodus, Laden Erlauben, Entladen Erlauben, 100%-Ladungsreduktion per Spannung, Aktiver Zellabgleich, Laden nach externem Preis, Netto-Balance
UhrzeitenEnde Externes Laden

Fehlerbehebung

ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Diese Integration wird eingestellt — zu Omnibattery migrieren

Aus der README

The Marstek Venus Energy Manager is a comprehensive Home Assistant integration designed to monitor and control Marstek Venus E and C series batteries (v2 and v3) and Venus D and Venus A series batteries via Modbus TCP. It provides advanced energy management features including predictive grid charging, customizable time slots for discharge control, and device load exclusion logic.
Zero Export/Import PD Controller: Keeps grid exchange near zero using a Proportional-Derivative algorithm.
Oscillation Prevention: Deadband and derivative gain prevent rapid charge/discharge cycling.
One-Click PD Profiles + Quality Sensor: Pick a tuning profile (Very smooth → Very aggressive) instead of tuning gains by hand; a control-quality sensor reports whether the result is stable,…
Multi-Battery Support: Manage up to 6 batteries with intelligent load sharing and SOC-based priority.
Predictive Grid Charging: Automatically charges from the grid when solar forecast + battery won't cover tomorrow's consumption. Supports fixed time slots, dynamic pricing, and real-time pricing…
Time Slots (v2): Per-battery windows with independent charge/discharge ticks, optional SOC and power overrides, and a manual mode that forces a fixed charge or discharge power. Up to 8 slots per…
Weekly Full Charge: Forces 100% SOC once a week for LFP cell balancing.
Solar-Aware Charge Delay: Holds back grid charging while solar can still cover the required energy.

Aus der README von ffunes/Marstek-Venus-Energy-Manager, GNU GPL v3.0. Gekürzt.