Thuisbatterij met Home Assistant: lokale API, Modbus en cloudafhankelijkheid

Updated on

Thuisbatterij met Home Assistant: lokale API, Modbus en cloudafhankelijkheid

Een thuisbatterij die “met Home Assistant werkt” kan alleen gegevens tonen, via een cloudverbinding communiceren of rechtstreeks lokaal bestuurbaar zijn. Dat zijn verschillende niveaus van controle.

Voor je aankoop is daarom niet alleen belangrijk óf er een Home Assistant-integratie bestaat. Je wilt weten hoe de koppeling communiceert, welke gegevens je kunt uitlezen, welke instellingen je kunt wijzigen en wat er nog werkt wanneer internet of een clouddienst niet beschikbaar is.

Korte conclusie

Maak Home Assistant alleen tot een harde aankoopvoorwaarde als je zelf automatiseringen wilt beheren of lokale controle belangrijk vindt. Controleer dan niet alleen of er een integratie bestaat, maar hoe die communiceert, welke data lokaal beschikbaar zijn, welke instellingen schrijfbaar zijn en wat zonder internet blijft werken.

Wat betekent ‘werkt met Home Assistant’ eigenlijk?

De term “Home Assistant compatible” zegt op zichzelf weinig over de hoeveelheid controle die je krijgt. Een koppeling kan uit verschillende lagen bestaan.

Niveau 1: gegevens zichtbaar

Home Assistant kan bijvoorbeeld batterijstatus, laadstatus of vermogen tonen. Dat bewijst alleen dat data beschikbaar komt. Het bewijst nog niet dat Home Assistant rechtstreeks met de batterij op je lokale netwerk communiceert.

Niveau 2: lokaal uitlezen

Bij lokaal uitlezen haalt Home Assistant gegevens rechtstreeks via je eigen netwerk op. Dat vermindert voor die dataroute de afhankelijkheid van een externe cloud. Maar lokaal kunnen lezen betekent nog niet dat Home Assistant ook instellingen mag wijzigen.

Niveau 3: lokaal schrijven

Bij local write kan Home Assistant ondersteunde parameters of commando’s rechtstreeks naar het apparaat sturen. Welke functies dat precies zijn, hangt af van het model, de firmware en de integratie. Schrijftoegang tot één instelling betekent dus niet dat iedere batterijfunctie bestuurbaar is.

Niveau 4: automatiseren

Wanneer de benodigde gegevens en commando’s beschikbaar zijn, kan Home Assistant daar automatiseringen omheen bouwen. Denk bijvoorbeeld aan een regel die reageert op beschikbare meetdata, batterijstatus of andere ondersteunde apparaten. De economische toepassing daarvan, bijvoorbeeld bij wisselende stroomprijzen, is een aparte vraag. Lees daarvoor hoe automatische batterij-sturing bij een dynamisch contract wordt gebruikt.

Zichtbaar in Home Assistant is niet hetzelfde als lokaal bestuurbaar.

Vijf niveaus van Home Assistant-koppeling
Niveau Wat kan Home Assistant? Wat bewijst dit nog niet?
Monitoring Waarden tonen Dat communicatie lokaal is
Local read Data lokaal ophalen Dat instellingen schrijfbaar zijn
Local write Ondersteunde commando’s sturen Dat alle functies beschikbaar zijn
Automation Logica uitvoeren Dat het hele systeem cloudvrij is
Offline local control Gewenste lokale functies blijven zonder internet werken Dat setup, updates of service geen cloud gebruiken

Lokale API, Modbus, MQTT, lokale TCP en cloud-API

De communicatiemethode bepaalt hoe Home Assistant het apparaat bereikt. Maar een protocolnaam vertelt nog niet hoeveel controle je daadwerkelijk krijgt.

Lokale API

Een lokale API is een interface die via het lokale netwerk bereikbaar is. Zo’n interface kan alleen gegevens beschikbaar stellen, maar kan ook bepaalde instellingen of commando’s ondersteunen. Vraag daarom altijd welke functies read-only zijn en welke functies daadwerkelijk schrijfbaar zijn.

Modbus

Modbus is een communicatieprotocol dat bij energieapparatuur onder meer via een netwerkverbinding of seriële verbinding kan worden gebruikt. De officiële Home Assistant-documentatie over Modbus beschrijft dat Home Assistant gegevens van Modbus-apparaten kan uitlezen en apparaten kan aansturen wanneer de betreffende interface en registers dat ondersteunen.

