Marstek Venus Energy Manager voor Home Assistant (Marketplace-integratie)

Installaties: 79 die analysegegevens delen
GitHub-sterren: 148
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v2.1.1, 14 juli 2026
Categorie: Energie, Zonne-energie en batterijen
Soort: Marketplace-integratie
Merk: Marstek
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: marstek_venus_energy_manager
Bron: github.com/ffunes/Marstek-Venus-Energy-Manager
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/Marstek-Venus-Energy-Manager.

Over dit item

Marstek Venus Energy Manager bewaakt en bestuurt Marstek Venus E-, A- en D-batterijen via lokaal Modbus TCP. Het voegt een proportioneel-afgeleide regelaar toe die het batterijvermogen aanpast om het netverbruik en de netteruglevering dicht bij nul te houden, met selecteerbare afstelprofielen en een sensor voor regelkwaliteit. Voorspellende netlading gebruikt een sensor met zonneprognose om van het net te laden wanneer de prognose en de batterij de volgende dag niet dekken, en een laadvertraging houdt dit tegen zolang zonne-energie het nog kan dekken. Tijdvensters per batterij bepalen wanneer laden of ontladen is toegestaan, met optionele limieten voor laadniveau en vermogen, en er is een handmatige modus die een vast vermogen afdwingt. Andere functies zijn piekafvlakking, wekelijkse volledige lading voor celbalancering, uitsluiting van belasting voor apparaten met een hoog vermogen en ondersteuning voor meerdere batterijen. De reparatiemelding geeft aan dat de integratie is stopgezet en verwijst naar Omnibattery, en de installatie gebeurt in de UI.

Automatische samenvatting van de README en de code van ffunes/Marstek-Venus-Energy-Manager, 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.

Marstek Venus Energy Manager configureren

NetverbruikssensorSensor die geïmporteerd (+) of geëxporteerd (-) vermogen naar het net aangeeft. De controller past de batterijen aan om deze waarde dicht bij 0W te houden.
Zonne-voorspellingssensor (optioneel)Sensor die de zonneproductievoorspelling in kWh levert (bijv. Solcast). Indien hier geconfigureerd, wordt deze automatisch gebruikt voor voorspellend laden en zonne-oplaadvertraging.
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

Aantal batterijen

Aantal batterijen

Stap 3

NaamBeschrijvende naam om deze batterij te identificeren
IP-adresIP-adres van de batterij op uw lokale netwerk
Modbus-poortModbus-poort (meestal 502)
Modbus Slave IDModbus slave-/unit-id (standaard 1). Wijzig dit alleen wanneer een Modbus-proxy meerdere batterijen aan éé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

Stap 4

