Slimme woning: Home Assistant, HomeWizard en Modbus

Een slimme woning is een woning waarin apparaten gegevens delen en taken automatisch kunnen uitvoeren. Voor uw energie betekent dat bijvoorbeeld: zien hoeveel stroom uw zonnepanelen opwekken, hoeveel uw woning gebruikt en wanneer uw batterij oplaadt. Uw thuisbatterij is daarin een onderdeel dat energie bewaart voor een later moment.

Home Assistant is een gratis computerprogramma dat u thuis op een eigen apparaat draait en gegevens van veel verschillende slimme apparaten samenbrengt in één overzicht. HomeWizard is een Nederlands merk met meetapparaten, zoals de P1-meter, die u in uw meterkast plaatst. Beide kunnen u inzicht geven; geen van beide is onderdeel van uw Pylontech-installatie.

Uw thuisnetwerk is de verbinding tussen apparaten binnen uw woning, via kabel of WiFi. Dat is iets anders dan internet: de Pylontech-app kan via internet en de cloud van de fabrikant werken, terwijl Home Assistant en HomeWizard vooral binnen uw eigen netwerk communiceren. Een werkende app bewijst dus niet dat een lokale koppeling werkt, en andersom.

Via de Pylontech-app ziet u standaard de belangrijkste gegevens van uw batterij: laadstand, energiestromen en werkmodus. Extra mogelijkheden — zoals gegevens combineren met andere apparaten of eigen automatiseringen — hangen af van aanvullende apparatuur, uw exacte model en de firmware. Inzicht in energiegegevens betekent niet automatisch dat de batterij ook rechtstreeks aangestuurd kan worden.

Een P1-meter leest de gegevens van uw slimme elektriciteitsmeter. Zo ziet u netafname en teruglevering, en kunt u veranderingen in uw verbruik volgen. Dit is een meting aan de aansluiting met het net, niet automatisch een afzonderlijke meting van uw zonnepanelen of batterij.

Wanneer zonnepanelen, woning en batterij tegelijk werken, ziet de P1-meter het gezamenlijke nettoresultaat. Voor afzonderlijke PV-opwek is een geschikte opwekmeting of omvormerkoppeling nodig. Voor de batterijlaadstand (SOC) is batterijtelemetrie nodig. Een P1-meter alleen vertelt niet of teruggeleverde energie uit PV of de batterij komt.

Home Assistant kan gegevens uit meerdere geschikte apparaten samen tonen. Gebruik voor een energiedashboard passende energietellers in kWh; live vermogenssensoren zijn een andere soort informatie. Controleer tijdstippen, eenheden en meetrichting en voorkom dat dezelfde energie twee keer wordt opgeteld.

Uitlezen betekent kijken: netvermogen, SOC en grafieken volgen. Aansturen betekent opdrachten geven: bijvoorbeeld een laadplan veranderen. Een werkende sensor bewijst niet dat veilige besturing beschikbaar is. Begin met alleen uitlezen en vergelijken met de oorspronkelijke apps.

Home Assistant heeft een officiële HomeWizard-integratie voor ondersteunde modellen, waaronder P1 Meter, kWh Meter, Energy Socket, Watermeter en Plug-In Battery. De documentatie noemt ook ondersteunde driefase-kWh-meters. Controleer de exacte modelcode: dit is geen belofte voor ieder HomeWizard-product.

HomeWizard P1-data uitlezen betekent NIET dat HomeWizard rechtstreeks de Force H3X kan besturen. Home Assistant kan HomeWizard-netmetingen en afzonderlijke H3X-batterijmetingen combineren. Dat zijn twee aparte koppelingen, niet één bewezen officiële HomeWizard–Pylontech-besturingsverbinding.

De HomeWizard-API werkt op het lokale netwerk. Afhankelijk van model en API-versie verschilt de toegang: sommige apparaten vragen inschakelen van de lokale API, andere hebben een autorisatieproces. API v2 gebruikt een toegangstoken na apparaatgebonden toestemming. Volg de actuele officiële handleiding; deel geen token of wachtwoord.

