📉
📉
📉
📉
DSMRloggerAPI
Search…
Documentatie DSMRloggerAPI firmware
DSMRloggerAPI GUI
FSmanager
DSMR-editor
Beschrijving restAPI's
DSMR-logger gerelateerde restAPI's
Slimme Meter gerelateerde restAPI's
Historische Gegevens gerelateerde restAPI's
Nieuwe DSMRloggerAPI firmware flashen
Arduino IDE geschikt maken voor het compileren van de DSMRloggerAPI firmware
DSMRloggerAPI firmware
Update Server
Slimme Meters
Integratie met Home Assistant
Upgrade DSMRloggerAPI v2 to v3
Upgrade DSMRloggerWS naar DSMRloggerAPI
Oude Hardware (met ESP-01 bordje)
License
Powered By GitBook
Beschrijving restAPI's
Alle beschikbare gegevens kunnen via restAPI call's bij de DSMR-logger worden opgevraagd. De restAPI's zijn verdeelt 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).

Aanroepen restAPI vanuit verschillende systemen

Een restAPI kan op verschillende manieren worden aangeroepen.

Javascript

1
fetch("http://dsmr-api.local/api/v1/dev/time")
2
.then(response => response.json())
3
.then(json => {
4
console.log("parsed .., data is ["+ JSON.stringify(json)+"]");
5
for( let i in json.devtime ){
6
if (json.devtime[i].name == "time")
7
{
8
console.log("Got new time ["+json.devtime[i].value+"]");
9
document.getElementById('theTime').innerHTML = json.devtime[i].value;
10
}
11
}
12
})
13
.catch(function(error) {
14
var p = document.createElement('p');
15
p.appendChild(
16
document.createTextNode('Error: ' + error.message)
17
);
18
});
19
​
Copied!

Unix command

1
curl http://dsmr-api.local/api/v1/dev/time
Copied!
Geeft dit als output:
1
{"devtime":[
2
{"name": "time", "value": "2020-03-23 11:45:40"},
3
{"name": "epoch", "value": 1584963941}
4
]}
Copied!

Home Assistant

configuration.yaml:
1
### configuration.yaml
2
### DSMRloggerAPI
3
- platform: rest
4
name: "Levering"
5
resource: http://<ip-dsmr-logger>/api/v1/sm/fields/power_returned
6
unit_of_measurement: "kWh"
7
value_template: '{{ value_json.fields[1].value | round(3) }}'
8
​
9
- platform: rest
10
name: "Laatste Update restAPI"
11
resource: http://192.168.2.106/api/v1/sm/fields/timestamp
12
# value_template: '{{ value_json.fields[0].value }}'
13
value_template: >
14
{{ value_json.fields[0].value[4:6] + "-" +
15
value_json.fields[0].value[2:4] + "-" +
16
"20"+value_json.fields[0].value[0:2] + " " +
17
value_json.fields[0].value[6:8] + ":" +
18
value_json.fields[0].value[8:10] + ":" +
19
value_json.fields[0].value[10:13] }}
20
​
21
- platform: rest
22
name: "Levering l1"
23
resource: http://192.168.2.106/api/v1/sm/fields/power_returned_l1
24
unit_of_measurement: "Watt"
25
value_template: '{{ (value_json.fields[1].value | float * 1000.0) | round(1) }}'
26
​
27
- platform: rest
28
name: "Levering l2"
29
resource: http://192.168.2.106/api/v1/sm/fields/power_returned_l2
30
unit_of_measurement: 'Watt'
31
value_template: '{{ (value_json.fields[1].value | float * 1000.0) | round(1) }}'
32
​
33
- platform: rest
34
name: "Levering l3"
35
resource: http://192.168.2.106/api/v1/sm/fields/power_returned_l3
36
unit_of_measurement: 'Watt'
37
value_template: '{{ (value_json.fields[1].value | float * 1000.0) | round(1) }}'
38
​
Copied!
geeft dit resultaat:
Met hassOS lukt het mij niet om bij resource de hostname (DSMR-API.local) te gebruiken. Met het IP adres lukt het wel.

