Omnibattery voor Home Assistant (Marketplace-integratie)

Installaties: 838 die analysegegevens delen
GitHub-sterren: 206
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v1.5.0, 13 oktober 2026
Categorie: Energie, Zonne-energie en batterijen
Soort: Marketplace-integratie
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: omnibattery
Bron: github.com/ffunes/Omnibattery
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Screenshots Uit de README van ffunes/Omnibattery.

Over dit item

Omnibattery is een aangepaste integratie die onder andere thuisbatterijen van Marstek Venus en Zendure bewaakt en bestuurt. Het communiceert lokaal met de batterijen, afhankelijk van het merk via Modbus TCP, seriële Modbus RTU of lokale HTTP, en wordt ingesteld in de UI. Een proportioneel-differentiële regelaar houdt de uitwisseling met het net dicht bij nul, met selecteerbare afstelprofielen en een sensor die de regelkwaliteit meldt. Meerdere batterijen van verschillende merken kunnen samen worden beheerd, met lastverdeling en prioriteit op basis van laadtoestand. Laden kan worden gepland op basis van de zonneverwachting en dynamische prijzen, met tijdvakken per batterij, een wekelijkse volledige lading en piekafvlakking. Het voegt sensoren, schakelaars, nummers, selecties, knoppen en binaire sensoren toe, plus optionele driefasige stroombeveiliging en reparatiemeldingen.

Automatische samenvatting van de README en de code van ffunes/Omnibattery, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Wordt vanzelf gevonden Home Assistant vindt het op het netwerk en biedt aan om het toe te voegen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Schakelaars
Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Omnibattery configureren

NetverbruikssensorRealtime sensor voor geïmporteerd (+) of geëxporteerd (-) netvermogen. Updates elke 1-2 seconden worden aanbevolen. Tragere sensoren worden geaccepteerd, maar vertraagde metingen verminderen de regelkwaliteit; de laatste meting wordt maximaal 65 seconden gevolgd.
Off-grid vermogenssensor (optioneel)Afzonderlijke W/kW-meter voor het back-upcircuit. Deze moet verschillen van de normale netsensor. Configuratie toont een softwareschakelaar die deze bron voor regeling en statistieken selecteert; de fysieke off-grid/EPS-poort van de batterij wordt niet ingeschakeld.
Teken van off-grid meter omgekeerdSchakel dit in wanneer de off-grid sensor de omgekeerde conventie gebruikt: positief = export en negatief = verbruik. Dit geldt alleen wanneer de off-grid metermodus actief is.
Zonneprognosesensor voor de hele dag (verouderd)Verouderde sensor met de zonneprognose voor de hele dag. Bestaande installaties kunnen deze tijdens de overgang blijven gebruiken; kies voor nieuwe configuraties bij voorkeur Resterend vandaag.
Sensor resterende zonneprognose vandaag (aanbevolen)Sensor met de vandaag nog verwachte zonneproductie in kWh. Bij opslaan vervangt deze de verouderde prognose voor de hele dag en wordt nooit verminderd met reeds gemeten productie.
Zonneproductiesensor (optioneel)Realtime PV-productievermogenssensor (W/kW) van een externe omvormer die niet via de MPPT-ingangen van de batterij loopt. Wordt gebruikt om de Zon-node in het energiestroomdiagram van het dashboard te tonen. Laat leeg als je panelen rechtstreeks de MPPT van de batterij voeden.
Meterteken omgekeerdSchakel deze optie in als uw meter de omgekeerde conventie gebruikt: positief = export, negatief = import. De eenheid (W/kW) wordt automatisch gedetecteerd.
Maximaal gecontracteerd vermogen (W)Totaal gecontracteerd vermogen in watt. Het systeem overschrijdt deze limiet niet bij het laden om het uitvallen van de zekering te voorkomen
Driefasige stroombeveiliging inschakelenOptionele stroomveiligheidsenvelop voor driefasige installaties; configureer sensoren en de fysieke batterijfase in de volgende stap.

Driefasige stroombeveiliging

