[[Uebersicht|← Zurück zur Homepage]] # Omnibattery > 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://ffunes.github.io/Omnibattery/ **Docs:** https://ffunes.github.io/Omnibattery/ **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. Dies ist die zentrale Funktion zur Verwaltung von Balkonkraftwerk, Marstek Speicher, Stromverbrauch und Strombezug vom öffentlichen Netz. Im Falle einer Fehlfunktion dieser Anwendung ist wie --- ## 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 „Omnibattery" suchen 2. Installieren 3. Home Assistant neu starten **Manuell:** - Komponente `omnibattery` 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 | |-----------|--------|-----------| | Omnibattery | ✅ 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: [[03 Marstek Venus 3|Marstek Venus 3]], [[05 Marstek CT002|Marstek CT002]] - Bisherige Energiesteuerung: [[01 Node-Red Konzept|Node-Red Energiefluss Optimierung]] (durch diese Integration abgelöst) - Solarprognose: [[Tibber]], Solcast - Temperaturschutz der Speicher: [[06 Marstek-Temperatur-Alarm|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]]