HYXI Halo koppelen aan Home Assistant: zo werkt het, en wat kan wel en niet
De HYXI Halo werkt met Home Assistant via de gratis community-integratie HYXI. Via de HYXI-cloud lees je alles uit, ook in het Energy-dashboard; aansturen kan alleen lokaal via Modbus. Zo koppel je hem, stap voor stap.
Ja, de HYXI Halo werkt met Home Assistant. Dat gaat via de gratis integratie HYXI, die je in HACS vindt. Via de HYXI-cloud lees je alles uit wat je wilt zien: laadniveau, laden en ontladen, afname en teruglevering, ook in het Energy-dashboard. Zelf aansturen kan alleen via een lokale Modbus-verbinding. Goed om te weten: het is een community-integratie, niet van HYXI zelf.
In dit artikel lees je hoe je de Halo koppelt, wat je daarna ziet, waarom aansturen via de cloud niet kan en of je dat eigenlijk wel wilt.
Home Assistant en de Halo in het kort
| Onderdeel | Zo zit het |
|---|---|
| Integratie | HYXI (ha-hyxi-cloud), een community-project, gratis en open source |
| Installeren | via HACS, de HYXI-integratie staat in de standaardwinkel |
| Uitlezen | via de HYXI-cloud, met een eigen Access Key en Secret Key, of lokaal via Modbus |
| Aansturen | alleen lokaal, via Modbus over RS485 |
| Energy-dashboard | ja |
| Verversen via de cloud | elke 1 tot 60 minuten (standaard 5), met optioneel directe meldingen |
| Officieel van HYXI | nee |
Bron: de HYXI-integratie voor Home Assistant op GitHub en de bijbehorende handleiding, gecontroleerd op 3 november 2026.
Twee manieren om te koppelen
Via de HYXI-cloud: uitlezen
Dit is de makkelijkste route en voor de meeste mensen genoeg. Home Assistant haalt de gegevens van je Halo op bij de HYXI-cloud, dezelfde plek waar de HYXI-app ze vandaan haalt. Je hebt geen extra hardware nodig, alleen een gratis account op het ontwikkelaarsplatform van HYXI.
Via lokale Modbus: uitlezen en aansturen
Wil je de Halo ook vanuit Home Assistant aansturen, of wil je niet afhankelijk zijn van internet, dan koppel je hem rechtstreeks via Modbus. Daarvoor heb je een RS485-adapter en een netwerkkabel nodig, en wat technische kennis. Hoe dat werkt, lees je in HYXI Halo en Modbus: lokaal uitlezen en aansturen via RS485.
Zo koppel je de Halo via de cloud
- Installeer de integratie. Open HACS in Home Assistant, zoek op HYXI, kies Download en herstart Home Assistant.
- Log in op het ontwikkelaarsplatform van HYXI. Ga naar open.hyxicloud.com en log in met hetzelfde e-mailadres waarmee je Halo in de HYXI-app staat. Een ander adres werkt niet.
- Maak een applicatie aan. Daarmee krijg je een Access Key en een Secret Key. Je gebruikt dus niet het wachtwoord van je HYXI-app.
- Voeg de integratie toe. Ga in Home Assistant naar Instellingen, Apparaten en diensten, Integratie toevoegen, en zoek HYXI. Kies HYXI Cloud, vul de twee sleutels in en kies de regio Europa.
- Kies hoe vaak hij ververst. Standaard elke 5 minuten. Wil je wijzigingen direct zien, zet dan de directe meldingen (webhook push) aan.
De integratie draait daarna naast de HYXI-app. Je Halo blijft gewoon werken zoals je hem in de app hebt ingesteld.
Wat zie je in Home Assistant?
Welke sensoren je krijgt, hangt af van je apparaat en je verbinding. Bij de Halo zie je onder meer het laadniveau, of hij laadt of ontlaadt en met hoeveel vermogen, wat je huis van het net haalt of teruglevert, en tellers voor wat er in en uit de batterij is gegaan. Die tellers kun je gebruiken in het Energy-dashboard van Home Assistant, naast je zonnepanelen en je slimme meter.
Daarmee kun je ook slimme automatiseringen maken, zonder de batterij zelf aan te sturen. Een paar voorbeelden:
- Zet de boiler of de vaatwasser aan met een slimme stekker als de Halo vol is en je toch teruglevert.
- Stuur jezelf een melding als het laadniveau 's avonds onder een grens zakt.
- Laat een lampje kleuren als je huis stroom van het net haalt.
Waarom kun je de Halo niet via de cloud aansturen?
Volgens de maker van de integratie heeft HYXI bevestigd dat batterijcommando's die je met je eigen sleutels stuurt, niet worden doorgegeven aan de batterij. HYXI doet dat alleen voor erkende aanbieders van een virtuele energiecentrale (VPP). Via de cloud kun je de Halo dus wel volgen, maar niet laten laden of ontladen. Meer over VPP lees je in Wat is een Virtual Power Plant?
Via lokale Modbus geldt die beperking niet. Dan krijg je knoppen voor rust, laden, ontladen en zelfverbruik, en kun je het laad- en ontlaadvermogen instellen. Die besturing staat standaard uit, zodat Home Assistant niet per ongeluk tegen de HYXI-app in werkt.
Moet je de Halo eigenlijk via Home Assistant aansturen?
Voor de meeste mensen niet. De HYXI-app stuurt de Halo al slim aan: de zelflerende HYXI AI kijkt naar je verbruik, je zonnepanelen en de uurprijzen, en met een dynamisch contract laadt hij op de goedkope uren. Lees ook Hoe werken dynamische energiecontracten?
Home Assistant is dan vooral handig om alles op één plek te zien en andere apparaten op je batterij af te stemmen. Wil je de batterij toch zelf aansturen, houd dan rekening met drie dingen:
- Laat niet twee systemen tegelijk sturen. Stuurt Home Assistant de batterij, dan neemt het de besturing over van de werkstand in de HYXI-app.
- Valt Home Assistant uit, dan blijft de laatste opdracht staan. De batterij doet wat hij het laatst kreeg, tot Home Assistant weer terug is en het overneemt.
- De automatische Energy Manager in de integratie is nog bèta. Hij werkt alleen via lokale Modbus en houdt nog geen rekening met dynamische stroomprijzen.
En Homey?
Gebruik je Homey Pro in plaats van Home Assistant, dan is er een niet-officiële app HYXI Cloud. Die werkt ook via de sleutels van het ontwikkelaarsplatform van HYXI. Je ziet het laadniveau, laden en ontladen, en of je huis stroom afneemt of teruglevert, en je kunt daar flows op bouwen.
Veelgestelde vragen
Is er een officiële Home Assistant-integratie van HYXI?
Nee. De integratie HYXI is een community-project. HYXI levert wel het ontwikkelaarsplatform met de sleutels waarmee de integratie werkt.
Wat kost het?
Niets. De integratie is gratis en open source, en het account op het ontwikkelaarsplatform ook.
Werkt het zonder internet?
Via de cloud niet. Via lokale Modbus wel: dan praat Home Assistant rechtstreeks met de Halo.
Kan ik de Halo vanuit Home Assistant laten laden op goedkope uren?
Alleen via lokale Modbus, met je eigen automatisering. Makkelijker is het om dat aan de HYXI AI in de app over te laten, die met een dynamisch contract zelf op de uurprijzen stuurt.
Helpen jullie met de installatie?
Wij zijn niet de makers van de integratie, maar denken graag mee. App ons als je ergens vastloopt.
Meer weten over de Halo?
Lees HYXI Halo uitgelegd of bekijk de datasheet in gewone taal. Wil je weten welke opstelling bij je past, doe dan de matchtest, of bekijk De Huisvriend, de HYXI Halo.
Geschreven door het team van SmartReserve. Wij bezorgen elke batterij persoonlijk, op afspraak.
Bereken jouw besparing
Hoeveel bespaar jij met een thuisbatterij in jouw situatie?
Open de calculator →