Netstroomsensor L1Realtime RMS-stroom met teken van fysieke fase L1. A en mA worden geaccepteerd.
Netstroomsensor L2Realtime RMS-stroom met teken van fysieke fase L2. A en mA worden geaccepteerd.
Netstroomsensor L3Realtime RMS-stroom met teken van fysieke fase L3. A en mA worden geaccepteerd.
Zekeringgrootte L1 (A)Zekeringgrootte/stroomlimiet voor L1 in ampère. Voer een waarde onder de nominale waarde in om ruimte te laten voor vertragingen en pieken.
Zekeringgrootte L2 (A)Zekeringgrootte/stroomlimiet voor L2 in ampère. Voer een waarde onder de nominale waarde in om ruimte te laten voor vertragingen en pieken.
Zekeringgrootte L3 (A)Zekeringgrootte/stroomlimiet voor L3 in ampère. Voer een waarde onder de nominale waarde in om ruimte te laten voor vertragingen en pieken.

Stap 3

Fysieke batterijfase

Aantal batterijen

Aantal batterijen

Stap 5

BatterijmerkMarstek Venus: Modbus TCP. Zendure SolarFlow: lokale HTTP (HEMS moet uitgeschakeld zijn voor Omnibattery-besturing). Anker SOLIX Solarbank Max AC / 4 E5000 Pro: Modbus TCP (schakel Modbus TCP in onder Third-Party Control in de Anker-app; slechts één Modbus-client tegelijk). Sessy: lokale HTTP.

Stap 6

NaamBeschrijvende naam om deze batterij te identificeren
IP-adresIP-adres van de batterij op uw lokale netwerk. Laat leeg als je een seriële poort gebruikt.
Modbus-poortModbus-poort (meestal 502)
Modbus slave-IDModbus slave-/unit-id (standaard 1). Wijzig dit alleen wanneer een Modbus-proxy meerdere batterijen op één IP:poort koppelt met verschillende slave-id's.
BatterijmodelSelecteer de modelversie van uw batterij. Ev2 voor oudere modellen, Ev3 voor nieuwere modellen met bijgewerkte registerkaart, A (Venus A) of D (Venus D) voor hybride omvormermodellen
Seriële poort (Modbus RTU)Pad van de USB-RS485-adapter, bijv. /dev/ttyUSB0 of COM3. Vul dit in plaats van het IP-adres in om Modbus RTU via serieel te gebruiken; laat leeg voor TCP.
Bereikt via een RS485-gatewayVink aan wanneer de Modbus TCP-verbinding op een RS485-gateway uitkomt (Elfin EW11, USB-RS485-brug ...) in plaats van op de TCP-poort van de batterij zelf. De wachttijd tussen berichten bestaat alleen in de TCP-server van de batterij; verlagen naar 30 ms maakt het uitlezen van een Venus Ev3/A/D ongeveer drie keer sneller. De wachttijd geldt per batterij: delen meerdere batterijen één gateway, dan draagt de bus evenveel keer zoveel verkeer — vink het weer uit als uitlezingen mislukken of verlopen. Laat uit als je rechtstreeks verbindt met het IP-adres van de batterij.

Stap 7

NaamBeschrijvende naam om deze batterij te identificeren
IP-adresIP-adres van de Zendure SolarFlow op uw lokale netwerk
HTTP-poortHTTP-poort (standaard 80)

Stap 8

Naam
MQTT-apparaat-IDHoymiles MQTT-ID, bijvoorbeeld MSA-280024341346.
BatterijmodelGebruik automatische detectie tenzij het apparaat een onjuist of generiek model publiceert.

Na het instellen

