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.

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.

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 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:

of met:

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

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

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.

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,
    "free_sketch_space": 1310720,
    "filesysSetting_size": 1378241,
    "flashchip_speed": 80000000,
    "flashchip_mode": "DIO",
    "filesystem_type": "SPIFFS",
    "compile_options": "",
    "ssid": "AandeWiFi",
    "wifi_rssi": -47,
    "time": "02-01-2023 13:09:13",
    "uptime": "3(d)-02:06(H:m)",
    "uptime_sec": 266770,
    "daily_reboot": 0,
    "oled_type": 2,
    "oled_flip_screen": 1,
    "neo_brightness": 30,
    "smhasfaseinfo": 1,
    "telegram_interval": 10,
    "telegram_count": 31513,
    "telegram_errors": 0,
    "mqtt_broker": "192.168.12.250:1883",
    "mqtt_interval": 60,
    "mqtt_broker_connected": "yes",
    "reboots": 2,
    "last_reset": "[3] Software reset digital core (ESP.restart())"
  }
}

Systeem Tijd

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

Deze restAPI geeft de systeem tijd van de DSMR-logger

{
  "devtime": {
    "timestamp": "230102130942W",
    "time": "02-01-2023 13:09:49",
    "time_rev": "2023-01-0002 13:09:",
    "epoch": 1672661389,
    "uptime": "3(d)-02:06(H:m)",
    "uptime_secs": 266808
  }
}

Instellingen

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

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

{
  "system": [
    {
      "name": "hostname", "value": "DSMR-ESP32", "type": "s", "maxlen": 29
    },
    {
      "name": "index_page", "value": "DSMRindex.html", "type": "s", "maxlen": 49
    },
    {
      "name": "daily_reboot", "value": 0, "type": "i", "min": 1, "max": 1
    },
    {
      "name": "no_hour_slots", "value": 121, "type": "i", "min": 49, "max": 190
    },
    {
      "name": "no_day_slots", "value": 32, "type": "i", "min": 15, "max": 155
    },
    {
      "name": "no_month_slots", "value": 2, "type": "i", "min": 2, "max": 5
    },
    {
      "name": "alter_ring_slots", "value": 0, "type": "i", "min": 0, "max": 1
    },
    {
      "name": "tlgrm_interval", "value": 5, "type": "i", "min": 2, "max": 60
    },
    {
      "name": "oled_type", "value": 2, "type": "i", "min": 0, "max": 2
    },
    {
      "name": "oled_screen_time", "value": 3, "type": "i", "min": 0, "max": 300
    },
    {
      "name": "oled_flip_screen", "value": 1, "type": "i", "min": 0, "max": 1
    },
    {
      "name": "neo_brightness", "value": 75, "type": "i", "min": 10, "max": 250
    },
    {
      "name": "mqtt_broker", "value": "192.168.12.250", "type": "s", "maxlen": 100
    },
    {
      "name": "mqtt_broker_port", "value": 1883, "type": "1", "min": 1, "max": 9999
    },
    {
      "name": "mqtt_user", "value": "", "type": "s", "maxlen": 39
    },
    {
      "name": "mqtt_passwd", "value": "", "type": "s", "maxlen": 39
    },
    {
      "name": "mqtt_toptopic", "value": "DSMR-DEV32", "type": "s", "maxlen": 20
    },
    {
      "name": "mqtt_interval", "value": 10, "type": "i", "min": 0, "max": 600
    }
  ]
}

Instellingen aanpassen

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

