Alle beschikbare gegevens kunnen via restAPI call's bij de DSMR-logger worden opgevraagd. De restAPI's zijn verdeeld in drie groepen. Informatie die met de hardware en firmware te maken heeft (/dev), informatie die met de Slimme Meter te maken heeft (/sm) en historische gegevens die, aan de hand van de door de Slimme Meter afgegeven gegevens, door de DSMR-logger in bestanden worden opgeslagen (/hist).

• DSMR-logger gerelateerde restAPI's

• Slimme Meter gerelateerde restAPI's

Aanroepen restAPI vanuit verschillende systemen

Een restAPI kan op verschillende manieren worden aangeroepen.

Javascript

Unix command

Geeft dit als output:

Home Assistant

configuration.yaml:

geeft dit resultaat:

De source van deze code kun je op vinden.

Andere systemen

Veel andere systemen hebben hun eigen manier om restAPI's op te vragen. Lees hiervoor de betreffende documentatie.

Voor de DSMRlogger32 firmware zijn de volgende bibliotheken nodig:

dsmr2Lib

Deze library is een uitbreiding op de arduino-dsmr van Matthijs Kooijman. Je kunt de dsmr2Lib library hier downloaden.

ezTime

Deze is door Rop Gonggrijp ontwikkeld. Installatie via de Library Manager. Je kunt meer informatie over deze bibliotheek vinden.

WiFiManager

Installatie via de Library Manager. Je kunt meer over deze door Tzapu ontwikkelde, bibliotheek vinden. De DSMRlogger32 firmware is getest met version 0.15.0 van deze bibliotheek maar nieuwere versies zullen waarschijnlijk ook werken.

TelnetStream

Deze bibliotheek is door Juraj Andrassy ontwikkeld. Installatie via de Library Manager. Je kunt meer informatie over deze bibliotheek vinden. De firmware is getest met version 1.2.2 maar nieuwere versies zullen waarschijnlijk ook werken.

SSD1306Ascii

William Greiman heeft deze bibliotheek ontwikkeld met in het achterhoofd minimaal gebruik van resources (dus: een bibliotheek die weinig geheugen gebruikt). Installatie via de Library Manager. Meer informatie over deze bibliotheek kun je vinden. De DSMR-logger Firmware is getest met Version1.3.0 maar nieuwere versies zullen waarschijnlijk ook werken.

SSD1306AsciiWire

Onderdeel van SSD1306Ascii.

Adafruit NeoPixel

Door Adafruit ontwikkelde bibliotheek om NeoPixels aan te sturen. Installatie via de Library Manager.

PubSubClient

Nick O'Leary (knolleary) heeft deze bibliotheek ontwikkeld. Installatie via de Library Manager. Getest met versie 2.7.0 Je kunt meer informatie over deze bibliotheek vinden.

ArduinoJson

Ontwikkeld door Benoit Blanchon. Installatie via de Library Manager. Getest met versie 16.19.3. vind je meer informatie over deze library.

SPIFFS_SysLogger

Je kunt de bibliotheek downloaden. Pas op! voor gebruik van het LittleFS moet je versie gebruiken!

Overige libraries

Onderstaande libraries zijn onderdeel van de ESP8266 Core en moeten dus niet handmatig geïnstalleerd worden!

• FS

• SPIFFS

• WiFi

• WebServer

Clonen Firmware

De DSMRlogger32 firmware staat hier https://github.com/mrWheel/DSMRlogger32. Er zijn twee manieren om de firmware te clonen.

1. download de repository als een .zip file

2. gebruik git

Als je niet handig bent met git raad ik je aan de repository als een .zip file te downloaden.

Ga naar de .

Download .zip file

Klik op de groene knop [<> Code] ..

.. en selecteer [Download ZIP]

Er volgt een scherm als dit:

1. Bewaar het .zip bestand op een plek op je computer waar je hem terug kunt vinden.

2. Unzip het DSMRlogger32-main.zip bestand in de ArduinoIDE Sketchbook Location.

3. Rename de map

Ga verder naar .

git clone

Om de repository met git te kunnen clonen moet je er éérst voor zorgen dat je git op je systeem hebt staan. Hoe je dat moet doen valt buiten de scope van deze documentatie maar kun je alles vinden over hoe je dit, voor jouw systeem, moet doen.

Voor nu ga ik ervan uit dat je git op je systeem hebt staan en dat je weet hoe je ermee moet werken.

Ga naar de Arduino Sketchbook location (de map waar al je Sketches in staan, ) en toets het volgende commando in:

That's it!

In Sketchbook location staat hierna een nieuwe map met de naam DSMRlogger32.

DSMRlogger32 Sketch openen

Start de ArduinoIDE opnieuw op en klik op het open icoon.

Selecteer in het drop-down menu "Open" ..

In het pop-up window dat nu verschijnt navigeer je naar de map "DSMRlogger32" ..

.. en selecteer je de sketch DSMRlogger32.ino. Er verschijnt een nieuw editor window met de firmware van de DSMRlogger32!

