Veraltete Stromzähler-API

Bei Neuentwicklungen stattdessen meters-Modul verwenden! Die veraltete Stromzähler-API unterstützt nur einen Stromzähler (den, der als linked_meter_slot in meters_legacy_api/config konfiguriert ist) und kann nur eine Teilmenge der unterstützten Stromzählerwerte melden und verarbeiten. Die veraltete API wird vom meters_legacy_api-Modul-Modul emuliert.

warp1

meter/state

Der Zustand des Stromzählers.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/state

{ "state": 2, "type": 3 }

Schreiben

curl http://$HOST/meter/state -d '{ "state": 2, "type": 3 }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/state

{ "state": 2, "type": 3 }

Schreiben

Mit MQTT auf $PREFIX/meter/state_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/state_update -m '{ "state": 2, "type": 3 }'

Name	Bedeutung
state int	Zustand des Stromzählers 0 - Kein Stromzähler verbunden 1 - Stromzähler unzuverlässig, eventuell nur einphasig verbunden. 2 - Stromzähler verbunden
type int	Typ des verbauten Stromzählers. Nicht jeder Stromzähler wird von jedem Gerät unterstützt! 0 - Kein Stromzähler verfügbar 2 - Eastron SDM630 3 - Eastron SDM72V2 1 - Eastron SDM72

meter/values

Die Messwerte des Stromzählers. Benötigt das Feature "meter"

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/values

{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }

Schreiben

curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values

{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }

Schreiben

Mit MQTT auf $PREFIX/meter/values_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/values_update -m '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'

Name	Bedeutung
power float (W)	Die aktuelle Ladeleistung.
energy_rel float (kWh)	Die geladene Energie seit dem letzten Reset.
energy_abs float (kWh)	Die geladene Energie seit der Herstellung des Stromzählers.

meter/phases

Angeschlossene und aktive Phasen. Benötigt das Feature "meter_phases".

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/phases

{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}

Schreiben

curl http://$HOST/meter/phases -d '{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases

{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}

Schreiben

Mit MQTT auf $PREFIX/meter/phases_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/phases_update -m '{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}'

Name	Bedeutung
phases_active bool[3]	Die derzeit aktiven Phasen [0] - Phase L1 aktiv [1] - Phase L2 aktiv [2] - Phase L3 aktiv
phases_connected bool[3]	Die angeschlossenen Phasen [0] - Phase L1 angeschlossen [1] - Phase L2 angeschlossen [2] - Phase L3 angeschlossen

meter/error_counters

Fehlerzähler der Kommunikation mit dem Stromzähler.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/error_counters

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/error_counters

{ "meter": 0, "bricklet": 0, "bricklet_reset": 0 }

Name	Bedeutung
meter int	(Nur WARP 1) Kommunikationsfehler zwischen RS485 Bricklet und Stromzähler.
bricklet int	(Nur WARP 1) Kommunikationsfehler zwischen ESP Brick und RS485 Bricklet.
bricklet_reset int	(Nur WARP 1) Unerwartete Resets des RS485 Bricklets.

meter/all_values

Alle Messwerte, die vom eingebauten Stromzähler gemessen werden. Benötigt das Feature "meter_all_values". Hintereinanderliegende Werte die mit .. gekennzeichnet sind, beziehen sich auf die drei Phasen L1, L2 und L3.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/all_values

[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]

Schreiben

curl http://$HOST/meter/all_values -d '[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/all_values

[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]

Schreiben

Mit MQTT auf $PREFIX/meter/all_values_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/all_values_update -m '[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]'

Index	Bedeutung
[0..2] float (V)	Spannung gegen Neutral
[3..5] float (A)	Strom
[6..8] float (W)	Wirkleistung
[9..11] float (VA)	Scheinleistung
[12..14] float (var)	Blindleistung
[15..17] float	Leistungsfaktor; Das Vorzeichen des Leistungsfaktors gibt die Richtung des Stromflusses an.
[18..20] float (°)	relative Phasenverschiebung
[21] float (V)	Durchschnittliche Spannung gegen Neutral
[22] float (A)	Durchschnittlicher Strom
[23] float (A)	Summe der Phasenströme
[24] float (W)	Gesamtwirkleistung
[25] float (VA)	Gesamtscheinleistung
[26] float (var)	Gesamtblindleistung
[27] float	Gesamtleistungsfaktor
[28] float (°)	Gesamtphasenverschiebung
[29] float (Hz)	Frequenz der Versorgungsspannung
[30] float (kWh)	Wirkenergie (Import; vom Fahrzeug aufgenommen)
[31] float (kWh)	Wirkenergie (Export; vom Fahrzeug abgegeben)
[32] float (kvarh)	Blindenergie (Import; vom Fahrzeug aufgenommen)
[33] float (kvarh)	Blindenergie (Export; vom Fahrzeug abgegeben)
[34] float (kVAh)	Gesamtscheinenergie
[35] float (Ah)	Transportierte elektrische Ladung
[36] float (W)	Bezogene Wirkleistung; Entspricht Import-Export-Differenz
[37] float (W)	Max. bezogene Wirkleistung; Höchster gemessener Wert
[38] float (VA)	Bezogene Scheinleistung; Entspricht Import-Export-Differenz
[39] float (VA)	Max. bezogene Scheinleistung; Höchster gemessener Wert
[40] float (A)	Bezogener Neutralleiterstrom
[41] float (A)	Max. bezogener Neutralleiterstrom; Höchster gemessener Wert
[42] float (V)	Spannung L1 zu L2
[43] float (V)	Spannung L2 zu L3
[44] float (V)	Spannung L3 zu L1
[45] float (V)	Durchschnittliche Spannung zwischen Phasen
[46] float (A)	Neutralleiterstrom
[47..49] float (%)	Total Harmonic Distortion (THD) der Spannung
[50..52] float (%)	Total Harmonic Distortion (THD) des Stroms
[53] float (%)	Durchschnittliche Spannungs-THD
[54] float (%)	Durchschnittliche Strom-THD
[55..57] float (A)	Bezogener Strom
[58..60] float (A)	Max. bezogener Strom; Höchster gemessener Wert
[61] float (%)	Spannungs-THD L1 zu L2
[62] float (%)	Spannungs-THD L2 zu L3
[63] float (%)	Spannungs-THD L3 zu L1
[64] float (%)	Durchschnittliche Spannungs-THD zwischen Phasen
[65] float (kWh)	Summe der Gesamtwirkenergien; Import-Export-Summe aller Phasen
[66] float (kvarh)	Summe der Gesamtblindenergien; Import-Export-Summe aller Phasen
[67..69] float (kWh)	Wirkenergie (Import; vom Fahrzeug aufgenommen)
[70..72] float (kWh)	Wirkenergie (Export; vom Fahrzeug abgegeben)
[73..75] float (kWh)	Gesamtwirkenergie; Import-Export-Summe
[76..78] float (kvarh)	Blindenergie (Import; vom Fahrzeug aufgenommen)
[79..81] float (kvarh)	Blindenergie (Export; vom Fahrzeug abgegeben)
[82..84] float (kvarh)	Gesamtblindenergie; Import-Export-Summe

meter/reset

Setzt den Energiezähler zurück. Leerer Payload. Es muss einer der folgenden Werte übergeben werden: null, "", false, 0, [] oder {}

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Schreiben

curl http://$HOST/meter/reset -d 'null'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/meter/reset -m 'null'