{"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

• Opmerking:

  • Euro's per maand

gas_netw_costs (Netwerk kosten Gas)

• type: float

• min: 0

• max: 100

• Decimalen: 2

• Opmerking:

  • Euro's per maand

tlgrm_interval (telegram Interval)

• type: Integer

• min: 1

• max: 60

• Opmerking:

  • Seconden

index_page (alternatieve index.html pagina)

• type: String

• maxlen: 49

• Opmerking:

  • Characters

  • Default: DSMRindex.html

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

  • indien '0' worden er géén berichten verstuurd

  • er wordt nooit vaker een bericht verstuurd dan tlgrm_interval

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

• Historie gerelateerde restAPI's

Aanroepen restAPI vanuit verschillende systemen

Een restAPI kan op verschillende manieren worden aangeroepen.

• Javascript

• Unix command

• Home Assistant

• Arduino Mega met Ethernet Shield

• ESP8266

• ESP32

Javascript

    fetch(APIGW+"v2/dev/time")
      .then(response => response.json())
      .then(json => {
        //console.log("parsed .., data is ["+ JSON.stringify(json)+"]");
        data = json.devtime;
        for( let field in data )
        {
          //console.log("dev/time: field["+field+"], value["+data[field]+"]");
          if (field == "time")
          {
            //console.log("Got new time ["+data[field]+"]");
            document.getElementById('theTime').innerHTML = data[field];
          }
        }
      })
      .catch(function(error) {
        var p = document.createElement('p');
        p.appendChild(
          document.createTextNode('Error: ' + error.message)
        );
      });     

Unix command

curl http://dsmr-api.local/api/v2/dev/time

Geeft dit als output:

{
  "devtime": {
    "timestamp": "230104142233W",
    "time": "04-01-2023 14:22:17",
    "time_rev": "2023-01-04 14:22:17",
    "epoch": 1672838537,
    "uptime": "1(d)-22:27(H:m)",
    "uptime_secs": 167241
  }
}

Home Assistant

configuration.yaml:

### configuration.yaml
### DSMRloggerAPI 

    <<help>>

geeft dit resultaat:

De source van deze code kun je op github vinden.

Andere systemen

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

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.

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

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.

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.

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!

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

• Benodigde Bibliotheken

• DSMRlogger32 Firmware

• Firmware Flashen

• Data map Flashen

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

Flash Firmware

Om (nieuwe) firmware te flashen moet je op de knop [Choose file] onder de kop "Firmware:" klikken.

Er verschijnt nu een drop-down window waar je de gewenste firmware kunt selecteren.

Klik vervolgens op [Update Firmware]

Flash File Systeem

Om een nieuw bestands systeem op de DSMR-logger te flashen klik je op de knop [Choose file] onder de kop "FileSystem:".

Er verschijnt nu een drop-down window waar je het gewenste .spiffs.bin bestand systeem kunt selecteren.

Klik vervolgens op de knop [Update FileSystem]

Flashen is geslaagd

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

/api/v2/hist/{actual|hours|days|months}

of:

/api/v2/hist/{actual|hours|days|months}{/asc|/desc}

of:

/api/v2/hist/{actual|hours|days|months}/<recs>{/asc|/desc}

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",
          "power_delivered_l1": 0.861,
          "power_delivered_l2": 0.119,
          "power_delivered_l3": 0.722,
          "power_returned_l1": 0,
          "power_returned_l2": 0,
          "power_returned_l3": 0,
          "gas_delivered": 5310.341
        }
      }
    ],
    "46": [
      {
        "actual": {
          "timestamp": "230102153133W",
          "power_delivered_l1": 1.074,
          "power_delivered_l2": 0.284,
          "power_delivered_l3": 0.343,
          "power_returned_l1": 0,
          "power_returned_l2": 0,
          "power_returned_l3": 0,
          "gas_delivered": 5310.344
        }
      }
    ],
    .
    .
    .
    "152": [
      {
        "actual": {
          "timestamp": "230102154119W",
          "power_delivered_l1": 1.185,
          "power_delivered_l2": 0.424,
          "power_delivered_l3": 0.656,
          "power_returned_l1": 0,
          "power_returned_l2": 0,
          "power_returned_l3": 0,
          "gas_delivered": 5310.699
        }
      }
    ],
    "153": [
      {
        "actual": {
          "timestamp": "230102154123W",
          "power_delivered_l1": 0.781,
          "power_delivered_l2": 0.658,
          "power_delivered_l3": 0.059,
          "power_returned_l1": 0,
          "power_returned_l2": 0,
          "power_returned_l3": 0,
          "gas_delivered": 5310.703
        }
      }
    ],
    "154": [
      {
        "actual": {
          "timestamp": "230102154129W",
          "power_delivered_l1": 1.147,
          "power_delivered_l2": 0.826,
          "power_delivered_l3": 0.67,
          "power_returned_l1": 0,
          "power_returned_l2": 0,
          "power_returned_l3": 0,
          "gas_delivered": 5310.705
        }
      }
    ]
  }
}

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.

{
  "hours": [
    {
      "recnr": 0,
      "recid": "22122815",
      "slot": 113,
      "edt1": 6198.015,
      "edt2": 9157.279,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5047.048
    },
    {
      "recnr": 1,
      "recid": "22122816",
      "slot": 114,
      "edt1": 6199.161,
      "edt2": 9161.557,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5049.235
    },
    {
      "recnr": 2,
      "recid": "22122817",
      "slot": 115,
      "edt1": 6200.28,
      "edt2": 9165.792,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5051.459
    },
    {
      "recnr": 3,
      "recid": "22122818",
      "slot": 116,
      "edt1": 6201.412,
      "edt2": 9170.153,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5053.669
    },
    {
      "recnr": 4,
      "recid": "22122819",
      "slot": 117,
      "edt1": 6202.533,
      "edt2": 9174.56,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5055.86
    },
    .
    .
    .
    {
      "recnr": 118,
      "recid": "23010213",
      "slot": 110,
      "edt1": 6331.18,
      "edt2": 9661.992,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5305.721
    },
    {
      "recnr": 119,
      "recid": "23010214",
      "slot": 111,
      "edt1": 6332.962,
      "edt2": 9668.602,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5309.217
    },
    {
      "recnr": 120,
      "recid": "23010215",
      "slot": 112,
      "edt1": 6333.831,
      "edt2": 9671.759,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5310.865
    }
  ]
}

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.