Versie 5 van de DSMR-logger32 hardware maakt gebruik van een ESP32-WROVER processor. Deze processor zit op de printplaat van de DSMR-logger32 gesoldeerd en moet dus, op de printplaat, geflashed worden.

Overtuig je ervan dat alle tabbladen aanwezig zijn!

Om de firmware naar de DSMR-logger32 te kunnen flashen moet deze eerst voor deze versie van de DSMR-logger32 geschikt worden gemaakt.

Dit doe je door in de DSMRlogger32.ino (het eerste tabblad) de #define's aan te passen.

Door de twee slashes (

Met de Update Server is het mogelijk om firmware en het bestand systeem naar een DSMR-logger32 te flashen.

Je kunt de Update Server op twee manieren opstarten:

• Door op de knop [Update Firmware] in de FSmanager te klikken

• Door in de browser de volgende URL in te toetsen: http://dsmr-esp32.local/update of: http://<hetIPadresVanDeDSMRlogger>/update

Om de firmware op de DSMR-logger32 te krijgen moeten een aantal stappen worden ondernomen. Hieronder staat welke stappen dat zijn.

• Benodigde Bibliotheken

Nieuwe DSMRlogger32 firmware kan via de web-interface van de DSMR-logger "Over the Air" geflashed worden maar mocht dat, om de één of andere reden niet lukken dan kunnen de pré compiled binaries ook bedraad geflashed worden.

In dit gitbook vind je alle informatie over de DSMRlogger32 firmware voor de DSMR-logger32.

Introductie

Je vindt hier de documentatie van de DSMRlogger32 hardware en firmware voor versie 5 van de DSMR-logger. Deze DSMR-logger is "Plug-And-Play" en alleen in bijzondere gevallen moet er, via de GUI, iets aan de instellingen aangepast worden (bijvoorbeeld als je een hele oude Slimme Meter hebt of als je een zgn. "Enkel Fase" Slimme Meter hebt). Deze documentatie is ook voor de gebruikers en makers die meer willen dan alleen de DSMR-logger aansluiten op hun Slimme Meter. De meeste gebruikers zullen voldoende hebben aan alleen dit hoofdstuk.

De DSMR-logger32 is een hardware en software systeem waarmee de Slimme Meter kan worden uitgelezen. De uitgelezen data (oftewel telegrammen) worden in de DSMR-logger32 opgeslagen en kunnen met behulp van gestandaardiseerde restAPI call's worden opgevraagd.

Deze versie van de DSMRlogger32 firmware kan overweg met vrijwel alle, mij bekende, Slimme Meters (DSMR 2+, DSMR3+, DSMR4+, DSMR5+ en de Belgische varianten hiervan).

Meer informatie

• ​ beschrijft het eerste idee achter de Slimme Meter uitlezer.

• In kun je de ontwikkeling van de hardware en firmware vinden.

• ​ staat een introductie van de DSMRloggerAPI firmware

Begrippen

In dit document worden de volgende begrippen gebruikt:

Een volledige beschrijving van dit project kun je vinden.

De hardware is behoorlijk aangepast ten opzichte van de voorgaande versies.

De drie belangrijkste aanpassingen zijn de secondaire P1 poort, de Watchdog en de mogelijkheid om een shield op de DSMR-logger32 te plaatsen. Iets minder belangrijk, maar wel erg informatief zijn de drie Neopixels. Twee worden bestuurd door de ESP32 de derde wordt bestuurd door de Watchdog (ATtiny85).

De DSMRlogger32 heeft de mogelijkheid om meterstanden en instellingen via de browser te veranderen.

Je start de DSMR-editor door in het hoofdscherm op het icoontje te klikken.

Betekenis van de knoppen:

• Terug: Terug naar het hoofdscherm van de DSMR-logger.

• Meterstanden: Hier kunnen, per maand, de meterstanden worden ingevoerd. Er kan gekozen worden tussen de meterstanden van de gebruikte energie, de opgewekte energie en het gas verbruik.

• Settings: Hier kunnen bepaalde parameters die specifiek zijn voor jouw Slimme Meter worden ingevoerd.

• System: Voor jouw DSMR-logger specifieke parameters.

• Herstel: ingevoerde veranderingen die nog niet zijn opgeslagen worden teniet gedaan.

• Opslaan: de ingevoerde gegevens worden opgeslagen.

Meterstanden aanpassen

Het muteren van de maanden tabel is nog niet helemaal zoals het zou moeten zijn. Het is vrij lastig omdat de software zeker moet zijn dat de jaar/maand gegevens, van boven naar beneden, aflopen en aansluiten en ook de meterstanden moeten een steeds lagere waarde hebben. Wordt niet aan voorgaande inter-validatie voldaan, dan kleurt het vakje waar de fout is ontdekt rood en worden de gegevens niet opgeslagen.

Slimme Meter Settings aanpassen

Use Pré DSMR 40 (0=No, 1=Yes)

Zet deze rubriek op "1" als je een DSMR 2+ of DSMR 3+ Slimme Meter hebt. Deze instelling wordt pas actief nadat de DSMR-logger opnieuw is opgestart.

MBus-1 (2,3,4) Type Meter

Voer hier het Type in van de meter die op de betreffende MBus is aangesloten. Het Type van Gas meters is "003". Als in jouw installatie de Gas meter is aangesloten op MBus-ID2 voer je bij de rubriek**"MBus-2 Type meter"**een "3" in. Bij MBus-ID's waar niets op is aangesloten voer je het beste een "0" in.

SM Has Fase Info (0=No, 1=Yes)

Voer een 1 in als de aangesloten Slimme Meter wél fase informatie afgeeft, voer anders een 0 (nul) in. Of jouw Slimme Meter Fase Informatie af geeft kun je zien door naar een telegram te kijken. Geeft jouw Slimme Meter Fase Informatie dan zie je rubrieken met een naam waar _l1, _l2 en _l3 achter staat. Je hebt een Slimme meter die géén fase info afgeeft als de grafieken leeg blijven.

Device Settings aanpassen

Hostname

De default Hostname is DSMR-ESP32. De documentatie gaat ook uit van deze default hostname. Mocht je de hostname hier veranderen dan moet je bij het lezen van de documentatie overal "DSMR-ESP32" vervangen door de door jou ingevoerde hostname.

Te gebruiken index.html pagina

De standaard index pagina is "DSMRindex.html". Mocht je zelf een GUI schrijven dan kun je hier de naam van de index pagina van jouw GUI invullen (nadat je jouw .html pagina naar het bestand systeem hebt ge-upload). Standaard staat er ook een DSMRindexEDGE.html pagina op het bestand systeem. Deze is gelijk aan de DSMRindex.html pagina maar hij haalt de javascript en css bestanden uit de github repository zodat aanpassingen (uitbreidingen of verbeteringen) automatisch door de DSMR-logger gebruikt worden. Je kunt alternatieve GUI's eenvoudig uitproberen door in de FSmanager op deze bestanden te klikken.

Dagelijkse Reboot

Soms is het handig om de DSMR-logger iedere dag automatisch te re-booten. Door deze optie op "1" te zetten gebeurt dat iedere ochtend.

Uren/Dagen/Maanden historie aanpassen

Het is mogelijk om, binnen grenzen, de hoeveelheid historie die je per uur, dag of maand wilt opslaan in het betreffende RING bestand, aan te passen. Je kunt slechts één van deze RING-bestanden per keer aanpassen. Om dat te doen moet je zowel het aantal veranderen alsook de rubriek "Historie aanpassen" op "1" zetten en op [Opslaan] klikken.

Telegram Lees Interval

Default interval is 10. Dit betekent dat er iedere tien seconden een telegram wordt gelezen en verwerkt. De minimum waarde is 2 seconden.

OLED type

Hier kun je invoeren óf en wat voor OLED schermpje op de DSMR-logger is aangesloten.

• Voer een 0 (nul) in als er geen OLED scherm is aangesloten

• Voer een 1 in als het scherm van het type SDD1306 is

• Voer een 2 in als het scherm van het type SH1106 is

Flip Oled scherm

• Voer 0 (nul) in om het scherm standaard te gebruiken

• Voet 1 in als je het scherm "op zijn kop" gebruikt.

MQTT Top Topic

Dit is het topic waarmee de MQTT berichten naar de broker worden verstuurd. Standaard is het Top Topic "DSMR-ESP32".

Verzend MQTT berichten

Hier kun je opgeven hoe vaak de DSMR-logger een bericht naar de MQTT broker moet sturen. Voer je hier '0' (nul) in dan worden er géén berichten naar de MQTT broker verstuurd. Een waarde kleiner dan de Telegram Lees Interval zorgt ervoor dat na ieder gelezen telegram een bericht naar de MQTT broker wordt verstuurd.

Met de FSmanager is het mogelijk bestanden op het bestand systeem (SPIFFS) van de DSMR-logger te plaatsen of ze ervan te verwijderen. Ook kan de inhoud van bestanden die aanwezig zijn op het bestand systeem worden getoond (dit is niet mogelijk met .html bestanden omdat deze direct door de browser geïnterpreteerd -en dus uitgevoerd- worden).

Daarnaast kent de FSmanager nog de volgende functies:

• Starten van de Update Server [Update Firmware]

• Rebooten van de DSMR-logger[Reboot]

• Formatteren van het SPIFFS [Format FileSYS]

• Soms blijft het scherm leeg. Klik dan op de knop[List File System]

• Met de knop[Exit FSmanager] keer je terug naar het hoofdscherm.

Er zijn verschillende manieren om de FSmanager te starten:

• Vanuit het DSMR-logger hoofdscherm door op het icoon te klikken

• Door in de browser de volgende URL in te toetsen http://dsmr-esp32.local/FSmanager of: http://<ipAdresVanDeLogger>/FSmanager

Het bestand systeem formatteren

De FSmanager heeft de mogelijkheid om het bestand systeem te formatteren. Deze functie is alleen nodig als het bestand systeem problemen vertoont. Normaal gesproken is deze functie nooit nodig en daarom is de knop ook uitgeschakeld. Om de knop te activeren moet het bestand met de naam !doNotFormat(het eerste teken is een uitroep-teken) ge-delete worden. De inhoud van het bestand is niet belangrijk. Zodra dit bestand afwezig is wordt de [Format FileSYS] knop geactiveerd.

Na iedere herstart zal de DSMRlogger32 firmware controleren of het bestand systeem correct geformatteerd is. In dat geval plaatst het automatisch een bestand met de naam !doNotFormat in de root directory.

De Graphical User Interface (GUI) van de DSMR-logger32 kun je bereiken door de URL "http://dsmr-esp32.local/" in de adresbalk van je browser in te toetsen:

Mocht je bij Systeem Settings een andere HostName ingevoerd hebben, dan verandert deze URL natuurlijk in "<Hostname>.local".

Veel browser vinden het niet fijn als je een "niet-geëncrypte" site bezoekt en vragen dan eerst of je dat wel echt wil ...

... omdat we weten waar we mee bezig zijn kun je in dit geval met een gerust hart op de knop [Continue to site] klikken.

Bij het opstarten van de DSMR-logger32 kun je, aan de hand van de NeoPixels zien wat hij "aan het doen is".

Na een [Reset] of bij het aansluiten van de spanning zal de DSMR-logger32 een aantal stappen uitvoeren. Als eerste zal de NEO-WD Blauw worden en de twee andere Neopixels zullen snel blinken in verschillende kleuren. Daarna worden NEO-1 en NEO-2 kortstondig rood.

De Watchdog

De Watchdog stuurt NEO-WD aan en het verloop is altijd als volgt:

Bijzondere situatie

Bij de eerste keer opstarten, als je met de credentials hebt ge-reset óf als je de DSMR-logger32 naar een lokatie verplaatst waar hij geen verbinding met het ingevoerde/bekende WiFi AccessPoint kan maken, zullen de Neopixels als volgt gaan branden:

Afhankelijk van hoe snel je met het selecteren van je WiFi AP bent zal de NEO-WD in "normale operatie" komen (stap 3/4) en langzaam Groen pulseren. Duurt het selecteren en bewaren van je WiFi credentials te lang dan zal de NEO-WD eerst langzaam en daarna snel in Rood pulseren waarna de ESP32 wordt ge-reset en deze weer met de normale opstart procedure start.

Voeding niet toereikend

Als de externe voeding of de voeding van de Slimme Meter niet voldoende vermogen levert (minimaal 500mA) dan zal dat te zien zijn aan de NeoPixels die dan als volgt branden/knipperen:

Normale verwerking

Bij het opstarten zullen de NeoPixels als volgt branden/pulseren:

Als de hele opstart procedure (goed) is doorlopen hoort de NEO-WD langzaam in het groen te pulseren. Zolang de Watchdog regelmatig een heartbeat van de ESP32 ontvangt zal dat het geval zijn. Dat de ESP32 een heartbeat verstuurt kun je zien omdat NEO-1 dan héél even Wit oplicht.

Iedere keer dat de DSMR-logger een telegram verwerkt zal NEO-2 even fel groen oplichten.

Systeem Informatie van de Slimme Meter

GET http://dsmr-esp32.local/api/v2/sm/info

Geeft systeem een JSON string met informatie van de Slimme Meter, zoals ID's en Serie nummers, terug.

{
  "info": {
    "identification": "XMX5LBGGFB2410065887",
    "p1_version": "50",
    "equipment_id": "4530303336303033373839373339363136",
    "electricity_tariff": "0002",
    "mbus1_device_type": 3,
    "mbus1_equipment_id_tc": "4730303339303031363532303530323136"
  }
}

Informatie uit het laatst gelezen telegram

GET http://dsmr-esp32.local/api/v2/sm/actual

Geeft de actuele meterstanden van de Slimme Meter terug in een JSON string.

Alle velden die de dsmr library terug kan geven

GET http://dsmr-esp32.local/api/v2/sm/fields

Geeft een JSON string met alle velden die door de DSMRlogger32 firmware kunnen worden terug gegeven.

\

Let op!

Niet iedere Slimme Meter geeft ook al deze velden terug. Als de Slimme meter een veld niet terug geeft heeft

"value"

de waarde

"-"

.

Informatie van één veld uit het laatst gelezen telegram

GET http://dsmr-esp32.local/api/v2/sm/fields/<fieldName>

Geeft een JSON string met informatie over één veld terug. Bijvoorbeeld:

http://dsmr-esp32.local/api/v2/sm/fields/current_l2

Onbewerkt telegram uit de Slimme Meter

GET http://dsmr-esp32.local/api/v2/sm/telegram

Geeft een telegram terug precies zo als de Slimme Meter die ook afgeeft, dus inclusief "\r\n" line endings en inclusief de CheckSum!

Met onderstaande code kun je met een ESP8266 gegevens uit de DSMR-logger32 ophalen en verder verwerken.

informatie over de DSMR-logger

GET http://dsmr-esp32.local/api/v2/dev/info

Deze restAPI geeft informatie terug van de DSMR-logger

{
  "devinfo": {
    "author": "Willem Aandewiel (www.aandewiel.nl)",
    "fwversion": "v5.0.2 (22-12-2022)",
    "compiled": "Dec 24 2022 10:42:31",
    "hostname": "DSMR-ESP32",
    "ipaddress": "192.168.12.143",
    "macaddress": "8C:4B:14:81:FF:B0",
    "indexfile": "DSMRindex.html",
    "free_heap": 229604,
    "min_free_heap": 4087619,
    "psram_size": 4191755,
    "free_psram_size": 4057915,
    "used_psram_size": 133840,
    "chip_model": "ESP32-D0WDQ5",
    "sdk_version": "v4.4.2",
    "cpu_freq": 240,
    "sketch_size": 1207712,

Systeem Tijd

GET http://dsmr-esp32.local/api/v2/dev/time

Deze restAPI geeft de systeem tijd van de DSMR-logger

Instellingen

GET http://dsmr-esp32.local/api/v2/dev/settings

Deze restAPI geeft alle, door de gebruiker muteerbare, Slimme Meter settingen terug

Instellingen aanpassen

POST http://dsmr-esp32.local/api/v2/settings/{"name":"<settingVeld>","value":"<nieuweWaarde>"}

Hieronder een opsomming van de settingsVelden:

hostname

• type: String

• maxlen: 29

• Opmerking:

  • Characters

ed_tariff1 (Geleverde Energy, tarief 1)

• type: float

• min: 0

• max: 10

• decimalen: 5

ed_tariff2 (Geleverde Energy, tarief 2)

• type: float

• min: 0

• max: 10

• Decimalen: 5

er_tariff1 (Opgewekte Energy, tarief 1)

• type: float

• min: 0

• max: 10

• Decimalen: 5

er_tariff2 (Opgewekte Energy, tarief 2)

• type: float

• min: 0

• max: 10

• Decimalen: 5

gd_tariff (Gas Geleverd)

• type: float

• min: 0

• max: 10

• Decimalen: 5

electr_netw_costs (Netwerk kosten Electra)

• type: float

• min: 0

• max: 100

• Decimalen: 2

gas_netw_costs (Netwerk kosten Gas)

• type: float

• min: 0

• max: 100

• Decimalen: 2

tlgrm_interval (telegram Interval)

• type: Integer

• min: 1

• max: 60

• Opmerking:

index_page (alternatieve index.html pagina)

• type: String

• maxlen: 49

• Opmerking:

  • Characters

mqtt_broker (URL of IP-adres)

• type: String

• maxlen: 100

• Opmerking:

  • Characters

mqtt_broker_port

• type: Integer

• min: 0

• max: 9999

mqtt_user

• type: String

• maxlen: 39

• Opmerking:

  • Characters

mqtt_passwd

• type: String

• maxlen: 29

• Opmerking:

  • Characters

mqtt_toptopic

• type: String

• maxlen: 20

• Opmerking:

  • Characters

mqtt_interval (interval voor het versturen van MQTT berichten)

• type: Integer

• min: 0

• max: 600

• Opmerking: Seconden

De restAPI's voor het opvragen van historische gegevens hebben dit formaat:

of:

of:

Opvragen actuele gegevens

GET http://dsmr-esp32.local/api/v2/hist/actual

{
  "store": {
    "44": [
      {
        "actual": {
          "timestamp": "230102153122W",
          "power_delivered_l1": 0.379,
          "power_delivered_l2": 0.135,
          "power_delivered_l3": 0.415,
          "power_returned_l1": 0,
          "power_returned_l2": 0,
          "power_returned_l3": 0,
          "gas_delivered": 5310.339
        }
      }
    ],
    "45": [
      {
        "actual": {
          "timestamp": "230102153126W",

Opvragen gegevens uit de uren tabel

GET http://dsmr-esp32.local/api/v2/hist/hours

Geeft een JSON string met de historische gegevens over de afgelopen 24 uur terug.

Opvragen gegevens uit de dagen tabel

GET http://dsmr-esp32.local/api/v2/hist/days

Geeft een JSON string met alle gegevens over de afgelopen dagen terug.

Opvragen gegevens uit de maanden tabel

GET http://dsmr-esp32.local/api/v2/hist/months

Geeft een JSON string met alle gegevens van de afgelopen maanden terug.

Behalve met de GUI kun je de DSMR-logger32 ook bereiken via het telnet protocol (poort 23). De meeste UNIX varianten (waaronder MacOS) kennen de standaard telnet client. Windows gebruikers moeten een programma zoals Putty installeren.

Telnet is een onbeveiligd protocol dat geen gebruik maakt van een gebruikersnaam en/of wachtwoord.

Start in een terminal window de telnet client als volgt op:

telnet <ip-adres-DSMR-logger32>

of met:

telnet DSMR-ESP32.local

Als de verbinding lukt zie je dit:

Als je nu op de[Enter] toets drukt krijg je een menu te zien:

De menu-keuzen waar een asterisk (*) voor staat werken alleen als je de letter als HOOFDLETTER intoetst. De meeste opties spreken voor zich.

Je sluit de telnet client af door de toetscombinatie [Control]+"]" in te toetsen:

Toets achter "telnet>" de letter "q" in en druk op [Enter].

Home Assistant kan op twee manieren gegevens uit de DSMR-logger32 (met de DSMRlogger32 firmware) ophalen.

Via restAPI

Om de gegevens door middel van de restAPI's uit de DSMR-logger32 te halen moet het configuration.yaml bestand er ongeveer als volgt uit zien:

Heeft iemand een werkend YAML bestand dat met restAPI's werkt????

Met onderstaande code kun je met een ESP32 gegevens uit de DSMR-logger32 ophalen en verder verwerken.

Arduino Mega met Ethernet shield

Met onderstaande code kun je, met een Arduino MEGA met Ethernet shield, gegevens uit de DSMR-logger32 ophalen en verder verwerken.

Installatie ArduinoIDE

Download en installeer de meest actuele versie van de Arduino Integrated Development Environment (IDE) voor het Operating Systeem (OS) waar jouw Desktop of Laptop computer (er zijn versies voor Windows, Linux en Mac) mee werkt. Je kunt de Software hier downloaden.

Na het downloaden moet je het ontvangen bestand uitpakken (unzip of untar) en installeren. Dat installeren is per OS anders maar staat duidelijk op de website van Arduino aangegeven. Eenmaal geïnstalleerd kun je direct met de Arduino IDE aan de slag.

Om de IDE met de ESP32 microprocessor te kunnen gebruiken moeten we nog wat stappen uitvoeren.

Vragen en Antwoorden

• Niet alles DSMR 4 is DSMR 4

• Overstappen van een DSMR-logger versie 4

Niet alles DSMR 4 is DSMR 4 ..

Mijn DSMR-logger32 doet het niet als ik hem op de Slimme Meter aansluit. Er zijn Slimme Meters die 'zeggen' DSMR Versie 4 te volgen maar toch geen 5 volt met voldoende stroom leveren. Bouwers van de DSMR-logger32 hebben problemen gemeld met de KAIFA MA105A en MA105C en met de KAIFA MA304. Kijk bijvoorbeeld en . Dit probleem is op te lossen door de DSMR-logger32 op een externe (bijvoorbeeld USB) voeding aan te sluiten.

Raak ik bij een overstap van een DSMR-logger v4 mijn historie kwijt?

Heb je al een DSMR-logger versie 4 met de DSMRloggerAPI firmware in gebruik en je stapt over naar de DSMR-logger32 dan wil je uiteraard je historisch data meenemen. Dat kán, maar je moet daar wel de juiste procedure voor volgen omdat de RING bestanden van de DSMRlogger32 firmware nét iets anders zijn dan die van de DSMRloggerAPI firmware.

Kan de DSMR-logger32 verbinding maken met ieder modem?

Helaas blijkt de ESP32 geen verbinding te kunnen maken met Technicolor modems (van Ziggo). Of het probleem in het modem zit of in de Arduino esp32 core is mij niet bekend. Zie ook op github.

Kan ik met een 5 volt USB to TTL adaptor de DSMR-logger32 flashen?

Als het een type is dat de TX en RX signalen op 3v3 levert (bijvoorbeeld ) dan kán het wel, maar moet je de 5 Volt output niet op de DSMR-logger32 aansluiten. De overige aansluitingen maak je zoals in het plaatje hieronder. Áls je de rode draad als voeding wilt gebruiken, dan moet je deze verbinden met de 5v testpin naast de 5Volt Ext. jack connector.

Wanneer moet ik Updaten en wanneer Upgraden?

We doen een update als we de firmware willen vervangen met een nieuwere versie van dezelfde firmware (dus we vervangen DSMRlogger32 door een nieuwere versie van DSMRlogger32).

We doen een upgrade als we de ene firmware vervangen door een andere (dus we vervangen bijvoorbeeld DSMRlogger32 door DSMRlogger64).

Update

Bij een update zal de lay-out van de data-bestanden niet veranderen en kun je volstaan met het opnieuw flashen van de firmware. Voor de data-map (SPIFFS) kun je twee wegen bewandelen.

1) Je haalt m.b.v. de FSmanager de .html en .js bestanden op uit de data-map en zet deze in SPIFFS

2) Je haalt met de FSmanager de RINGxxxx.csv bestanden op en zet deze in de data-map, waarna je met het ESP32Sketch Data Upload tool de data-map naar SPIFFS kunt overzetten.

Upgrade

Bij een upgrade moet je zowel de firmware als de data-map opnieuw naar de DSMR-logger32 flashen. Uiteraard kun je ook in dit geval éérst de RINGxxxx.csv bestanden uit de DSMR-logger32 halen en ergens op je computer bewaren.

Waarom zie ik mijn gasverbruik niet?

Ik zie mijn gasverbruik niet op de DSMR-logger Waarschijnlijk zit je gasmeter niet op kanaal 1 aangesloten. Kijk in een Telegram op welk kanaal je gasmeter wél is aangesloten en pas dit aan in .

Wat zijn de maten van de DSMR-logger32?

Wat zijn de maten van de DSMR-logger32?

De buitenmaten zijn 80mm x 78mm.

De hoogte van de DSMR-logger32 is ongeveer 20mm (bovenkant RJ12 connectoren) of ~18mm (bovenkant OLED scherm (indien geplaatst).

Aansluiting externe voeding

De middenconnector van de DC plug is positief:

Omdat deze voeding ook voor de (secundaire) P1 poort gebruikt wordt moet deze 5 volt zijn!

Wat is het verschil tussen RJ10 en RJ12?

Wat is het verschil tussen RJ10 en RJ12? Hier bestaat nogal wat verwarring over op het internet. Het is niet helemaal duidelijk wat de juiste benaming van deze Registered Jack stekkers is. De meest gehanteerde benamingen zijn:

RJ12 (6P6C)

RJ11 (6P4C)

RJ10 (4P4C)

RJ11 en RJ12 zijn even breed en passen in dezelfde female connector, maar bij de eerste maken alleen de 4 binnenste contacten verbinding terwijl bij de RJ12 alle 6 de contacten verbinding maken. Ook de RJ10 stekker past in een RJ12 female connector maar ook dan worden alleen de binnenste 4 contacten met elkaar verbonden.

In die gevallen waarbij een externe voeding nodig is omdat de Slimme Meter niet genoeg stroom levert voor de DSMR-logger én de Slimme Meter géén telegrammen verstuurt als er een externe voeding wordt gebruikt, zijn zowel de RJ11 als de RJ10 stekkers de oplossing.

Installatie ESP32 core

In de Arduino IDE moet bij “Instellingen” de volgende URL worden ingevoerd achter “Additional Boards Manager URL’s:” (zie blauw gekleurde regel)

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

Lees vooral de uitleg in het README.md bestand en de uitgebreide documentatie op hun website!

Er kunnen meer additional board manager URL’s worden ingevuld. Je moet ze dan achter elkaar zetten en scheiden door een komma (,).

Nadat de preferences zijn geupdate moet je in de Arduino IDE de Boards Manager opstarten:

Nadat de Boards Manager is opgestart (dat duurt even) moet je in de selectie-balk "esp32" intoetsen.

Klik nu op [Install] of selecteer de gewenst versie en klik op [Update]. De DSMRlogger32 firmware is met versie 2.0.5 van de ESP32 core getest.

Om het mogelijk te maken de "data" map van de DSMRlogger32 firmware naar de DSMR-loggr32 te uploaden, moet eerst een extensie in de Arduino IDE worden geïnstalleerd.

Ga hiervoor naar .

Ga vervolgens naar en selecteer het nieuwste esp32fs.zip bestand.

Maak een map tools aan in je Arduino Projecten map (als die map nog niet bestaat) en ga in de map "tools" staan.

Pak nu het

MIT License

Copyright © 2022 - 2023 Willem Aandewiel

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

In de volgende vier hoofdstukken wordt beschreven wat je moet doen om zélf de DSMRlogger32 firmware te compileren en naar de DSMR-logger32 te flashen.

• Arduino IDE

• ESP32 Core

• Installatie Bibliotheken

WiFi configureren

Als de DSMR-logger32 voor het eerst op de P1 poort van de Slimme Meter wordt aangesloten, of als je in de Telnet User Interface de letter "W" hebt ingetoetst, zijn de credentials van je WiFi Access Point nog niet/niet meer bekend.

De DSMR-logger32 zal nu een eigen AccessPoint opstarten. Heb je een OLED-schermpje op je DSMR-logger32 aangesloten dan staat er op het OLED schermpje dat er een AccessPoint is opgestart (AP mode active) en dat je daar verbinding mee moet maken. Maar ook zonder OLED schermpje kun je aan de NEOpixels zien dat er een AccessPoint is opgestart. NEO-1 zal namelijk fel wit branden (NEO-2 is uit).

Met je computer/mobiel/tablet, ga je naar Netwerk Instellingen en kijk je welke WiFi Access Points (AP) er allemaal zijn.

Als daar een WiFi AP met de naam DSMR-ESP32-xx:yy:zz tussen staat maak je daar verbinding mee (er hoeft geen wachtwoord te worden ingevoerd). Er kunnen nu twee dingen gebeuren:

1. Er verschijnt een popUp window met de optie om je WiFi netwerk te configureren (klik op [Configure WiFi]).;

2. Of er gebeurt niets. Ga dan met je browser naar http://192.168.4.1/ waarna er een (popUp) window verschijnt waarin je je WiFi netwerk kunt configureren (klik op [Configure WiFi]).

Nu volgt er een scherm met alle WiFi netwerken die in de buurt gevonden zijn. Selecteer jouw WiFi netwerk en voer het bijbehorende wachtwoord in.

Druk vervolgens op [Save].

De DSMR-logger32 zal rebooten en verbinding maken met jouw WiFi router (zie: ).

Als de DSMR-logger32 nog steeds geen verbinding met jouw WiFi netwerk kan maken dan start hij weer zijn eigen AP op (NEO-1 brandt weer fel wit, NEO-2 is uit) en dan zul je de WiFi procedure opnieuw moeten uitvoeren.

Als de DSMR-logger32 normaal is opgestart en de drie NeoPixels branden groen, ga dan met je browser naar: http://DSMR-ESP32.local/ of http://<IPadresVanDeDSMRlogger>

In de browser verschijnt nu de de hoofd-pagina van de DSMR-logger32 met daarin de actuele data uit je Slimme Meter.

Je kunt met telnet DSMR-ESP32.local of met telnet <IPadresVanDeDSMRlogger> inloggen op je DSMR-logger32 en volgen waar hij mee bezig is (zie ).

Om te bepalen welk IP is uitgegeven aan de ESP door de DHCP server, kun je in je router kijken, of dit opzoeken met bijv. de Fing app of met nmap.

AP mode blijvend activeren

Het is mogelijk om de DSMR-logger32 permanent als Access Point te gebruiken. De DSMR-logger32 wordt dan niet op je eigen netwerk aangesloten maar blijft zelf een AP. Je kunt de GUI benaderen door op je PC of tablet het AP (DSMR-ESP32-xx:yy:zz) te kiezen (zoals hiervoor beschreven). Het IP address waar je in AP mode naar toe moet browsen is http://192.168.4.1 Je kunt deze mode activeren door tijdens het opstarten de [Flash] knop in te drukken en ingedrukt te houden tot de NEOpixels niet meer blinken. Wil je niet iedere keer de [Flash] knop in te moeten drukken bij het opstarten, dan kun je in Settings (klik op het houweeltje) ...

... op klik op System ...

... waarna je de waarde van run als AccessPoint in een 1 kunt veranderen.

Vergeet vervolgens niet om op [Opslaan] te klikken! Druk nu op de [Reset] knop van de DSMR-logger32 en deze zal vervolgens altijd als AP opstarten (tot je de waarde weer terug zet naar 0 uiteraard.

Onderstaande tabel geeft de gegevens weer zoals deze door gebruikers worden gemeld. Om de lijst zo compleet mogelijk te maken verzoek ik iedere maker/gebruiker om deze gegevens met ons te delen!

Nu je een ArduinoIDE hebt waarmee je ESP32’s kunt programmeren (flashen) zul je ontdekken dat er door briljante mensen software is ontwikkeld die je kunt gebruiken om complexe projecten te realiseren, zonder dat je zelf het wiel hoeft uit te vinden.

Deze software wordt veelal in de vorm van een bibliotheek aangeboden en je hoeft zo’n bibliotheek alleen maar te installeren om er gebruik van te kunnen maken.

Hier vind je de officiële instructies voor het installeren van bibliotheken met de ArduinoIDE.

Stel je wilt je ESP32 benaderen met een telnet client zodat je vanaf je Desktop of Laptop op de ESP32 kunt inloggen. Je hebt op de ESP32 dan een telnet server nodig. Met wat Googelen naar "ESP32 telnet" blijken hier een aantal bibliotheken voor te bestaan.

Installatie vanaf een .zip bestand

Als voorbeeld nemen we TelnetStream van Juraj Andrassy. Zijn telnet implementatie kun je vanaf deze pagina als bibliotheek downloaden.

Om de bibliotheek te installeren klik je op de groene [Clone or download] (of [<> Code]) knop en selecteer je [Download ZIP].

Onthoud waar je het zip-file bewaard hebt!

Ga nu naar de Arduino IDE en selecteer:

[Sketch]=>[Include Library] =>[Add .ZIP Library]

Er verschijnt een selectie window waar je het bestand selecteert dat zojuist gedownload hebt.

Klik op [Choose].

De bibliotheek is nu geïnstalleerd en klaar om gebruikt te worden. De meeste bibliotheken komen met een aantal voorbeeld programma’s waarmee je kunt leren hoe je de bibliotheek kunt gebruiken.

Installatie via Library Manager

Verreweg de eenvoudigste manier om een bibliotheek te installeren is via de Library Manager.

Na het klikken op "Manage Libraries.." verschijnt er een pop-up window van de Library Manager. Voer in de zoekbalk de gewenste bibliotheek in.

.. en klik op [Install] of [Update]. De bibliotheek is nu geïnstalleerd.

Voorbeelden uitproberen

Juraj Andrassy is erg summier met zijn uitleg maar gelukkig is er een map met voorbeelden (nou ja, één voorbeeld).

(sorry, het plaatje is een beetje verknipt)

Klik je nu op[TelnetStreamTest]dan wordt dit voorbeeld programma in de Arduino IDE geladen.

Installeer op dezelfde manier de andere bibliotheken die voor de DSMRlogger32firmware nodig zijn.