Batterij
NetverbruikssensorRealtime sensor voor geïmporteerd (+) of geëxporteerd (-) netvermogen. Updates elke 1-2 seconden worden aanbevolen. Tragere sensoren worden geaccepteerd, maar vertraagde metingen verminderen de regelkwaliteit; de laatste meting wordt maximaal 65 seconden gevolgd.
Off-grid vermogenssensor (optioneel)Afzonderlijke W/kW-meter voor het back-upcircuit. Deze moet verschillen van de normale netsensor. Configuratie toont een softwareschakelaar die deze bron voor regeling en statistieken selecteert; de fysieke off-grid/EPS-poort van de batterij wordt niet ingeschakeld.
Teken van off-grid meter omgekeerdSchakel dit in wanneer de off-grid sensor de omgekeerde conventie gebruikt: positief = export en negatief = verbruik. Dit geldt alleen wanneer de off-grid metermodus actief is.
Zonneprognosesensor voor de hele dag (verouderd)Verouderde sensor met de zonneprognose voor de hele dag. Bestaande installaties kunnen deze tijdens de overgang blijven gebruiken; kies voor nieuwe configuraties bij voorkeur Resterend vandaag.
Sensor resterende zonneprognose vandaag (aanbevolen)Sensor met de vandaag nog verwachte zonneproductie in kWh. Bij opslaan vervangt deze de verouderde prognose voor de hele dag en wordt nooit verminderd met reeds gemeten productie.
Zonneproductiesensor (optioneel)Realtime PV-productievermogenssensor (W/kW) van een externe omvormer die niet via de MPPT-ingangen van de batterij loopt. Wordt gebruikt om de Zon-node in het energiestroomdiagram van het dashboard te tonen. Laat leeg als je panelen rechtstreeks de MPPT van de batterij voeden.
Meterteken omgekeerdSchakel deze optie in als uw meter de omgekeerde conventie gebruikt: positief = export, negatief = import. De eenheid (W/kW) wordt automatisch gedetecteerd.
Maximaal gecontracteerd vermogen (W)Totaal gecontracteerd vermogen in watt. Het systeem overschrijdt deze limiet niet bij het laden om het uitvallen van de zekering te voorkomen
Driefasige stroombeveiliging inschakelenOptionele stroomveiligheidsenvelop voor driefasige installaties; configureer sensoren en de fysieke batterijfase in de volgende stap.
Netstroomsensor L1Realtime RMS-stroom met teken van fysieke fase L1. A en mA worden geaccepteerd.
Netstroomsensor L2Realtime RMS-stroom met teken van fysieke fase L2. A en mA worden geaccepteerd.
Netstroomsensor L3Realtime RMS-stroom met teken van fysieke fase L3. A en mA worden geaccepteerd.
Zekeringgrootte L1 (A)Zekeringgrootte/stroomlimiet voor L1 in ampère. Voer een waarde onder de nominale waarde in om ruimte te laten voor vertragingen en pieken.
Zekeringgrootte L2 (A)Zekeringgrootte/stroomlimiet voor L2 in ampère. Voer een waarde onder de nominale waarde in om ruimte te laten voor vertragingen en pieken.
Zekeringgrootte L3 (A)Zekeringgrootte/stroomlimiet voor L3 in ampère. Voer een waarde onder de nominale waarde in om ruimte te laten voor vertragingen en pieken.
Fysieke batterijfase
Aantal batterijen
BatterijmerkMarstek Venus: Modbus TCP. Zendure SolarFlow: lokale HTTP (HEMS moet uitgeschakeld zijn voor Omnibattery-besturing). Anker SOLIX Solarbank Max AC / 4 E5000 Pro: Modbus TCP (schakel Modbus TCP in onder Third-Party Control in de Anker-app; slechts één Modbus-client tegelijk). Sessy: lokale HTTP.
NaamBeschrijvende naam om deze batterij te identificeren
IP-adresIP-adres van de batterij op uw lokale netwerk. Laat leeg als je een seriële poort gebruikt.
Modbus-poortModbus-poort (meestal 502)
Modbus slave-IDModbus slave-/unit-id (standaard 1). Wijzig dit alleen wanneer een Modbus-proxy meerdere batterijen op één IP:poort koppelt met verschillende slave-id's.
BatterijmodelSelecteer de modelversie van uw batterij. Ev2 voor oudere modellen, Ev3 voor nieuwere modellen met bijgewerkte registerkaart, A (Venus A) of D (Venus D) voor hybride omvormermodellen
Seriële poort (Modbus RTU)Pad van de USB-RS485-adapter, bijv. /dev/ttyUSB0 of COM3. Vul dit in plaats van het IP-adres in om Modbus RTU via serieel te gebruiken; laat leeg voor TCP.
Bereikt via een RS485-gatewayVink aan wanneer de Modbus TCP-verbinding op een RS485-gateway uitkomt (Elfin EW11, USB-RS485-brug ...) in plaats van op de TCP-poort van de batterij zelf. De wachttijd tussen berichten bestaat alleen in de TCP-server van de batterij; verlagen naar 30 ms maakt het uitlezen van een Venus Ev3/A/D ongeveer drie keer sneller. De wachttijd geldt per batterij: delen meerdere batterijen één gateway, dan draagt de bus evenveel keer zoveel verkeer — vink het weer uit als uitlezingen mislukken of verlopen. Laat uit als je rechtstreeks verbindt met het IP-adres van de batterij.
NaamBeschrijvende naam om deze batterij te identificeren
IP-adresIP-adres van de Zendure SolarFlow op uw lokale netwerk
HTTP-poortHTTP-poort (standaard 80)

