[[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 Omnibattery optimiert die Energieflüsse der Marstek-Batterien intelligent: Die Integration kombiniert Solarprognose, vorausschauendes Netzladen und Lastverteilung über mehrere Speicher hinweg und wählt so automatisch die günstigsten Zeitpunkte zum Laden und Entladen. In unserem Setup ist sie die zentrale Steuerung, die Balkonkraftwerk, Marstek-Speicher, Hausverbrauch und Strombezug aus dem öffentlichen Netz aufeinander abstimmt. > [!warning] Bei einer Fehlfunktion > Fällt Omnibattery aus, wird die Steuerung vorübergehend manuell auf die Marstek-Hersteller-App umgestellt. Die genaue Vorgehensweise beschreibt [[12 Plan B Omnibattery|Plan B: Notfall-Steuerung]]. --- ## 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) Die Integration steuert unsere **3× Marstek Venus E v3** direkt über Modbus TCP und ersetzt dabei gleich zwei bisherige Lösungen: die frühere „Marstek Venus Modbus"-UI-Integration sowie die Node-RED-Energiefluss-Automatisierung. ## Installierte Komponenten | Komponente | Status | Anmerkung | |-----------|--------|-----------| | Omnibattery | ✅ Aktiv | via HACS, v1.8.2 | | Tibber Integration | ✅ Aktiv | HA-Integration, dynamischer Stromtarif | | Marstek Venus Modbus (alt) | ⛔ Deaktiviert | ersetzt durch Energy Manager | ## Konfiguration ### Batterien - 3× Marstek Venus E v3 (je 5 kWh → 15 kWh brutto, 13,2 kWh nutzbar, 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:** [[Tibber]] (dynamischer Stundentarif) • **Umgestellt von:** ENTSO-e (Transparency Platform) - **Anbindung:** Tibber Access-Token (developer.tibber.com) • **URL:** https://tibber.com/ • **Kosten:** gemäß Tibber-Tarif ### Predictive Charging - **Modus:** Dynamic Pricing (Preisquelle: Tibber) • 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 (Tibber) | ✅ 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 | Omnibattery Dynamic Pricing (Tibber) ersetzt die Node-RED-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: [[01 Marstek Venus 3|Marstek Venus 3]], [[02 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: [[20 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 | | 2.1 | 2026-07-12 09:34 | Preisintegration von ENTSO-e auf **Tibber** umgestellt (Komponente, Konfiguration, Predictive Charging, Feature-Tabelle) | | 2.2 | 2026-07-12 13:32 | Fließtext geglättet (Funktion, Setup-Intro); abgebrochenen Satz behoben und durch Callout mit Verweis auf Plan B ersetzt | | 2.3 | 2026-07-17 11:05 | Speicherkapazität korrigiert (Nutzerangabe): „je 13 kWh" → **je 5 kWh** (15 kWh brutto, ca. 13 kWh nutzbar). Siehe [[00 Marstek Speicher (MOC)]] v1.4 | | 2.4 | 2026-07-17 12:05 | Nutzbare Kapazität präzisiert: 13,2 kWh (Nutzerangabe) | --- [[Impressum|Impressum]] | [[Datenschutzerklärung|Datenschutz]]