Meten is het registreren van een waarde, zoals het actuele netvermogen via een P1-meter. Monitoren is die metingen over tijd volgen en weergeven, bijvoorbeeld in een Home Assistant-dashboard. Aansturen is een opdracht terugsturen die het gedrag van een apparaat verandert, zoals een laadplan wijzigen. Elke volgende stap vraagt meer van de koppeling én van de beveiliging.

Een cloudkoppeling loopt via servers van de fabrikant of leverancier: de Pylontech-app werkt zo. Een lokale koppeling blijft binnen uw eigen netwerk, zoals de HomeWizard-API of een Modbus TCP-verbinding. Lokaal werken geeft meer zelfstandigheid, maar verplaatst ook de verantwoordelijkheid voor beveiliging naar uw eigen netwerk.

Niet-officiële integraties worden niet door de fabrikant getest of ondersteund. Ze kunnen na een firmware-update stoppen of afwijkende waarden tonen, en de gevolgen voor garantie en support zijn niet vastgelegd. Gebruik ze daarom eerst alleen om te kijken, en laat elke vorm van aansturing vooraf beoordelen.

Noteer de router, het apparaat waarop Home Assistant draait, de HomeWizard-modelcodes en het exacte H3X-model (eenfase of driefase) met firmware. Maak een Home Assistant-back-up en bewaar de bestaande instellingen voordat u een nieuwe integratie toevoegt.

De router verbindt apparaten binnen uw woning. LAN is het lokale netwerk; dat kan via kabel (Ethernet) of WiFi bereikbaar zijn. Gebruik bij Home Assistant bij voorkeur een stabiele bekabelde verbinding als het apparaat dat ondersteunt. Controleer WiFi-bereik zonder kabels of aansluitingen van de batterij zelf te wijzigen.

Open via uw eigen vertrouwde routeradres de routerinstellingen. Zoek de lijst met verbonden apparaten of DHCP-clients. De naam verschilt per router. Herken het apparaat via modelnaam of een gecontroleerd MAC-adres; raad niet welk apparaat de batterij is.

Een IP-adres is het adres van een apparaat op uw netwerk. Bijvoorbeeld 192.168.1.42 is uitsluitend een voorbeeld, niet het adres van uw systeem. Noteer de echte lokale adressen van Home Assistant, HomeWizard en de beschikbare H3X-netwerkinterface. Een cloud-ID of serienummer is geen lokaal IP-adres.

DHCP geeft apparaten automatisch een IP-adres. Met een DHCP-reservering koppelt de router een vast uitgedeeld adres aan het juiste apparaat. Zoek bij uw router naar adresreservering, selecteer het gecontroleerde apparaat en volg de routerhandleiding.

Gebruik een adres dat de router toestaat en voorkom dubbele adressen. Stel niet tegelijk een willekeurig vast adres in het apparaat en een andere routerreservering in. Controleer na een reguliere herverbinding of het genoteerde adres nog klopt; herstart een batterij niet als netwerkproef.

Laat Home Assistant en de meetapparaten elkaar binnen het toegestane lokale netwerk bereiken. Een ping kan een aanwijzing zijn, maar niet ieder apparaat beantwoordt ping. Een geslaagde ping bewijst bovendien niet dat de benodigde API of Modbus-dienst bereikbaar is.

Een poort is de ingang voor een bepaalde netwerkdienst. Een API geeft gegevens of functies via afgesproken verzoeken. Modbus TCP is een apart communicatieprotocol; een Modbus-poort is geen website die u in de browser hoeft te openen. HomeWizard gebruikt zijn eigen API en niet automatisch Modbus 502.

Bij gescheiden netwerken/VLAN's kan gerichte toestemming nodig zijn van Home Assistant naar het bedoelde apparaat. Laat een netwerkdeskundige dit beperkt inrichten. Zet de firewall niet volledig uit en gebruik nooit port-forwarding naar de batterij.

Controleer het ondersteunde model in de officiële Home Assistant-documentatie. Volg daarna Instellingen > Apparaten & diensten > Integratie toevoegen > HomeWizard. Automatische ontdekking kan beschikbaar zijn; anders volgt u de actuele integratiedocumentatie voor lokale toegang.

