Omnibattery für Home Assistant (Marketplace-Integration)

Installationen: 838 teilen Analysedaten
GitHub-Sterne: 206
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v1.5.0, 13. Oktober 2026
Kategorie: Energie, Solar und Batteriespeicher
Art: Marketplace-Integration
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: omnibattery
Quelle: github.com/ffunes/Omnibattery
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/Omnibattery.

Überblick

Omnibattery ist eine benutzerdefinierte Integration, die unter anderem Heimbatterien von Marstek Venus und Zendure überwacht und steuert. Sie kommuniziert lokal mit den Batterien, je nach Marke über Modbus TCP, serielles Modbus RTU oder lokales HTTP, und wird in der Benutzeroberfläche eingerichtet. Ein Proportional-Differential-Regler hält den Netzaustausch nahe null, mit wählbaren Abstimmungsprofilen und einem Sensor, der die Regelqualität meldet. Mehrere Batterien verschiedener Marken können zusammen verwaltet werden, mit Lastverteilung und Priorität nach Ladezustand. Das Laden kann anhand der Solarprognose und dynamischer Preise geplant werden, mit Zeitfenstern pro Batterie, einer wöchentlichen Vollladung und Lastspitzenkappung. Sie fügt Sensoren, Schalter, Zahlen, Auswahlen, Tasten und Binärsensoren hinzu, dazu optional einen dreiphasigen Stromschutz und Reparaturhinweise.

Zusammenfassung der README und des Codes von ffunes/Omnibattery, 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.

Omnibattery konfigurieren

NetzverbrauchssensorEchtzeitsensor für importierte (+) oder exportierte (-) Netzleistung. Aktualisierungen alle 1-2 Sekunden werden empfohlen. Langsamere Sensoren werden akzeptiert, verzögerte Messwerte verringern jedoch die Regelqualität; dem letzten Messwert wird bis zu 65 Sekunden lang gefolgt.
Off-Grid-Leistungssensor (optional)Separater W/kW-Zähler für den versorgten Ersatzstromkreis. Er muss sich vom normalen Netzsensor unterscheiden. Die Konfiguration stellt einen Software-Schalter bereit, der diese Quelle für Regelung und Statistiken auswählt; der physische Off-Grid/EPS-Port der Batterie wird dadurch nicht aktiviert.
Vorzeichen des Off-Grid-Zählers invertiertAktivieren, wenn der Off-Grid-Sensor die umgekehrte Konvention verwendet: positiv = Export und negativ = Verbrauch. Gilt nur bei aktivem Off-Grid-Zählermodus.
Solarprognose-Sensor für den gesamten Tag (veraltet)Veralteter Sensor für die Solarprognose des gesamten Tages. Bestehende Installationen können ihn während der Übergangszeit weiterverwenden; für neue Konfigurationen wird Heute verbleibend empfohlen.
Sensor für die heute verbleibende Solarprognose (empfohlen)Sensor für die heute noch erwartete Solarproduktion in kWh. Beim Speichern ersetzt er die veraltete Ganztagesprognose und wird nicht um die bereits gemessene Produktion reduziert.
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
Dreiphasigen Stromschutz aktivierenOptionale Strom-Sicherheitsgrenze für dreiphasige Anlagen; Sensoren und physische Batteriephase werden im nächsten Schritt konfiguriert.

Dreiphasiger Stromschutz

Netzstromsensor L1Signierter Echtzeit-RMS-Strom der physischen Phase L1. A und mA werden akzeptiert.
Netzstromsensor L2Signierter Echtzeit-RMS-Strom der physischen Phase L2. A und mA werden akzeptiert.
Netzstromsensor L3Signierter Echtzeit-RMS-Strom der physischen Phase L3. A und mA werden akzeptiert.
Sicherungsgröße L1 (A)Sicherungsgröße/Stromgrenze für L1 in Ampere. Geben Sie einen Wert unterhalb des Nennwerts ein, um Spielraum für Verzögerungen und Spitzen zu lassen.
Sicherungsgröße L2 (A)Sicherungsgröße/Stromgrenze für L2 in Ampere. Geben Sie einen Wert unterhalb des Nennwerts ein, um Spielraum für Verzögerungen und Spitzen zu lassen.
Sicherungsgröße L3 (A)Sicherungsgröße/Stromgrenze für L3 in Ampere. Geben Sie einen Wert unterhalb des Nennwerts ein, um Spielraum für Verzögerungen und Spitzen zu lassen.