Arduino Mega met Ethernet shield

Ik ben niet erg handig met JSON libraries (liefst parse ik de data helemaal zelf zodat ik ook alles zelf "in de hand" heb). Het zou mij daarom ook niet verbazen als onderstaande code simpeler en beter kan.
Getest door Bert Diepeveen (met dank!).
1
// in the main program:
2
#include <Ethernet.h>
3
#include <SPI.h>
4
#include <Arduino_JSON.h> // let op! dit is een andere library dan "ArduinoJson"
5
//
6
#define _IS_ARDUINO_MEGA
7
#define _DSMR_IP_ADDRESS "IP_ADDRESS_OF_YOUR_DSMR_LOGGER"
8
#define _READINTERVAL 60000
9
//
10
const char *DSMRprotocol = "http://";
11
const char *DSMRserverIP = _DSMR_IP_ADDRESS;
12
const char *DSMRrestAPI = "/api/v1/sm/actual";
13
String payload;
14
int httpResponseCode;
15
uint32_t lastRead = 0;
16
​
17
//--- catch specific fields for further processing -------
18
//--- these are just an example! see readDsmrLogger() ----
19
String timeStamp;
20
int voltageL1, currentL1;
21
float pwrDelivered, pwrReturned;
22
​
23
​
24
//--------------------------------------------------------------------------
25
bool dsmrGETrequest()
26
{
27
EthernetClient ETHclient;
28
HttpClient DSMRclient = HttpClient(ETHclient, DSMRserverIP, 80);
29
​
30
payload = "";
31
32
Serial.println(F("making GET request"));
33
DSMRclient.get(DSMRrestAPI);
34
​
35
// read the response code and body of the response
36
httpResponseCode = DSMRclient.responseStatusCode();
37
Serial.print(F("http Response Code: "));
38
Serial.println(httpResponseCode);
39
​
40
if (httpResponseCode <= 0)
41
{
42
return false;
43
}
44
​
45
payload = DSMRclient.responseBody();
46
//--debug-Serial.print(F("payload: "));
47
//--debug-Serial.println(payload);
48
49
// Free resources
50
DSMRclient.stop();
51
​
52
return true;
53
54
} // dsmrGETrequest()
55
​
56
​
57
//--------------------------------------------------------------------------
58
void setup()
59
{
60
// setup Serial ..
61
.
62
.
63
// Initialize Ethernet library
64
byte mac[] = {0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED};
65
if (!Ethernet.begin(mac))
66
{
67
Serial.println(F("Failed to configure Ethernet"));
68
return;
69
}
70
delay(1000);
71
.
72
.
73
lastRead = millis() + _READINTERVAL;
74
75
} // setup()
76
​
77
​
Copied!
Verder moet je de Algemene functies onderaan deze pagina in je sketch opnemen.

ESP8266 (WiFi)

