[[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
**Lizenz:** GPL-3.0 • **Version:** v2.0.6 (Stand Juni 2026)
**Sprachen:** Python (≈83 %), JavaScript (≈17 %)
---
## 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
---
## Repository-Struktur
| Pfad | Inhalt |
|---|---|
| `custom_components/marstek_venus_energy_manager/` | Kernintegration (Python) |
| `blueprints/` | Home-Assistant-Automation-Vorlagen |
| `site-docs/` | Dokumentation (mkdocs) |
| `tests/` | Testsuites |
| `.github/` | Workflow-Konfigurationen |
| `hacs.json` | HACS-Konfiguration |
| `mkdocs.yml` | Dokumentationsgenerator |
| `pytest.ini` | Test-Konfiguration |
---
## Hinweise
- **Haftungsausschluss:** Das Projekt wird ohne Gewährleistung bereitgestellt. Nutzer tragen das Risiko für Hardwareschäden durch fehlerhafte Modbus-Register-Konfigurationen.
- **Testplattform des Entwicklers:** 2× Venus E v2, 2× v3 mit Elfin-EW11 und Shelly Pro 3EM.
---
## Bezug zu unserem Setup
- Eigene Hardware-Doku: [[Marstek Venus 3|Marstek Venus 3]], [[Marstek CT002|Marstek CT002]]
- Eigene Energiesteuerung: [[Anwendungen und Projekte/Node-Red Energiefluss Optimierung/01 Node-Red Konzept|Node-Red Energiefluss Optimierung]] (aktuell via Node-RED gelöst – diese Integration wäre eine HA-native Alternative)
- Solarprognose: [[Tibber|Tibber]], Solcast
- zur Kontrolle der BAtteriespeicher:[[03 Marstek-Temperatur-Alarm]]
> [!note] Prüfen
> Diese Integration könnte das bestehende Node-RED-Energiemanagement teilweise oder ganz ersetzen. Vor einem Einsatz: Kompatibilität mit Venus 3 und vorhandenem Shelly-Setup testen.
---
*Erstellt: 2026-06-18*
---
[[Hinweise/Impressum|Impressum]] | [[Hinweise/Datenschutzerklärung|Datenschutz]]