Thuisbatterij aansturen: per merk wat je mag lezen en wat je mag schrijven

Eén regel op een terminal, enter, en in de omvormer klikt een relais. De batterij begint te ontladen terwijl de app op de telefoon dicht staat.

Dat kastje van duizenden euro's heet jouw batterij. Wie de knoppen bedient staat op geen enkele productpagina.

De video vertelt in veertien minuten waarom dat uitmaakt. Dit artikel is de documentatie eronder: per merk het endpoint of het registernummer, de firmwareversie waarin dat getal geldt, de datum waarop het is nagetrokken, en de twee rekensommen die in een video niet passen. Wie de video nooit ziet, mist hier niets.

Eén ding vooraf, want het bepaalt hoe je de rest leest. Dit stuk gaat niet over welke batterij de beste is. Het gaat over de vraag die bijna niemand vóór aankoop stelt: mag ik dit ding een vermogen opdragen, of mag ik alleen kiezen uit een lijstje dat iemand anders heeft opgesteld?

Belangrijkste punten

• Open betekent niet aan. Victron publiceert zijn volledige registerlijst en zet Modbus TCP standaard uit. Sessy heeft een gedocumenteerde Open modus, maar een geschreven setpoint doet niets zolang het apparaat niet in API-modus staat.
• Lezen en schrijven zijn twee verschillende rechten. Bijna elk merk laat je de stand uitlezen. Het aantal merken dat je een vermogen in watt laat schrijven, is aanzienlijk kleiner.
• Een modus is geen vermogen. HomeWizard is het scherpste voorbeeld: vier modi, geen watt. En het endpoint zit op de méter, niet op de batterij.
• Het merk zegt minder dan het model. Zendure, Anker SOLIX en Marstek splitsen alle drie tussen oude en nieuwe apparaten. "Ondersteunt merk X lokale aansturing" heeft daarom geen antwoord.
• Een registernummer is geen constante. Victron verschoof het net-doelregister van 2700 naar 2716+2717 vanaf Venus-versie 3.50. Wie het oude nummer gebruikt schrijft naar een register dat de flash van het GX-toestel sneller verslijt.
• Een setpoint van −800 W haalt zelden 800 W uit je batterij. Het meetpunt is de netaansluiting, niet de omvormer. De huislast komt eroverheen.
• Lokale sturing overleeft een internetstoring, geen stroomstoring. Dat zijn twee verschillende storingen en ze worden voortdurend door elkaar gehaald.

Aansturen is twee vragen, niet één

Bijna elk gesprek over dit onderwerp loopt vast omdat "aansturen" twee dingen tegelijk betekent. Uit elkaar getrokken zijn het twee vragen, en ze hebben per merk een ander antwoord.

De eerste vraag is lezen tegenover schrijven. Je ziet wat het apparaat doet, tegenover: je zegt wat het apparaat doet. Een API die alleen de laadstand, het vermogen en de spanning teruggeeft, is een venster. Nuttig voor een dashboard, waardeloos voor een strategie. Vrijwel elke fabrikant geeft je dat venster, want het kost hem niets en het staat goed op de doos.

De tweede vraag is een modus tegenover een vermogen. Een modus kiezen betekent: uit een lijstje dat de fabrikant heeft opgesteld. Nul op de meter. Vol laden. Standby. Een vermogen schrijven betekent: achthonderd watt, nu, die kant op. Het eerste is een keuze binnen andermans plan, het tweede is een eigen plan.

Die twee vragen staan los van elkaar, en dat is precies waarom "heeft dit merk een API?" niet de vraag is die je moet stellen. Een merk kan een uitstekend gedocumenteerde API hebben waarmee je alleen mag lezen. Een ander merk kan schrijven toestaan, maar alleen een modus.

De merkkolom

Hier bestaat het artikel om. Vier standen, geen drie. "Werkend maar niet ondersteund" is een andere werkelijkheid dan "open".

Victron is de maatstaf, en zijn registernummer is versiegebonden

Victron is de enige leverancier in dit onderzoek die de registerlijst zélf publiceert én schrijven officieel ondersteunt. Daarom staat het merk hier bovenaan, en daarom is de val die eronder zit het waard om uit te schrijven.

Modbus TCP staat standaard uit. Aanzetten gaat via Settings → Services → Modbus-TCP. De beschikbare apparaten en adressen staan onder Available services en op het tabblad Unit ID mapping in het Modbus-TCP-Excelbestand. De eenheid is watt: positief betekent stroom van het net afnemen, negatief betekent terugleveren.

Het net-doelregister is verhuisd.

Victron zelf, over waarom het uitmaakt welk nummer je pakt: "it is recommended that future implementations use the 32-bit setting at registers 2716 and 2717 to avoid constantly logging the new setpoint to VRM, and wearing the flash on the GX-device with repeated writes." Register 2700 blijft werken. Het is de oude weg en het slijt de flash.

De les is breder dan Victron en het is de reden dat elke regel in dit artikel een datum draagt: een registernummer, een endpoint of een veldnaam is geen constante. Het hoort bij een firmwareversie. Deze fact-sheet noteerde 2700 als het register zonder versie erbij, en daardoor viel niet te zien dat hij verlopen was.