Ik ben niet erg handig met JSON libraries (liefst parse ik de data helemaal zelf zodat ik ook alles zelf "in de hand" heb). Het zou mij daarom ook niet verbazen als onderstaande code simpeler en beter kan.
1
// Include in the main program:
2
#include <WiFi.h>
3
#include <Arduino_JSON.h> // let op! Niet ArduinoJson!
4
//
5
#define _IS_ESP8266
6
#define _DSMR_IP_ADDRESS "IP_ADDRESS_OF_YOUR_DSMR_LOGGER"
7
#define _WIFI_SSID "YOUR_WIFI_SSID"
8
#define _WIFI_PASSWRD "YOUR_WIF_PASSWORD"
9
#define _READINTERVAL 60000
10
//
11
const char *ssid = _WIFI_SSID;
12
const char *password = _WIFI_PASSWRD;
13
//
14
const char *DSMRprotocol = "http://";
15
const char *DSMRserverIP = _DSMR_IP_ADDRESS;
16
const char *DSMRrestAPI = "/api/v1/sm/actual";
17
String payload;
18
int httpResponseCode;
19
uint32_t lastRead = 0;
20
​
21
//--- catch specific fields for further processing -------
22
//--- these are just an example! see readDsmrLogger() ----
23
String timeStamp;
24
int voltageL1, currentL1;
25
float pwrDelivered, pwrReturned;
26
​
27
//--------------------------------------------------------------------------
28
bool dsmrGETrequest()
29
{
30
WiFiClient DSMRclient;
31
​
32
payload = "";
33
​
34
Serial.print("DSMRclient.connect("); Serial.print(DSMRserverIP);
35
Serial.println(", 80)");
36
if (!DSMRclient.connect(DSMRserverIP, 80))
37
{
38
Serial.println(F("error connecting to DSMRlogger "));
39
payload = "{\"actual\":[{\"name\":\"httpresponse\", \"value\":\"error connecting\"}]}";
40
return false;
41
}
42
​
43
//-- normal operation
44
DSMRclient.print(F("GET "));
45
DSMRclient.print(DSMRrestAPI);
46
DSMRclient.println(" HTTP/1.1");
47
DSMRclient.print(F("Host: "));
48
DSMRclient.println(DSMRserverIP);
49
DSMRclient.println(F("Connection: close"));
50
DSMRclient.println();
51
​
52
DSMRclient.setTimeout(1000);
53
​
54
//--debug-Serial.println("find(HTTP/1.1)..");
55
DSMRclient.find("HTTP/1.1"); // skip everything up-until "HTTP/1.1"
56
//--debug-Serial.print("DSMRclient.parseInt() ==> ");
57
httpResponseCode = DSMRclient.parseInt(); // parse status code
58
59
Serial.print("HTTP Response code: ");
60
Serial.println(httpResponseCode);
61
62
if (httpResponseCode <= 0)
63
{
64
payload = "{\"actual\":[{\"name\":\"httpresponse\", \"value\": "+String(httpResponseCode)+"}]}";
65
return false;
66
}
67
​
68
// Skip HTTP headers
69
if (!DSMRclient.find("\r\n\r\n"))
70
{
71
Serial.println(F("Invalid response"));
72
payload = "{\"actual\":[{\"name\":\"httpresponse\", \"value\": "+String(httpResponseCode)+"}]}";
73
return false;
74
}
75
​
76
while(DSMRclient.connected())
77
{
78
if (DSMRclient.available())
79
{
80
// read an incoming lines from the server:
81
String line = DSMRclient.readStringUntil('\r');
82
line.replace("\n", "");
83
if ( (line[0] == '{') || (line[0] == ',')
84
|| (line[0] == '[') || (line[0] == ']') )
85
{
86
//--debug-Serial.print(line);
87
payload += line;
88
}
89
}
90
}
91
//--debug-Serial.println();
92
93
// Free resources
94
DSMRclient.stop();
95
​
96
return true;
97
98
} // dsmrGETrequest()
99
​
100
​
101
//--------------------------------------------------------------------------
102
void setup()
103
{
104
// setup serial ..
105
.
106
.
107
// setup WiFi ..
108
WiFi.begin(ssid, password);
109
Serial.println("Connecting");
110
while(WiFi.status() != WL_CONNECTED)
111
{
112
delay(500);
113
Serial.print(".");
114
}
115
Serial.println("");
116
Serial.print("Connected to WiFi network with IP Address: ");
117
Serial.println(WiFi.localIP());
118
119
lastRead = millis() + _READINTERVAL;
120
.
121
.
122
123
} // setup()
124
​
Copied!
Verder moet je de Algemene functies onderaan deze pagina in je sketch opnemen.

ESP32 (WiFi)