Schritt 3

Physische Batteriephase

Anzahl der Batterien

Anzahl der Batterien

Schritt 5

BatteriemarkeMarstek Venus: Modbus TCP. Zendure SolarFlow: lokales HTTP (HEMS muss für die Steuerung durch Omnibattery deaktiviert sein). Anker SOLIX Solarbank Max AC / 4 E5000 Pro: Modbus TCP (aktiviere Modbus TCP unter Third-Party Control in der Anker-App; es ist immer nur ein Modbus-Client gleichzeitig möglich). Sessy: lokales HTTP.

Schritt 6

NameBeschreibender Name zur Identifizierung dieser Batterie
IP-AdresseIP-Adresse der Batterie in Ihrem lokalen Netzwerk. Leer lassen, wenn ein serieller Port verwendet wird.
Modbus-PortModbus-Port (normalerweise 502)
Modbus-Slave-IDModbus Slave-/Unit-ID (Standard 1). Nur ändern, wenn ein Modbus-Proxy mehrere Batterien über dieselbe IP:Port mit unterschiedlichen Slave-IDs 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
Serieller Port (Modbus RTU)Pfad des USB-RS485-Adapters, z. B. /dev/ttyUSB0 oder COM3. Statt der IP-Adresse ausfüllen, um Modbus RTU über die serielle Schnittstelle zu nutzen; für TCP leer lassen.
Über ein RS485-Gateway verbundenAktivieren, wenn die Modbus-TCP-Verbindung auf einem RS485-Gateway (Elfin EW11, USB-RS485-Brücke ...) endet statt am TCP-Port der Batterie selbst. Die Wartezeit zwischen Nachrichten existiert nur im TCP-Server der Batterie; auf 30 ms gesenkt wird die Abfrage einer Venus Ev3/A/D rund dreimal schneller. Die Wartezeit gilt pro Batterie: teilen sich mehrere Batterien ein Gateway, trägt der Bus entsprechend mehr Verkehr — dann wieder deaktivieren, wenn Lesevorgänge fehlschlagen oder in Zeitüberschreitungen laufen. Bei direkter Verbindung zur IP der Batterie ausgeschaltet lassen.

Schritt 7

NameBeschreibender Name zur Identifizierung dieser Batterie
IP-AdresseIP-Adresse des Zendure SolarFlow in Ihrem lokalen Netzwerk
HTTP-PortHTTP-Port (Standard 80)

Schritt 8

Name
MQTT-Geräte-IDHoymiles MQTT-ID, zum Beispiel MSA-280024341346.
BatteriemodellVerwenden Sie die automatische Erkennung, sofern das Gerät kein falsches oder generisches Modell veröffentlicht.

Nach der Einrichtung

