Basis voor energiedata

1. Begin met bewijs, niet met een merkenlijst

Een toestel is pas bruikbaar voor een automation wanneer Home Assistant de juiste entiteit met de juiste betekenis aanbiedt. Twee meters van hetzelfde merk kunnen verschillen door model, regio, firmware, integratie of account. Daarom controleert deze gids entiteitsgedrag en belooft hij geen compatibiliteit op basis van een logo.

2. Scheid vermogen, energie, piek en prijs

Home Assistant bewaart entiteitsstatussen als tekst. “Numeriek” betekent dus dat de actuele status als een eindig getal kan worden gelezen. unknown, unavailable, lege tekst of een prijs met valutateken zijn geen numerieke statussen. De eenheid hoort in het attribuut unit_of_measurement, niet in de status zelf.

3. Maak een entiteitsinventaris in Ontwikkelaarstools

1. Open Ontwikkelaarstools → Statussen. Zoek op integratie of toestelnaam. Kies niet alleen op basis van de leesbare naam.
2. Kopieer de exacte entiteits-ID. Noteer actuele status, unit_of_measurement, device_class en welke fysieke grootheid de integratiedocumentatie beschrijft.
3. Controleer het numerieke formaat. Vervang in Ontwikkelaarstools → Sjablonen de voorbeeld-ID hieronder. De laatste regel moet True geven.
4. Observeer echt gedrag. Gebruik een bestaand toestel via zijn normale bediening en bekijk minstens twee updates. Omzeil nooit toestel- of elektrische beveiliging voor een test.
5. Schrijf twijfel op. “Waarschijnlijk netafname” is geen bewijs. Gebruik de entiteit niet in een automation tot betekenis en richting vaststaan.

{{ states('sensor.jouw_kandidaat') }}
{{ state_attr('sensor.jouw_kandidaat', 'unit_of_measurement') }}
{{ state_attr('sensor.jouw_kandidaat', 'device_class') }}
{{ is_number(states('sensor.jouw_kandidaat')) }}

De Statussen-tool toont de softwarestatus van dit moment. Hij bewijst niet dat meter, stroomklem, kabel of kring fysiek juist is.

4. Bewijs het teken van je netvermogen

De optionele Foundation-normalisatie verwacht één getekende netto-netvermogensentiteit: positief betekent afname van het net en negatief betekent injectie naar het net. Huisverbruik, PV-productie en omvormervermogen zijn andere grootheden.

Geeft je integratie aparte entiteiten voor afname- en injectievermogen, dan voldoet geen van beide op zichzelf aan het contract van een getekende bron. Samenvoegen kan alleen na controle van eenheden, timing en betekenis. Het geleverde bestand neemt niet stilzwijgend aan dat beide waarden synchroon zijn.

5. Controleer actualiteit en eerlijke uitval

Ook een getal kan verouderd zijn. Bekijk Geschiedenis of de entiteitsdetails terwijl je normale verbruik verandert. Noteer hoe snel de bron reageert en of de integratie regelmatig blijft rapporteren wanneer de waarde gelijk blijft. Vergelijk dat gedrag met het vereiste interval van de gekozen kit.

• De waarde reageert binnen het gedocumenteerde of geobserveerde ritme.
• Een korte bronuitval wordt unavailable of zichtbaar ongezond en niet stilletjes nul.
• Na herstel keren waarde en eenheid terug zonder tweede entiteit.
• Een herstart wijzigt tekenafspraak niet en zet cumulatieve afname niet op nul.
• Je weet of identieke opeenvolgende waarden bij deze integratie als verse rapporten tellen.

6. Installeer het optionele normalisatiepackage

Download de publieke kern swf_grid.yaml plus swf025_energy_data_health.yaml en gebruik ze pas nadat je één getekende netvermogensbron in W of kW en één cumulatieve netafnamebron in kWh hebt gevonden. Maak eerst een back-up. Installeer exact één gridkern; bestaan de gedeelde entiteiten al, behoud die kopie en voeg alleen de Foundation-energiecontrole toe.

1. Vervang de ene sensor.REPLACE_GRID_POWER in swf_grid.yaml door de gecontroleerde getekende vermogensentiteit.
2. Vervang elke sensor.REPLACE_GRID_IMPORT_KWH door de gecontroleerde cumulatieve afname-entiteit.
3. Gebruik Ontwikkelaarstools → YAML → Configuratie controleren. Los elke fout op vóór de herstart.
4. Na de herstart moeten exact deze entiteiten bestaan:

sensor.swf_grid_power_w
sensor.swf_grid_import_w
sensor.swf_grid_export_w
binary_sensor.swf_grid_data_problem
sensor.swf025_grid_import_energy
binary_sensor.swf025_energy_data_problem

De productnamespace swf025_* is bewust gekozen. Zo botsen de unieke ID's en entiteits-ID's niet met SWF-020 of andere producten. Hernoem ze niet terug naar algemene swf_grid_*-ID's. Maakt Home Assistant een suffix _2, los dan de oude of dubbele registratie op via Instellingen → Apparaten & diensten → Entiteiten. Interne verwijzingen verwachten de exacte ID's hierboven.

7. Droogtest zonder live hardware te bedienen

Wil je eerst veilig testen, maak dan via Instellingen → Apparaten & diensten → Helpers twee Getal-helpers. Geef de ene een bereik met negatieve waarden en eenheid W, de andere een niet-negatief bereik en kWh. Kies duidelijke ID's zoals input_number.swf025_test_grid_power_w en input_number.swf025_test_import_kwh, koppel ze in een testkopie van het package, controleer de configuratie en herstart.

De Statussen-tool verandert alleen de tijdelijke voorstelling in Home Assistant en stuurt het echte toestel niet aan. Simuleer uitval uitsluitend met testhelpers en wijzig de helper daarna normaal om hem te herstellen. Koppel vervolgens een schone packagekopie aan je bewezen live-entiteiten en herhaal de configuratiecontrole.

8. Geschiktheidsmatrix per product

9. Leg je go/no-go vast

Bewaar een korte notitie met datum, Home Assistant-versie, integratienaam, exacte entiteits-ID's, eenheden, tekenafspraak, geobserveerd updateritme, uitvalgedrag en de productrij die je hebt voltooid. Herhaal dit na een wijziging aan integratie, firmware, meter, tarief of een grote Home Assistant-update.