SEM-documentatie

Sensoren aansluiten

Welke sensoren SEM per signaal verwacht, hoe de automatische herkenning werkt en welke overschrijving je instelt als een waarde niet klopt.

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

SEM is eerst automatisch herkennen: voor de meeste hardware vindt het de juiste sensoren zelf uit je Energie-dashboard van Home Assistant en het apparatenregister. Deze gids is voor de rest — zodat je, als een waarde 0, unavailable of verkeerd aangeeft, kunt zien wat SEM verwacht en welke overschrijving je moet instellen. Elke overschrijving staat op het dashboard (SEM-configuratiekaart / solar_energy_management.set_option) — er is geen veld in de configuratiestappen om naar te zoeken.

De volgorde van bepalen (elk signaal)

  1. Automatisch herkennen — trefwoorden voor merk/naam + een scan van het apparaat van de sensor op een bijbehorende sensor.
  2. Afleiden — vermogen berekenen uit een energieteller (kWh) als er geen vermogenssensor bestaat.
  3. Handmatige overschrijving — de nooduitgang hieronder, als 1–2 niets opleveren.

Merk je dat je een overschrijving instelt, dan is dat een teken dat onze automatische herkenning je hardware heeft gemist — vertel ons het merk + de entity_id van de sensor in de issuetracker en we voegen die toe aan de herkenningstabel, zodat de volgende persoon het gratis krijgt.

Wat SEM per signaal nodig heeft

Signaal Eenheid / conventie Automatisch herkennen Handmatige overschrijving (dashboard)
Zonnevermogen W, ≥ 0 Zonnevermogen uit het Energie-dashboard; anders een sensor pv_power/solar_power/production_power op het zonne-apparaat Zonnevermogensensor (solar_production_sensor)
Netvermogen W, − = afname, + = teruglevering Netvermogen uit het Energie-dashboard; gesplitste afname/teruglevering ondersteund Sensoren netafname / teruglevering
Batterijvermogen W, − = ontladen, + = laden battery_power / charge_discharge_power / lade_entladeleistung (EN+DE) op het batterijapparaat Batterijvermogensensor (battery_power_sensor)
SOC batterij %, 0–100 soc / state_of_charge / batterieladung, of device_class battery + % SOC-sensor batterij (battery_soc_sensor)
Batterijcycli aantal cycles / zyklen / ladezyklen / full_cycles op het batterijapparaat Sensor batterijcycli (battery_cycles_sensor) — anders schat SEM het uit de doorvoer
Vermogen van een lastapparaat (warmtepomp / warm water / schakelaar) W, ≥ 0 een bijbehorende vermogenssensor op het apparaat …vermogenssensor, of een kWh-energiesensor (SEM leidt het vermogen af)

Opmerkingen per hardware

  • Huawei (SUN2000 / LUNA2000): volledig automatisch herkend. De gecombineerde vermogenssensor van de batterij heet …_charge_discharge_power (EN) of …_lade_entladeleistung (DE). LUNA2000 biedt geen sensor voor het totaal aantal cycli, dus gebruikt SEM zijn schatting op basis van de doorvoer voor de cycli.
  • SolarEdge + opstellingen met alleen energiesensoren: heeft je Energie-dashboard energie voor zon/batterij (kWh) maar geen vermogenssensor (W), dan toont het live vermogen 0 en wordt het huisverbruik op 0 afgekapt. Stel de Zonnevermogensensor (en Batterijvermogensensor) in op je echte vermogensentiteiten.
  • Sonnenbatterie: SEM herkent vermogen/SOC van de batterij automatisch. Voor het echte totale aantal cycli (de waarde op my.sonnen.de) stel je de Sensor batterijcycli in op de entiteit …_cycles van de integratie ha_sonnenbatterie — SEM toont die dan in plaats van zijn schatting.
  • Fronius / SolaX / GoodWe / Growatt / SMA / Victron / Powerwall / Kostal / Enphase / Sessy: automatisch herkend via het Energie-dashboard; zie de patronen voor gesplitst net / batterij met twee sensoren in de lijst met ondersteunde hardware in de README. Lijkt het teken van het batterijvermogen omgedraaid, gebruik dan Batterijteken herstellen.
  • Viessmann ViCare (Vitocal-warmtepomp / warm tapwater): de meters per apparaat zijn vaak oplopende kWh-tellers (“energie warm tapwater/verwarming dit jaar”) zonder vermogenssensor. Wijs het warmtepomp-/ warmwaterapparaat naar zijn energiesensor (kWh) — SEM herkent automatisch een bijbehorende vermogenssensor als die bestaat, en leidt anders een vloeiend live vermogenssignaal af uit de teller (het deelt elke stap door de werkelijk verstreken tijd, zodat een trage jaarteller nooit piekt).

Kom je er nog steeds niet uit?

Open een GitHub-issue met: het merk van je omvormer/batterij, de entity_id’s van de sensoren waarvan je verwacht dat SEM ze gebruikt, en een dump van de Systeemdiagnose (diag_ed_config toont wat SEM op dit moment leest). Dat is de invoer waarmee we de trefwoordtabellen voor automatische herkenning uitbreiden.

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