Maximaal laadvermogen (W)Maximaal toegestaan vermogen om de batterij op te laden
Maximaal ontlaadvermogen (W)Maximaal toegestaan vermogen om de batterij te ontladen
Maximale SOC (%)Maximale laadtoestand - batterij laadt niet boven deze waarde
Minimale SOC (%)Minimale laadtoestand - batterij ontlaadt niet onder deze waarde
Laadhysterese inschakelenVoorkomt dat de batterij laadt wanneer SOC dicht bij het maximum is
Hysterese percentage (%)Batterij laadt niet tot SOC daalt naar (max_soc - hysterese). Bijv.: Max SOC 100% met 5% hysterese = geen laden tot 95%
Drempelwaarde backup offgrid-belasting (W)Een offgrid-belasting boven deze waarde wordt behandeld als een actieve back-upgebeurtenis en sluit de batterij uit van PD-regeling. Verhoog dit als er permanente lasten (router, camera's) op de offgrid-poort zijn aangesloten.
100%-lading op spanning begrenzenWanneer het doel 100% is, wordt laden vanaf 3.48 V maximale celspanning beperkt tot 95 W en gestopt bij 3.58 V om de onbalans na 60 seconden te meten.

Ontladingstijdslots

Tijdslots configureren

Stap 6

StarttijdStarttijd (24u). Middernachtovergang wordt ondersteund.
EindtijdEindtijd (24u).
Dagen van de weekDagen waarop dit tijdslot geldt.
Betrokken batterijSelecteer 'all' voor alle batterijen of een specifieke batterij.
Laden toestaanIndien aangevinkt is laden toegestaan binnen het slot. Als GEEN slot laden toestaat, is laden standaard vrij.
Ontladen toestaanIndien aangevinkt is ontladen toegestaan binnen het slot. Als GEEN slot ontladen toestaat, is ontladen standaard vrij.
SOC max/min van slot beherenIndien aangevinkt overschrijft het slot de SOC max/min van de batterij binnen het venster.
Max. laad-/ontlaadvermogen beherenIndien aangevinkt beperkt of forceert het slot het maximale vermogen.
BedrijfsmodusPD: het predictieve algoritme regelt het vermogen met de sloplafond. Handmatig: geforceerd ontladen of laden op het opgegeven vermogen.

Stap 7

Batterij 1 — Min. SOC (%)
Batterij 1 — Max. SOC (%)
Batterij 1 — Max. laadvermogen (W)
Batterij 1 — Max. ontlaadvermogen (W)
Batterij 2 — Min. SOC (%)
Batterij 2 — Max. SOC (%)
Batterij 2 — Max. laadvermogen (W)
Batterij 2 — Max. ontlaadvermogen (W)
Batterij 3 — Min. SOC (%)
Batterij 3 — Max. SOC (%)
Batterij 3 — Max. laadvermogen (W)
Batterij 3 — Max. ontlaadvermogen (W)
Batterij 4 — Min. SOC (%)
Batterij 4 — Max. SOC (%)
Batterij 4 — Max. laadvermogen (W)

Meer tijdslots toevoegen

Nog een tijdslot toevoegen

Na het instellen

NetverbruikssensorSensor die geïmporteerd (+) of geëxporteerd (-) vermogen naar het net aangeeft.
Zonne-voorspellingssensor (optioneel)Sensor die de zonneproductievoorspelling in kWh levert (bijv. Solcast). Indien hier geconfigureerd, wordt deze automatisch gebruikt voor voorspellend laden en zonne-oplaadvertraging.
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
Aantal batterijen
NaamBeschrijvende naam om deze batterij te identificeren
IP-adresIP-adres van de batterij op uw lokale netwerk
Modbus-poortModbus-poort (meestal 502)
Modbus Slave IDModbus slave-/unit-id (standaard 1). Wijzig dit alleen wanneer een Modbus-proxy meerdere batterijen aan éé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
Maximaal laadvermogen (W)Maximaal toegestaan vermogen om de batterij op te laden
Maximaal ontlaadvermogen (W)Maximaal toegestaan vermogen om de batterij te ontladen
Maximale SOC (%)Maximale laadtoestand
Minimale SOC (%)Minimale laadtoestand
Laadhysterese inschakelenVoorkomt dat de batterij laadt wanneer SOC dicht bij het maximum is
Hysterese percentage (%)Batterij laadt niet tot SOC daalt naar (max_soc - hysterese). Bijv.: Max SOC 100% met 5% hysterese = geen laden tot 95%
Drempelwaarde backup offgrid-belasting (W)Een offgrid-belasting boven deze waarde wordt behandeld als een actieve back-upgebeurtenis en sluit de batterij uit van PD-regeling. Verhoog dit als er permanente lasten (router, camera's) op de offgrid-poort zijn aangesloten.
100%-lading op spanning begrenzenWanneer het doel 100% is, wordt laden vanaf 3.48 V maximale celspanning beperkt tot 95 W en gestopt bij 3.58 V om de onbalans na 60 seconden te meten.
Tijdslots configureren
StarttijdStarttijd (24u). Middernachtovergang wordt ondersteund.
EindtijdEindtijd (24u).
Dagen van de weekDagen waarop dit tijdslot geldt.
Betrokken batterijSelecteer 'all' voor alle batterijen of een specifieke batterij.
Laden toestaanIndien aangevinkt is laden toegestaan binnen het slot. Als GEEN slot laden toestaat, is laden standaard vrij.
Ontladen toestaanIndien aangevinkt is ontladen toegestaan binnen het slot. Als GEEN slot ontladen toestaat, is ontladen standaard vrij.
SOC max/min van slot beherenIndien aangevinkt overschrijft het slot de SOC max/min van de batterij binnen het venster.
Max. laad-/ontlaadvermogen beherenIndien aangevinkt beperkt of forceert het slot het maximale vermogen.
BedrijfsmodusPD: het predictieve algoritme regelt het vermogen met de sloplafond. Handmatig: geforceerd ontladen of laden op het opgegeven vermogen.
Batterij 1 — Min. SOC (%)
Batterij 1 — Max. SOC (%)
Batterij 1 — Max. laadvermogen (W)
Batterij 1 — Max. ontlaadvermogen (W)
Batterij 2 — Min. SOC (%)
Batterij 2 — Max. SOC (%)
Batterij 2 — Max. laadvermogen (W)
Batterij 2 — Max. ontlaadvermogen (W)
Batterij 3 — Min. SOC (%)
Batterij 3 — Max. SOC (%)
Batterij 3 — Max. laadvermogen (W)
Batterij 3 — Max. ontlaadvermogen (W)
Batterij 4 — Min. SOC (%)
Batterij 4 — Max. SOC (%)
Batterij 4 — Max. laadvermogen (W)
Nog een tijdslot toevoegen

Teksten uit de code van ffunes/Marstek-Venus-Energy-Manager. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

Binaire sensorenPiekbegrenzing Actief, Voorspellend Laden Actief, WiFi-status, Cloudstatus, Balanceermodus, Laadhysterese
KnoppenApparaat Resetten
NummersLaadvermogen, Ontlaadvermogen, Max. Laadvermogen, Max. Ontlaadvermogen, SOC Laadgrens, SOC Ontlaadgrens, Laden tot SOC, PD Kp, PD Kd, PD Dode Zone, PD Max. Vermogenswijziging, PD Richtingshysterese en nog 16
SelectiesGeforceerde Modus, Werkmodus, Dag voor Wekelijkse Volledige Lading, PD-Afstemprofiel
SensorenOntlaadvenster, Actieve Batterijen, Systeem Batterijcelvermogen, Totaal Zonnevermogen, Dagelijkse Zonneproductie, Dagelijks Huishoudverbruik, PD-Regelkwaliteit, Huishoudverbruik, Dagelijkse Netimport, Dagelijkse Netexport, Niet-reagerende Batterijen, Configuratieoverzicht en nog 54
SchakelaarsHandmatige Modus, Voorspellend Laden, Laadvertraging, Piekbegrenzing, Back-upfunctie, RS485-besturingsmodus, Laden Toestaan, Ontladen Toestaan, 100%-Laadbegrenzing op Spanning, Actieve Celbalansmodus, Laden op Externe Prijs, Nettosaldo
TijdenEinde Extern Laden

Probleemoplossing

ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Deze integratie wordt stopgezet — migreer naar Omnibattery

Uit de README

The Marstek Venus Energy Manager is a comprehensive Home Assistant integration designed to monitor and control Marstek Venus E and C series batteries (v2 and v3) and Venus D and Venus A series batteries via Modbus TCP. It provides advanced energy management features including predictive grid charging, customizable time slots for discharge control, and device load exclusion logic.
Zero Export/Import PD Controller: Keeps grid exchange near zero using a Proportional-Derivative algorithm.
Oscillation Prevention: Deadband and derivative gain prevent rapid charge/discharge cycling.
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 6 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…
Time Slots (v2): 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.
Solar-Aware Charge Delay: Holds back grid charging while solar can still cover the required energy.

Uit de README van ffunes/Marstek-Venus-Energy-Manager, GNU GPL v3.0. Ingekort.