Integratie

Het Jullix energiebeheersysteem kan je ook integreren in andere omgevingen zoals een domotica-omgeving bijvoorbeeld. Home Assistant is hiervan een voorbeeld. In deze wiki zal je informatie vinden hoe dit kan. De functionaliteit van het Jullix energiebeheer wordt voortdurend uitgebreid, deze informatie is daarom nog niet volledig maar zal ook regelmatig aangepast worden.

Je zal in je domoticasysteem gegevens van het Jullix energiebeheer kunnen weergeven:. het actueel vermogen dat de zonnepanelen leveren, de kWh-meter, de gasmeterstand enz. Je zal het energiebeheersysteem niet kunnen besturen.

Een eerste mogelijkheid is via een platform-API. Dit gaat dan via het internet en met de authenticatiegegevens van het platform. In principe kan je alle data en functies die je ziet in de app of platform ook aanspreken via deze API. De documentatie hiervan vind je op https://mijn.jullix.be/apidocs/.

Deze documentatie wordt voortdurend geüpdatet.

Authenticatie kan via de Authorization header samen met een token.

Authorization: Bearer <token>

Deze token kan je aanmaken via het portaal, bij Profiel en API-tokens. Als je op de sleutel klikt, krijg je de JWT token die je moet gebruiken in de HTTP-header.

In HomeAssistant bijvoorbeeld kun je dan een sensor maken volgens: https://www.home-assistant.io/integrations/sensor.rest/

Een tweede mogelijkheid is directe communicatie met Jullix, zonder internet. Hiervoor gaan we ervan uit dat Jullix verbonden is aan een privé netwerk. Als je toegang hebt tot het privé netwerk heb je ook toegang tot Jullix. Als je domoticasysteem ook in het privé netwerk hangt, kan die dus direct met de Jullix communiceren en bijvoorbeeld zonnepaneeldata en data van de digitale meter enz. opvragen.

Hostname: jullix.local (gaat via mDNS) of het IP-address van Jullix
De volgende HTTP-endpoints kunnen lokaal bereikt worden (geen authenticatie nodig):

• /api/ems/meter
• /api/ems/solar
• /api/ems/battery
• /api/ems/charger
• /api/ems/plug

Via de directe toegang heb je alleen toegang tot realtime data. Voor andere data heb je de platform-API nodig. Je kan ook beide mogelijkheden combineren.