Zum Hauptinhalt springen

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.

meter/state​

Der Zustand des Stromzählers.

Beispiel
# $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 }'
NameBedeutung
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
# $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 }'
NameBedeutung
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
# $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]
}'
NameBedeutung
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
# $HOST z.B. warp-AbCd

Lesen​

curl http://$HOST/meter/error_counters
{ "meter": 0, "bricklet": 0, "bricklet_reset": 0 }
NameBedeutung
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
# $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
  ]'
IndexBedeutung
[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 {}

Beispiel
# $HOST z.B. warp-AbCd

Schreiben​

curl http://$HOST/meter/reset -d '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
# $HOST z.B. warp-AbCd

Lesen​

curl http://$HOST/meter/last_reset
{ "last_reset": 1714728252 }

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

NameBedeutung
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
# $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 ''
NameBedeutung
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​

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
# $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
  ]
}
NameBedeutung
offset
int (ms)

Das Alter des zuletzt gemessenen Wertes.

samples
int[..]

Die gemessenen Werte.




meter/live​

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

Beispiel
# $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.

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