Modbus-ondersteuning betekent daarom niet automatisch dat je de batterij kunt aansturen. De registermap en de door het apparaat beschikbaar gestelde functies bepalen wat je werkelijk kunt lezen en schrijven.

MQTT

MQTT gebruikt een berichtmodel waarbij apparaten en diensten gegevens via onderwerpen kunnen publiceren en ontvangen. Ook hier hangt de uiteindelijke functionaliteit af van wat het apparaat of de integratie beschikbaar maakt. MQTT is dus niet automatisch beter of vollediger dan Modbus of een lokale API.

Lokale TCP-communicatie

Niet iedere lokale integratie gebruikt Modbus, MQTT of een REST-API. Een fabrikant kan ook een eigen protocol bouwen dat rechtstreeks via TCP op het lokale netwerk communiceert.

Een batterij hoeft dus geen Modbus of REST-API te gebruiken om lokaal bestuurbaar te zijn. De relevante vraag is welke lokale lees- en schrijfcommando’s daadwerkelijk beschikbaar zijn.

Cloud-API

Bij een cloud-API loopt de gegevensuitwisseling via infrastructuur van de fabrikant of dienstverlener. Voor die route kunnen onder meer internettoegang, accountauthenticatie, de beschikbaarheid van de API en de servers van de aanbieder nodig zijn.

Dat maakt een cloudintegratie niet automatisch slecht. Voor veel gebruikers kan een goed onderhouden cloudkoppeling juist eenvoudig zijn. Het verschil wordt belangrijk wanneer lokale bediening tijdens een internetstoring of minder afhankelijkheid van één clouddienst voor jou een aankoopvoorwaarde is.

Een protocolnaam is geen aankoopbewijs. Je moet weten welke functies je lokaal kunt lezen en schrijven.

Uitlezen is niet hetzelfde als aansturen

Een integratie kan bijvoorbeeld de laadstatus, het actuele vermogen, een apparaatstatus of beschikbare PV-data tonen zonder dat Home Assistant de bedrijfsinstellingen van de batterij mag wijzigen.

Schrijftoegang kan afhankelijk van het concrete systeem bijvoorbeeld betrekking hebben op laad- of ontlaadinstellingen, een bedrijfsmodus, een reserve-instelling, netladen of andere ondersteunde regelparameters. Dat zijn voorbeelden van mogelijke functies, geen lijst die iedere thuisbatterij moet aanbieden.

Stel vóór aankoop daarom twee afzonderlijke vragen: welke waarden kan ik lezen? en welke instellingen kan ik schrijven?

Een antwoord als “er is een API” of “het systeem ondersteunt Modbus” is daarvoor onvoldoende.

Wat gebeurt er als internet uitvalt?

Controleer offline gedrag in vier afzonderlijke lagen. Anders ontstaat snel de verkeerde conclusie dat één lokale functie betekent dat het hele systeem zonder internet werkt.

1. Batterijwerking

Controleer eerst of de batterij zelf haar reeds ingestelde werking blijft uitvoeren wanneer de internetverbinding wegvalt. Dat is iets anders dan de vraag of Home Assistant nog toegang heeft.

2. Lokale communicatie

Controleer vervolgens of Home Assistant de batterij op het lokale netwerk nog kan bereiken. Een cloudintegratie kan stoppen terwijl een aparte lokale route blijft functioneren.

3. Lokale besturing

Lokale bereikbaarheid is nog geen bewijs van control. Controleer of Home Assistant zonder internet ook de functies kan schrijven die voor jouw automatiseringen nodig zijn.

4. Cloud- en appdiensten

De fabrikant-app, remote service, firmware-updates of externe energie- en prijsdiensten kunnen andere connectiviteitsvereisten hebben dan de lokale Home Assistant-route. Controleer die functies daarom afzonderlijk.

Lokale Home Assistant-bediening betekent niet automatisch dat het volledige productecosysteem cloudvrij is.

Controleer deze 7 punten vóór aankoop

Gebruik niet alleen een compatibiliteitslogo of een merknaam. Vraag bewijs voor de exacte batterij en softwareversie die je wilt kopen.

Praktische checklist