meter/last_reset

Der Zeitpunkt des letzten Zähler-Resets (siehe meter/reset) als Unix-Timestamp. 0 falls kein Reset durchgeführt wurde, oder zum Zeitpunkt des Resets keine Netzwerk-Zeitsynchronisierung vorlag.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/last_reset

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/last_reset

{ "last_reset": 1714728252 }

Zuletzt zurückgesetzt 2024-05-03T11:24:12+02:00

Name	Bedeutung
last_reset int (s)	Unix-Timestamp des Zeitpunkts des letzten Zähler-Resets.

meter/type_override

Erlaubt es den verbauten Zählertyp zu überschreiben, falls die Auto-Detektion nicht funktioniert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/type_override

Schreiben

curl http://$HOST/meter/type_override -d ''

oder abgekürzt:

curl http://$HOST/meter/type_override -d ''

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/type_override

Schreiben

Mit MQTT auf $PREFIX/meter/type_override_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/type_override_update -m ''

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/meter/type_override_update -m ''

Name	Bedeutung
type int	Stromzählertyp, der verwendet werden soll 0 - Kein Stromzähler verfügbar 1 - SDM72 2 - SDM630 3 - SDM72V2 255 - Typ-Override nicht aktiv. Stromzählertyp wird automatisch detektiert.

meter/history

HTTP (curl)

Eine 48-Stunden-Historie der Ladeleistung in Watt. Bisher fehlende Werte werden durch null angezeigt. Die Historie wird von hinten nach vorne gefüllt, sodass null-Werte nur geschlossen am Anfang des Arrays auftreten, falls der ESP innerhalb der letzten 48 Stunden neugestartet wurde. Es werden bis zu 720 Werte ausgegeben, das entspricht einem Messwert alle 4 Minuten. Diese Messwerte sind der jeweilige Durchschnitt dieser 4 Minuten.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

curl http://$HOST/meter/history

{
  "offset": 60927,
  "samples": [
      null, null, null, null, null, null, null, null,
      // 600 weitere null-Werte entfernt
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0, 1736, 6656, 6655, 6666,
      6680, 6716, 6714, 6625, 6640, 6641, 6595, 6612,
      6592, 6593, 6589, 6592, 6600, 6625, 6626, 6637,
      6665, 6636, 6632, 6656, 6616, 6611, 6646, 6670,
      6691, 6715, 6787, 6754, 6761, 6797, 6771, 6685,
      6705, 6778, 6703, 6675, 6681, 6721, 6739, 6816,
      6872, 6858, 6821, 6836, 6784, 6871, 6943, 6930,
      6968, 6955, 6837, 6800, 6846, 6919, 6881, 6736,
      6671, 6655, 6674, 6743, 6878, 5733, 4462, 3712,
      3098, 2693, 2337, 2098, 1683, 1575, 1575,   84,
         0,    0,    0,    0,    0,    0,    0,    0
  ]
}

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

Name	Bedeutung
offset int (ms)	Das Alter des zuletzt gemessenen Wertes.
samples int[..]	Die gemessenen Werte.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

meter/live

HTTP (curl)

Die letzten Ladeleistungs-Messwerte. Auf Basis dieser Werte werden die Durchschnittswerte für meter/history generiert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

curl http://$HOST/meter/live

{
  "offset": 370,
  "samples_per_second": 1.99565,
  "samples": [
    2626, 2626, 2626, 2626, 2626, 2626, 2626, 2673,
    2673, 2673, 2673, 2673, 2673, 2673, 2673, 2677,
    2677, 2677, 2677, 2677, 2677, 2677, 2677, 2677,
    2677, 2677, 2677, 2677, 2677, 2677, 2677,  988,
     988,  988,  988,  988,  988,  988,  988,    3,
       3,    3,    3,    3,    3,    3,    3,    1,
       1,    1,    1,    1,    1,    1,    1,    3,
       3,    3,    3,    3,    3,    3,    3,    3,
       3,    3,    3,    3,    3,    3,    3,    3,
       3,    3,    3,    3,    3,    3,    3,    4
   ]
}

Es liegen 80 Werte vor, ~ 2 Werte pro Sekunde wurden erhoben, das Offset des letzten Werts sind 370 ms -> Die Messwerte reichen im Moment 40,370 Sekunden in die Vergangenheit.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

Name	Bedeutung
offset int (ms)	Das Alter des zuletzt gemessenen Wertes.
samples_per_second float (Hz)	Die Anzahl der gemessenen Werte pro Sekunde.
samples int[..]	Die gemessenen Werte. Abhängig von der Länge des Arrays und dem samples_per_second-Wert kann ermittelt werden, wie weit in die Vergangenheit die Messwerte reichen.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

warp2

meter/state

Der Zustand des Stromzählers.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/meter/state

{ "state": 2, "type": 3 }

Schreiben

curl http://$HOST/meter/state -d '{ "state": 2, "type": 3 }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/state

{ "state": 2, "type": 3 }

Schreiben

Mit MQTT auf $PREFIX/meter/state_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/state_update -m '{ "state": 2, "type": 3 }'

Name	Bedeutung
state int	Zustand des Stromzählers 0 - Kein Stromzähler verbunden 1 - Stromzähler unzuverlässig, eventuell nur einphasig verbunden. 2 - Stromzähler verbunden
type int	Typ des verbauten Stromzählers. Nicht jeder Stromzähler wird von jedem Gerät unterstützt! 0 - Kein Stromzähler verfügbar 2 - Eastron SDM630 3 - Eastron SDM72V2 4 - Eastron SDM72CTM 5 - Eastron SDM630MCT 6 - Eltako DSZ15DZMOD 7 - YTL DEM4A

meter/values

Die Messwerte des Stromzählers. Benötigt das Feature "meter"

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/meter/values

{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }

Schreiben

curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values

{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }

Schreiben

Mit MQTT auf $PREFIX/meter/values_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/values_update -m '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'

Name	Bedeutung
power float (W)	Die aktuelle Ladeleistung.
energy_rel float (kWh)	Die geladene Energie seit dem letzten Reset.
energy_abs float (kWh)	Die geladene Energie seit der Herstellung des Stromzählers.

meter/phases

Angeschlossene und aktive Phasen. Benötigt das Feature "meter_phases".

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/meter/phases

{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}

Schreiben

curl http://$HOST/meter/phases -d '{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases

{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}

Schreiben

Mit MQTT auf $PREFIX/meter/phases_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/phases_update -m '{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}'

Name	Bedeutung
phases_active bool[3]	Die derzeit aktiven Phasen [0] - Phase L1 aktiv [1] - Phase L2 aktiv [2] - Phase L3 aktiv
phases_connected bool[3]	Die angeschlossenen Phasen [0] - Phase L1 angeschlossen [1] - Phase L2 angeschlossen [2] - Phase L3 angeschlossen

meter/error_counters

Fehlerzähler der Kommunikation mit dem Stromzähler.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/meter/error_counters

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/error_counters

{
  "local_timeout": 0,
  "global_timeout": 0,
  "illegal_function": 0,
  "illegal_data_access": 0,
  "illegal_data_value": 0,
  "slave_device_failure": 0
}

Name	Bedeutung
local_timeout int	(Nur WARP 2 und WARP 3 und Energy Manager) Local Timeout
global_timeout int	(Nur WARP 2 und WARP 3 und Energy Manager) Global Timeout
illegal_function int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Function
illegal_data_access int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Data Access
illegal_data_value int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Data Value
slave_device_failure int	(Nur WARP 2 und WARP 3 und Energy Manager) Slave Device Failure