Als uw model dat vereist, staat lokale API-toegang volgens de documentatie in de HomeWizard-app bij Settings > Meters > het apparaat. Voor P1 Meter, kWh Meter en Plug-In Battery beschrijft de huidige Home Assistant-pagina een andere authenticatiemethode; ga dus niet voor ieder apparaat van dezelfde schakelaar uit.

Vergelijk vervolgens de actuele netmeting met de HomeWizard-app op hetzelfde tijdstip. Controleer afzonderlijke import-/exporttellers voordat u het energiedashboard samenstelt. Autorisatie of een token voert u uitsluitend in de eigen vertrouwde integratie in.

De Force H3X is een hybride systeem: batterij en omvormer in één. De communicatie tussen batterij en omvormer is intern en hoort bij het systeem; daar sluit u zelf niets op aan. De vraag van deze rubriek is wat daarbuiten mogelijk is: communicatie tussen de omvormer en een energiemanagementsysteem (EMS), en communicatie met een externe controller zoals Home Assistant.

De fabrikantshandleidingen documenteren een LAN-aansluiting voor netwerk, een EMS-connector voor EMS-communicatie en inbedrijfname, en een WiFi-antenne. Dat zijn officiële interfaces. Wat ze niet documenteren is een algemeen bruikbare externe Modbus RTU- of CAN-interface voor huisautomatisering: de beschreven COM-aansluitingen zijn bedoeld voor zaken als de meter, noodstop en parallelle systemen. Een netwerkstekkertje of RS485-vermelding op een verkooppagina is dus geen bewijs van een open besturingsinterface.

De praktijkroute die wél aantoonbaar werkt, is Modbus TCP via het lokale netwerk. Communitymeldingen laten zien dat dit beschikbaar kwam na een firmware-update van de communicatiedongle, en een externe EMS-leverancier documenteert dezelfde route via LAN op poort 502. Dit is model- en firmwareafhankelijk: ga er niet van uit dat iedere H3X dit zonder tussenkomst van de installateur aanbiedt.

Pylontech-Research publiceert een custom Home Assistant-integratie voor lokale Force H3X-monitoring. Dit is een onofficiële communityoplossing, geen bevestigde fabrikantondersteuning. De actuele README noemt model-, firmware- en configuratieafhankelijke sensoren. Eenfase- en driefaseondersteuning moet per concrete installatie worden gecontroleerd.

Laat een deskundige eerst onderhoudsstatus, broncode, installatie-instructies, rechten en gevolgen voor support beoordelen. Gebruik alleen de gekozen gecontroleerde bronversie; installeer geen willekeurig bestand uit een forumreactie. Leg die versie en firmware vast en maak vooraf een back-up. Deze pagina geeft geen installatiecommando's of Modbus-schrijfregisters.

Belangrijk: de huidige README zegt dat de FH3X-werkmodus alleen-lezen is en niet in Home Assistant kan worden veranderd. Schrijfbare controls zijn volgens de README nog niet op echte hardware gevalideerd en niet ondersteund voor normaal gebruik. De titel van de forumdiscussie bewijst geen veilige laad-/ontlaadbesturing.

De gecontroleerde communitybron noemt standaard Modbus TCP-poort 502. Het const.py-bestand bevat BMS device ID 1 en PCS device ID 2. Dit zijn brongebonden referentiewaarden, geen universele instelling voor ieder H3X-systeem.

BMS is het batterijbeheer; PCS is de vermogenselektronica/omvormerzijde. Een device ID (ook unit ID genoemd) selecteert een logische Modbus-eenheid; het is iets anders dan het IP-adres. Een bereikbaar IP en poort leveren niet automatisch juiste data op als de unit ID, firmware of registerinterpretatie niet klopt.

Belangrijk vooraf: volgens de integratiedocumentatie is Modbus TCP op de Force H3X standaard UITGESCHAKELD en moet het door de installateur of een gebruiker met de juiste rechten worden ingeschakeld. Een bereikbaar IP-adres zegt dus nog niets. Klassiek Modbus op poort 502 is bovendien niet versleuteld en kent geen inlogbeveiliging; de beveiligde variant (Modbus Security op poort 802) is voor de H3X niet geverifieerd. Houd de verbinding daarom strikt binnen uw vertrouwde netwerk.

