{"id":2226,"date":"2020-02-28T12:19:20","date_gmt":"2020-02-28T11:19:20","guid":{"rendered":"https:\/\/willem.aandewiel.nl\/?p=2226"},"modified":"2026-02-28T09:39:31","modified_gmt":"2026-02-28T08:39:31","slug":"restapis-zijn-hip-nieuwe-firmware-voor-de-dsmr-logger","status":"publish","type":"post","link":"https:\/\/willem.aandewiel.nl\/index.php\/2020\/02\/28\/restapis-zijn-hip-nieuwe-firmware-voor-de-dsmr-logger\/","title":{"rendered":"restAPI\u2019s zijn hip! (nieuwe firmware voor de DSMR-logger)"},"content":{"rendered":"\n

307,975 keer bekeken \/ views<\/p>\n\n\n\n

Je zult je ongetwijfeld afvragen \u201cwaarom weer een nieuw versie van de firmware?<\/em>\u201d<\/p>\n\n\n\n

De belangrijkste reden is dat steeds meer devices met internet zijn verbonden en dat steeds meer van deze devices gegevens met elkaar uitwisselen door middel van restAPI\u2019s.<\/p>\n\n\n\n

En daar kan de DSMR-logger natuurlijk niet bij achterblijven.<\/p>\n\n\n\n

15 juni 2021
Release v3.0.1<\/strong> van de DSMRloggerAPI firmware
Deze zgn. \u201cOne Fits All<\/strong><\/em>\u201d release maakt het overbodig om voor verschillende soorten Slimme Meters (DSMR 2+, 3+, 4+ 5+ en de Belgische varianten hiervan) aangepaste firmware te gebruiken. Alle (mij bekende) Slimme Meters kunnen met deze \u00e9ne release uitgelezen worden.
Zie vooral ook de offici\u00eble documentatie<\/a>!
Maar kijk, voor een volledig beeld, ook hier<\/a>, hier<\/a>, hier<\/a> en hier<\/a>!<\/p>\n\n\n\n

Maar goed, wat is dan het voordeel van het gebruik van restAPI\u2019s? Daarvoor is het misschien handig om eerst even vast te stellen wat de primaire taak van de DSMR-logger is en hoe de DSMR-logger met de DSMRloggerWS firmware \u2018werkt<\/em>\u2019.<\/p>\n\n\n\n

Primair is het de taak van de DSMR-logger om de Slimme Meter uit te lezen. <\/p>\n\n\n\n

Niet meer en niet minder.<\/em><\/strong><\/p>\n\n\n\n

Maar de DSMRloggerWS firmware voert niet alleen deze primaire taak uit, maar is ook heel druk met de besturing van de GUI en het reageren op invoer van de gebruiker. Dat maakt het lastig voor \u2018makers<\/em>\u2019 om bijvoorbeeld een GUI te ontwikkelen die specifiek voor een bepaalde situatie geschikt is of die gewoon mooier is dan de GUI die standaard met de DSMRloggerWS firmware wordt meegeleverd (ik ben redelijk goed in het ontwikkelen van robuuste hard- en software, maar als het om grafische zaken gaat ben ik gewoon een onbenul).<\/p>\n\n\n\n

Deze integratie tussen primaire taak en presentatie maakt ook dat de DSMR-logger soms drukker bezig is met het presenteren van mooie plaatjes dan met het goed verwerken van de telegrammen uit de Slimme Meter. Daarnaast blijkt dat steeds meer \u2018makers<\/em>\u2019 specifieke wensen hebben om gegevens uit de DSMR-logger te halen. Het is onmogelijk om dit allemaal in de firmware in te bakken.<\/p>\n\n\n\n

En dan komt de DSMRloggerAPI firmware als geroepen!<\/em><\/p>\n\n\n\n

Het restAPI protocol is buitengewoon simpel. Het is gewoon een http request zoals je die ook gebruikt om een web pagina op te vragen. Het verschil is dat het antwoord op het http request geen web-pagina maar (meestal) een JSON string is.<\/p>\n\n\n\n

Wil je de home pagina van deze website opvragen, dan toets je in de URL balk van je browser:<\/p>\n\n\n\n

https:\/\/www.aandewiel.nl<\/p>\n\n\n\n

.. waarna de browser de opgevraagde pagina op het scherm zet.<\/p>\n\n\n

\n
\"\"<\/figure>\n<\/div>\n\n\n

Het opvragen van gegevens uit de DSMR-logger gaat op dezelfde manier. Als URL toets je bijvoorbeeld in:<\/p>\n\n\n\n

http:\/\/DSMR-API.local\/api\/v1\/sm\/actual<\/p>\n\n\n\n

In de browser zie je vervolgens het antwoord dat er zo uit ziet:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Het antwoord komt terug als een JSON string die eenvoudig verder verwerkt kan worden.<\/p>\n\n\n\n

De firmware kent een aantal restAPI call\u2019s zoals bijvoorbeeld (er zijn er meer):<\/p>\n\n\n\n

\/api\/v1\/dev\/info<\/td>Geeft systeem informatie over de DSMR-logger terug<\/td><\/tr>
\/api\/v1\/dev\/time<\/td>Geeft de systeem (Slimme Meter) tijd terug<\/td><\/tr>
\/api\/v1\/dev\/settings<\/td>Geeft de systeem settings van de DSMR-logger terug<\/td><\/tr>
\/api\/v1\/sm\/info<\/td>Geeft systeem informatie van de Slimme Meter terug (meter id, p1 versie, equipment id enz.)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Voor de andere restAPI\u2019s verwijs ik je naar de offici\u00eble documentatie<\/a> van de DSMRloggerAPI firmware. <\/p>\n\n\n\n

Als je dit project leuk vindt overweeg dan om een kleine donatie te geven
\n\n

\n
\n \n \n \n \n \n \n \n \n \"\"\n <\/div>\n<\/form>\n\n<\/p>\n\n\n\n

Behalve de gegevens die via de restAPI\u2019s bij de DSMR-logger kunnen worden opgevraagd en in JSON formaat worden terug gegeven is het ook mogelijk om de telegrammen, exact zoals die door de Slimme Meter worden afgegeven op te vragen (dat gaat niet in de browser omdat deze het resultaat wil opslaan op je computer). De restAPI hiervoor is:<\/p>\n\n\n\n

http:\/\/dsmr-api.local\/api\/v1\/sm\/telegram<\/p>\n\n\n\n

De DSMR-logger geeft dan het volgende terug:<\/p>\n\n\n

\n
\"\"<\/figure>\n<\/div>\n\n\n

Dit is het volledige telegram zoals die door de Slimme Meter wordt verstuurd, inclusief “\\r\\n” line endings en CRC Checksum.<\/p>\n\n\n\n

De DSMRloggerAPI firmware zorgt er dus voor dat de DSMR-logger zich alleen nog met zijn primaire taak hoeft bezig te houden en af-en-toe een restAPI request moet beantwoorden. Ook dit is simpeler gemaakt dan in de vorige firmware omdat alles terug wordt gegeven zoals de Slimme Meter het aanlevert (met de benaming zoals de  arduino-dsmr bibliotheek van Matthijs Kooijman ze afgeeft). <\/p>\n\n\n\n

De hiervoor beschreven situatie is de \u201cideale situatie<\/em>\u201d. In de uiteindelijke implementatie heeft de DSMRloggerAPI firmware nog een paar andere taken en wel:<\/p>\n\n\n\n