meter/all_values

Alle Messwerte, die vom eingebauten Stromzähler gemessen werden. Benötigt das Feature "meter_all_values". Hintereinanderliegende Werte die mit .. gekennzeichnet sind, beziehen sich auf die drei Phasen L1, L2 und L3.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/meter/all_values

[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]

Schreiben

curl http://$HOST/meter/all_values -d '[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/all_values

[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]

Schreiben

Mit MQTT auf $PREFIX/meter/all_values_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/all_values_update -m '[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]'

Index	Bedeutung
[0..2] float (V)	Spannung gegen Neutral
[3..5] float (A)	Strom
[6..8] float (W)	Wirkleistung
[9..11] float (VA)	Scheinleistung
[12..14] float (var)	Blindleistung
[15..17] float	Leistungsfaktor; Das Vorzeichen des Leistungsfaktors gibt die Richtung des Stromflusses an.
[18..20] float (°)	relative Phasenverschiebung
[21] float (V)	Durchschnittliche Spannung gegen Neutral
[22] float (A)	Durchschnittlicher Strom
[23] float (A)	Summe der Phasenströme
[24] float (W)	Gesamtwirkleistung
[25] float (VA)	Gesamtscheinleistung
[26] float (var)	Gesamtblindleistung
[27] float	Gesamtleistungsfaktor
[28] float (°)	Gesamtphasenverschiebung
[29] float (Hz)	Frequenz der Versorgungsspannung
[30] float (kWh)	Wirkenergie (Import; vom Fahrzeug aufgenommen)
[31] float (kWh)	Wirkenergie (Export; vom Fahrzeug abgegeben)
[32] float (kvarh)	Blindenergie (Import; vom Fahrzeug aufgenommen)
[33] float (kvarh)	Blindenergie (Export; vom Fahrzeug abgegeben)
[34] float (kVAh)	Gesamtscheinenergie
[35] float (Ah)	Transportierte elektrische Ladung
[36] float (W)	Bezogene Wirkleistung; Entspricht Import-Export-Differenz
[37] float (W)	Max. bezogene Wirkleistung; Höchster gemessener Wert
[38] float (VA)	Bezogene Scheinleistung; Entspricht Import-Export-Differenz
[39] float (VA)	Max. bezogene Scheinleistung; Höchster gemessener Wert
[40] float (A)	Bezogener Neutralleiterstrom
[41] float (A)	Max. bezogener Neutralleiterstrom; Höchster gemessener Wert
[42] float (V)	Spannung L1 zu L2
[43] float (V)	Spannung L2 zu L3
[44] float (V)	Spannung L3 zu L1
[45] float (V)	Durchschnittliche Spannung zwischen Phasen
[46] float (A)	Neutralleiterstrom
[47..49] float (%)	Total Harmonic Distortion (THD) der Spannung
[50..52] float (%)	Total Harmonic Distortion (THD) des Stroms
[53] float (%)	Durchschnittliche Spannungs-THD
[54] float (%)	Durchschnittliche Strom-THD
[55..57] float (A)	Bezogener Strom
[58..60] float (A)	Max. bezogener Strom; Höchster gemessener Wert
[61] float (%)	Spannungs-THD L1 zu L2
[62] float (%)	Spannungs-THD L2 zu L3
[63] float (%)	Spannungs-THD L3 zu L1
[64] float (%)	Durchschnittliche Spannungs-THD zwischen Phasen
[65] float (kWh)	Summe der Gesamtwirkenergien; Import-Export-Summe aller Phasen
[66] float (kvarh)	Summe der Gesamtblindenergien; Import-Export-Summe aller Phasen
[67..69] float (kWh)	Wirkenergie (Import; vom Fahrzeug aufgenommen)
[70..72] float (kWh)	Wirkenergie (Export; vom Fahrzeug abgegeben)
[73..75] float (kWh)	Gesamtwirkenergie; Import-Export-Summe
[76..78] float (kvarh)	Blindenergie (Import; vom Fahrzeug aufgenommen)
[79..81] float (kvarh)	Blindenergie (Export; vom Fahrzeug abgegeben)
[82..84] float (kvarh)	Gesamtblindenergie; Import-Export-Summe

meter/reset

Setzt den Energiezähler zurück. Leerer Payload. Es muss einer der folgenden Werte übergeben werden: null, "", false, 0, [] oder {}

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Schreiben

curl http://$HOST/meter/reset -d 'null'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/meter/reset -m 'null'

meter/last_reset

Der Zeitpunkt des letzten Zähler-Resets (siehe meter/reset) als Unix-Timestamp. 0 falls kein Reset durchgeführt wurde, oder zum Zeitpunkt des Resets keine Netzwerk-Zeitsynchronisierung vorlag.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/meter/last_reset

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/last_reset

{ "last_reset": 1714728252 }

Zuletzt zurückgesetzt 2024-05-03T11:24:12+02:00

Name	Bedeutung
last_reset int (s)	Unix-Timestamp des Zeitpunkts des letzten Zähler-Resets.

meter/history

HTTP (curl)

Eine 48-Stunden-Historie der Ladeleistung in Watt. Bisher fehlende Werte werden durch null angezeigt. Die Historie wird von hinten nach vorne gefüllt, sodass null-Werte nur geschlossen am Anfang des Arrays auftreten, falls der ESP innerhalb der letzten 48 Stunden neugestartet wurde. Es werden bis zu 720 Werte ausgegeben, das entspricht einem Messwert alle 4 Minuten. Diese Messwerte sind der jeweilige Durchschnitt dieser 4 Minuten.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

curl http://$HOST/meter/history

{
  "offset": 60927,
  "samples": [
      null, null, null, null, null, null, null, null,
      // 600 weitere null-Werte entfernt
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0, 1736, 6656, 6655, 6666,
      6680, 6716, 6714, 6625, 6640, 6641, 6595, 6612,
      6592, 6593, 6589, 6592, 6600, 6625, 6626, 6637,
      6665, 6636, 6632, 6656, 6616, 6611, 6646, 6670,
      6691, 6715, 6787, 6754, 6761, 6797, 6771, 6685,
      6705, 6778, 6703, 6675, 6681, 6721, 6739, 6816,
      6872, 6858, 6821, 6836, 6784, 6871, 6943, 6930,
      6968, 6955, 6837, 6800, 6846, 6919, 6881, 6736,
      6671, 6655, 6674, 6743, 6878, 5733, 4462, 3712,
      3098, 2693, 2337, 2098, 1683, 1575, 1575,   84,
         0,    0,    0,    0,    0,    0,    0,    0
  ]
}

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

Name	Bedeutung
offset int (ms)	Das Alter des zuletzt gemessenen Wertes.
samples int[..]	Die gemessenen Werte.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

meter/live

HTTP (curl)

Die letzten Ladeleistungs-Messwerte. Auf Basis dieser Werte werden die Durchschnittswerte für meter/history generiert.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

curl http://$HOST/meter/live

