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.

• Actueel overzicht

• Overzicht per uur

• Overzicht per dag

• Overzicht per maand

• Telegram

• All Fields

• Systeem informatie

• rest API's

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

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

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

• ​Hier staat een introductie van de DSMRloggerAPI firmware

• Veel informatie over de hardware en het gebruik wordt hier beschreven.

• De DSMRlogger32 firmware kun je op github vinden

• Voor de meeste mensen is het gebruik van de twee binaries het eenvoudigste. Deze binaries kun je binnenkort hier vinden.

Begrippen

In dit document worden de volgende begrippen gebruikt:

Een volledige beschrijving van dit project kun je hier 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).

OLED display

Als optie kan een 0.96" of 1.3" OLED display worden aangesloten.

Let er wél op dat er twee versies van deze schermen worden aangeboden die op het eerste gezicht helemaal hetzelfde lijken, maar waarvan de GND en Vcc aansluitingen omgewisseld zijn! Bij één en dezelfde leverancier kom je beide versies tegen. Controleer dus áltijd hoe jouw versie op de DSMR-logger32 moet worden aangesloten!

En om de verwarring compleet te maken zijn er ook OLED schermpjes (ik ben dit tot nu toe alleen bij de 1.3" tegen gekomen) waarop de opdruk aan de bovenkant niet overeenkomt met de daadwerkelijke aansluitingen.

Dit type OLED scherm heeft aan de bovenkant de opdruk "1" (naast VDD) en "4" (naast SDA) maar aan de onderkant een mogelijkheid om "1" en "2" om te draaien door twee 0 ohm weerstandjes op de gewenste plek te solderen. Bij sommige schermpjes zijn deze weerstandjes zodanig geplaatst dat de opdruk aan de bovenkant overeen komt met de werkelijke aansluiting .. maar soms dus ook niet. Opletten dus!

Daarom heeft de DSMR-logger32 géén verbindingen naar het OLED schermpje voor GND en VCC. Afhankelijk van de aansluitingen op jouw OLED schermpje moet je de volgende draadbruggen solderen.

De I2C bus [SCL-SDA] zijn wél standaard doorverbonden. Heeft jouw OLED schermpje daar óók een andere volgorde voor (ben ik nog niet tegen gekomen) dan kun je aan de onderkant van het PCB twee spoortjes (zie zwarte kruisjes) doorsnijden en op het patch gebied tussen SDA, SCL en I2C1, I2C2 de voor jou werkende doorverbindingen maken..

Selecteer Power Bron

Er zijn drie manieren om de DSMR-logger32 van voedingsspanning te voorzien. Er mag altijd maar één van de drie geselecteerd worden door een jumper te plaatsen.

In het linker plaatje is de Slimme Meter als spanningsbron geselecteerd. In het middelste plaatje komt de spanning van het shield af. Wordt de jumper in het midden geplaatst, zoals in het rechter plaatje, dan moet er een externe USB voeding (5 volt) op de Power Jack worden aangesloten.

Zie ook de Onderdelen Lijst.

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:

Trying 192.168.2.13...
Connected to 192.168.2.13.
Escape character is '^]'.

[11:02:52] processSlimmemeter  (  86): telegramCount=[87930] telegramErrors=[0]

[Time----] Function------------(line):
[11:02:52] processTelegram     (  17): Telegram[87931]=>tlgrmData.timestamp[230109110250W]
[11:02:53] processTelegram     ( 136): prevHour[11] -- lastHour[11] 
[11:03:02] processSlimmemeter  (  86): telegramCount=[87931] telegramErrors=[0]

[Time----] Function------------(line):
[11:03:02] processTelegram     (  17): Telegram[87932]=>tlgrmData.timestamp[230109110300W]
[11:03:03] processTelegram     ( 136): prevHour[11] -- lastHour[11] 
[11:03:03] sendMQTTData        ( 157): MQTTinterval [30]

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

Commands are (*X only uppercase):

   B - Board Info
  *E - erase file from Filesystem
   F - force Reboot Watchdog
   I - Identify by blinking NeoPixels
   L - List Filesystem
   P - No Parsing (show RAW data from Smart Meter)
  *R - Reboot
   S - Show Settings
  *U - Update Filesystem (save Data-files)
   V - Toggle Verbose 1
  *W - Force Re-Config WiFi
  *Y - Stop zending heartbeat pulses
  *Z - Zero Counters and sysLog

   D - Display Day table from Filesystem
   H - Display Hour table from Filesystem
   M - Display Month table from Filesystem

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:

telnet>

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

telnet> q
Connection closed.

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 telnet 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 Slimme Meter geselecteerd is als Power bron ("PWR SELECT" - "SM") en de Slimme Meter kan niet voldoende vermogen leveren 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.