Ga naar inhoud

Kanalen

In de instellingen van de CEMM en in deze wiki kom je regelmatig het woord "kanaal" (of "channel") tegen. "Kanalen" worden door de CEMM gebruikt om gegevens van meters te organiseren. Iedere meter is opgebouwd uit één of meerdere kanalen. Door een meter toe te voegen aan de CEMM worden deze kanalen automatisch aangemaakt.

Voor standaardgebruik van de CEMM is het niet nodig te begrijpen hoe kanalen werken, maar als je van plan bent om de CEMM te integreren met andere systemen, eigen tijdreeksen te configureren of zelf een Modbus meter te definiëren, is het handig om te weten wat kanalen zijn en hoe ze werken.

Een simpele kWh meter heeft twee kanalen: vermogen (W) en energie (kWh).

label (label) sleutel (key) eenheid (unit) aggregatie methode (aggregation_method)
Vermogen electric_power W AVG
Energie electric_energy kWh COUNTER

In dit voorbeeld zie je de belangrijkste eigenschappen van een kanaal:

  • label: Dit is de naam van het kanaal zoals het wordt getoond in o.a. widgets en tijdreeksen. Het label is aan te passen via de instellingen van de meter.
  • sleutel: De sleutel is een unieke code die het kanaal identificeert. Binnen een meter is de sleutel uniek. De sleutel is heel belangrijk voor de CEMM, omdat het bepaalt welke tijdreeksen en widgets getoond kunnen worden.
  • eenheid: De eenheid bepaalt hoe de data wordt weergegeven. De eenheid wordt in feite bepaald door de sleutel; een electric_energy kanaal heeft altijd de eenheid kWh.
  • aggregatie methode: Naast de sleutel is de aggregatie methode ook heel belangrijk voor de CEMM. De aggregatie methode bepaalt hoe de data van het kanaal wordt verwerkt.

Aggregatie methoden

Aggregatie is het proces waarbij meerdere waardes worden gecombineerd tot één waarde. Dit gebeurt in de CEMM iedere minuut, de CEMM berekent dan voor ieder kanaal:

  • een minuutwaarde op basis van alle metingen in die minuut
  • een uurwaarde op basis van alle minuutwaardes in dat uur
  • een dagwaarde op basis van alle minuutwaardes in die dag
  • etc.

De aggregatie methode van het kanaal bepaalt hoe de waardes worden verwerkt. Voor een vermogen moet het gemiddelde worden berekend, terwijl voor energie de hoogste meterstand moet worden genomen.

De aggregatie methode heeft ook invloed op de manier waarop bijvoorbeeld tijdreeksen en exports worden gemaakt.

De CEMM heeft de volgende aggregatie methoden: AVG, COUNTER, PULSE, CALCULATED, TARIFF, DERIVED, TRANSIENT. Deze worden hieronder beschreven.

AVG

Wordt gebruikt voor onder andere: vermogen, spanning, stroom, doorstroming (L/min) en temperatuur.

De waarde wordt altijd berekend als het gemiddelde van de meetwaarden.

COUNTER

Wordt gebruikt voor onder andere: energie en gas. Deze methode kan alleen gebruikt worden bij meters met een absolute meterstand, zoals de slimme meter of Modbus kWh-meters.

De CEMM slaat per minuut de hoogste meterstand op. Voor grotere periodes wordt het verbruik opgeslagen (berekend als het verschil tussen de hoogste en laagste meterstand).

PULSE

Wordt gebruikt voor: energie, gas en water. Deze methode kan gebruikt worden bij meters die pulsen geven.

De CEMM telt alle pulsen bij elkaar op en slaat deze waarde op. Voor grotere periodes kan de som van de onderliggende periodes worden gebruikt (dag is som van minuten).

CALCULATED

Deze methode gebruikt meetwaarden van andere kanalen om een nieuwe waarde te berekenen. Deze berekening vindt iedere minuut plaats en het resultaat wordt opgeslagen. Deze methode wordt onder andere gebruikt om het werkelijke energieverbruik uit te rekenen.

Ieder CALCULATED kanaal heeft een operation en andere parameters die bepalen hoe de berekening wordt uitgevoerd.

TARIFF

Vergelijkbaar met CALCULATED, maar dan specifiek om kosten te berekenen. Kosten worden niet berekend op minuutniveau, alleen voor grotere periodes.

Een TARIFF kanaal is gekoppeld aan een COUNTER of PULSE kanaal en aan een tarief. De berekening van de kosten gebeurt op basis van het verbruik van het gekoppelde kanaal en het op dat moment geldende tarief.