Begin uitsluitend met uitlezen. Controleer SOC, netrichting en vermogenswaarden tegen de originele monitoring, inclusief eenheden en actualiteit. Onbeschikbare sensors zijn geen nulmetingen. Protocolspecificaties zijn volgens de repository niet openbaar meegeleverd; verkrijg zo nodig een geautoriseerde versie via de fabrikant.

De meestgestelde vraag is of Home Assistant de batterij ook kan aansturen. Per mogelijkheid de eerlijke status, op basis van de geraadpleegde bronnen:

Bekijk rond een zonnig moment tegelijk PV-opwek, woningverbruik, batterijvermogen/SOC en P1-netvermogen. Export op de P1-meter kan een overschot aanwijzen, maar de herkomst moet u met de andere metingen beoordelen. Stijgende SOC en laadvermogen kunnen opslag aangeven; vergelijk over tijd en let op vertraagde sensoren.

Een PV-overschotmelding of dashboard is een read-only eerste stap. Die melding zorgt niet vanzelf dat de H3X gaat laden. Ook een volle batterij, laadlimiet of bestaande bedrijfsmodus kan verklaren waarom zonnestroom alsnog naar het net gaat.

Combineer actuele totale contractprijzen met SOC en verwacht huishoudelijk verbruik om eerst een inzichtelijk plan te maken. Het doel blijft: PV direct gebruiken, overschot opslaan en alleen zinvol netladen voor later eigenverbruik. Belastingen, btw, opslagen, verliezen, slijtage en terugleverkosten tellen mee; geen automatische winstclaim.

Zonder bewezen prijs-API kunt u gecontroleerde prijzen handmatig vergelijken, maar die werken zich niet vanzelf bij. Een oud schema is geen actuele dynamische regeling. Een Home Assistant-dashboard bewijst geen werkende H3X-besturing: laat een laadplan voorlopig via de al gevalideerde systeemroute beoordelen, niet via onbewezen communitycontrols.

Tijdens dure uren controleert u woningvraag, batterijontlading en P1-netrichting. Ontladen naar de woning is niet hetzelfde als export. PV-export is niet hetzelfde als netgeladen batterij verkopen. We beloven geen nul-export zonder aantoonbare inrichting én metingen.

“Ik wil in Home Assistant zien hoeveel elektriciteit mijn woning verbruikt.” Dat kan met een HomeWizard P1-meter of een andere geschikte meter en de officiële HomeWizard-integratie. U ziet import, export en actueel vermogen aan de hoofdaansluiting. Extra apparatuur: de P1-meter zelf. Beperking: dit is het nettoresultaat, geen aparte batterij- of PV-meting.

“Ik heb een HomeWizard P1-meter; wat voegt die toe?” Hij maakt uw netuitwisseling zichtbaar in apps en dashboards, ook voor Home Assistant. Hij voegt geen batterijgegevens toe: laadstand en batterijvermogen blijft u in de Pylontech-app of via een aparte, modelafhankelijke uitleeskoppeling volgen.

“Kan Home Assistant de Pylontech-app vervangen?” Nee. De app blijft nodig voor installatie, instellingen, firmware en de betrouwbare referentiemeting. Home Assistant is een aanvullend overzicht dat gegevens combineert; het is geen vervanging voor de beheeromgeving van het systeem.

Modbus TCP-poort 502 NOOIT open naar internet. Gebruik geen port-forwarding, publieke tunnel of router-DMZ voor de batterij. Vertrouw niet op Modbus als eigen internetbeveiliging: beperk de verbinding tot het vertrouwde lokale netwerk en alleen noodzakelijke apparaten.

Beveilig router en Home Assistant met updates en sterke toegangsbeveiliging; bescherm back-ups en API-tokens. Voor toegang op afstand tot een dashboard is een afzonderlijk beveiligde oplossing nodig, nooit een openbaar gemaakte batterijpoort.

Laat niet tegelijk Pylontech Dynamic, tijdschema's, een EMS en Home Assistant tegengestelde opdrachten geven. Schrijven of automations komen pas na afzonderlijke hardware-/firmwarevalidatie, installateursakkoord en een herstelplan. De huidige communitybron ondersteunt het schrijfpad niet voor normaal gebruik.