{
  "offset": 370,
  "samples_per_second": 1.99565,
  "samples": [
    2626, 2626, 2626, 2626, 2626, 2626, 2626, 2673,
    2673, 2673, 2673, 2673, 2673, 2673, 2673, 2677,
    2677, 2677, 2677, 2677, 2677, 2677, 2677, 2677,
    2677, 2677, 2677, 2677, 2677, 2677, 2677,  988,
     988,  988,  988,  988,  988,  988,  988,    3,
       3,    3,    3,    3,    3,    3,    3,    1,
       1,    1,    1,    1,    1,    1,    1,    3,
       3,    3,    3,    3,    3,    3,    3,    3,
       3,    3,    3,    3,    3,    3,    3,    3,
       3,    3,    3,    3,    3,    3,    3,    4
   ]
}

Es liegen 80 Werte vor, ~ 2 Werte pro Sekunde wurden erhoben, das Offset des letzten Werts sind 370 ms -> Die Messwerte reichen im Moment 40,370 Sekunden in die Vergangenheit.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

Name	Bedeutung
offset int (ms)	Das Alter des zuletzt gemessenen Wertes.
samples_per_second float (Hz)	Die Anzahl der gemessenen Werte pro Sekunde.
samples int[..]	Die gemessenen Werte. Abhängig von der Länge des Arrays und dem samples_per_second-Wert kann ermittelt werden, wie weit in die Vergangenheit die Messwerte reichen.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

warp3

meter/state

Der Zustand des Stromzählers.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/meter/state

{ "state": 2, "type": 3 }

Schreiben

curl http://$HOST/meter/state -d '{ "state": 2, "type": 3 }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/state

{ "state": 2, "type": 3 }

Schreiben

Mit MQTT auf $PREFIX/meter/state_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/state_update -m '{ "state": 2, "type": 3 }'

Name	Bedeutung
state int	Zustand des Stromzählers 0 - Kein Stromzähler verbunden 1 - Stromzähler unzuverlässig, eventuell nur einphasig verbunden. 2 - Stromzähler verbunden
type int	Typ des verbauten Stromzählers. Nicht jeder Stromzähler wird von jedem Gerät unterstützt! 0 - Kein Stromzähler verfügbar 2 - Eastron SDM630 3 - Eastron SDM72V2 4 - Eastron SDM72CTM 5 - Eastron SDM630MCT 6 - Eltako DSZ15DZMOD 7 - YTL DEM4A

meter/values

Die Messwerte des Stromzählers. Benötigt das Feature "meter"

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/meter/values

{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }

Schreiben

curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values

{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }

Schreiben

Mit MQTT auf $PREFIX/meter/values_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/values_update -m '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'

Name	Bedeutung
power float (W)	Die aktuelle Ladeleistung.
energy_rel float (kWh)	Die geladene Energie seit dem letzten Reset.
energy_abs float (kWh)	Die geladene Energie seit der Herstellung des Stromzählers.

meter/phases

Angeschlossene und aktive Phasen. Benötigt das Feature "meter_phases".

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/meter/phases

{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}

Schreiben

curl http://$HOST/meter/phases -d '{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases

{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}

Schreiben

Mit MQTT auf $PREFIX/meter/phases_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/phases_update -m '{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}'

Name	Bedeutung
phases_active bool[3]	Die derzeit aktiven Phasen [0] - Phase L1 aktiv [1] - Phase L2 aktiv [2] - Phase L3 aktiv
phases_connected bool[3]	Die angeschlossenen Phasen [0] - Phase L1 angeschlossen [1] - Phase L2 angeschlossen [2] - Phase L3 angeschlossen

meter/error_counters

Fehlerzähler der Kommunikation mit dem Stromzähler.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/meter/error_counters

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/error_counters

{
  "local_timeout": 0,
  "global_timeout": 0,
  "illegal_function": 0,
  "illegal_data_access": 0,
  "illegal_data_value": 0,
  "slave_device_failure": 0
}

Name	Bedeutung
local_timeout int	(Nur WARP 2 und WARP 3 und Energy Manager) Local Timeout
global_timeout int	(Nur WARP 2 und WARP 3 und Energy Manager) Global Timeout
illegal_function int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Function
illegal_data_access int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Data Access
illegal_data_value int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Data Value
slave_device_failure int	(Nur WARP 2 und WARP 3 und Energy Manager) Slave Device Failure

meter/all_values

Alle Messwerte, die vom eingebauten Stromzähler gemessen werden. Benötigt das Feature "meter_all_values". Hintereinanderliegende Werte die mit .. gekennzeichnet sind, beziehen sich auf die drei Phasen L1, L2 und L3.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/meter/all_values

[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]

Schreiben

curl http://$HOST/meter/all_values -d '[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/all_values

[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]

Schreiben

Mit MQTT auf $PREFIX/meter/all_values_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/all_values_update -m '[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]'

Index	Bedeutung
[0..2] float (V)	Spannung gegen Neutral
[3..5] float (A)	Strom
[6..8] float (W)	Wirkleistung
[9..11] float (VA)	Scheinleistung
[12..14] float (var)	Blindleistung
[15..17] float	Leistungsfaktor; Das Vorzeichen des Leistungsfaktors gibt die Richtung des Stromflusses an.
[18..20] float (°)	relative Phasenverschiebung
[21] float (V)	Durchschnittliche Spannung gegen Neutral
[22] float (A)	Durchschnittlicher Strom
[23] float (A)	Summe der Phasenströme
[24] float (W)	Gesamtwirkleistung
[25] float (VA)	Gesamtscheinleistung
[26] float (var)	Gesamtblindleistung
[27] float	Gesamtleistungsfaktor
[28] float (°)	Gesamtphasenverschiebung
[29] float (Hz)	Frequenz der Versorgungsspannung
[30] float (kWh)	Wirkenergie (Import; vom Fahrzeug aufgenommen)
[31] float (kWh)	Wirkenergie (Export; vom Fahrzeug abgegeben)
[32] float (kvarh)	Blindenergie (Import; vom Fahrzeug aufgenommen)
[33] float (kvarh)	Blindenergie (Export; vom Fahrzeug abgegeben)
[34] float (kVAh)	Gesamtscheinenergie
[35] float (Ah)	Transportierte elektrische Ladung
[36] float (W)	Bezogene Wirkleistung; Entspricht Import-Export-Differenz
[37] float (W)	Max. bezogene Wirkleistung; Höchster gemessener Wert
[38] float (VA)	Bezogene Scheinleistung; Entspricht Import-Export-Differenz
[39] float (VA)	Max. bezogene Scheinleistung; Höchster gemessener Wert
[40] float (A)	Bezogener Neutralleiterstrom
[41] float (A)	Max. bezogener Neutralleiterstrom; Höchster gemessener Wert
[42] float (V)	Spannung L1 zu L2
[43] float (V)	Spannung L2 zu L3
[44] float (V)	Spannung L3 zu L1
[45] float (V)	Durchschnittliche Spannung zwischen Phasen
[46] float (A)	Neutralleiterstrom
[47..49] float (%)	Total Harmonic Distortion (THD) der Spannung
[50..52] float (%)	Total Harmonic Distortion (THD) des Stroms
[53] float (%)	Durchschnittliche Spannungs-THD
[54] float (%)	Durchschnittliche Strom-THD
[55..57] float (A)	Bezogener Strom
[58..60] float (A)	Max. bezogener Strom; Höchster gemessener Wert
[61] float (%)	Spannungs-THD L1 zu L2
[62] float (%)	Spannungs-THD L2 zu L3
[63] float (%)	Spannungs-THD L3 zu L1
[64] float (%)	Durchschnittliche Spannungs-THD zwischen Phasen
[65] float (kWh)	Summe der Gesamtwirkenergien; Import-Export-Summe aller Phasen
[66] float (kvarh)	Summe der Gesamtblindenergien; Import-Export-Summe aller Phasen
[67..69] float (kWh)	Wirkenergie (Import; vom Fahrzeug aufgenommen)
[70..72] float (kWh)	Wirkenergie (Export; vom Fahrzeug abgegeben)
[73..75] float (kWh)	Gesamtwirkenergie; Import-Export-Summe
[76..78] float (kvarh)	Blindenergie (Import; vom Fahrzeug aufgenommen)
[79..81] float (kvarh)	Blindenergie (Export; vom Fahrzeug abgegeben)
[82..84] float (kvarh)	Gesamtblindenergie; Import-Export-Summe