DERIVED

Deze methode wordt gebruikt om een waarde te berekenen, het is vergelijkbaar met CALCULATED, maar het grote verschil is dat er geen gegevens worden opgeslagen.

De gegevens worden berekend aan het eind van de aggregatie en wanneer bijvoorbeeld tijdreeksen worden opgevraagd.

TRANSIENT

Deze methode wordt gebruikt wanneer een waarde wel wordt uitgelezen, maar niet wordt opgeslagen. Bijvoorbeeld als je wel de net frequentie wilt zien, maar niet wilt opslaan.

Alleen de realtime waarde is beschikbaar.

Onderwerpen (topics)

Tijdens de aggregatie worden per kanaal een aantal waardes berekent. Iedere waarde noemen we een onderwerp (afgeleid van het MQTT concept topic). Welke onderwerpen worden berekend is afhankelijk van twee dingen:

  • de aggregatie methode van het kanaal
  • het moment van de aggregatie

Hier volgt een overzicht van alle onderwerpen, met daarbij het interval waarop de waarde wordt bijgewerkt/gepubliceerd.

Onderwerp Interval Beschrijving
realtime 10s* De meest recente waarde van het kanaal.
reading iedere minuut De meest recente meterstand van het kanaal.
this/day iedere minuut Waarde van de huidige dag.
this/month iedere minuut Waarde van de huidige maand.
this/year ieder uur Waarde van het huidige jaar.
last/minute iedere minuut Waarde van afgelopen minuut.
last/15minutes ieder kwartier Waarde van afgelopen 15 minuten.
last/day iedere dag Waarde van afgelopen dag.
last/month iedere maand Waarde van afgelopen maand.
last/year ieder uur Waarde van afgelopen jaar.

* Iedere keer als de meter wordt uitgelezen wordt een nieuwe realtime waarde gepubliceerd. Dit is meestal iedere 10 seconden.

Per aggregatie methode zijn niet alle onderwerpen beschikbaar. Deze relatie is in de volgende tabel te zien:

Onderwerp AVG COUNTER PULSE CALCULATED TARIFF DERIVED TRANSIENT
realtime ✅* ✅*
reading
this/day
this/month
this/year
last/minute
last/15minutes ✅**
last/hour
last/day
last/month
last/year

* De realtime waarde van CALCULATED en DERIVED kanalen wordt één keer per minuut berekend.

** Deze waarde wordt nu berekend, maar in de toekomst mogelijk niet meer.

Ondersteunde kanalen

Als je een Modbus of MQTT meter aanmaakt of een meter uitbreidt, heb je de mogelijkheid zelf kanalen toe te voegen. Hierbij is het belangrijk dat je de juiste sleutel, eenheid en aggregatie methode kiest. De aggregatie methode is het belangrijkst, omdat deze bepaalt hoe de data wordt verwerkt. De sleutel en eenheid hebben vooral invloed op de manier waarop de CEMM de data presenteert.

Op basis van het meter-type, de meter-rol en de beschikbare kanalen (sleutels) wordt bepaald welke tijdreeksen en widgets worden getoond. Door de volgende sleutels (zo veel mogelijk) te gebruiken, zorg je ervoor dat de CEMM de data op de juiste manier verwerkt en presenteert.

Elektriciteit: vermogen en energie

Sleutel Eenheid Aggregatie methode Beschrijving
electric_power W AVG Vermogen
electric_power_import W AVG Vermogen Afname
electric_power_export W AVG Vermogen Teruglevering
electric_power_l1 W AVG Vermogen L1
electric_power_l2 W AVG Vermogen L2
electric_power_l3 W AVG Vermogen L3
electric_power_import_l1 W AVG Vermogen Afname L1
electric_power_import_l2 W AVG Vermogen Afname L2
electric_power_import_l3 W AVG Vermogen Afname L3
electric_power_export_l1 W AVG Vermogen Teruglevering L1
electric_power_export_l2 W AVG Vermogen Teruglevering L2
electric_power_export_l3 W AVG Vermogen Teruglevering L3
electric_energy kWh COUNTER of PULSE Energie
electric_energy_import kWh COUNTER of PULSE Energie Afname
electric_energy_export kWh COUNTER Energie Teruglevering
electric_energy_import_t1 kWh COUNTER Energie Afname T1
electric_energy_import_t2 kWh COUNTER Energie Afname T2
electric_energy_export_t1 kWh COUNTER Energie Teruglevering T1
electric_energy_export_t2 kWh COUNTER Energie Teruglevering T2
electric_energy_l1 kWh COUNTER Energie L1
electric_energy_l2 kWh COUNTER Energie L2
electric_energy_l3 kWh COUNTER Energie L3
electric_energy_import_l1 kWh COUNTER Energie Afname L1
electric_energy_import_l2 kWh COUNTER Energie Afname L2
electric_energy_import_l3 kWh COUNTER Energie Afname L3
electric_energy_export_l1 kWh COUNTER Energie Teruglevering L1
electric_energy_export_l2 kWh COUNTER Energie Teruglevering L2
electric_energy_export_l3 kWh COUNTER Energie Teruglevering L3

