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.

Nodered - Nexus Thuisbatterij flow
Nodered – Nexus Thuisbatterij flow

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)

EntityHerkomstFunctie
sensor.thuisbatterij_battery_socZonneplan integratieSOC (%) van de Nexus thuisbatterij
select.thuisbatterij_battery_control_modeZonneplan integratieBatterijmodus (dynamic_charging / self_consumption)
sensor.zonneplan_current_electricity_tariffZonneplan integratieHuidige 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
EntityTypeFunctie
input_select.tb_modehelperCentrale 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)
EntityFunctie
input_number.tb_soc_minOndergrens ontladen
input_number.tb_soc_maxBovengrens laden
input_number.tb_batt_kwhCapaciteit 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)

EntityHerkomstInhoudzie
sensor.goedkoopste_urentemplateUren goedkoop → duur (bijv. 01 02 03)zie blog: goedkoopste uren
sensor.duurste_urentemplateUren duur → goedkoopzie 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)

EntityHerkomstFunctieZie
switch.id3_chargingAlfen ModbusDetecteert actief laden
sensor.ev_laadlog_debugNode-REDUren waarop EV laadtzie blog EV laden in node red

Tijdens EV-laden worden goedkope batterij-uren automatisch uitgesloten.


TenneT netbalans

EntityHerkomst
sensor.tennet_balance_prices_adjustedtemplate
input_number.tb_tennet_offsethelper

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:

  1. Laadvermogen (W) -> directe aansturing doormiddel van Solis intergratie
  2. Ontlaadvermogen (W) -> directe aansturing doormiddel van Solis intergratie
  3. Force charge aan -> directe aansturing doormiddel van Solis intergratie
  4. Force charge uit -> directe aansturing doormiddel van Solis intergratie
  5. Force discharge aan -> directe aansturing doormiddel van Solis intergratie
  6. Force discharge uit -> directe aansturing doormiddel van Solis intergratie
  7. 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!!