{
  "days": [
    {
      "recnr": 0,
      "recid": "22120223",
      "slot": 0,
      "edt1": 6059.023,
      "edt2": 8676.882,
      "ert1": 1183.884,
      "ert2": 2600.835,
      "gdt": 4809.171
    },
    {
      "recnr": 1,
      "recid": "22120323",
      "slot": 1,
      "edt1": 6074.667,
      "edt2": 8676.882,
      "ert1": 1183.884,
      "ert2": 2600.835,
      "gdt": 4814.832
    },
    {
      "recnr": 2,
      "recid": "22120423",
      "slot": 2,
      "edt1": 6091.162,
      "edt2": 8676.882,
      "ert1": 1183.884,
      "ert2": 2600.835,
      "gdt": 4821.213
    },
    .
    .
    .
    {
      "recnr": 29,
      "recid": "22123123",
      "slot": 29,
      "edt1": 6288.5,
      "edt2": 9500.478,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5223.111
    },
    {
      "recnr": 30,
      "recid": "23010123",
      "slot": 30,
      "edt1": 6315.821,
      "edt2": 9604.45,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5276.099
    },
    {
      "recnr": 31,
      "recid": "23010215",
      "slot": 31,
      "edt1": 6333.831,
      "edt2": 9671.759,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5310.865
    }
  ]
}

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.