Elektriciteit: reactief vermogen

Sleutel Eenheid Aggregatie methode Beschrijving
electric_reactive_power_import VAR AVG Reactief vermogen afname
electric_reactive_power_export VAR AVG Reactief vermogen teruglevering
electric_reactive_energy_import kVARh COUNTER Reactief energie afname
electric_reactive_energy_export kVARh COUNTER Reactief energie teruglevering

Elektriciteit: spanning en stroom

Sleutel Eenheid Aggregatie methode Beschrijving
voltage V AVG Spanning
voltage_l1 V AVG Spanning L1
voltage_l2 V AVG Spanning L2
voltage_l3 V AVG Spanning L3
current A AVG Stroom
current_l1 A AVG Stroom L1
current_l2 A AVG Stroom L2
current_l3 A AVG Stroom L3

Elektriciteit: overig

Sleutel Eenheid Aggregatie methode Beschrijving
power_factor - AVG Power factor
frequency Hz AVG Frequentie
irradiance W/m2 AVG Zonnestraling
irradiation Wh/m2 COUNTER Ingestraalde energie

Gas

Sleutel Eenheid Aggregatie methode Beschrijving
gas_volume m3 COUNTER of PULSE Gas volume
volume m3 COUNTER of PULSE Gas volume
flow L/min AVG Gas doorstroming

Water

Sleutel Eenheid Aggregatie methode Beschrijving
volume m3 COUNTER of PULSE Water volume
flow L/min AVG Water doorstroming

Klimaat & weer

Sleutel Eenheid Aggregatie methode Beschrijving
temperature °C AVG Temperatuur
relative_humidity % AVG Relatieve luchtvochtigheid
wind_speed m/s AVG Windsnelheid
wind_direction deg AVG Windrichting

Overig

Sleutel Eenheid Aggregatie methode Beschrijving
electric_usage_power W CALCULATED Gereserveerd voor berekend verbruik
electric_usage_energy kWh CALCULATED Gereserveerd voor berekend verbruik

Veelvoorkomende kanalen

Dit overzicht geeft een indicatie van de beschikbare kanalen voor veelvoorkomende meters. Per meter type is dit de minimale lijst van kanalen. Het is bijvoorbeeld mogelijk om ook voltage kanaal toe te voegen aan de slimme meter. Dit moet echter handmatig ingesteld worden.

Slimme meter DSMR

Kanaal key eenheid type
Afname laagtarief electric_energy_import_t1 kWh COUNTER
Afname hoogtarief electric_energy_import_t2 kWh COUNTER
Teruglevering laagtarief electric_energy_export_t1 kWh COUNTER
Teruglevering hoogtarief electric_energy_export_t2 kWh COUNTER
Vermogen afname electric_power_import W AVG
Vermogen teruglevering electric_power_export W AVG
Elektrisch verbruik energie electric_usage_energy kWh CALCULATED
Elektrisch verbruik vermogen electric_usage_power W CALCULATED

Slimme meter DSMR Gas

Kanaal key eenheid type
Gas volume gas_volume m3 COUNTER

Puls (elektrisch)

Kanaal key eenheid type
Elektrische energie electric_energy kWh PULSE
Elektrisch vermogen electric_power W AVG

Puls (water en gas)

Kanaal key eenheid type
Volume volume m3 PULSE
Doorstroming flow L/min AVG

Eastron SDM120

Kanaal key eenheid type
Elektrisch vermogen electric_power W AVG
Afname hoogtarief electric_energy_import kWh COUNTER
Teruglevering laagtarief electric_energy_export kWh COUNTER

Eastron SDM72D & SDM630

Kanaal key eenheid type
Vermogen afname electric_power_import W AVG
Vermogen teruglevering electric_power_export W AVG
Afname hoogtarief electric_energy_import kWh COUNTER
Teruglevering laagtarief electric_energy_export kWh COUNTER