✓ Exact model en firmware: controleer de concrete batterij, omvormer of controller en de relevante softwareversie. Accepteer geen merkbrede compatibiliteitsbelofte.
✓ Communicatieroute: vraag of de koppeling een lokale API, Modbus, MQTT, een eigen lokale TCP-route of een cloud-API gebruikt.
✓ Lokaal of via cloud: laat bevestigen of Home Assistant rechtstreeks met het apparaat communiceert of via infrastructuur van de fabrikant.
✓ Read en write: vraag afzonderlijk welke data leesbaar zijn en of er ook ondersteunde schrijfcommando’s bestaan.
✓ Schrijfbare functies: vraag concrete voorbeelden van de instellingen die jouw gewenste automatisering nodig heeft.
✓ Gedrag zonder internet: test of data, besturing en lokale automatiseringen beschikbaar blijven wanneer de externe verbinding ontbreekt.
✓ Wie onderhoudt de integratie: controleer of het om Home Assistant Core, een door de fabrikant geleverde custom integration of een HACS/community-project gaat, en wie updates en support verzorgt.

Voor slimme batterij-sturing begint de keten vaak al bij de meetdata. Wil je dat deel afzonderlijk controleren, lees dan hoe meetdata voor slimme batterij-sturing beschikbaar komen.

Wanneer moet lokale aansturing een harde aankoopvoorwaarde zijn?

Niet ieder huishouden heeft dezelfde hoeveelheid technische vrijheid nodig. De waarde van lokale controle hangt vooral af van wat je zelf met Home Assistant wilt doen.


Snelle beslisregel

  • Maak lokale aansturing een harde eis als: je eigen Home Assistant-automatiseringen wilt bouwen, meerdere apparaten zelf wilt coördineren, lokale bediening bij internetuitval belangrijk vindt of minder afhankelijk wilt zijn van één vendor-cloud.
  • Maak het niet automatisch een harde eis als: je vooral eenvoudige automatische batterijwerking wilt, de fabrikant-app jouw use case goed afdekt en eenvoud of support zwaarder weegt dan technische vrijheid.
  • Onderzoek eerst verder als: een verkoper alleen “Home Assistant compatible” zegt zonder uit te leggen hoe de koppeling communiceert en welke functies schrijfbaar zijn.

Hoe controleer je een concrete thuisbatterij?

Maak van “werkt met Home Assistant” een bewijsbare technische vraag. Gebruik hiervoor deze volgorde:

  1. Noteer het exacte model. Neem ook de relevante omvormer, controller en firmware mee als die onderdeel zijn van de koppeling.
  2. Controleer de documentatie van fabrikant en integratie. Kijk niet alleen naar een webshoptekst of een algemene compatibiliteitslijst.
  3. Bepaal de communicatiemethode. Is de route lokaal, cloudgebaseerd of zijn beide modi beschikbaar?
  4. Controleer read én write. Vraag welke waarden je kunt uitlezen en welke functies je kunt wijzigen.
  5. Controleer offline gedrag. Bepaal wat de batterij, de lokale koppeling en Home Assistant blijven doen zonder internet.
  6. Controleer de integratiestatus. Is het Home Assistant Core, fabrikantsoftware of een community/HACS-integratie?
  7. Vraag beslissende functies schriftelijk te bevestigen. Zeker wanneer een specifieke lokale automatisering een voorwaarde voor je aankoop is.

Je hoeft daarvoor geen YAML, registeradressen of programmeercode te begrijpen. Als koper moet je vooral kunnen bewijzen dat de gewenste gegevens en regelcommando’s voor jouw concrete configuratie beschikbaar zijn.

Hoe werkt de Home Assistant-koppeling bij Sunpura?

Onze Home Assistant HA-EMS-integratie laat goed zien waarom alleen naar een protocolnaam kijken te beperkt is. De huidige integratie bevat zowel een Cloud Mode als een Local Mode.

Voor de S2400 vermelden we op onze Nederlandse supportpagina expliciet dat deze compatibel is met Home Assistant. Dat bevestigt de Home Assistant-compatibiliteit op modelniveau. Het betekent niet automatisch dat iedere hieronder beschreven lokale functie voor iedere firmwareversie van de S2400 beschikbaar is.

Cloud Mode

In Cloud Mode gebruikt onze HA-EMS-integratie de Sunpura-cloudroute en accountauthenticatie. Deze route moet daarom afzonderlijk worden beoordeeld van de lokale communicatiemogelijkheid.

Local Mode

In Local Mode slaat onze HA-EMS-integratie de cloudlogin over en zoekt zij ondersteunde Sunpura-apparaten op het lokale netwerk. De integratie gebruikt vervolgens een directe TCP-verbinding met het lokale IP-adres en de apparaatpoort.

Voor jou betekent dit dat deze Home Assistant-route rechtstreeks lokaal kan communiceren zonder eerst via de cloudlogin te lopen. Dit zegt nog niet dat alle andere Sunpura-diensten of productfuncties zonder internet werken.