With some help from Random Nerd Tutorials.
Ik ben niet erg handig met JSON libraries (liefst parse ik de data helemaal zelf zodat ik ook alles zelf "in de hand" heb). Het zou mij daarom ook niet verbazen als onderstaande code simpeler en beter kan.
1
// Include in the main program:
2
#include <WiFi.h>
3
#include <HTTPClient.h>
4
#include <Arduino_JSON.h> // let op! Niet ArduinoJson!
5
//
6
#define _IS_ESP32
7
#define _DSMR_IP_ADDRESS "IP_ADDRESS_OF_YOUR_DSMR_LOGGER"
8
#define _WIFI_SSID "YOUR_WIFI_SSID"
9
#define _WIFI_PASSWRD "YOUR_WIF_PASSWORD"
10
#define _READINTERVAL 60000
11
//
12
const char *ssid = _WIFI_SSID;
13
const char *password = _WIFI_PASSWRD;
14
//
15
const char *DSMRprotocol = "http://";
16
const char *DSMRserverIP = _DSMR_IP_ADDRESS;
17
const char *DSMRrestAPI = "/api/v1/sm/actual";
18
String payload;
19
int httpResponseCode;
20
uint32_t lastRead = 0;
21
​
22
//--- catch specific fields for further processing -------
23
//--- these are just an example! see readDsmrLogger() ----
24
String timeStamp;
25
int voltageL1, currentL1;
26
float pwrDelivered, pwrReturned;
27
​
28
//--------------------------------------------------------------------------
29
bool dsmrGETrequest()
30
{
31
HTTPClient DSMRclient;
32
33
// Your IP address with path or Domain name with URL path
34
DSMRclient.begin(String(DSMRprotocol) + String(DSMRserverIP)+String(DSMRrestAPI));
35
36
// Send HTTP GET request
37
httpResponseCode = DSMRclient.GET();
38
​
39
Serial.print("HTTP Response code: ");
40
Serial.println(httpResponseCode);
41
42
payload = "";
43
44
if (httpResponseCode > 0)
45
{
46
payload = DSMRclient.getString();
47
}
48
else
49
{
50
payload = "{\"actual\":[{\"name\":\"httpresponse\", \"value\": "+String(httpResponseCode)+"}]}";
51
// Free resources
52
DSMRclient.end();
53
return false;
54
}
55
​
56
// Free resources
57
DSMRclient.end();
58
59
return true;
60
​
61
} // dsmrGETrequest()
62
​
63
​
64
//--------------------------------------------------------------------------
65
void setup()
66
{
67
// setup Serial ..
68
.
69
.
70
// setup WiFi ..
71
WiFi.begin(ssid, password);
72
Serial.println("Connecting");
73
while(WiFi.status() != WL_CONNECTED)
74
{
75
delay(500);
76
Serial.print(".");
77
}
78
Serial.println("");
79
Serial.print("Connected to WiFi network with IP Address: ");
80
Serial.println(WiFi.localIP());
81
82
lastRead = millis() + _READINTERVAL;
83
.
84
.
85
86
} // setup()
87
​
Copied!
Verder moet je de Algemene functies onderaan deze pagina in je sketch opnemen.

Algemene functies