meter/reset

Setzt den Energiezähler zurück. Leerer Payload. Es muss einer der folgenden Werte übergeben werden: null, "", false, 0, [] oder {}

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Schreiben

curl http://$HOST/meter/reset -d 'null'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/meter/reset -m 'null'

meter/last_reset

Der Zeitpunkt des letzten Zähler-Resets (siehe meter/reset) als Unix-Timestamp. 0 falls kein Reset durchgeführt wurde, oder zum Zeitpunkt des Resets keine Netzwerk-Zeitsynchronisierung vorlag.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/meter/last_reset

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/last_reset

{ "last_reset": 1714728252 }

Zuletzt zurückgesetzt 2024-05-03T11:24:12+02:00

Name	Bedeutung
last_reset int (s)	Unix-Timestamp des Zeitpunkts des letzten Zähler-Resets.

meter/history

HTTP (curl)

Eine 48-Stunden-Historie der Ladeleistung in Watt. Bisher fehlende Werte werden durch null angezeigt. Die Historie wird von hinten nach vorne gefüllt, sodass null-Werte nur geschlossen am Anfang des Arrays auftreten, falls der ESP innerhalb der letzten 48 Stunden neugestartet wurde. Es werden bis zu 720 Werte ausgegeben, das entspricht einem Messwert alle 4 Minuten. Diese Messwerte sind der jeweilige Durchschnitt dieser 4 Minuten.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

curl http://$HOST/meter/history

{
  "offset": 60927,
  "samples": [
      null, null, null, null, null, null, null, null,
      // 600 weitere null-Werte entfernt
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0, 1736, 6656, 6655, 6666,
      6680, 6716, 6714, 6625, 6640, 6641, 6595, 6612,
      6592, 6593, 6589, 6592, 6600, 6625, 6626, 6637,
      6665, 6636, 6632, 6656, 6616, 6611, 6646, 6670,
      6691, 6715, 6787, 6754, 6761, 6797, 6771, 6685,
      6705, 6778, 6703, 6675, 6681, 6721, 6739, 6816,
      6872, 6858, 6821, 6836, 6784, 6871, 6943, 6930,
      6968, 6955, 6837, 6800, 6846, 6919, 6881, 6736,
      6671, 6655, 6674, 6743, 6878, 5733, 4462, 3712,
      3098, 2693, 2337, 2098, 1683, 1575, 1575,   84,
         0,    0,    0,    0,    0,    0,    0,    0
  ]
}

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

Name	Bedeutung
offset int (ms)	Das Alter des zuletzt gemessenen Wertes.
samples int[..]	Die gemessenen Werte.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

meter/live

HTTP (curl)

Die letzten Ladeleistungs-Messwerte. Auf Basis dieser Werte werden die Durchschnittswerte für meter/history generiert.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

curl http://$HOST/meter/live

{
  "offset": 370,
  "samples_per_second": 1.99565,
  "samples": [
    2626, 2626, 2626, 2626, 2626, 2626, 2626, 2673,
    2673, 2673, 2673, 2673, 2673, 2673, 2673, 2677,
    2677, 2677, 2677, 2677, 2677, 2677, 2677, 2677,
    2677, 2677, 2677, 2677, 2677, 2677, 2677,  988,
     988,  988,  988,  988,  988,  988,  988,    3,
       3,    3,    3,    3,    3,    3,    3,    1,
       1,    1,    1,    1,    1,    1,    1,    3,
       3,    3,    3,    3,    3,    3,    3,    3,
       3,    3,    3,    3,    3,    3,    3,    3,
       3,    3,    3,    3,    3,    3,    3,    4
   ]
}

Es liegen 80 Werte vor, ~ 2 Werte pro Sekunde wurden erhoben, das Offset des letzten Werts sind 370 ms -> Die Messwerte reichen im Moment 40,370 Sekunden in die Vergangenheit.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

Name	Bedeutung
offset int (ms)	Das Alter des zuletzt gemessenen Wertes.
samples_per_second float (Hz)	Die Anzahl der gemessenen Werte pro Sekunde.
samples int[..]	Die gemessenen Werte. Abhängig von der Länge des Arrays und dem samples_per_second-Wert kann ermittelt werden, wie weit in die Vergangenheit die Messwerte reichen.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

wem

meter/state

Der Zustand des Stromzählers.

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/meter/state

{ "state": 2, "type": 3 }

Schreiben

curl http://$HOST/meter/state -d '{ "state": 2, "type": 3 }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/state

{ "state": 2, "type": 3 }

Schreiben

Mit MQTT auf $PREFIX/meter/state_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/state_update -m '{ "state": 2, "type": 3 }'

Name	Bedeutung
state int	Zustand des Stromzählers 0 - Kein Stromzähler verbunden 1 - Stromzähler unzuverlässig, eventuell nur einphasig verbunden. 2 - Stromzähler verbunden
type int	Typ des verbauten Stromzählers. Nicht jeder Stromzähler wird von jedem Gerät unterstützt! 0 - Kein Stromzähler verfügbar 2 - Eastron SDM630 3 - Eastron SDM72V2 4 - Eastron SDM72CTM 5 - Eastron SDM630MCT 6 - Eltako DSZ15DZMOD 7 - YTL DEM4A

meter/values

Die Messwerte des Stromzählers. Benötigt das Feature "meter"

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/meter/values

{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }

Schreiben

curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values

{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }

Schreiben

Mit MQTT auf $PREFIX/meter/values_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/values_update -m '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'

Name	Bedeutung
power float (W)	Die aktuelle Ladeleistung.
energy_rel float (kWh)	Die geladene Energie seit dem letzten Reset.
energy_abs float (kWh)	Die geladene Energie seit der Herstellung des Stromzählers.

meter/phases

Angeschlossene und aktive Phasen. Benötigt das Feature "meter_phases".

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/meter/phases

{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}

Schreiben

curl http://$HOST/meter/phases -d '{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases

{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}

Schreiben

Mit MQTT auf $PREFIX/meter/phases_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/phases_update -m '{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}'

Name	Bedeutung
phases_active bool[3]	Die derzeit aktiven Phasen [0] - Phase L1 aktiv [1] - Phase L2 aktiv [2] - Phase L3 aktiv
phases_connected bool[3]	Die angeschlossenen Phasen [0] - Phase L1 angeschlossen [1] - Phase L2 angeschlossen [2] - Phase L3 angeschlossen

meter/error_counters

Fehlerzähler der Kommunikation mit dem Stromzähler.

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/meter/error_counters

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/error_counters

{
  "local_timeout": 0,
  "global_timeout": 0,
  "illegal_function": 0,
  "illegal_data_access": 0,
  "illegal_data_value": 0,
  "slave_device_failure": 0
}

