Home Assistant · versie 0.2.0 (experiment)

Home Assistant-integratie

Je all-in kWh-prijs als sensor in het Energy-dashboard, en je P1-meter elk kwartier naar je dossier: zo rekent de simulator met je verbruik van gisteren, niet met dat van je laatste Fluvius-export.

Experiment. De integratie werkt, maar wordt nog getest. Installeren gaat voorlopig met de hand (geen HACS) en de instellingen staan in configuration.yaml. Een sleutel vraag je via contact.

Wat doet ze

  • Prijssensoren sensor.sef_afnameprijs en sensor.sef_injectieprijs: wat één kWh nu kost of opbrengt met je huidige contract, all-in in EUR incl. btw, elk kwartier vernieuwd. Bij een dynamisch contract staan de kwartierprijzen van vandaag (na 13 uur ook morgen) in het attribuut kwartieren.
  • P1-upload: twee minuten na elk kwartier leest ze de telwerken van je P1-meter (bv. HomeWizard) uit de statistieken van Home Assistant en stuurt de kwartierwaarden naar je dossier. Een gemist kwartier vult ze vanzelf aan, tot 10 dagen terug.
Download sef-homeassistant.zip

Vooraf

  1. Een account met een opgeladen Fluvius-export. De P1-upload sluit aan op de laatste meting in je dossier en kan hoogstens 10 dagen aanvullen.
  2. Je huidige contract aangeduid in Mijn Energieplatform, voor de prijssensoren.
  3. Een eigen API-sleutel voor Home Assistant met scope dossier:lezen (prijzen) en dossier:schrijven (P1-upload). Zonder dossier:schrijven werken enkel de prijssensoren.
  4. De P1-stroom toegestaan: Mijn Energieplatform → Instellingen → P1-meter. Zonder dat vinkje weigert het platform elke upload, ook met een geldige sleutel.
  5. Een P1-meter in Home Assistant met kWh-telwerken (state_class: total_increasing), bv. de HomeWizard-integratie.

Installatie

  1. Pak de zip uit in /config/ van Home Assistant, zodat er /config/custom_components/sef/ staat (bv. met de add-on Samba share of Studio Code Server).
  2. Zoek je telwerken: Instellingen → Ontwikkelhulpmiddelen → Statussen, zoek op energy_import_tariff en energy_export_tariff.
  3. Het meter-ID: het serienummer van je P1-meter (bij HomeWizard: Instellingen → Apparaten → HomeWizard → apparaatinfo), enkel letters en cijfers. Je dossier koppelt de eerste upload aan dit ID; een ander ID daarna wordt geweigerd.
  4. Zet de sleutel in secrets.yaml en de rest in configuration.yaml, en herstart Home Assistant.
# secrets.yaml
sef_sleutel: sef_...

# configuration.yaml
sef:
  sleutel: !secret sef_sleutel
  meter: 5c2fafabcdef            # serienummer van de P1-meter
  afname_1: sensor.p1_meter_energy_import_tariff_1
  afname_2: sensor.p1_meter_energy_import_tariff_2
  injectie_1: sensor.p1_meter_energy_export_tariff_1
  injectie_2: sensor.p1_meter_energy_export_tariff_2
  tarief_1: dag                  # 1.8.1/2.8.1 = dag (Belgische afspraak); omgekeerd? zet nacht
  # enkelvoudig: true            # enkel bij een enkelvoudige meter

Zonder meter of telwerken komen enkel de prijssensoren. Weigert je dossier een upload, dan verschijnt een melding in Home Assistant (SEF weigerde de P1-upload …) met de reden.

Energy-dashboard

Instellingen → Dashboards → Energie → Elektriciteitsnet: kies bij elk afnametelwerk "Gebruik een entiteit met de huidige prijs" → sensor.sef_afnameprijs, en bij elk injectietelwerk sensor.sef_injectieprijs. De vaste kosten (vaste vergoeding, capaciteitstarief) zitten bewust niet in die prijs.

Goed om te weten

  • Fluvius gaat voor. Na een herstart of storing zet Home Assistant het verbruik van de periode zonder statistiek in het eerste blok erna: het totaal klopt, het tijdstip niet. Een latere Fluvius-export vervangt die kwartieren.
  • Eén register per kwartier: het telwerk dat bewoog. Wisselt het tarief binnen het kwartier, dan gaat alles naar het grootste.
  • Limiet: 12 uploads per uur per sleutel; normaal zijn het er 4.

Privacy

De integratie praat enkel met Energieplatform Vlaanderen (/api/v1, versleuteld), niet met derden. Ze stuurt enkel kwartiersommen van afname en injectie naar je eigen dossier, nooit je momentane vermogen of de ruwe meterberichten. Van het serienummer van je P1-meter bewaart het platform enkel een versleutelde afdruk, zoals bij je EAN. Kwartierwaarden van het laatste uur zeggen of er iemand thuis is: daarom een aparte sleutel die je elk moment kan laten intrekken. Onder Instellingen → P1-meter zie je hoeveel P1-kwartieren er bewaard zijn, stop je de stroom meteen, en wis je alle P1-waarden en de meterkoppeling. Je account wissen wist ook alles.

De sleutel staat enkel in je eigen Home Assistant. Laat hem intrekken zodra je de koppeling niet meer gebruikt. Zie ook Jouw gegevens en de API-documentatie.