Aansluiten en oplossen

Marstek Venus E in Home Assistant: lokaal aansturen

De Venus E 3.0 heeft een open API waarmee Home Assistant hem over je eigen netwerk uitleest en aanstuurt. Wat er per model is, wat je aanzet in de Marstek-app en waar je op let.

4 minuten lezen · Gecontroleerd op 7 oktober 2026

Een Marstek Venus E kun je uitlezen en aansturen vanuit Home Assistant, over je eigen netwerk. Marstek heeft daar een open API voor gemaakt en een eigen integratie voor Home Assistant. Dit stuk zegt per model wat er is, hoe je het aanzet en waar je op let.

Per model wat er is

Model	Poorten	Marstek noemt
Venus E 3.0	Wifi, LAN, RS-485	Open API, met Home Assistant
Venus E 4.0	Wifi, LAN, RS-485	Open API voor andere systemen
Venus E Max	Wifi, LAN, RS-485	Koppelen met externe systemen

Schuif de tabel opzij om alles te zien

Bij de Venus E 3.0 is het het duidelijkst: Marstek noemt Home Assistant en ioBroker met naam, en de integratie van Marstek zelf ondersteunt dit model. Bij de Venus E 4.0 noemt Marstek een open API voor energiesystemen van derden, zonder Home Assistant erbij. Bij de Venus E Max staat alleen dat hij met externe systemen te koppelen is.

De integratie van Marstek voor Home Assistant noemt nu drie types: de Venus A, de Venus D en de Venus E 3.0. Andere types weigert hij bij het instellen tot ze zijn toegevoegd. Heb je een 4.0 of een Max, reken dan nu op de Marstek-app en houd de lijst van de integratie in de gaten.

Zo werkt de open API

De batterij praat over je lokale netwerk met andere systemen, via wifi of de netwerkkabel. De opdrachten gaan als kleine tekstberichten over UDP, standaard op poort 30000. Er komt geen cloud aan te pas: de integratie van Marstek vraagt geen account of externe dienst. Marstek schrijft erbij dat de API bedoeld is voor gevorderde gebruikers en dat je hem op eigen risico gebruikt.

Wat je nodig hebt

Home Assistant Core 2025.10.0 of nieuwer.
De batterij en Home Assistant op hetzelfde lokale netwerk.
De batterij gekoppeld in de Marstek-app: de Marstek-app koppelen.
De open API aan. In de app-handleiding van de 3.0 heet de schakelaar "Local API"; daarna stel je de poort in.
Bij de 3.0 het liefst firmware 150 of hoger. Vanaf die versie zijn volgens Marstek ook de systeeminstellingen via de API bereikbaar: firmware bijwerken.

Twee integraties

De integratie van Marstek zelf leest uit: laadtoestand, vermogen, status en de modus waarin de batterij staat, elke 30 seconden. Je zet hem met de hand in de map custom_components van Home Assistant en herstart. Daarna voeg je hem toe onder Instellingen, Apparaten en diensten, en laat je hem zoeken op je netwerk of vul je het IP-adres van de batterij in.

Wil je ook sturen, dan is er een integratie uit de community, has-marstek-local-api, die je via HACS installeert. Die gebruikt dezelfde open API en kan ook van modus wisselen, een schema zetten en een vast laad- of ontlaadvermogen opgeven. Hij komt niet van Marstek. De Venus E 3.0 staat erin als ondersteund; andere modellen met de open API staan erin als "kan werken".

Wat je kunt aansturen

De open API kent vijf modi: Auto, AI, Manual, Passive en UPS. Auto is wat de app zelfconsumptie noemt.

Manual: een eigen schema met tien tijdvakken, elk met begin- en eindtijd, dagen van de week en een vermogen.
Passive: een vast vermogen voor een afgetelde tijd. Daarmee laat je Home Assistant zelf regelen, bijvoorbeeld op dynamische uurprijzen of een zonnevoorspelling.

Waar je op let

Zet je de open API aan, dan kunnen volgens Marstek sommige ingebouwde functies van de batterij uitgaan, om botsende opdrachten te voorkomen. Niet elk model kent elke opdracht.
Gebruikers melden dat de modus of een instelling kan verspringen nadat de API is aangezet. Kijk daarna in de Marstek-app of je modus en je netwerkvermogen nog staan zoals je ze had.
De API heeft geen wachtwoord. Alles in je netwerk kan de batterij lezen en opdrachten geven. Zet hem alleen aan op je eigen, vertrouwde netwerk.
De grens van 800 watt geldt alleen voor terugleveren; laden kan op vol vermogen. Laat Home Assistant op een gedeelde groep dus nooit meer dan 800 watt terugleveren. De community-integratie houdt die grens standaard aan. Meer vermogen vraagt volgens Marstek eerst de goedkeuring van een elektricien: stopcontact of eigen groep.
Marstek Nederland schrijft op zijn vragenpagina dat Home Assistant niet officieel wordt ondersteund. De fabrikant biedt de open API en de integratie wel aan. Het is een koppeling voor wie zelf wil instellen.

En de RS-485-poort?

De Venus E heeft ook een RS-485-poort. Marstek beschrijft in zijn eigen documentatie alleen de open API over het netwerk. Integraties die de RS-485-poort gebruiken, komen van gebruikers; die beschrijven wij hier niet.

MarstekMarstek Venus E 3.05,12 kWh · 4,61 kWh · Uitbreidbaar€ 1.199,00Bekijk dit model

Heb ik Home Assistant nodig om de batterij slim te laten werken?

Nee. De Marstek-app heeft eigen modi voor zelfconsumptie, dynamische prijzen en een vast schema.

Werkt de koppeling zonder internet?

De integratie praat rechtstreeks met de batterij over je eigen netwerk en vraagt geen cloudaccount. Voor het koppelen van de batterij, het aanzetten van de API en updates blijft de Marstek-app nodig.

Kan ik later terug naar alleen de Marstek-app?

Ja. Verwijder de integratie in Home Assistant en zet de open API in de Marstek-app uit. De batterij neemt dan geen lokale opdrachten meer aan.

Iets onduidelijk? Stel je vraag, dan vullen we dit stuk aan. Laatst bijgewerkt op 7 oktober 2026.