Batterie
NetzverbrauchssensorEchtzeitsensor für importierte (+) oder exportierte (-) Netzleistung. Aktualisierungen alle 1-2 Sekunden werden empfohlen. Langsamere Sensoren werden akzeptiert, verzögerte Messwerte verringern jedoch die Regelqualität; dem letzten Messwert wird bis zu 65 Sekunden lang gefolgt.
Off-Grid-Leistungssensor (optional)Separater W/kW-Zähler für den versorgten Ersatzstromkreis. Er muss sich vom normalen Netzsensor unterscheiden. Die Konfiguration stellt einen Software-Schalter bereit, der diese Quelle für Regelung und Statistiken auswählt; der physische Off-Grid/EPS-Port der Batterie wird dadurch nicht aktiviert.
Vorzeichen des Off-Grid-Zählers invertiertAktivieren, wenn der Off-Grid-Sensor die umgekehrte Konvention verwendet: positiv = Export und negativ = Verbrauch. Gilt nur bei aktivem Off-Grid-Zählermodus.
Solarprognose-Sensor für den gesamten Tag (veraltet)Veralteter Sensor für die Solarprognose des gesamten Tages. Bestehende Installationen können ihn während der Übergangszeit weiterverwenden; für neue Konfigurationen wird Heute verbleibend empfohlen.
Sensor für die heute verbleibende Solarprognose (empfohlen)Sensor für die heute noch erwartete Solarproduktion in kWh. Beim Speichern ersetzt er die veraltete Ganztagesprognose und wird nicht um die bereits gemessene Produktion reduziert.
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
Dreiphasigen Stromschutz aktivierenOptionale Strom-Sicherheitsgrenze für dreiphasige Anlagen; Sensoren und physische Batteriephase werden im nächsten Schritt konfiguriert.
Netzstromsensor L1Signierter Echtzeit-RMS-Strom der physischen Phase L1. A und mA werden akzeptiert.
Netzstromsensor L2Signierter Echtzeit-RMS-Strom der physischen Phase L2. A und mA werden akzeptiert.
Netzstromsensor L3Signierter Echtzeit-RMS-Strom der physischen Phase L3. A und mA werden akzeptiert.
Sicherungsgröße L1 (A)Sicherungsgröße/Stromgrenze für L1 in Ampere. Geben Sie einen Wert unterhalb des Nennwerts ein, um Spielraum für Verzögerungen und Spitzen zu lassen.
Sicherungsgröße L2 (A)Sicherungsgröße/Stromgrenze für L2 in Ampere. Geben Sie einen Wert unterhalb des Nennwerts ein, um Spielraum für Verzögerungen und Spitzen zu lassen.
Sicherungsgröße L3 (A)Sicherungsgröße/Stromgrenze für L3 in Ampere. Geben Sie einen Wert unterhalb des Nennwerts ein, um Spielraum für Verzögerungen und Spitzen zu lassen.
Physische Batteriephase
Anzahl der Batterien
BatteriemarkeMarstek Venus: Modbus TCP. Zendure SolarFlow: lokales HTTP (HEMS muss für die Steuerung durch Omnibattery deaktiviert sein). Anker SOLIX Solarbank Max AC / 4 E5000 Pro: Modbus TCP (aktiviere Modbus TCP unter Third-Party Control in der Anker-App; es ist immer nur ein Modbus-Client gleichzeitig möglich). Sessy: lokales HTTP.
NameBeschreibender Name zur Identifizierung dieser Batterie
IP-AdresseIP-Adresse der Batterie in Ihrem lokalen Netzwerk. Leer lassen, wenn ein serieller Port verwendet wird.
Modbus-PortModbus-Port (normalerweise 502)
Modbus-Slave-IDModbus Slave-/Unit-ID (Standard 1). Nur ändern, wenn ein Modbus-Proxy mehrere Batterien über dieselbe IP:Port mit unterschiedlichen Slave-IDs 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
Serieller Port (Modbus RTU)Pfad des USB-RS485-Adapters, z. B. /dev/ttyUSB0 oder COM3. Statt der IP-Adresse ausfüllen, um Modbus RTU über die serielle Schnittstelle zu nutzen; für TCP leer lassen.
Über ein RS485-Gateway verbundenAktivieren, wenn die Modbus-TCP-Verbindung auf einem RS485-Gateway (Elfin EW11, USB-RS485-Brücke ...) endet statt am TCP-Port der Batterie selbst. Die Wartezeit zwischen Nachrichten existiert nur im TCP-Server der Batterie; auf 30 ms gesenkt wird die Abfrage einer Venus Ev3/A/D rund dreimal schneller. Die Wartezeit gilt pro Batterie: teilen sich mehrere Batterien ein Gateway, trägt der Bus entsprechend mehr Verkehr — dann wieder deaktivieren, wenn Lesevorgänge fehlschlagen oder in Zeitüberschreitungen laufen. Bei direkter Verbindung zur IP der Batterie ausgeschaltet lassen.
NameBeschreibender Name zur Identifizierung dieser Batterie
IP-AdresseIP-Adresse des Zendure SolarFlow in Ihrem lokalen Netzwerk
HTTP-PortHTTP-Port (Standard 80)

