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 eenheidkWh
. - 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 |