De lokale API van de HomeWizard P1 Meter is een open aansluiting waarmee andere apparaten in je thuisnetwerk je actuele verbruik en teruglevering rechtstreeks bij de P1 Meter kunnen ophalen. De data blijft daarbij in je eigen netwerk en gaat niet eerst langs een server van HomeWizard. Home Assistant, Homey en steeds meer stekker-thuisbatterijen gebruiken deze route, waardoor je de HomeWizard P1 Meter voor meer kunt inzetten dan alleen het monitoren van je energieverbruik. Alles loopt daarbij over je eigen Wi-Fi, dus een stabiele verbinding is geen luxe maar een voorwaarde.
In dit blog leggen we uit wat de API precies doorgeeft, hoe je hem aanzet, wat je ermee doet in Home Assistant en Homey, en hoe een thuisbatterij er zijn laad- en ontlaadbeslissingen op baseert.
Wat is de lokale API van de HomeWizard P1 Meter?
API staat voor Application Programming Interface: een vaste afspraak over hoe software gegevens aan andere software doorgeeft. De HomeWizard P1 Meter leest via de P1-poort van je slimme meter je stroom- en gasverbruik live uit en stuurt die data via Wi-Fi naar de HomeWizard Energy-app. Met de lokale API kan ook een ander apparaat in hetzelfde netwerk die data opvragen, rechtstreeks bij de P1 Meter zelf.
Lokaal betekent: het verzoek gaat van apparaat naar apparaat binnen je eigen netwerk. Er zit geen server van HomeWizard of van een batterijmerk tussen. Valt je internet weg of ligt een cloud plat, dan blijft de koppeling gewoon werken. Je router moet wel aan blijven, want daar loopt al het verkeer overheen.
De HomeWizard Energy-app op je smartphone of tablet werkt anders: die haalt de data via de cloud van HomeWizard en heeft dus wel internet nodig. Je hebt de app ook nodig om de P1 Meter op je Wi-Fi aan te sluiten en de lokale API aan te zetten.
Wat de P1 Meter doorgeeft, staat in de API-documentatie van HomeWizard. Voor de P1 Meter is dat onder meer:
- Actueel vermogen in watt, totaal en per fase. Bij teruglevering is de waarde negatief.
- Meterstanden voor afname en teruglevering in kWh, ook per tarief.
- Spanning en stroom per fase, plus de netfrequentie.
- Netkwaliteit: het aantal spanningsdips, spanningspieken en stroomonderbrekingen dat je slimme meter registreerde.
- Gas en water, als je slimme meter die standen van een gas- of watermeter ontvangt.
- De Wi-Fi-signaalsterkte van de P1 Meter zelf, in procenten.
Historische data zit er niet in. HomeWizard schrijft dat de API alleen de meest recente meting geeft. Wil je grafieken over maanden, dan slaat het systeem dat de data ophaalt die zelf op. Gebruik je Homey, dan bewaart je Homey Pro de metingen, zodat je ook maanden later nog terugkijkt.
Ter info
Hoe vaak ververst de P1-data?
De P1 Meter kan nooit sneller zijn dan je slimme meter. Een slimme meter volgens DSMR 5 (Dutch Smart Meter Requirements, de Nederlandse norm voor slimme meters) ververst de P1-gegevens volgens Netbeheer Nederland elke seconde. Een oudere slimme meter volgens DSMR 4 doet dat eens per tien seconden. Gas en water lopen trager: die geeft ook een slimme meter volgens DSMR 5 maar eens per vijf minuten door.
Ook het systeem dat de P1 Meter uitleest, bepaalt de snelheid. Toen we de HomeWizard P1 Meter zelf in Homey toevoegden, stond het uitleesinterval standaard op tien seconden. Via de geavanceerde instellingen van het apparaat zet je dat op één seconde.
API v1 of v2: wat is het verschil?
De P1 Meter spreekt twee versies van de API. Versie 1 is de oudste en de eenvoudigste: een gewoon webadres in je netwerk dat zonder wachtwoord antwoord geeft, zolang je de lokale API in de app hebt aangezet. Iedereen in je netwerk kan de data dan lezen.
Versie 2 noemt HomeWizard zelf veiliger en uitgebreider. Hij staat altijd aan, verstuurt alles versleuteld via HTTPS en laat alleen apparaten toe die jij goedkeurt. Dat goedkeuren gaat met de knop op de P1 Meter: een systeem vraagt toegang, jij drukt op de knop, en binnen 30 seconden krijgt het een eigen sleutel. Daarnaast kan v2 nieuwe metingen zelf doorsturen, in plaats van te wachten tot iemand erom vraagt.
Belangrijker voor wie een HomeWizard Plug-In Battery heeft: de aansturing van die batterij loopt alleen via v2. De P1 Meter is daar de regelaar, en via v2 lees en wijzig je zijn instellingen.
| Kenmerk | Lokale API v1 | Lokale API v2 |
|---|---|---|
| Aanzetten | Schakelaar in de HomeWizard Energy-app | Staat altijd aan |
| Toegang | Iedereen in je netwerk | Alleen na een druk op de knop van de P1 Meter |
| Verbinding | HTTP, onversleuteld | HTTPS, versleuteld |
| Data ophalen | Opvragen (pollen) | Opvragen of live laten doorsturen |
| Plug-In Battery aansturen | Nee | Ja |
Hoe zet je de lokale API aan?
Voor v1 open je de HomeWizard Energy-app en ga je naar Instellingen, Meters, kies je je P1 Meter en zet je Lokale API aan. Dat doe je per apparaat: heb je ook een Energy Socket of kWh-meter, dan zet je hem daar apart aan. Voor v2 hoef je in de app niets te doen. Het systeem dat wil koppelen vraagt om een druk op de knop.
Wil je zien of het werkt, dan heb je alleen een browser nodig. Zoek in je router of in de app het IP-adres van de P1 Meter op en open http://<ip-adres>/api/v1/data. Je krijgt een blok tekst met alle actuele waarden, waaronder active_power_w: je vermogen van dit moment. Ververs de pagina een paar keer en je ziet het getal meebewegen met wat je in huis aan- en uitzet.
Een systeem dat de P1 Meter zelf moet vinden, hoeft het IP-adres niet te kennen. De P1 Meter kondigt zich in het netwerk aan via mDNS (multicast DNS, een manier waarop apparaten elkaar in een lokaal netwerk op naam vinden). Home Assistant gebruikt dat bijvoorbeeld om de P1 Meter automatisch voor te stellen.
Wat doe je met de API in Home Assistant?
Home Assistant heeft sinds versie 2022.2 een officiële HomeWizard-integratie die volledig lokaal werkt. Meestal vindt Home Assistant de P1 Meter zelf. Bij het toevoegen kan hij je vragen om op de knop van de P1 Meter te drukken: dat is de v2-goedkeuring. Daarna haalt de integratie standaard elke vijf seconden nieuwe waarden op.
Elke meetwaarde wordt een eigen sensor. De meterstanden voor afname en teruglevering koppel je aan het energiedashboard van Home Assistant, zodat je verbruik per uur, dag en maand ziet en zelf bewaart. Het actuele vermogen gebruik je in automatiseringen: de boiler aan bij genoeg teruglevering, een melding als je basislast ’s nachts hoger is dan normaal, of je laadpaal terugschakelen als het totaal te hoog oploopt.
Daarmee wordt Home Assistant een doorgeefluik. De data van de P1 Meter stuur je door naar apparaten die zelf geen HomeWizard kennen, zoals een thuisbatterij met een open koppeling. Hoe dat per merk en per batterij werkt, lees je in ons artikel over een P1 Meter koppelen aan Home Assistant.
Hoe gebruik je de P1 Meter in Homey?
In Homey loopt de koppeling via de HomeWizard-app uit de Homey App Store. Dat is een app van een ontwikkelaar uit de community, niet van HomeWizard zelf. Ook die werkt lokaal via de API, en ook hier moet de lokale API aanstaan of geef je toegang met de knop.
Dat de app de P1 Meter standaard elke tien seconden uitleest, heeft een reden. Volgens de ontwikkelaar op het Homey-forum overbelastte een interval van één seconde oudere Homey-modellen. Een recente Homey Pro kan dat wel aan. Wij zetten het interval in de geavanceerde instellingen op één seconde, en dan volgt Homey je verbruik vrijwel live.
Met de P1-data in Homey bouw je flows: apparaten schakelen op overschot, Homey Energy voeden met je echte verbruik of je laadpaal laten meebewegen. Een HomeWizard Plug-In Battery stuur je vanuit Homey aan via de v2-API, bijvoorbeeld met een HTTP-kaart in een flow. Hoe dat gaat, beschreven we bij de aansturing van de Plug-In Battery via de lokale API. Meer over de combinatie lees je in werkt HomeWizard met Homey?
Hoe weet een stekker-thuisbatterij wanneer hij moet laden?
Een stekker-thuisbatterij die op nul op de meter stuurt, moet elk moment weten of je huis stroom afneemt of teruglevert. Dat doet hij in veel gevallen op basis van de data die de P1 Meter ophaalt uit de slimme meter. Steeds meer merken laten de batterij daarom zelf de lokale API van de HomeWizard uitlezen, zodat je geen tweede P1 Meter of P1-splitter nodig hebt.
De logica is eenvoudig. Geeft de P1 Meter een positief vermogen, dan neem je stroom af en levert de batterij bij. Is het vermogen negatief, dan lever je terug en laadt de batterij met dat overschot. Na elke aanpassing kijkt de batterij opnieuw naar de P1 Meter en stelt bij, net zolang tot de stand rond nul uitkomt. Hoe vaker hij een vers getal krijgt, hoe dichter hij bij nul blijft: met een slimme meter volgens DSMR 4 loopt elke batterij tot tien seconden achter.
Bij de HomeWizard Plug-In Battery zit het andersom. Daar is de P1 Meter de baas: hij rekent uit wat de batterijen moeten doen en stuurt ze aan. Via de v2-API kies je zelf de modus, zoals nul op de meter of stand-by, en bepaal je of de batterij mag laden, ontladen of allebei. Volgens de documentatie is er ook een voorspellende modus die op verwacht verbruik en energieprijzen stuurt, maar die vraagt wel een verbinding met de cloud van HomeWizard.
Welke merken de HomeWizard P1 Meter ondersteunen en hoe goed dat werkt, verschilt sterk en verandert met elke firmware-update. Dat houden we bij in een apart overzicht: welke thuisbatterijen werken met de HomeWizard P1 Meter? Ben je nog aan het kiezen, kijk dan ook bij de stekker-thuisbatterijen die we testten.
Waarom is een stabiele Wi-Fi-verbinding zo belangrijk?
Voor inzicht in een app maakt een korte hapering weinig uit: je grafiek mist een paar seconden. Voor een batterij die op de P1 Meter stuurt, is het een ander verhaal. Krijgt hij geen antwoord van de P1 Meter, dan weet hij niet meer wat je huis doet. Wat een batterij dan doet, verschilt per merk, maar sturen op nul lukt in die tijd niet.
Juist de P1 Meter heeft het daarbij lastig. Hij zit in de meterkast, vaak ver van de router, achter een deur, metaal en beton. Daarbij werkt hij volgens HomeWizard alleen op 2,4 GHz. Ook het type router speelt mee: in een eerder artikel beschreven we waarom de Wi-Fi van een HomeWizard wegvalt op een Ziggo-router.
Twee signalen dat je verbinding tekortschiet: de batterij reageert traag of grillig op een waterkoker, of de P1 Meter staat in de app regelmatig even offline. De API geeft de signaalsterkte van de P1 Meter zelf door. Zie je daar structureel lage waarden, dan ligt het probleem bijna altijd bij de afstand tot je router.
Tip van de redactie
Geef je P1 Meter een vast IP-adres
Sommige batterij-apps koppelen de P1 Meter op zijn IP-adres. Deelt je router na een herstart een ander adres uit, dan zoekt de batterij op de verkeerde plek. Leg in je router een vast adres voor de P1 Meter vast, meestal heet dat een DHCP-reservering. Het kost twee minuten en voorkomt een koppeling die zomaar stopt.
Zo maak je de koppeling betrouwbaar
Een paar maatregelen lossen de meeste problemen met de lokale API op, ongeacht of Home Assistant, Homey of een batterij aan de andere kant zit:
- Breng Wi-Fi naar de meterkast. Een access point of een mesh-punt in de buurt maakt meer verschil dan welke instelling ook. HomeWizard adviseert zelf om de router dicht bij het apparaat te hebben.
- Zorg dat 2,4 GHz aan staat op het punt waar de P1 Meter mee verbindt. Een netwerk dat alleen 5 GHz uitzendt, ziet de P1 Meter niet.
- Houd alles in één netwerk. De P1 Meter en het systeem dat hem uitleest, moeten in hetzelfde netwerk zitten. Een gastnetwerk of apart IoT-netwerk zonder doorgang tussen de twee blokkeert de API.
- Laat de cloud aan staan. Je kunt de P1 Meter volledig lokaal laten werken, maar volgens Home Assistant krijgt hij dan ook geen firmware-updates meer. En juist met updates voegt HomeWizard functies aan de API toe.
Heb je nog geen P1 Meter, of twijfel je tussen merken, dan vergeleken we de bekende modellen op data, app en koppelingen in de beste P1 Meter. Hoe zo’n P1 Meter je slimme meter precies uitleest, staat in hoe werkt een P1 Meter?