1
//--------------------------------------------------------------------------
2
void readDsmrLogger()
3
{
4
int fieldNr = 0;
5
​
6
dsmrGETrequest();
7
​
8
Serial.println();
9
Serial.println(F("==== Start parsing payload ======================="));
10
11
// This is how the "actual" JSON object looks like:
12
// {"actual":[
13
// {"name":"timestamp","value":"200911140716S"}
14
// ,{"name":"energy_delivered_tariff1","value":3433.297,"unit":"kWh"}
15
// ,{"name":"energy_delivered_tariff2","value":4453.041,"unit":"kWh"}
16
// ,{"name":"energy_returned_tariff1","value":678.953,"unit":"kWh"}
17
// ...
18
// ,{"name":"power_delivered_l2","value":0.071,"unit":"kW"}
19
// ,{"name":"power_delivered_l3","value":0,"unit":"kW"}
20
// ,{"name":"power_returned_l1","value":0,"unit":"kW"}
21
// ,{"name":"power_returned_l2","value":0,"unit":"kW"}
22
// ,{"name":"power_returned_l3","value":0.722,"unit":"kW"}
23
// ,{"name":"gas_delivered","value":2915.08,"unit":"m3"}
24
// ]}
25
​
26
//--debug-Serial.print(F("payload: "));
27
//--debug-Serial.println(payload);
28
​
29
JSONVar dsmrJsonObject = JSON.parse(payload);
30
31
// JSON.typeof(jsonVar) can be used to get the type of the var
32
if (JSON.typeof(dsmrJsonObject) == "undefined")
33
{
34
Serial.println(F("Parsing failed!"));
35
return;
36
}
37
//--debug-Serial.print("JSON.typeof(dsmrJsonObject) = ");
38
//--debug-Serial.println(JSON.typeof(dsmrJsonObject));
39
​
40
JSONVar dsmrJsonField = dsmrJsonObject["actual"];
41
​
42
// dsmrJsonField.length() can be used to get the length of the array
43
//--debug-Serial.print("dsmrJsonField.length() = ");
44
//--debug-Serial.println(dsmrJsonField.length());
45
//--debug-Serial.println();
46
47
for (int i = 0; i < dsmrJsonField.length(); i++)
48
{
49
fieldNr++;
50
//--debug-Serial.print(dsmrJsonField[i]);
51
String sName = (const char *)dsmrJsonField[i]["name"];
52
String sValue = (const char *)dsmrJsonField[i]["value"];
53
if (sValue == "") sValue = String((double)dsmrJsonField[i]["value"]);
54
String sUnit = (const char *)dsmrJsonField[i]["unit"];
55
//---- list all fields and values ----
56
Serial.print(sName); Serial.print(" \t");
57
Serial.print(sValue); Serial.print(" ");
58
Serial.print(sUnit);
59
Serial.println();
60
//--- now catch some fields of interrest for further
61
//--- processing
62
//--- you need to declare the fields to be captured global
63
if (sName == "timestamp") timeStamp = sValue;
64
if (sName == "voltage_l1") voltageL1 = sValue.toInt();
65
if (sName == "current_l1") currentL1 = sValue.toInt();
66
if (sName == "power_delivered") pwrDelivered = sValue.toFloat();
67
if (sName == "power_returned") pwrReturned = sValue.toFloat();
68
}
69
​
70
Serial.println(F("=================================================="));
71
Serial.print(F("Parsed [")); Serial.print(fieldNr); Serial.println(F("] fields"));
72
73
} // readDsmrLogger()
74
​
Copied!
In de main loop() function moet deze code komen:
1
​
2
//--------------------------------------------------------------------------
3
void loop()
4
{
5
if ((millis() - lastRead) > _READINTERVAL)
6
{
7
lastRead = millis();
8
Serial.println("\r\nread API from DSMR-logger...");
9
readDsmrLogger();
10
Serial.println(F("\r\nCaptured fields .."));
11
Serial.print(F("timestamp : \t")); Serial.println(timeStamp);
12
Serial.print(F("voltage L1 : \t")); Serial.println(voltageL1);
13
Serial.print(F("current L1 : \t")); Serial.println(currentL1);
14
Serial.print(F("pwrDelivered : \t")); Serial.println(pwrDelivered);
15
Serial.print(F("pwrReturned : \t")); Serial.println(pwrReturned);
16
}
17
.
18
.
19
} // loop()
Copied!
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.
Previous
DSMR-editor
Next
DSMR-logger gerelateerde restAPI's
Last modified 1yr ago
Export as PDF
Copy link
Contents
Aanroepen restAPI vanuit verschillende systemen
Javascript
Unix command
Home Assistant
Arduino Mega met Ethernet shield
ESP8266 (WiFi)
ESP32 (WiFi)
Algemene functies
Andere systemen