Name	Bedeutung
local_timeout int	(Nur WARP 2 und WARP 3 und Energy Manager) Local Timeout
global_timeout int	(Nur WARP 2 und WARP 3 und Energy Manager) Global Timeout
illegal_function int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Function
illegal_data_access int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Data Access
illegal_data_value int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Data Value
slave_device_failure int	(Nur WARP 2 und WARP 3 und Energy Manager) Slave Device Failure

meter/all_values

Alle Messwerte, die vom eingebauten Stromzähler gemessen werden. Benötigt das Feature "meter_all_values". Hintereinanderliegende Werte die mit .. gekennzeichnet sind, beziehen sich auf die drei Phasen L1, L2 und L3.

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/meter/all_values

[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]

Schreiben

curl http://$HOST/meter/all_values -d '[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/all_values

[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]

Schreiben

Mit MQTT auf $PREFIX/meter/all_values_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/all_values_update -m '[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]'

Index	Bedeutung
[0..2] float (V)	Spannung gegen Neutral
[3..5] float (A)	Strom
[6..8] float (W)	Wirkleistung
[9..11] float (VA)	Scheinleistung
[12..14] float (var)	Blindleistung
[15..17] float	Leistungsfaktor; Das Vorzeichen des Leistungsfaktors gibt die Richtung des Stromflusses an.
[18..20] float (°)	relative Phasenverschiebung
[21] float (V)	Durchschnittliche Spannung gegen Neutral
[22] float (A)	Durchschnittlicher Strom
[23] float (A)	Summe der Phasenströme
[24] float (W)	Gesamtwirkleistung
[25] float (VA)	Gesamtscheinleistung
[26] float (var)	Gesamtblindleistung
[27] float	Gesamtleistungsfaktor
[28] float (°)	Gesamtphasenverschiebung
[29] float (Hz)	Frequenz der Versorgungsspannung
[30] float (kWh)	Wirkenergie (Import; vom Fahrzeug aufgenommen)
[31] float (kWh)	Wirkenergie (Export; vom Fahrzeug abgegeben)
[32] float (kvarh)	Blindenergie (Import; vom Fahrzeug aufgenommen)
[33] float (kvarh)	Blindenergie (Export; vom Fahrzeug abgegeben)
[34] float (kVAh)	Gesamtscheinenergie
[35] float (Ah)	Transportierte elektrische Ladung
[36] float (W)	Bezogene Wirkleistung; Entspricht Import-Export-Differenz
[37] float (W)	Max. bezogene Wirkleistung; Höchster gemessener Wert
[38] float (VA)	Bezogene Scheinleistung; Entspricht Import-Export-Differenz
[39] float (VA)	Max. bezogene Scheinleistung; Höchster gemessener Wert
[40] float (A)	Bezogener Neutralleiterstrom
[41] float (A)	Max. bezogener Neutralleiterstrom; Höchster gemessener Wert
[42] float (V)	Spannung L1 zu L2
[43] float (V)	Spannung L2 zu L3
[44] float (V)	Spannung L3 zu L1
[45] float (V)	Durchschnittliche Spannung zwischen Phasen
[46] float (A)	Neutralleiterstrom
[47..49] float (%)	Total Harmonic Distortion (THD) der Spannung
[50..52] float (%)	Total Harmonic Distortion (THD) des Stroms
[53] float (%)	Durchschnittliche Spannungs-THD
[54] float (%)	Durchschnittliche Strom-THD
[55..57] float (A)	Bezogener Strom
[58..60] float (A)	Max. bezogener Strom; Höchster gemessener Wert
[61] float (%)	Spannungs-THD L1 zu L2
[62] float (%)	Spannungs-THD L2 zu L3
[63] float (%)	Spannungs-THD L3 zu L1
[64] float (%)	Durchschnittliche Spannungs-THD zwischen Phasen
[65] float (kWh)	Summe der Gesamtwirkenergien; Import-Export-Summe aller Phasen
[66] float (kvarh)	Summe der Gesamtblindenergien; Import-Export-Summe aller Phasen
[67..69] float (kWh)	Wirkenergie (Import; vom Fahrzeug aufgenommen)
[70..72] float (kWh)	Wirkenergie (Export; vom Fahrzeug abgegeben)
[73..75] float (kWh)	Gesamtwirkenergie; Import-Export-Summe
[76..78] float (kvarh)	Blindenergie (Import; vom Fahrzeug aufgenommen)
[79..81] float (kvarh)	Blindenergie (Export; vom Fahrzeug abgegeben)
[82..84] float (kvarh)	Gesamtblindenergie; Import-Export-Summe

meter/reset

Setzt den Energiezähler zurück. Leerer Payload. Es muss einer der folgenden Werte übergeben werden: null, "", false, 0, [] oder {}

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Schreiben

curl http://$HOST/meter/reset -d 'null'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/meter/reset -m 'null'

meter/last_reset

Der Zeitpunkt des letzten Zähler-Resets (siehe meter/reset) als Unix-Timestamp. 0 falls kein Reset durchgeführt wurde, oder zum Zeitpunkt des Resets keine Netzwerk-Zeitsynchronisierung vorlag.

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/meter/last_reset

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/last_reset

{ "last_reset": 1714728252 }

Zuletzt zurückgesetzt 2024-05-03T11:24:12+02:00

Name	Bedeutung
last_reset int (s)	Unix-Timestamp des Zeitpunkts des letzten Zähler-Resets.

meter/history

HTTP (curl)

Eine 48-Stunden-Historie der Ladeleistung in Watt. Bisher fehlende Werte werden durch null angezeigt. Die Historie wird von hinten nach vorne gefüllt, sodass null-Werte nur geschlossen am Anfang des Arrays auftreten, falls der ESP innerhalb der letzten 48 Stunden neugestartet wurde. Es werden bis zu 720 Werte ausgegeben, das entspricht einem Messwert alle 4 Minuten. Diese Messwerte sind der jeweilige Durchschnitt dieser 4 Minuten.

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

curl http://$HOST/meter/history

{
  "offset": 60927,
  "samples": [
      null, null, null, null, null, null, null, null,
      // 600 weitere null-Werte entfernt
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0, 1736, 6656, 6655, 6666,
      6680, 6716, 6714, 6625, 6640, 6641, 6595, 6612,
      6592, 6593, 6589, 6592, 6600, 6625, 6626, 6637,
      6665, 6636, 6632, 6656, 6616, 6611, 6646, 6670,
      6691, 6715, 6787, 6754, 6761, 6797, 6771, 6685,
      6705, 6778, 6703, 6675, 6681, 6721, 6739, 6816,
      6872, 6858, 6821, 6836, 6784, 6871, 6943, 6930,
      6968, 6955, 6837, 6800, 6846, 6919, 6881, 6736,
      6671, 6655, 6674, 6743, 6878, 5733, 4462, 3712,
      3098, 2693, 2337, 2098, 1683, 1575, 1575,   84,
         0,    0,    0,    0,    0,    0,    0,    0
  ]
}

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

Name	Bedeutung
offset int (ms)	Das Alter des zuletzt gemessenen Wertes.
samples int[..]	Die gemessenen Werte.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

meter/live

HTTP (curl)

Die letzten Ladeleistungs-Messwerte. Auf Basis dieser Werte werden die Durchschnittswerte für meter/history generiert.

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

curl http://$HOST/meter/live

