Integraties, sensoren en complete uitleg (voor Home Assistant)
Deze blog is specifiek geschreven voor gebruikers van de Zonneplan Nexus thuisbatterij in combinatie met Home Assistant en Node-RED. De kern van de oplossing is één centrale Node-RED function node die bepaalt wanneer en hoede Nexus-batterij laadt of ontlaadt, op basis van uurprijzen, SOC, arbitrage-logica, TenneT-balans en (optioneel) EV-laden.
Hieronder benoem ik eerst expliciet alle gebruikte integraties en sensoren, met duidelijke herkomst (integratie of zelf aangemaakt in Home Assistant). Daarna volgt de functionele uitleg.

Gebruikte integraties:
1. Zonneplan integration for Home Assistant (verplicht)
Deze integratie is cruciaal en levert:
- actuele stroomprijs
- uur-forecast van prijzen (vandaag)
- Nexus batterijstatus (SOC)
- koppeling met Zonneplan-ecosysteem
De Zonneplan Nexus thuisbatterij is hier volledig op gebaseerd.
2. Solis Modbus Integration for Home Assistant:
Wordt gebruikt om de batterij direct aan te sturen:
- directe controle wilt over laad-/ontlaadvermogen
- gedetailleerde batterij- en netmetingen
- lokale Modbus-sturing
3. home-assistant-alfen-modbus (optioneel – alleen bij EV-integratie)
Alleen nodig als je:
- een Alfen-laadpaal hebt
- EV-laden wilt uitsluiten van goedkope batterij-uren
- conflicten tussen auto en batterij wilt voorkomen
Overzicht: alle gebruikte sensoren en helpers
Batterij & Zonneplan (uit integratie)
| Entity | Herkomst | Functie |
|---|---|---|
sensor.thuisbatterij_battery_soc | Zonneplan integratie | SOC (%) van de Nexus thuisbatterij |
select.thuisbatterij_battery_control_mode | Zonneplan integratie | Batterijmodus (dynamic_charging / self_consumption) |
sensor.zonneplan_current_electricity_tariff | Zonneplan integratie | Huidige stroomprijs + forecast-attribuut |
Belangrijk: het
forecast-attribuut van deze sensor is essentieel voor arbitrage. Zonder forecast geen winstberekening.
Moduskeuze (zelf aangemaakt in Home Assistant)
input_select:
tb_mode:
name: TB modus
options:
- uit
- zelfverbruik
- arbitrage
- powerplay
- auto
- force_charge
- force_discharge
- huisondersteuning
| Entity | Type | Functie |
|---|---|---|
input_select.tb_mode | helper | Centrale moduskeuze voor de hele flow |
SOC- en capaciteitsinstellingen (helpers)
input_number:
tb_soc_min:
name: TB minimale SOC
tb_soc_max:
name: TB maximale SOC
tb_batt_kwh:
name: TB batterij capaciteit (kWh)
| Entity | Functie |
|---|---|
input_number.tb_soc_min | Ondergrens ontladen |
input_number.tb_soc_max | Bovengrens laden |
input_number.tb_batt_kwh | Capaciteit Nexus batterij |
Vermogenslimieten (helpers)
input_number:
tb_max_charge_power_w:
name: TB max laadvermogen
tb_max_discharge_power_w:
name: TB max ontlaadvermogen
Worden direct gebruikt als Node-RED setpoints.
Goedkoopste & duurste uren (sensoren – zelf aangemaakt)
| Entity | Herkomst | Inhoud | zie |
|---|---|---|---|
sensor.goedkoopste_uren | template | Uren goedkoop → duur (bijv. 01 02 03) | zie blog: goedkoopste uren |
sensor.duurste_uren | template | Uren duur → goedkoop | zie blog: goedkoopste uren |
Bovenstaande templates zijn opgenomen in de onderstaande download.
Aantal actieve uren:
input_number:
tb_cheap_hours_count:
tb_expensive_hours_count:
Arbitrage-instellingen
input_number:
tb_min_arbitrage_spread:
name: Minimale arbitrage spread (€)
Voorbeeld: 0.15 = alleen ontladen bij ≥ 15 cent winst.
EV-integratie (optioneel)
| Entity | Herkomst | Functie | Zie |
|---|---|---|---|
switch.id3_charging | Alfen Modbus | Detecteert actief laden | – |
sensor.ev_laadlog_debug | Node-RED | Uren waarop EV laadt | zie blog EV laden in node red |
Tijdens EV-laden worden goedkope batterij-uren automatisch uitgesloten.
TenneT netbalans
| Entity | Herkomst |
|---|---|
sensor.tennet_balance_prices_adjusted | template |
input_number.tb_tennet_offset | helper |
input_number:
tb_tennet_offset:
name: Offset Tennet (€)
Bij een onbalans-spike:
- force-modus wordt genegeerd
- Nexus schakelt naar
dynamic_charging
Specifiek voor de Zonneplan Nexus thuisbatterij
Deze flow is afgestemd op het gedrag van de Nexus:
- schakelen tussen dynamic charging en self consumption -> Zonneplan integratie
- gebruik van Zonneplan uurprijzen en forecast
- veilig omgaan met cloud-gestuurde logica
- voorkomen van “tegenwerken” tussen batterij, EV en net
De Node-RED logica fungeert als intelligente regisseur.
Wat stuurt de Node-RED function node uit?
De function node heeft 7 uitgangen:
- Laadvermogen (W) -> directe aansturing doormiddel van Solis intergratie
- Ontlaadvermogen (W) -> directe aansturing doormiddel van Solis intergratie
- Force charge aan -> directe aansturing doormiddel van Solis intergratie
- Force charge uit -> directe aansturing doormiddel van Solis intergratie
- Force discharge aan -> directe aansturing doormiddel van Solis intergratie
- Force discharge uit -> directe aansturing doormiddel van Solis intergratie
- Gewenste batterijmodus (
self_consumption/dynamic_charging) -> aansturing doormiddel van zonneplan intergrate.
Elke output bevat een tb_decision object met:
- gekozen modus
- SOC-waarden
- prijsinformatie
- arbitrage-spread
- menselijk leesbare reden
Hieronder kun je bovenstaande flow downloaden incl. de genoemde templates (goedkoopste en duurste uren). De genoemde helpers kun je zelf aanmaken in Home Assistant onder apparaten en diensten -> helpers -> Helper toevoegen.
Let op gebruik is op eigen risico!!