Wat een setpoint meet

Hier zit de rekensom die een video niet aankan, en het is de fout die ik zelf maakte.

Mijn aanname was: schrijf −800 W en er gaat achthonderd watt je huis in. Je haalt stroom uit de batterij, dus die gaat naar je apparaten. Dat klopt niet.

Het meetpunt is de netaansluiting, niet de omvormer. Het setpoint stuurt het vermogen dat door de netmeter loopt. Victron, over ESS mode 3, woordelijk: "When set to -400W, it will feed 400W back through its input. This energy will be taken from the battery. If there is also a 200W AC load connected to AC output the total energy taken from the battery will be 600W." En over mode 1: "the ESS control system tries to keep the power flowing through the grid meter at 0 Watt."

Uitgerekend voor een gewoon huishouden:

De batterij ontlaadt dus harder naarmate je huis meer verbruikt, terwijl het getal dat je schreef niet verandert. Wie een setpoint dicht bij het maximale ontlaadvermogen zet en daarna de vaatwasser aanzet, loopt tegen een limiet die niet in zijn eigen som stond.

Er hoort nog een detail bij. De standaardwaarde is +50 W, een bewuste dode band die het systeem licht laat afnemen zodat het nooit per ongeluk teruglevert.

De knop zit niet waar je hem zoekt

Twee merken laten zien dat "waar zit de API" een echte vraag is en geen formaliteit.

HomeWizard zet het endpoint op de meter. De fabrikant waarschuwt er zelf voor: "Despite its name, the /api/batteries endpoint is available on the P1 Meter and kWh Meter." Geen meter betekent geen lokale aansturing, hoe de batterij er verder ook uitziet. En wat je er doorheen mag duwen is een modus: zero (nul op de meter, de standaard), to_full, plus standby en predictive die allebei als legacy zijn aangemerkt. Vier modi, geen watt.

Sessy laat je wél een vermogen schrijven, en toch is een setpoint alleen niet genoeg. De Open modus is een benoemde productfunctie met een eigen pagina. De documentatie staat op het IP-adres van het apparaat zelf, met /api erachter, en er is een downloadbare OpenAPI-spec. Authenticatie is basic auth met de gebruikersnaam en het wachtwoord van de sticker op het apparaat. Setpoint-conventie: negatief is laden, positief is ontladen, tussen het minimum- en maximumvermogen van de unit.

De nuance die overal wegvalt: een setpoint doet niets zolang de Sessy in NOM-modus staat of in een andere modus dan API. Ook bij het meest open merk is het dus eerst een modus kiezen en dán een vermogen schrijven. Modus en watt zijn geen tegenpolen. Het zijn twee stappen.

Zendure gaat via een lokale REST-API, zenSDK genaamd: GET /properties/report om te lezen, POST /properties/write om te schrijven, mDNS voor discovery, volledig op het eigen netwerk. Aanzetten doe je eerst in de app: HEMS toevoegen, dan de app sluiten.

Het generatiepatroon: het merk zegt minder dan het model

Van alles hierboven veroudert deze observatie het langzaamst, en daarom draagt zij dit artikel.

Drie merken splitsen alle drie op modelniveau, niet op merkniveau:

• Zendure. zenSDK draait op de nieuwe generatie (SolarFlow 800 / Plus / Pro, 1600 AC+, 2400 AC / AC+ / Pro, SmartMeter3CT). De oudere apparaten (Hyper 2000, Hub 1200, Hub 2000, Ace 1500) lopen over MQTT, standaard naar de cloud-broker van Zendure.
• Anker SOLIX. De officiële integratie staat op naam van Anker zelf en werkt lokaal over poort 502, met verversing elke vijf seconden en zowel modus als vermogens-setpoint. Ondersteund zijn onder meer de Solarbank 4 E5000 Pro en de Solarbank Max AC. Voor de Solarbank 2 en 3 staat lokale Modbus-aansturing nog open als verzoek in de eigen issue-tracker.
• Marstek. Poort 502 gaat open vanaf firmware V144, plus een factory reset (aan-knop tien seconden vasthouden), en alleen op de Venus E v3 via netwerkkabel. De v1 en v2 hebben de RS485-naar-TCP-bridge nog nodig.

"Ondersteunt merk X lokale aansturing" is daarom geen vraag met een antwoord. Het modelnummer beslist, en bij Marstek beslist zelfs de firmwareversie mee.

Marstek is de vierde stand

Marstek verdient een eigen alinea, want het merk is het duidelijkste voorbeeld van iets dat geen van de drie gebruikelijke labels dekt.

Wat bevestigd is: meerdere onafhankelijke bronnen melden hetzelfde: Duits, Nederlands, twee fora en twee GitHub-repositories. over poort 502, firmware V144 en de factory reset. Er is maar één gelijktijdige Modbus TCP-verbinding mogelijk, dus je dashboard en je automatisering vechten om dezelfde socket.