Teksten uit de code van ffunes/Omnibattery. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

Binaire sensorenPiekbegrenzing Actief, Voorspellend Laden Actief, Status slim voorontladen, Status prijsrem zonne-overschot, Status ontlaadreserve, WiFi-status, Cloudstatus, ESP-WiFi-status, Abnormale PLL-herstart, Overtemperatuurlimiet, Lagetemperatuurlimiet, Waarschuwing: abnormale ventilator en nog 22
KnoppenApparaat Resetten, Voorspellend Laden Herevalueren
NummersMinimale besparing overschotrem, Minimale besparing ontlaadreserve, Laadvermogen, Ontlaadvermogen, Max. Laadvermogen, Max. Ontlaadvermogen, SOC Laadgrens, SOC Ontlaadgrens, Laden tot SOC, PD Kp, PD Kd, PD Dode Zone en nog 37
SelectiesGeforceerde Modus, Batterijfase, Werkmodus, Dag voor Wekelijkse Volledige Lading, Laadvolgorde, Primaire batterij, Verkoop bij hoge prijs, PD-Afstemprofiel, Off-Grid-modus
SensorenOntlaadvenster, Actieve Batterijen, Status Driefasige Beveiliging, Systeem Batterijcelvermogen, Totaal Zonnevermogen, Dagelijkse Zonneproductie, Dagelijks Huishoudverbruik, Verwacht huishoudelijk verbruiksprofiel, Huidige verbruiksprofielregistratie, Dagelijkse bedrijfstijdlijn, PD-Regelkwaliteit, Huishoudverbruik en nog 125
SchakelaarsPrijsrem zonne-overschot, Ontlaadreserve, Werkelijke vraag vooruitsturen, Handmatige Modus, Driefasen-stroombeveiliging, Directe Tracking zonder PD, Off-grid Metermodus, Gegarandeerd Minimum SOC, Systeemvermogenslimieten, Voorspellend Laden, Vakantiemodus, Laadvertraging en nog 19
TijdenEinde Extern Laden

Acties

Verbruiksdagen uitsluitenHoudt volledige lokale dagen buiten het geleerde verbruik, voor een dag die het huishouden niet vertegenwoordigt: een meteruitval, een eenmalige gebeurtenis, een afwezigheid. Fysieke energiemeters en geschiedenis blijven ongemoeid; alleen het leren negeert die dagen. De uitsluiting wordt bewaard, zodat een latere Recorder-backfill de dagen niet kan terugzetten.Velden: Startdatum, Einddatum

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
SysteemstatusVoegt de eigen status toe aan de systeeminformatie van Home Assistant.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Markeer je EV-lader bij de uitgesloten apparaten, Geconfigureerde sensor bestaat niet meer, Driefasenbeveiliging kan door handmatige opdrachten worden omzeild, Netvermogenssensor publiceert niet meer, De netvermogenssensor werkt te langzaam bij, Prijsdata onbruikbaar, Zonneprognose onbruikbaar, Gebruik een resterende zonneprognose

Uit de 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.

Uit de README van ffunes/Omnibattery, GNU GPL v3.0. Ingekort.