{
  "offset": 370,
  "samples_per_second": 1.99565,
  "samples": [
    2626, 2626, 2626, 2626, 2626, 2626, 2626, 2673,
    2673, 2673, 2673, 2673, 2673, 2673, 2673, 2677,
    2677, 2677, 2677, 2677, 2677, 2677, 2677, 2677,
    2677, 2677, 2677, 2677, 2677, 2677, 2677,  988,
     988,  988,  988,  988,  988,  988,  988,    3,
       3,    3,    3,    3,    3,    3,    3,    1,
       1,    1,    1,    1,    1,    1,    1,    3,
       3,    3,    3,    3,    3,    3,    3,    3,
       3,    3,    3,    3,    3,    3,    3,    3,
       3,    3,    3,    3,    3,    3,    3,    4
   ]
}

Es liegen 80 Werte vor, ~ 2 Werte pro Sekunde wurden erhoben, das Offset des letzten Werts sind 370 ms -> Die Messwerte reichen im Moment 40,370 Sekunden in die Vergangenheit.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

Name	Bedeutung
offset int (ms)	Das Alter des zuletzt gemessenen Wertes.
samples_per_second float (Hz)	Die Anzahl der gemessenen Werte pro Sekunde.
samples int[..]	Die gemessenen Werte. Abhängig von der Länge des Arrays und dem samples_per_second-Wert kann ermittelt werden, wie weit in die Vergangenheit die Messwerte reichen.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

any

meter/state

Der Zustand des Stromzählers.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/state

{ "state": 2, "type": 3 }

Schreiben

curl http://$HOST/meter/state -d '{ "state": 2, "type": 3 }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/state

{ "state": 2, "type": 3 }

Schreiben

Mit MQTT auf $PREFIX/meter/state_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/state_update -m '{ "state": 2, "type": 3 }'

Name	Bedeutung
state int	Zustand des Stromzählers 0 - Kein Stromzähler verbunden 1 - Stromzähler unzuverlässig, eventuell nur einphasig verbunden. 2 - Stromzähler verbunden
type int	Typ des verbauten Stromzählers. Nicht jeder Stromzähler wird von jedem Gerät unterstützt! 0 - Kein Stromzähler verfügbar 2 - Eastron SDM630 3 - Eastron SDM72V2 WARP 1: 1 - Eastron SDM72 WARP 2 und WARP 3 und Energy Manager: 4 - Eastron SDM72CTM 5 - Eastron SDM630MCT 6 - Eltako DSZ15DZMOD 7 - YTL DEM4A

meter/values

Die Messwerte des Stromzählers. Benötigt das Feature "meter"

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/values

{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }

Schreiben

curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values

{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }

Schreiben

Mit MQTT auf $PREFIX/meter/values_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/values_update -m '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'

Name	Bedeutung
power float (W)	Die aktuelle Ladeleistung.
energy_rel float (kWh)	Die geladene Energie seit dem letzten Reset.
energy_abs float (kWh)	Die geladene Energie seit der Herstellung des Stromzählers.

meter/phases

Angeschlossene und aktive Phasen. Benötigt das Feature "meter_phases".

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/phases

{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}

Schreiben

curl http://$HOST/meter/phases -d '{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases

{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}

Schreiben

Mit MQTT auf $PREFIX/meter/phases_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/phases_update -m '{
  "phases_connected": [true, false, false],
  "phases_active": [true, false, false]
}'

Name	Bedeutung
phases_active bool[3]	Die derzeit aktiven Phasen [0] - Phase L1 aktiv [1] - Phase L2 aktiv [2] - Phase L3 aktiv
phases_connected bool[3]	Die angeschlossenen Phasen [0] - Phase L1 angeschlossen [1] - Phase L2 angeschlossen [2] - Phase L3 angeschlossen

meter/error_counters

Fehlerzähler der Kommunikation mit dem Stromzähler.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/error_counters

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/error_counters

{ "meter": 0, "bricklet": 0, "bricklet_reset": 0 }

Name	Bedeutung
meter int	(Nur WARP 1) Kommunikationsfehler zwischen RS485 Bricklet und Stromzähler.
bricklet int	(Nur WARP 1) Kommunikationsfehler zwischen ESP Brick und RS485 Bricklet.
bricklet_reset int	(Nur WARP 1) Unerwartete Resets des RS485 Bricklets.
local_timeout int	(Nur WARP 2 und WARP 3 und Energy Manager) Local Timeout
global_timeout int	(Nur WARP 2 und WARP 3 und Energy Manager) Global Timeout
illegal_function int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Function
illegal_data_access int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Data Access
illegal_data_value int	(Nur WARP 2 und WARP 3 und Energy Manager) Illegal Data Value
slave_device_failure int	(Nur WARP 2 und WARP 3 und Energy Manager) Slave Device Failure

meter/all_values

Alle Messwerte, die vom eingebauten Stromzähler gemessen werden. Benötigt das Feature "meter_all_values". Hintereinanderliegende Werte die mit .. gekennzeichnet sind, beziehen sich auf die drei Phasen L1, L2 und L3.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/all_values

[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]

Schreiben

curl http://$HOST/meter/all_values -d '[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/all_values

[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]

Schreiben

Mit MQTT auf $PREFIX/meter/all_values_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/all_values_update -m '[
    // Index 0
    215.6799927, 228.3399963, 218.5399933,
    31.42000008, 0, 0.01,
    6758, 0, -2,
    6758, 0, 2.424242258,
    // Index 12
    0, 0, 1.370018482,
    1, 0, -0.825000048,
    0, 0, 2.540998697,
    220.8533325, 10.47666645, 31.43000031,
    // Index 24
    6757, 6760.424316, 1.370018482,
    0, 2.540998697, null,
    943.289978, 0, null,
    null, null, null,
    // Index 36
    null, null, null,
    null, null, null,
    null, null, null,
    null, 31.41500282, null,
    // Index 48
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 60
    null, null, null,
    null, null, 943.289978,
    null, null, null,
    null, null, null,
    // Index 72
    null, null, null,
    null, null, null,
    null, null, null,
    null, null, null,
    // Index 84
    null
  ]'

