[[Uebersicht|← Zurück zur Homepage]]
# Marstek Venus Energy Manager
> Home-Assistant-Custom-Integration zur Überwachung und Steuerung von Marstek-Batteriesystemen via **Modbus TCP**. Verbindet Solarprognosen, Netzladen-Strategien und Lastverteilung in einem zentralen Energiemanagement.
**Quelle:** https://github.com/ffunes/Marstek-Venus-Energy-Manager
**Docs:** https://ffunes.github.io/Marstek-Venus-Energy-Manager/
**Lizenz:** GPL-3.0 • **Sprachen:** Python (≈83 %), JavaScript (≈17 %)
**Status bei uns:** ✅ In Betrieb (seit 2026-06-22)
---
## Funktion
Die Integration ermöglicht Besitzern von Marstek-Batterien, ihre Energieflüsse intelligent zu optimieren. Sie kombiniert Solarprognose, vorausschauendes Netzladen und Lastverteilung über mehrere Batterien hinweg.
---
## Hauptmerkmale
| Feature | Beschreibung |
|---|---|
| **Zero-Export-PD-Controller** | Proportional-Derivative-Algorithmus zur Minimierung des Netzaustauschs |
| **Multi-Batterie-Unterstützung** | Bis zu 6 Batterien mit intelligenter Lastverteilung |
| **Vorhersagendes Netzladen** | Lädt automatisch aus dem Netz, wenn Solarprognose + Batterie den morgigen Bedarf nicht decken |
| **Zeitfenster-Steuerung** | Bis zu 8 unabhängige Lade-/Entladefenster pro Integration |
| **Peak-Shaving** | Reserviert Batteriekapazität für Lastspitzen |
| **Lastausschluss** | Blockiert Hochleistungsgeräte (z. B. EV-Ladegerät) von der Batteriedeckung |
| **Wöchentliche Vollladung** | Zur LFP-Zellausgleichung (Balancing) |
---
## Voraussetzungen
| Komponente | Spezifikation |
|---|---|
| **Batteriesystem** | Marstek Venus E v2/v3, Venus A oder Venus D |
| **Modbus-Schnittstelle** | Elfin-EW11 RS485-zu-TCP-Konverter (für Venus E v2); v3/A/D haben natives Ethernet-Modbus-TCP |
| **Netzüberwachung** | HA-Sensor für Netzverbrauch (z. B. Shelly EM3 / Pro 3EM) |
| **Solarprognose** | Optional: Solcast, Forecast.Solar o. ä. |
| **Home Assistant** | Version 2024.x oder neuer |
| **Netzwerk** | Batterien per IP erreichbar |
---
## Installation
**Via HACS (empfohlen):**
1. Im Home Assistant Community Store (HACS) nach „Marstek Venus Energy Manager" suchen
2. Installieren
3. Home Assistant neu starten
**Manuell:**
- Komponente `marstek_venus_energy_manager` aus dem Release-ZIP in das Verzeichnis `custom_components/` kopieren
- Home Assistant neu starten
---
# Unser Setup (in Betrieb)
**Setup abgeschlossen:** 2026-06-22 • **Integrationsversion:** v1.8.2 (Mai 2026)
Custom-Integration zur Steuerung der **3× Marstek Venus E v3** Batterien via Modbus TCP. Ersetzt die bisherige „Marstek Venus Modbus" UI-Integration **und** die Node-RED Energiefluss-Automatisierung.
## Installierte Komponenten
| Komponente | Status | Anmerkung |
|-----------|--------|-----------|
| Marstek Venus Energy Manager | ✅ Aktiv | via HACS, v1.8.2 |
| ENTSO-e Integration | ✅ Aktiv | via HACS, Preiszone DE-LU |
| Marstek Venus Modbus (alt) | ⛔ Deaktiviert | ersetzt durch Energy Manager |
## Konfiguration
### Batterien
- 3× Marstek Venus E v3 (je 13 kWh, AC-gekoppelt)
- Verbindung: Modbus TCP (native Ethernet der Venus E v3)
- Alle 3 Batterien im Energy Manager konfiguriert
### Grid-Sensor
- Entity: `sensor.electricity_arenberger_str_230a_gesamtleistung`
- Vorzeichen: negative Werte = Einspeisung
### Preisintegration
- **Typ:** ENTSO-e (Transparency Platform) • **Zone:** DE-LU (Deutschland)
- **API-Token:** per E-Mail beantragt und eingerichtet • **URL:** https://transparency.entsoe.eu/ • **Kosten:** kostenlos
### Predictive Charging
- **Modus:** Dynamic Pricing • Tägliche Auswertung: 00:05 Uhr
- Wählt automatisch günstigste Stunden zur Netz-Ladung
- Entladung nur wenn Preis > Tagesdurchschnitt (price-based discharge control)
## Features (aktiv/geplant)
| Feature | Status | Anmerkung |
|---------|--------|-----------|
| PD-Controller (Zero Export/Import) | ✅ Aktiv | ~2,5s Regelzyklus |
| Dynamic Pricing (ENTSO-e) | ✅ Aktiv | günstigste Stunden automatisch |
| Multi-Battery Management | ✅ Aktiv | SOC-Priorisierung, 3 Batterien |
| Solar Charge Delay | 🔲 Prüfen | Solcast-Integration nötig |
| Solcast Forecast | 🔲 Prüfen | bereits in HA vorhanden |
| Weekly Full Charge | 🔲 Konfigurieren | LFP-Balancing |
| Cell Balance Monitor | 🔲 Beobachten | nach erster Vollladung |
| Peak Shaving | 🔲 Optional | Schwellwert konfigurieren |
| Hourly Net Balance | 🔲 Optional | Grid-Meter erforderlich |
## Dashboard
- Automatisch als HA Sidebar Panel installiert
- 3 Tabs: Overview / Batteries / Control — kein YAML, kein HACS-Frontend nötig
## Abgelöste Systeme
| System | Status | Grund |
|--------|--------|-------|
| Node-RED Energiefluss (logik.py) | ⛔ Abgelöst | Energy Manager übernimmt |
| Marstek Venus Modbus Integration | ⛔ Deaktiviert | Energy Manager nutzt eigene Modbus TCP |
| Tibber Preissteuerung (Node-RED) | ⛔ Abgelöst | ENTSO-e Dynamic Pricing ersetzt Tibber-Logik |
## Nächste Schritte
- [ ] Solar Charge Delay mit Solcast konfigurieren
- [ ] Weekly Full Charge aktivieren
- [ ] Betrieb beobachten (PD-Controller, Ladezeiten, Kosten)
- [ ] Alte „Marstek Venus Modbus" Integration endgültig löschen (nach Stabilitätsphase)
- [ ] Node-RED Marstek-Flow deaktivieren/löschen
---
## Bezug zu unserem Setup
- Eigene Hardware-Doku: [[Marstek Venus 3]], [[Marstek CT002]]
- Bisherige Energiesteuerung: [[01 Node-Red Konzept|Node-Red Energiefluss Optimierung]] (durch diese Integration abgelöst)
- Solarprognose: [[Tibber]], Solcast
- Temperaturschutz der Speicher: [[Marstek-Temperatur-Alarm]]
---
## Versionshistorie
| Version | Datum | Änderung |
|---------|-------|---------|
| 1.0 | 2026-06-18 | Recherche & Produktbewertung (ehem. HA-Übersicht-Notiz) |
| 1.0 | 2026-06-21 | Initiale Recherche & Bewertung Setup |
| 1.1 | 2026-06-22 | Setup abgeschlossen, in Betrieb |
| 2.0 | 2026-07-11 | Produktbeschreibung + Setup-Doku zu einer Notiz zusammengeführt |
---
[[Impressum|Impressum]] | [[Datenschutzerklärung|Datenschutz]]