1. Voorbereiding
Controleer eerst de netwerk- en toegangsvereisten. De integratie gebruikt lokale detectie en lokale datacommunicatie.
Hetzelfde lokale netwerk
Home Assistant en de Lunergy plug-in-thuisbatterij moeten zich in hetzelfde subnet bevinden. Het netwerk mag mDNS/UDP-broadcast niet blokkeren.
Toegang tot /config
Gebruik bijvoorbeeld Samba-share, File Editor, Studio Code Server of een SSH-terminal om bestanden in de Home Assistant-configuratiemap te plaatsen.
2. Downloaden en bestanden plaatsen
Download het actuele installatiepakket, controleer de pakketstructuur en plaats daarna de juiste mappen in Home Assistant.
ZIP uitpakken naar /config
Pak Lunergy_HA.zip direct uit in /config. Na het uitpakken moeten deze twee mappen bestaan:
U kunt de twee mappen ook handmatig naar dezelfde locaties kopiëren; het resultaat is identiek.
Belangrijke bestanden controleren
Controleer na het kopiëren of deze bestanden aanwezig zijn:
/config/custom_components/ha_ems/manifest.json /config/custom_components/ha_ems/local_mdns.py /config/www/ha_ems/ha-ems-local-devices-card.js /config/www/ha_ems/ha_ems.yaml3. Dashboard inschakelen en herstarten
Dashboard inschakelen in configuration.yaml
Open /config/configuration.yaml en voeg deze zelfstandige YAML-dashboardconfiguratie toe:
U kunt deze stap nu overslaan en later toevoegen. Als u deze configuratie later toevoegt, herstart Home Assistant dan nog een keer.
Home Assistant eenmalig herstarten
Ga naar Instellingen → Systeem → Serverbesturing en klik op Home Assistant herstarten. Dit is normaal de enige herstart die tijdens de installatie nodig is.
Na de herstart zijn de integratiebestanden geladen. Als u het dashboard heeft ingeschakeld, verschijnt HA EMS in de zijbalk. Dat er nog geen gegevens zichtbaar zijn, is normaal totdat de integratie is toegevoegd.
4. Integratie toevoegen
HA EMS toevoegen
Ga naar Instellingen → Apparaten en diensten → Integratie toevoegen. Zoek naar HA EMS en bevestig de configuratie.
Het configuratieproces maakt direct een lokale configuratievermelding aan. U hoeft geen account of wachtwoord in te vullen.
Na het toevoegen starten de detectie van de batterij en de dashboardgegevens automatisch. Een extra herstart is niet nodig.
5. Frontendresource en verificatie
Frontendresource controleren
Na het laden registreert de integratie de lokale frontendresource automatisch. Als de pagina meldt dat de aangepaste kaart niet is gevonden, voeg dan deze resource handmatig toe via Instellingen → Dashboards → Bronnen (Resources):
URL: /local/ha_ems/ha-ems-local-devices-card.js?v=0.6.2 Type: JavaScript ModuleVoeg dezelfde resource slechts een keer toe. Na het bijwerken van kaartbestanden kunt u in de browser Ctrl+F5 gebruiken om de cache te verversen.
Installatie verifiëren
Open Ontwikkelaarstools → Statussen en zoek naar deze entiteiten:
sensor.ha_ems_mode sensor.ha_ems_local_devices sensor.ha_ems_local_device_issuesBij de attributen van sensor.ha_ems_local_devices moet devices de gevonden batterijen tonen. Voor elke ondersteunde batterij wordt een eigen sensor.ha_ems_<device>_energy_parameters-entiteit aangemaakt.
Ziet u in het dashboard de melding dat er wordt gewacht op EnergyParameter-gegevens, controleer dan eerst de batterijverbinding en poort en kijk daarna in de Home Assistant-logboeken.
6. Veelgestelde vragen
Snelle controles voor de meest voorkomende installatiemeldingen.
| Situatie | Controle of oplossing |
|---|---|
| HA EMS is niet te vinden bij integraties. | Controleer of /config/custom_components/ha_ems/manifest.json bestaat en herstart Home Assistant. |
| Er worden geen batterijen gevonden. | Controleer of Home Assistant en de Lunergy plug-in-thuisbatterij in hetzelfde subnet zitten en of mDNS/UDP-broadcast niet wordt geblokkeerd. |
| De batterij is verbonden, maar de energiestroom ontbreekt. | De energiestroom vereist een EnergyParameter-respons. Controleer protocol_status, protocol_error en de logboeken. |
| NoM of AI in de Lunergy APP werkt niet na gebruik van Home Assistant. | Home Assistant kan conflicteren met de regelstrategie in de Lunergy APP. Verbreek eerst de Home Assistant-verbinding en schakel daarna AI of NoM opnieuw in via de Lunergy APP. |
| De pagina meldt dat de aangepaste kaart ontbreekt. | Controleer of het JS-bestand in /config/www/ha_ems/ staat, gebruik als type JavaScript Module en ververs met Ctrl+F5. |
Entiteiten tonen niet beschikbaar. |
Bekijk de eerste Python-fout in de Home Assistant-logboeken, los die fout op en herstart daarna de integratie. |
7. Verwijderen
Configuratievermelding verwijderen
Verwijder de HA EMS-configuratievermelding via Instellingen → Apparaten en diensten. Hiermee stoppen de lokale scan en TCP-verbinding.
Mappen verwijderen
Verwijder deze twee mappen uit /config:
Herstart Home Assistant daarna om het verwijderen af te ronden.
8. Communityproject: lokale TCP-integratie
Naast het officiële HA-EMS-integratiepakket is er ook een extern communityproject beschikbaar voor gebruikers die hun batterij lokaal via TCP willen koppelen.