Wat níét bevestigd is, en zwaarder weegt dan verwacht: er bestaat geen openbare officiële registerlijst. De registers zijn door de community gereverse-engineerd, waaronder 32100 tot en met 32104 voor spanning, stroom, vermogen en laadstand. Marstek Nederland noemt lokale aansturing in de eigen FAQ niet officieel ondersteund; de Home Assistant-integratie is een workaround.

Dat is preciezer dan "Marstek heeft Modbus" en eerlijker dan "Marstek is dicht". Het werkt, en het bestaat officieel niet.

Wat het kost, in euro's en in uren

De goedkoopste route in euro's is de duurste in uren. Dat is een afweging en geen verhouding: de eurokant is hard, de urenkant is niet gemeten.

Twee voorbehouden bij die tabel, en ze zijn allebei belangrijk genoeg om niet in een voetnoot te zetten.

Bliq Powerflow is de software bij de eigen Bliq-batterij. Een commerciële kennisbank presenteert het als een externe oplossing die op BYD, Huawei en SolarEdge werkt. De fabrikant zelf presenteert het als de software die bij het eigen product hoort, geleverd met een eigen energiemanager en SIM-dataplan; de compatibiliteitsclaim gaat over omvormermerken, niet over andermans batterijen. Ik volg de fabrikant, want die is hier de zwaardere bron. Wie een merkonafhankelijk voorbeeld zoekt: Home Battery Control, gratis, breed over RS485 en Modbus.

Niet elke P1-meter geeft je lokale toegang. "Koop een P1-meter en je bent binnen" volgt niet. Een deel van de P1-meters leest alleen uit naar de app van de eigen fabrikant en biedt geen open lokaal endpoint. De HomeWizard P1 doet het wel; die hebben we zelf. Controleer vóór aankoop of díe specifieke meter een open lokale API heeft.

Twee storingen die niet hetzelfde zijn

Dit stond tot voor kort verkeerd in ons eigen script, dus het staat hier met de correctie erbij.

Bij een internetstoring blijft lokale sturing werken. Er zat geen server tussen, dus je schema loopt door.

Bij een stroomstoring werkt er niets. De P1-meter heeft geen voeding, dus er is geen meting. En zonder omschakelkast, een ATS, loopt je huis sowieso niet door op de batterij, hoe vol die ook is. Noodstroom is een ander apparaat en een ander onderwerp.

Vier vragen aan de documentatie, vóór je koopt

En één vraag aan jezelf, die geen documentatie beantwoordt: hoeveel uur wil je hieraan kwijt zijn, elk kwartaal, als een firmware-update een register verschuift?

Wat hier bewust niet in staat

Deze sectie hoort erbij, want de weggelaten claims zeggen net zoveel als de opgenomen.

• Welke energieleveranciers aansturing aanbieden, en wát ze aansturen. Er bestaat een laag waarin je leverancier meestuurt op jouw batterij, en die laag is voor veel mensen de praktische route. Ik heb er geen per-leverancier-overzicht van met publieke bronnen erbij, dus er staan hier geen leveranciersnamen met claims. Dat overzicht is de volgende ronde onderzoek: Zonneplan, Eneco, Essent, Vandebron, Budget Energie en de rest, met per partij of de klant zelf een vermogen mag zetten of alleen mag meedoen.
• Eén merk met registers "alleen op aanvraag". Geschrapt. Eén bron, en dat was een blog, geen fabrikantsdocumentatie. Sigenergy dekt dezelfde nuance met een steviger bron.
• De precieze inhoud van een schrijfcommando. De endpoints staan hierboven omdat ze uit fabrikantdocumentatie komen. De veldnamen in de body heb ik niet uit een primaire bron kunnen bevestigen, dus die staan er niet. Draai het commando tegen je eigen unit voordat je erop bouwt.
• Hoeveel uur zelfbouw kost. Er bestaat geen urenregistratie voor een Modbus-integratie. De uitspraak "goedkoop in euro's, duur in uren" is een richting, geen verhouding, en zo staat hij er.
• Sigenergy opnieuw natrekken. De regel in de merkkolom komt uit onze eigen kennisbank, vastgelegd voor SigenStor, Sigen PV en Sigen Hybrid, en niet voor de SigenMate. In deze ronde is die niet opnieuw tegen een bron gehouden.

Veelgestelde vragen

De video

De toegankelijke versie van dit verhaal staat op Jay's Desk: wie er eigenlijk aan jouw batterij mag, in veertien minuten, met de terminal erbij en het relais dat klikt.

Dit artikel is de volledige versie: elk register met zijn firmwaregrens, elk endpoint met zijn voorwaarde, de rekensom achter het setpoint, en de verificatiedatum per merk.

Transparantie

Geen sponsoring, geen affiliate links, geen merkvoorkeur. Voor deze video en dit artikel is niets uitgeleend, gegeven of betaald. De Zendure-units die als voorbeeld dienen komen uit een afgesloten samenwerking uit de ThuisbatterijNederland-periode; er loopt geen betaling en geen afspraak.

Waar een getal van een fabrikant komt, staat dat erbij. Waar twee bronnen elkaar tegenspreken, staan ze allebei. Waar een cijfer een firmwareversie of een peildatum nodig heeft om te kloppen, staat die erbij.

Bronnen