Ga naar inhoud

MQTT

Sinds versie 1.9.0 is het mogelijk om gegevens van de CEMM te versturen naar een externe MQTT-broker. Dit kan bijvoorbeeld gebruikt worden om gegevens te integreren in een domotica systeem zoals Home Assistant. Op de pagina 'Instellingen' > 'MQTT' vind je een overzicht van alle ingestelde MQTT-brokers. Klik op 'Broker toevoegen' om een nieuwe broker te configureren.

Na het toevoegen van een broker kan je bij het gedeelte 'Publiceren' klikken op 'Configureer'. Hier kan je aangeven welke gegevens gepubliceerd moeten worden. In de meeste gevallen kies je bij 'Topic toevoegen' voor 'Kanaalgegevens'. Dit zijn dezelfde gegevens die ook op het dashboard worden getoond. Na het toevoegen van een topic kan je het onderwerp (MQTT-topic) instellen. De optie "retain" is een MQTT-instelling die aangeeft of de broker de laatst gepubliceerde waarde moet onthouden. De optie "formaat" bepaalt of de waarde als getal of als JSON-object wordt gepubliceerd.

Zodra er in de CEMM een nieuwe waarde bekend is, wordt deze gepubliceerd naar de ingestelde MQTT-brokers. Het interval hiervan hangt onder andere af van de achterliggende meter. Een actueel vermogen uit een DSMR 5.0 meter zal iedere seconde worden gepubliceerd. Voor Modbus RTU-meters probeert de CEMM iedere 10 seconde een nieuwe waarde uit te lezen. Voor niet-actuele gegevens zoals "afgelopen dag" of "afgelopen maand" wordt de waarde gepubliceerd zodra deze door de CEMM is bijgewerkt.

Home Assistant Discovery

Om de gegevens van de CEMM in Home Assistant te integreren, kan je de MQTT-integratie van Home Assistant gebruiken. Voeg in de CEMM de MQTT-broker van Home Assistant toe en klik bij het gedeelte 'Home Assistant Discovery' op 'Configureer'. Kies hier de kanalen die je naar Home Assistant wil sturen en klik op 'Opslaan'. Ververs de pagina van Home Assistant om de nieuwe sensoren te zien.

MQTT Monitoring

Met de module MQTT Monitoring is het mogelijk om gegevens in te lezen via MQTT. Na het activeren van deze module verschijnt er een extra optie bij het toevoegen van een meter. Kies voor 'MQTT' en 'Aangepast'. Configureer of kies een broker en vul de overige velden in. Voeg daarna registers toe voor de gegevens die moeten worden uitgelezen. Per register moet een topic en een parser ingesteld worden. De parser bepaalt hoe de waarde uit het bericht wordt gehaald.

De parser kan een van de volgende types zijn:

  • numeric - De waarde wordt als getal geïnterpreteerd
  • string - De waarde wordt als tekst geïnterpreteerd
  • json - De waarde wordt als JSON ingelezen en de waarde wordt uit het JSON-object gehaald aan de hand van het opgegeven JSONPath (uit het veld 'Parser opties'). De CEMM ondersteunt alleen de basis van JSONPath, zoals een absoluut pad naar een waarde. Zie de voorbeelden hieronder.

Voorbeelden JSON Path

Pad met meerdere lagen:

{"smartmeter": {"power": 123.45}}

$.smartmeter.power

Pad naar een array:

{"smartmeter": {"power": [123.45, "W"]}}

$.smartmeter.power[0]

Pad naar een array in de root:

[123.45, "W"]

$[0]