Niet alleen uitlezen

De lokale integratie bevat zowel lees- als schrijffuncties. In de huidige integratie zijn onder andere functies opgenomen voor het uitlezen en aanpassen van device-control parameters en EMS-registers.

Dat is belangrijker dan alleen de term “Home Assistant compatible”: de integratie bevat daadwerkelijk een lokale read/write-controlroute. Welke concrete functies voor jouw apparaat en firmware beschikbaar zijn, moet nog steeds modelspecifiek worden gecontroleerd.

Geen Modbus-claim voor Sunpura

Onze huidige Home Assistant-integratie gebruikt voor Local Mode een eigen lokale TCP-route. Dat is niet hetzelfde als bewijs dat de koppeling via Modbus wordt aangestuurd.

Een vermelding van LAN, Wi-Fi, RS485 of registers is daarom ook niet automatisch bewijs van een open API of Modbus-controlroute. De daadwerkelijke integratiearchitectuur is bepalend.

Wat blijft nog begrensd?

Local Mode biedt binnen onze Home Assistant-integratie een lokale control route zonder cloudlogin. Dat betekent niet automatisch dat installatie, firmware-updates, remote support, de Sunpura-app of alle andere functies volledig zonder internet werken.

Ook moet de ondersteuning van lokale functies per exact apparaat en firmware worden gecontroleerd. Voor de S2400 bevestigen we de Home Assistant-compatibiliteit, maar daaruit volgt niet automatisch dat iedere lokale read/write-functie voor iedere firmwareversie beschikbaar is.

Controleer vóór aankoop hoe jouw exacte batterij lokaal communiceert en welke functies schrijfbaar zijn.

Veelgestelde vragen

Werkt elke thuisbatterij met Home Assistant? +
Nee. En “werkt” kan verschillende dingen betekenen: alleen monitoring, lokale uitlezing of echte read/write-besturing. Controleer daarom altijd de exacte integratie van het model en de firmware die je wilt gebruiken.

Wat is het verschil tussen Home Assistant en Modbus? +
Home Assistant is het automatiseringsplatform. Modbus is één mogelijke communicatiemethode waarmee Home Assistant of een integratie gegevens met energieapparatuur kan uitwisselen.

Heb je Modbus nodig om een thuisbatterij lokaal aan te sturen? +
Nee. Een systeem kan ook lokaal communiceren via MQTT, een lokale API of een eigen TCP-protocol. Belangrijker dan de protocolnaam is welke gegevens en commando’s lokaal beschikbaar zijn.

Kun je met Modbus altijd laden en ontladen aansturen? +
Nee. Dat hangt af van de registers en functies die het specifieke apparaat schrijfbaar beschikbaar stelt. Modbus-ondersteuning op zichzelf is daarom geen bewijs van volledige batterijbesturing.

Werkt Home Assistant nog als internet uitvalt? +
Alleen voor functies die daadwerkelijk lokaal communiceren en lokaal bestuurbaar zijn. Een cloudroute blijft voor die communicatie afhankelijk van internet en de externe dienst. Controleer batterijwerking, lokale data, lokale besturing en cloud/appfuncties afzonderlijk.

Kan Sunpura lokaal met Home Assistant communiceren? +
Ja. Onze HA-EMS-integratie bevat een Local Mode die de cloudlogin overslaat en ondersteunde apparaten rechtstreeks via het lokale netwerk benadert. De integratie bevat ook lokale lees- en schrijffuncties. Welke lokale functies beschikbaar zijn, moet per apparaat en firmware worden gecontroleerd.

Gebruikt Sunpura Modbus voor Home Assistant? +
Onze huidige HA-EMS-integratie gebruikt voor Local Mode een directe lokale TCP-route. Daarom moet je niet aannemen dat de Home Assistant-koppeling via Modbus werkt. Eventuele Modbus-ondersteuning moet afzonderlijk worden gecontroleerd voor het exacte model en de betreffende firmware.


Jason - Sunpura Energy

Geschreven door Jason

Jason is vice-president bij Sunpura Energy en leidt de product- en technologiestrategie. Hij houdt zich dagelijks bezig met thuisbatterijen, P1-sturing, energieopslag en de manier waarop Nederlandse huishoudens slimmer met zonnestroom kunnen omgaan. In zijn artikelen maakt hij technische onderwerpen zoals terugleverkosten, dynamische energieprijzen en salderen begrijpelijk en praktisch toepasbaar.

Back to blog

Leave a comment