Texte aus dem Code von ffunes/Omnibattery. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

BinärsensorenSpitzenlastkappung Aktiv, Prädiktives Laden Aktiv, Status der intelligenten Vorentladung, Status Preisbremse Solarüberschuss, Status Entladereserve, WLAN-Status, Cloud-Status, ESP-WiFi-Status, Ungewöhnlicher PLL-Neustart, Übertemperaturgrenze, Niedrigtemperaturgrenze, Warnung: Lüfterfehler und 22 weitere
TastenGerät zurücksetzen, Prädiktives Laden neu bewerten
ZahlenMindestersparnis Überschussbremse, Mindestersparnis Entladereserve, Ladeleistung, Entladeleistung, Max. Ladeleistung, Max. Entladeleistung, Lade-SOC-Grenzwert, Entlade-SOC-Grenzwert, Laden bis SOC, PD Kp, PD Kd, PD Totband und 37 weitere
AuswahlfelderBetriebsmodus erzwingen, Batteriephase, Arbeitsmodus, Tag der wöchentlichen Vollladung, Ladereihenfolge, Primärbatterie, Verkauf bei Hochpreis, PD-Tuning-Profil, Off-Grid-Modus
SensorenEntladefenster, Aktive Batterien, Status des Phasenschutzes, System-Batteriezellenleistung, Gesamt-Solarleistung, Tägliche Solarproduktion, Täglicher Haushaltsverbrauch, Erwartetes Haushaltsverbrauchsprofil, Aktuelle Verbrauchsprofilerfassung, Tägliche Betriebslinie, PD-Regelqualität, Haushaltsverbrauch und 125 weitere
SchalterPreisbremse Solarüberschuss, Entladereserve, Tatsächlichen Bedarf vorsteuern, Manueller Modus, Dreiphasen-Stromschutz, Direkte Nachführung ohne PD, Off-Grid-Zählermodus, Garantierter Mindest-SOC, System-Leistungsgrenzen, Prädiktives Laden, Urlaubsmodus, Ladeverzögerung und 19 weitere
UhrzeitenEnde Externes Laden

Aktionen

Verbrauchstage ausschließenNimmt vollständige lokale Tage aus dem gelernten Verbrauch heraus, wenn ein Tag den Haushalt nicht repräsentiert: ein Zählerausfall, ein einmaliges Ereignis, eine Abwesenheit. Physische Zähler und Verlauf bleiben unverändert; nur das Lernen ignoriert diese Tage. Der Ausschluss wird gespeichert, sodass ein späterer Recorder-Backfill die Tage nicht zurückholen kann.Felder: Startdatum, Enddatum

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
SystemzustandErgänzt die System-Informationen von Home Assistant um den eigenen Status.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:E-Auto-Ladegerät unter den ausgeschlossenen Geräten markieren, Konfigurierter Sensor existiert nicht mehr, Dreiphasenschutz kann durch manuelle Befehle umgangen werden, Netzleistungssensor sendet keine Werte mehr, Der Netzleistungssensor aktualisiert zu langsam, Preisdaten unbrauchbar, Solarprognose unbrauchbar, Verbleibende Solarprognose verwenden

Aus der README

Mix and match different battery brands: Marstek, Zendure, Anker Solix, Sessy, Hoymiles MQTT and more to come!
Zero Export/Import PD Controller: Keeps grid exchange near zero using a Proportional-Derivative algorithm.
Integrated dashboard: All the controls and adjustments from a single place. Graphs and power flow diagram included!
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 10 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…
Negative-price opportunistic charging: Optional Dynamic Pricing-only charging fills each battery to its configured maximum SOC during negative import-price slots, even without solar panels or a…
Smart Pre-discharge / Anti-curtailment: Optional Dynamic Pricing-only planning creates battery headroom before forecast PV surplus at negative-injection prices, then blocks discharge during the…
Time Slots: 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.

Aus der README von ffunes/Omnibattery, GNU GPL v3.0. Gekürzt.