HomeWizard maakt aansturing thuisbatterij via lokale API mogelijk

HomeWizard heeft de firmware van de P1 Meter bijgewerkt zodat de HomeWizard Plug-in Battery nu via een lokale REST-API kan worden aangestuurd. Voor technische gebruikers betekent dit dat de HomeWizard thuisbatterij eindelijk in eigen smart home systemen is te integreren zoals Homey en Home Assistant. De API draait lokaal over HTTPS en gebruikt versie 2 van het HomeWizard-protocol. Wie eenmaal een autorisatietoken heeft (op te vragen met een POST naar /api/user en het indrukken van de knop op de P1 Meter), kan de batterij uitlezen en besturen met bijvoorbeeld curl of Postman.

Drie modi: zero, to_full en standby

Het nieuwe endpoint /api/batteries laat je de modus instellen en opvragen.

• zero probeert het netto verbruik van de woning rond nul te houden door automatisch te laden of te ontladen – ideaal om overschot aan zonnestroom op te slaan en tekorten op te vangen.
• to_full dwingt alle gekoppelde batterijen om zo snel mogelijk tot 100 % op te laden, ongeacht het huisverbruik. Sinds firmware 6.0201 schakelt de batterij na volledig laden automatisch naar standby voor maximale controle.
• standby zet laden en ontladen uit; handig voor onderhoud of als de accu’s tijdelijk buiten gebruik moeten blijven. Bijvoorbeeld voor het wegzetten van de batterij in de winter.

Naast de modus retourneert het endpoint realtime waarden zoals huidig vermogen (power_w), doelvermogen (target_power_w) en de maximale laad- en ontlaadcapaciteit (bij één batterij 1600 W laden, 800 W ontladen).

Automatisering met Home Assistant en Homey

Dankzij de API is het nu mogelijk om de Plug-in Battery koppelen aan Home Assistant, Homey en andere smart-home platformen. In Home Assistant zou je bijvoorbeeld een RESTful command om mode op standby te zetten zodra bijvoorbeeld een EV begint te laden. In Homey kan hetzelfde realiseren via een HTTP-request-kaart in een Flow. Domoticz-gebruikers werken aan een plug-in om de modus te wisselen met een virtuele switch.

Dat de vraag naar de API aansturing groot was blijkt wel uit het feit dat op fora als Tweakers blueprints, Node-RED-flows en scripts worden gedeeld om de batterij op basis van dynamische stroomtarieven slim aan te sturen.

Positieve ervaringen

De eerste praktijkervaringen met firmware 6.0203 zijn positief: de batterij reageert direct op API-commando’s en blijft stabiel. Een kleine kanttekening is dat de HomeWizard-app de standby-status nog niet altijd correct weergeeft; dit wordt naar verwachting in een volgende update verholpen. Verder ondersteunt de API op dit moment uitsluitend de drie genoemde modi. Een sturing (zoals een exact laad- of ontlaadvermogen instellen) ontbreekt nog, mede vanwege veiligheids­restricties – teruglevering mag niet boven 800 Watt per fase uitkomen. De P1 Meter fungeert daarom als regelsysteem dat meerdere batterijen binnen deze limieten coördineert.

Ontladen HomeWizard Plug-in Battery uitstellen

Wil je de Plug-in Battery automatisch pauzeren zodra je elektrische auto begint te laden? Maak in Home Assistant een automation die triggert wanneer het laadstation (bijv. je Wallbox-oplader) meer dan 1 kW afneemt. Bij die trigger roep je één rest_command aan dat via PUT https://<ip>/api/batteries met header Authorization: Bearer <TOKEN> en body {"mode":"standby"} de accu op pauze zet; zo voorkom je dat de batterij tegelijk ontlaadt. Voeg een tweede trigger toe die wordt geactiveerd wanneer het laadvermogen daalt onder 200 W en zet dan met dezelfde rest_command {"mode":"zero"}, zodat de batterij weer is ingesteld op Nul Op de Meter nadat de auto is volgeladen.

Hoe kan je zelf aan de slag met de API?

1. Update de P1 Meter naar firmware 6.0203.
2. Vraag een token aan via POST https://<ip-adres>/api/user en druk binnen 30 s op de knop van de P1 Meter om te bevestigen.
3. Roep het endpoint aan met bijvoorbeeld:

curl -X PUT "https://<ip>/api/batteries" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "X-Api-Version: 2" \
  -d '{"mode":"standby"}'

Omdat het certificaat self-signed is, voeg je in curl --insecure toe of schakel je certificaat­controle in Postman uit. De API is alleen lokaal bereikbaar, wat de veiligheid ten goede komt.

Toekomst: power-setpoints en aansturing via kWh meter

HomeWizard werkt aan power-setpoints (handmatig laad-/ontlaadvermogen) en extra modi zoals “alleen laden bij overschot”. Ook is ondersteuning voor de kWh-meter in ontwikkeling, we hebben al gehoord van beta-testers dat deze aansturing erg eenvoudig te installeren is en de batterij snel reageert op basis van de kWh meter. Uiteindelijk streeft HomeWizard naar een zo lokaal mogelijk systeem waarbij alle sturing binnen je eigen netwerk blijft.