Index	Bedeutung
[0..2] float (V)	Spannung gegen Neutral
[3..5] float (A)	Strom
[6..8] float (W)	Wirkleistung
[9..11] float (VA)	Scheinleistung
[12..14] float (var)	Blindleistung
[15..17] float	Leistungsfaktor; Das Vorzeichen des Leistungsfaktors gibt die Richtung des Stromflusses an.
[18..20] float (°)	relative Phasenverschiebung
[21] float (V)	Durchschnittliche Spannung gegen Neutral
[22] float (A)	Durchschnittlicher Strom
[23] float (A)	Summe der Phasenströme
[24] float (W)	Gesamtwirkleistung
[25] float (VA)	Gesamtscheinleistung
[26] float (var)	Gesamtblindleistung
[27] float	Gesamtleistungsfaktor
[28] float (°)	Gesamtphasenverschiebung
[29] float (Hz)	Frequenz der Versorgungsspannung
[30] float (kWh)	Wirkenergie (Import; vom Fahrzeug aufgenommen)
[31] float (kWh)	Wirkenergie (Export; vom Fahrzeug abgegeben)
[32] float (kvarh)	Blindenergie (Import; vom Fahrzeug aufgenommen)
[33] float (kvarh)	Blindenergie (Export; vom Fahrzeug abgegeben)
[34] float (kVAh)	Gesamtscheinenergie
[35] float (Ah)	Transportierte elektrische Ladung
[36] float (W)	Bezogene Wirkleistung; Entspricht Import-Export-Differenz
[37] float (W)	Max. bezogene Wirkleistung; Höchster gemessener Wert
[38] float (VA)	Bezogene Scheinleistung; Entspricht Import-Export-Differenz
[39] float (VA)	Max. bezogene Scheinleistung; Höchster gemessener Wert
[40] float (A)	Bezogener Neutralleiterstrom
[41] float (A)	Max. bezogener Neutralleiterstrom; Höchster gemessener Wert
[42] float (V)	Spannung L1 zu L2
[43] float (V)	Spannung L2 zu L3
[44] float (V)	Spannung L3 zu L1
[45] float (V)	Durchschnittliche Spannung zwischen Phasen
[46] float (A)	Neutralleiterstrom
[47..49] float (%)	Total Harmonic Distortion (THD) der Spannung
[50..52] float (%)	Total Harmonic Distortion (THD) des Stroms
[53] float (%)	Durchschnittliche Spannungs-THD
[54] float (%)	Durchschnittliche Strom-THD
[55..57] float (A)	Bezogener Strom
[58..60] float (A)	Max. bezogener Strom; Höchster gemessener Wert
[61] float (%)	Spannungs-THD L1 zu L2
[62] float (%)	Spannungs-THD L2 zu L3
[63] float (%)	Spannungs-THD L3 zu L1
[64] float (%)	Durchschnittliche Spannungs-THD zwischen Phasen
[65] float (kWh)	Summe der Gesamtwirkenergien; Import-Export-Summe aller Phasen
[66] float (kvarh)	Summe der Gesamtblindenergien; Import-Export-Summe aller Phasen
[67..69] float (kWh)	Wirkenergie (Import; vom Fahrzeug aufgenommen)
[70..72] float (kWh)	Wirkenergie (Export; vom Fahrzeug abgegeben)
[73..75] float (kWh)	Gesamtwirkenergie; Import-Export-Summe
[76..78] float (kvarh)	Blindenergie (Import; vom Fahrzeug aufgenommen)
[79..81] float (kvarh)	Blindenergie (Export; vom Fahrzeug abgegeben)
[82..84] float (kvarh)	Gesamtblindenergie; Import-Export-Summe

meter/reset

Setzt den Energiezähler zurück. Leerer Payload. Es muss einer der folgenden Werte übergeben werden: null, "", false, 0, [] oder {}

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Schreiben

curl http://$HOST/meter/reset -d 'null'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/meter/reset -m 'null'

meter/last_reset

Der Zeitpunkt des letzten Zähler-Resets (siehe meter/reset) als Unix-Timestamp. 0 falls kein Reset durchgeführt wurde, oder zum Zeitpunkt des Resets keine Netzwerk-Zeitsynchronisierung vorlag.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/last_reset

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/last_reset

{ "last_reset": 1714728252 }

Zuletzt zurückgesetzt 2024-05-03T11:24:12+02:00

Name	Bedeutung
last_reset int (s)	Unix-Timestamp des Zeitpunkts des letzten Zähler-Resets.

meter/type_override

(Nur WARP 1) Erlaubt es den verbauten Zählertyp zu überschreiben, falls die Auto-Detektion nicht funktioniert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/meter/type_override

Schreiben

curl http://$HOST/meter/type_override -d ''

oder abgekürzt:

curl http://$HOST/meter/type_override -d ''

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/type_override

Schreiben

Mit MQTT auf $PREFIX/meter/type_override_update

mosquitto_pub -h $BROKER -t $PREFIX/meter/type_override_update -m ''

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/meter/type_override_update -m ''

Name	Bedeutung
type int	Stromzählertyp, der verwendet werden soll 0 - Kein Stromzähler verfügbar 1 - SDM72 2 - SDM630 3 - SDM72V2 255 - Typ-Override nicht aktiv. Stromzählertyp wird automatisch detektiert.

meter/history

HTTP (curl)

Eine 48-Stunden-Historie der Ladeleistung in Watt. Bisher fehlende Werte werden durch null angezeigt. Die Historie wird von hinten nach vorne gefüllt, sodass null-Werte nur geschlossen am Anfang des Arrays auftreten, falls der ESP innerhalb der letzten 48 Stunden neugestartet wurde. Es werden bis zu 720 Werte ausgegeben, das entspricht einem Messwert alle 4 Minuten. Diese Messwerte sind der jeweilige Durchschnitt dieser 4 Minuten.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

curl http://$HOST/meter/history

{
  "offset": 60927,
  "samples": [
      null, null, null, null, null, null, null, null,
      // 600 weitere null-Werte entfernt
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0,    0,    0,    0,    0,
         0,    0,    0,    0, 1736, 6656, 6655, 6666,
      6680, 6716, 6714, 6625, 6640, 6641, 6595, 6612,
      6592, 6593, 6589, 6592, 6600, 6625, 6626, 6637,
      6665, 6636, 6632, 6656, 6616, 6611, 6646, 6670,
      6691, 6715, 6787, 6754, 6761, 6797, 6771, 6685,
      6705, 6778, 6703, 6675, 6681, 6721, 6739, 6816,
      6872, 6858, 6821, 6836, 6784, 6871, 6943, 6930,
      6968, 6955, 6837, 6800, 6846, 6919, 6881, 6736,
      6671, 6655, 6674, 6743, 6878, 5733, 4462, 3712,
      3098, 2693, 2337, 2098, 1683, 1575, 1575,   84,
         0,    0,    0,    0,    0,    0,    0,    0
  ]
}

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

Name	Bedeutung
offset int (ms)	Das Alter des zuletzt gemessenen Wertes.
samples int[..]	Die gemessenen Werte.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

meter/live

HTTP (curl)

Die letzten Ladeleistungs-Messwerte. Auf Basis dieser Werte werden die Durchschnittswerte für meter/history generiert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

curl http://$HOST/meter/live

{
  "offset": 370,
  "samples_per_second": 1.99565,
  "samples": [
    2626, 2626, 2626, 2626, 2626, 2626, 2626, 2673,
    2673, 2673, 2673, 2673, 2673, 2673, 2673, 2677,
    2677, 2677, 2677, 2677, 2677, 2677, 2677, 2677,
    2677, 2677, 2677, 2677, 2677, 2677, 2677,  988,
     988,  988,  988,  988,  988,  988,  988,    3,
       3,    3,    3,    3,    3,    3,    3,    1,
       1,    1,    1,    1,    1,    1,    1,    3,
       3,    3,    3,    3,    3,    3,    3,    3,
       3,    3,    3,    3,    3,    3,    3,    3,
       3,    3,    3,    3,    3,    3,    3,    4
   ]
}

Es liegen 80 Werte vor, ~ 2 Werte pro Sekunde wurden erhoben, das Offset des letzten Werts sind 370 ms -> Die Messwerte reichen im Moment 40,370 Sekunden in die Vergangenheit.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt

Name	Bedeutung
offset int (ms)	Das Alter des zuletzt gemessenen Wertes.
samples_per_second float (Hz)	Die Anzahl der gemessenen Werte pro Sekunde.
samples int[..]	Die gemessenen Werte. Abhängig von der Länge des Arrays und dem samples_per_second-Wert kann ermittelt werden, wie weit in die Vergangenheit die Messwerte reichen.

MQTT (mosquitto)

Wird nur von der HTTP-API unterstützt