SEM-documentatie

Net en VPP

Hoe SEM reageert op netgebeurtenissen van een virtuele energiecentrale (VPP): eerst observeren, koppelen met Axle Energy, vangrails en boekhouding per gebeurtenis.

Nederlandse vertaling van de officiële SEM-documentatie (MIT-licentie). Origineel: GRID_VPP.md op GitHub. Bij verschillen is de Engelse versie leidend.

SEM kan reageren op netgebeurtenissen van een virtuele energiecentrale (VPP) — aansturings- verzoeken van een aggregator zoals Axle Energy die je per gebeurtenis betaalt voor het leveren van flexibiliteit (“zoveel mogelijk”; er is geen gevraagd vermogensniveau). Gaat er een gebeurtenis af, dan zet SEM de bedieningen die het al heeft voor een ander doel in:

Gebeurtenis Batterij Laden van de auto Overschotlasten
Export (aan het net leveren) Geforceerd ontladen op maximaal vermogen, nooit onder de VPP-reserve-SOC Gepauzeerd gedurende het venster Afgeschakeld (piekafschakelpoort)
Import (netvermogen opnemen) Geforceerd laden op het maximaal geaccepteerde vermogen Verhoogd naar maximale stroom (als aangesloten) Mogen starten (niet afgeschakeld)
Vóór de gebeurtenis (export komt eraan) Aangevuld alleen met zon (auto gepauzeerd zodat overschot naar de batterij gaat — geen aanvulling vanaf het net in v1) Gepauzeerd —

Alles loopt via de bestaande aansturingsmechanismen van SEM (decide_battery → batterijadapters, het ene leespunt voor de laadmodus, de piekhouding van de overschotregeling). Er is geen tweede aansturing die kan blijven hangen.

Eerst observeren

vpp_observer_mode staat standaard aan. Zolang dat zo is, berekent SEM elke cyclus de volledige aansturing en:

  • logt het één INFO-regel per faseovergang — VPP event started (export) — WOULD dispatch: force_discharge, pause_ev, shed_loads,
  • stuurt het een melding bij begin/einde van een gebeurtenis (als mobiele meldingen aan staan),
  • publiceert het sensor.sem_vpp_event met de live boekhouding,

maar stuurt het niets aan. Laat een paar gebeurtenissen zo lopen, vergelijk het logboek met wat je VPP-portaal verwachtte, en zet de observatiemodus daarna uit.

Entiteiten koppelen (Axle Energy)

Stel in onder Configuratie → Geavanceerd → Net-VPP op het dashboard:

SEM-optie Axle-entiteit (gebruikelijk) Betekenis
vpp_event_active_entity binary_sensor.axle_event_in_progress Gebeurtenispoort — actief als de toestand on / in_progress is
vpp_direction_entity sensor.axle_event_direction export of import (onbekend → behandeld als export)
vpp_event_end_entity sensor.axle_event_end (tijdstempel) Optionele veiligheidsgrens (zie hieronder)
vpp_pre_event_entity binary_sensor.axle_event_in_1_hour Optionele trigger voor voorbereiding
vpp_enabled — Hoofd-opt-in (standaard uit)
vpp_observer_mode — Proefdraaien (standaard aan)
vpp_reserve_soc — Ondergrens bij export, standaard 20 %

Elke integratie die deze vorm aanbiedt, werkt — Axle is alleen de eerste koppeling.

Vangrails

  • Reserve-ondergrens: exportgebeurtenissen ontladen de thuisbatterij nooit onder vpp_reserve_soc. De effectieve ondergrens is max(vpp_reserve_soc, de eigen reserve van de batterij) — VPP kan hem alleen strenger maken. Op/onder de ondergrens gaat het ontladen gewoon niet door (en een onbeschikbare SOC houdt vast — nooit blind ontladen).
  • Batterijen op handen af blijven handen af: een batterij waarvan de modus off is, wordt nooit door een VPP-gebeurtenis aangestuurd.
  • Grens bij een vastzittende poort: blijft de gebeurtenispoort meer dan 30 minuten na het opgegeven eindtijdstip (vpp_event_end_entity) actief, dan behandelt SEM de gebeurtenis als voorbij en logt het een waarschuwing.
  • Einde gebeurtenis / afstemmen bij opstarten (de klasse van vastzitters uit #532): de geforceerde actie is een overschrijving per cyclus — zodra de gebeurtenis eindigt (of SEM herstart zonder actieve gebeurtenis) is de overschrijving weg, keert decide_battery terug naar NORMAL en zet de afsluiting command_normal() van elke adapter geforceerde setpoints op nul (Huawei ruimt daarnaast verweesde opstartwaarden op). Een geforceerde VPP-actie kan niet langer leven dan haar venster.
  • Opnieuw bevestigen per cyclus: niets aan een gebeurtenis wordt vastgezet — elke coördinatorcyclus leest de poort opnieuw; een hapering beëindigt de gebeurtenis gewoon.

Energieboekhouding per gebeurtenis

Er wordt per gebeurtenis betaald, dus SEM maakt bij het begin van een gebeurtenis een momentopname van de energietellers voor netafname/teruglevering en berekent bij het einde de geleverde kWh (exportgebeurtenissen gebruiken het verschil van de terugleverteller; importgebeurtenissen dat van de afnameteller; een teller die midden in een gebeurtenis reset — bijv. bij de wisseling om middernacht — boekt de geleverde energie en begint een nieuwe basis, en telt nooit negatief). De laatste 20 gebeurtenissen blijven bewaard na een herstart.

sensor.sem_vpp_event:

  • toestand: idle / pre_event / event_export / event_import
  • attributen: direction, started, delivered_kwh_so_far, observer, reason, last_event ({start, end, direction, kwh, observer}), events (laatste 5 records).

Een herstart midden in een gebeurtenis hervat het open record als de poort nog actief is (met behoud van de tot dan toe geleverde kWh); anders wordt het record gesloten en gemarkeerd als reconciled.

Bewust buiten de scope (v1)

  • Aanvulling vanaf het net vóór een gebeurtenis (alleen zon — eenvoudig en veilig).
  • Het volgen van een gevraagd vermogensniveau / setpoint (Axle heeft bevestigd: dat bestaat niet; gebeurtenissen zijn “zoveel mogelijk”).
  • Geforceerd starten van uitgestelde lasten bij importgebeurtenissen (die worden alleen niet afgeschakeld; de overschotregeling mag ze op haar eigen voorwaarden starten).
SEM-updates

Mis geen nieuwe SEM-versie

Krijg een mail bij nieuwe SEM-versies, bijgewerkte Nederlandse documentatie en praktijkcijfers. Je downloadt direct ook de gratis checklist voor het einde van de saldering.

Geen spam. Afmelden kan altijd met één klik.

Scroll naar boven