Integratie · Home Assistant

Home Assistant Integratie

Breng je Novolt site naar Home Assistant: live energiestromen, de batterijstatus, dynamische elektriciteitsprijzen, het dispatch plan en kant-en-klare tellers voor het Energy Dashboard. Alles verloopt via de veilige, read-only cloud API van Novolt.

Live energiestroom en batterijstatus in de Novolt-app — de meegeleverde Lovelace-kaarten gebruiken dezelfde weergave

Functionaliteiten

Live energiestromen

Zonnepanelen (PV), net (netto / afname / injectie), huisverbruik, batterijvermogen & laadstatus (SOC), EV-laadvermogen. Standaard elke 30 seconden geüpdatet.

Energy Dashboard klaar

Cumulatieve kWh-tellers voor netafname/-injectie, PV-productie en batterij laden/ontladen. Lokaal berekend uit de live metingen en hersteld na een herstart.

Dynamische prijzen

De huidige afname- en injectieprijs voor jouw tarief, inclusief de volledige day-ahead curve voor de komende 24 uur (werkt perfect samen met kaarten zoals ApexCharts).

Dispatch plan

Zie precies wat Novolt doet (rust, geforceerd laden, geforceerd ontladen), het geplande batterijvermogen inclusief schema voor de komende 24 uur en de goedkope uren om je EV te laden.

Entiteiten passen zich aan jouw site aan: een huis zonder batterij krijgt geen batterij-entiteiten, en een site zonder EV-laadpaal krijgt geen EV-entiteiten.

Installatie

De aanbevolen manier is via HACS (Home Assistant Community Store).

Ga in HACS naar het menu (drie puntjes rechtsboven) en kies Custom repositories.
Voeg https://github.com/gillesravyse/novolt-homeassistant toe als Integration.
Zoek en installeer Novolt in HACS en herstart Home Assistant.

Snelkoppeling: bij het aanmaken van een API-sleutel (zie Configuratie hieronder) vind je in de Novolt-app een knop Openen in Home Assistant. Die opent je eigen Home Assistant en zet de bovenstaande stappen 1-2 meteen voor je klaar in HACS.

Configuratie

Ga in de Novolt-app (app.novolt.be) naar Instellingen → Toegang, zet de schakelaar Geavanceerde instellingen aan en maak in het paneel API-sleutels een nieuwe sleutel aan (bijv. genaamd "Home Assistant"). Kopieer de sleutel meteen, je ziet ze maar één keer (novolt_sk_…).
Ga in Home Assistant naar Instellingen → Apparaten & diensten → Integratie toevoegen → Novolt.
Plak de API-sleutel en je bent klaar!

Je kunt de polling-intervallen aanpassen via de Configureer knop van de integratie (standaard: 30s voor live data, 5 minuten voor prijzen, plannen en aggregaten).

Let op: Home Assistant genereert de entiteit-ID's op basis van de taal van je interface op het moment van installeren. Bij een Nederlandstalige installatie heet de prijssensor bijvoorbeeld sensor.novolt_huidige_prijs en niet sensor.novolt_current_price. Kijk onder Instellingen → Apparaten & diensten → Novolt → 1 apparaat om jouw exacte entiteit-ID's te zien.

Energy Dashboard

Gebruik de volgende entiteiten onder Instellingen → Dashboards → Energie:

Energy Dashboard veld	Entiteit
Netafname	`sensor.novolt_grid_import_energy`
Teruglevering	`sensor.novolt_grid_export_energy`
Zonnepanelen (Zonne-energie)	`sensor.novolt_pv_energy`
Batterij opladen	`sensor.novolt_battery_charge_energy`
Batterij ontladen	`sensor.novolt_battery_discharge_energy`

Deze tellers berekenen de energie lokaal op basis van de live metingen. Bij een offline periode stopt de teller netjes, in plaats van onrealistische sprongen te maken.

Meegeleverde Dashboard Kaarten

De integratie bevat vijf op maat gemaakte Lovelace kaarten die er exact hetzelfde uitzien als in de Novolt app. Je hoeft hiervoor niets extra's te installeren: na het toevoegen van de integratie vind je ze gewoon terug bij het toevoegen van een kaart (Kaart toevoegen → zoek op "Novolt").

De entiteiten worden automatisch herkend, dus een lege configuratie is vaak al voldoende:

Kaart	Wat het toont
`custom:novolt-power-flow-card`	De live energiestromen tussen zon, net, huis, batterij en EV-laders, met geanimeerde lijnen en de batterij-ring.
`custom:novolt-battery-card`	De huidige batterijstatus (ring) plus hoeveel energie er vandaag geladen/ontladen is.
`custom:novolt-stats-card`	Statistische tegels: huidige prijs, zonneproductie van vandaag, zelfvoorzienendheid en injectieprijs.
`custom:novolt-price-card`	Een grafiek van de day-ahead prijzen met de geplande goedkope laaduren opgelicht.
`custom:novolt-forecast-card`	Het 24u-plan: voorspelling van zon en verbruik, het laad-/ontlaadplan voor de batterij en het verwachte batterijverloop.

Novolt stats-tegels: prijs, zon, zelfvoorziening en injectie

Novolt day-ahead prijsgrafiek met goedkope laaduren

Automatisering Voorbeeld

Omdat je nu toegang hebt tot de actuele spotprijzen, kun je eenvoudig grootverbruikers schakelen op goedkope momenten.

Wasmachine aan bij goedkope stroom:

triggers:
  - trigger: numeric_state
    entity_id: sensor.novolt_current_price
    below: 0.10
conditions:
  - condition: state
    entity_id: binary_sensor.novolt_live_data
    state: "on"
actions:
  - action: switch.turn_on
    target:
      entity_id: switch.wasmachine_stopcontact

Belangrijke Notities

Read-only: De integratie en API zijn fundamenteel ontworpen als read-only. De API-sleutel kan enkel data van jouw site inlezen, maar niets wijzigen. De slimme aansturing van je batterij gebeurt altijd veilig in het Novolt platform zelf.
Werkt vanaf Home Assistant 2024.8 of nieuwer.