{
  "months": [
    {
      "recnr": 0,
      "recid": "21013123",
      "slot": 16,
      "edt1": 4027.753,
      "edt2": 5345.965,
      "ert1": 706.531,
      "ert2": 1609.39,
      "gdt": 3426.986
    },
    {
      "recnr": 1,
      "recid": "21022823",
      "slot": 17,
      "edt1": 4160.245,
      "edt2": 5526.37,
      "ert1": 710.812,
      "ert2": 1622.42,
      "gdt": 3569.993
    },
    .
    .
    .
    {
      "recnr": 22,
      "recid": "22113023",
      "slot": 13,
      "edt1": 6056.715,
      "edt2": 8656.669,
      "ert1": 1183.884,
      "ert2": 2600.787,
      "gdt": 4800.665
    },
    {
      "recnr": 23,
      "recid": "22123123",
      "slot": 14,
      "edt1": 6288.5,
      "edt2": 9500.478,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5223.111
    },
    {
      "recnr": 24,
      "recid": "23010215",
      "slot": 15,
      "edt1": 6333.831,
      "edt2": 9671.759,
      "ert1": 1183.1,
      "ert2": 2600.5,
      "gdt": 5310.865
    }
  ]
}

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 (//) voor de #define weg te halen maak je een optie actief. Alleen tijdens het testen is het zinvol één of beide opties actief te maken. Voor een "productie" versie moeten de #defines uitgeschakeld blijven.

Vervolgens moeten de Boards settings als volgt worden ingesteld:

Klik nu op het Verify icon.

Onderin de Arduino IDE verschijnen meldingen met betrekking tot de voorgang van het compileren. Als het compileren succesvol is (en er dus geen compilatie fouten zijn opgetreden) zie je de volgende meldingen:

De waarden van "Sketch uses" en "Global variables use" kunnen anders zijn dan wat in bovenstaand plaatje staat. Dat is geen reden voor ongerustheid. De volgende stap is het daadwerkelijk uploaden (flashen) van de firmware naar de DSMR-logger32.

Firmware Bedraad Flashen

Sluit de FTDI-programmer aan op de Program-header van de DSMR-logger32

Als de FTDI programmer niet zelf de DSMR-logger32 in flash-mode kan zetten, voer dan de volgende vier handelingen uit:

1. Druk de FLASH knop in en houd deze ingedrukt

2. Druk op de RESET knop

3. Laat de RESET knop los

4. Laat de FLASH knop los

De DSMR-logger32 staat nu in Flash-mode en blijft in die mode tot er gegevens vanaf de programmer naar de DSMR-logger32 zijn overgebracht óf tot je nog een keer op de RESET knop drukt.

Vergeet niet in de Arduino IDE de Port te selecteren waarop je de FTDI programmer hebt aangesloten en druk op het Compile and Upload icoon.

Firmware Over The Air Flashen

Bij het Over The Air flashen van de firmware of data-map kan (moet) de DSMR-logger32 gewoon op de Slimme Meter aangesloten blijven.

Alle instellingen voor de DSMRlogger32 firmware blijven gelijk aan de bedrade methode van flashen.

klikken maar in het[Sketch]drop-down menu de keuze Upload Compiled Binary selecteren.

De firmware wordt nu gecompileerd en in de Arduino Sketch map waar de DSMRlogger32 firmware ook staat neergezet. Het bestand heet DSMRlogger32.ino.bin.

In de FSmanager klik je op de knop [Update Firmware]

Er verschijnt nu een scherm waarin je een firmware bestand (de naam eindigt op .ino.bin) kunt kiezen door op de bovenste knop [Choose File] te klikken.

Selecteer uit het popUp scherm dat nu verschijnt het binary file dat je wilt uploaden ..

.. klik op [Choose] (of [Open]) en daarna op de knop [Flash Firmware]

Na enige tijd krijg je de melding dat de upload is geslaagd en dat de DSMR-logger32 opnieuw opstart.

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.

Clonen Firmware

De DSMRlogger32 firmware staat hier. 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 DSMRlogger32-main naar DSMRlogger32 (dus zonder -main)

git clone

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

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!

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

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

ArduinoJson

SPIFFS_SysLogger

Overige libraries

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

• FS

• SPIFFS

• WiFi

• WebServer

• HTTPUpdateServer

• ESPmDNS

• WiFiUpd

• esp_heap_caps

• HardwareSerial

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.

Pre compiled Binaries

Op staan van de major releases binaries van zowel de firmware als van het SPIFFS bestand systeem.

Onder iedere release beschrijving staan de bijbehorende "Assets".

OTA flashen met de Update Server

Klik nu op de bovenste [Choose File] knop

Selecteer in het popup-window het zojuist gedownloade DSMRlogger32.ino.bin file:

Klik op [Open] of [Select] en klik vervolgens op de knop [Flash Firmware]. Na enige tijd verschijnt het volgende scherm:

.. waarna, na enige tijd, het hoofdscherm van de DSMR-logger32 weer verschijnt.

Bedraad flashen met het Espressif Flash Download tool

Espressif heeft voor zijn ESP-boards een (helaas alleen Windows) tool ontwikkeld dat het bedraad flashen erg eenvoudig maakt.

Pak het .zip file uit (unzip) en start het door op het mapje te klikken:

Klik nu op "flash_download_tools.exe" en selecteer [esp32 DownloadTool] in het volgende scherm:

Selecteer de vier bin bestanden.

• DSMRlogger32.ino.bootloader.binmoet op adres 0x1000 starten

• DSMRlogger32.ino.partitions moet op adres 0x8000 starten

• DSMRlogger32.ino.bin bestand moet op adres 0x10000 starten

• DSMRlogger32.spiffs.bin op adres 0x22500 starten

Selecteer de COM poort waar de DSMR-logger32 op is aangesloten, zet de DSMR-logger32 in flash mode en klik op [START].

Na enige tijd krijg je de melding dat alles goed is gegaan.

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????

Via MQTT:

Om de gegevens via een MQTT broker uit de DSMR-logger32 te halen moet het configuration.yaml bestand er ongeveer zo uit zien:

(met dank aan Henk Elzing)

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 https://github.com/lorol/arduino-esp32fs-plugin.

Ga vervolgens naar Releases 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 esp32fs.zip bestand uit. Controleer dat nu onder de map "tools" een nieuwe map "ESP32FS" staat, met daaronder een map "tool" (zonder 's') en dat in de map "tool" een programma "esp32fs.jar" staat.

Start nu de Arduino IDE (opnieuw) op en kijk of onder [Tools] het ESP32 Sketch Data Upload tool verschijnt!

Als je deze aanklikt verschijnt er een pop-up window waarin je kunt kiezen wat voor Filesysteem je wilt uploaden.

Voor de DSMR-logger32 moet dat "SPIFFS" zijn!

Zorg ervoor dat de juiste Seriële poort is geselecteerd én (belangrijk) dat de Serial Monitor uit staat!

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.

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!

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.

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.

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

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 Telnet User Interface).

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.

Vragen en Antwoorden

• Niet alles DSMR 4 is DSMR 4

• Overstappen van een DSMR-logger versie 4

• Kan de DSMR-logger32 verbinding maken met ieder modem?

• Werkt de DSMR-logger32 met mijn Slimme Meter?

• 5 Volt Programmer

• Update of Upgrade

• Slave kanaal Gasmeter

• Wat zijn de maten van de DSMR-logger32?

• Aansluiting Externe Voeding

• Wat is het verschil tussen RJ10 en RJ12?

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 hier en hier. 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 dit issue 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 deze) 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 Slimme Meter Settings.

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:

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.

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 github 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).

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.