Legacy Electricity Meter API
Use meters module for new developments instead!
The legacy electricity meter API only supports one electricity meter (the one configured as linked_meter_slot in meters_legacy_api/config) and can only report and process a subset of the supported electricity meter values. The legacy API is emulated by the meters_legacy_api module module.
meter/state
The state of the electricity meter.
| Name | Description |
|---|---|
stateint | State of the electricity meter
|
typeint | Type of the installed electricity meter. Not every meter is supported by every device!
|
meter/values
The measurement values of the electricity meter. Requires the feature "meter"
# $HOST e.g. warp-AbCd
Read
curl http://$HOST/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
With MQTT on $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 | Description |
|---|---|
powerfloat (W) | The current charging power. |
energy_relfloat (kWh) | The charged energy since the last reset. |
energy_absfloat (kWh) | The charged energy since the manufacture of the electricity meter. |
meter/phases
Connected and active phases. Requires the feature "meter_phases".
# $HOST e.g. warp-AbCd
Read
curl http://$HOST/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
curl http://$HOST/meter/phases -d '{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
With MQTT on $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 | Description |
|---|---|
phases_activebool[3] | The currently active phases
|
phases_connectedbool[3] | The connected phases
|
meter/error_counters
Error counters for communication with the electricity meter.
| Name | Description |
|---|---|
meterint | (Only WARP 1) Communication errors between RS485 Bricklet and electricity meter. |
brickletint | (Only WARP 1) Communication errors between ESP Brick and RS485 Bricklet. |
bricklet_resetint | (Only WARP 1) Unexpected resets of the RS485 Bricklet. |
meter/all_values
All measurement values measured by the built-in electricity meter. Requires the feature "meter_all_values". Consecutive values marked with .. refer to the three phases L1, L2 and L3.
# $HOST e.g. warp-AbCd
Read
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
]
Write
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
]'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd
Read
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
]
Write
With MQTT on $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 | Description |
|---|---|
[0..2]float (V) | Voltage to neutral |
[3..5]float (A) | Current |
[6..8]float (W) | Active power |
[9..11]float (VA) | Apparent power |
[12..14]float (var) | Reactive power |
[15..17]float | Power factor; The sign of the power factor indicates the direction of current flow. |
[18..20]float (°) | Relative phase shift |
[21]float (V) | Average voltage to neutral |
[22]float (A) | Average current |
[23]float (A) | Sum of phase currents |
[24]float (W) | Total active power |
[25]float (VA) | Total apparent power |
[26]float (var) | Total reactive power |
[27]float | Total power factor |
[28]float (°) | Total phase shift |
[29]float (Hz) | Supply voltage frequency |
[30]float (kWh) | Active energy (import; consumed by vehicle) |
[31]float (kWh) | Active energy (export; supplied by vehicle) |
[32]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[33]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[34]float (kVAh) | Total apparent energy |
[35]float (Ah) | Transported electric charge |
[36]float (W) | Consumed active power; Equals import-export difference |
[37]float (W) | Max. consumed active power; Highest measured value |
[38]float (VA) | Consumed apparent power; Equals import-export difference |
[39]float (VA) | Max. consumed apparent power; Highest measured value |
[40]float (A) | Consumed neutral current |
[41]float (A) | Max. consumed neutral current; Highest measured value |
[42]float (V) | Voltage L1 to L2 |
[43]float (V) | Voltage L2 to L3 |
[44]float (V) | Voltage L3 to L1 |
[45]float (V) | Average voltage between phases |
[46]float (A) | Neutral current |
[47..49]float (%) | Total Harmonic Distortion (THD) of voltage |
[50..52]float (%) | Total Harmonic Distortion (THD) of current |
[53]float (%) | Average voltage THD |
[54]float (%) | Average current THD |
[55..57]float (A) | Consumed current |
[58..60]float (A) | Max. consumed current; Highest measured value |
[61]float (%) | Voltage THD L1 to L2 |
[62]float (%) | Voltage THD L2 to L3 |
[63]float (%) | Voltage THD L3 to L1 |
[64]float (%) | Average voltage THD between phases |
[65]float (kWh) | Sum of total active energies; Import-export sum of all phases |
[66]float (kvarh) | Sum of total reactive energies; Import-export sum of all phases |
[67..69]float (kWh) | Active energy (import; consumed by vehicle) |
[70..72]float (kWh) | Active energy (export; supplied by vehicle) |
[73..75]float (kWh) | Total active energy; Import-export sum |
[76..78]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[79..81]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[82..84]float (kvarh) | Total reactive energy; Import-export sum |
meter/reset
Resets the energy meter.
Empty payload. One of the following values must be passed: null, "", false, 0, [] or {}
meter/last_reset
The time of the last meter reset (see meter/reset) as Unix timestamp. 0 if no reset was performed, or if no network time synchronization was available at the time of the reset.
| Name | Description |
|---|---|
last_resetint (s) | Unix timestamp of the time of the last meter reset. |
meter/type_override
Allows overriding the installed meter type if auto-detection does not work.
# $HOST e.g. warp-AbCd
Read
curl http://$HOST/meter/type_override
Write
curl http://$HOST/meter/type_override -d ''
or abbreviated:
curl http://$HOST/meter/type_override -d ''
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/type_override
Write
With MQTT on $PREFIX/meter/type_override_update
mosquitto_pub -h $BROKER -t $PREFIX/meter/type_override_update -m ''
or abbreviated:
mosquitto_pub -h $BROKER -t $PREFIX/meter/type_override_update -m ''
| Name | Description |
|---|---|
typeint | Electricity meter type to be used
|
meter/history
A 48-hour history of charging power in watts. Missing values are indicated by null. The history is filled from back to front, so null values only occur consecutively at the beginning of the array if the ESP was restarted within the last 48 hours. Up to 720 values are output, which corresponds to one measurement value every 4 minutes. These measurement values are the respective average of these 4 minutes.
# $HOST e.g. 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
]
}
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samplesint[..] | The measured values. |
meter/live
The last charging power measurement values. Based on these values, the average values for meter/history are generated.
# $HOST e.g. 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.
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samples_per_secondfloat (Hz) | The number of measured values per second. |
samplesint[..] | The measured values. Depending on the length of the array and the samples_per_second value, it can be determined how far back in time the measurement values reach. |
meter/state
The state of the electricity meter.
| Name | Description |
|---|---|
stateint | State of the electricity meter
|
typeint | Type of the installed electricity meter. Not every meter is supported by every device!
|
meter/values
The measurement values of the electricity meter. Requires the feature "meter"
# $HOST e.g. warp2-AbCd
Read
curl http://$HOST/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp2/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
With MQTT on $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 | Description |
|---|---|
powerfloat (W) | The current charging power. |
energy_relfloat (kWh) | The charged energy since the last reset. |
energy_absfloat (kWh) | The charged energy since the manufacture of the electricity meter. |
meter/phases
Connected and active phases. Requires the feature "meter_phases".
# $HOST e.g. warp2-AbCd
Read
curl http://$HOST/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
curl http://$HOST/meter/phases -d '{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp2/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
With MQTT on $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 | Description |
|---|---|
phases_activebool[3] | The currently active phases
|
phases_connectedbool[3] | The connected phases
|
meter/error_counters
Error counters for communication with the electricity meter.
| Name | Description |
|---|---|
local_timeoutint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Local Timeout |
global_timeoutint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Global Timeout |
illegal_functionint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Function |
illegal_data_accessint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Data Access |
illegal_data_valueint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Data Value |
slave_device_failureint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Slave Device Failure |
meter/all_values
All measurement values measured by the built-in electricity meter. Requires the feature "meter_all_values". Consecutive values marked with .. refer to the three phases L1, L2 and L3.
# $HOST e.g. warp2-AbCd
Read
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
]
Write
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
]'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp2/AbCd
Read
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
]
Write
With MQTT on $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 | Description |
|---|---|
[0..2]float (V) | Voltage to neutral |
[3..5]float (A) | Current |
[6..8]float (W) | Active power |
[9..11]float (VA) | Apparent power |
[12..14]float (var) | Reactive power |
[15..17]float | Power factor; The sign of the power factor indicates the direction of current flow. |
[18..20]float (°) | Relative phase shift |
[21]float (V) | Average voltage to neutral |
[22]float (A) | Average current |
[23]float (A) | Sum of phase currents |
[24]float (W) | Total active power |
[25]float (VA) | Total apparent power |
[26]float (var) | Total reactive power |
[27]float | Total power factor |
[28]float (°) | Total phase shift |
[29]float (Hz) | Supply voltage frequency |
[30]float (kWh) | Active energy (import; consumed by vehicle) |
[31]float (kWh) | Active energy (export; supplied by vehicle) |
[32]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[33]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[34]float (kVAh) | Total apparent energy |
[35]float (Ah) | Transported electric charge |
[36]float (W) | Consumed active power; Equals import-export difference |
[37]float (W) | Max. consumed active power; Highest measured value |
[38]float (VA) | Consumed apparent power; Equals import-export difference |
[39]float (VA) | Max. consumed apparent power; Highest measured value |
[40]float (A) | Consumed neutral current |
[41]float (A) | Max. consumed neutral current; Highest measured value |
[42]float (V) | Voltage L1 to L2 |
[43]float (V) | Voltage L2 to L3 |
[44]float (V) | Voltage L3 to L1 |
[45]float (V) | Average voltage between phases |
[46]float (A) | Neutral current |
[47..49]float (%) | Total Harmonic Distortion (THD) of voltage |
[50..52]float (%) | Total Harmonic Distortion (THD) of current |
[53]float (%) | Average voltage THD |
[54]float (%) | Average current THD |
[55..57]float (A) | Consumed current |
[58..60]float (A) | Max. consumed current; Highest measured value |
[61]float (%) | Voltage THD L1 to L2 |
[62]float (%) | Voltage THD L2 to L3 |
[63]float (%) | Voltage THD L3 to L1 |
[64]float (%) | Average voltage THD between phases |
[65]float (kWh) | Sum of total active energies; Import-export sum of all phases |
[66]float (kvarh) | Sum of total reactive energies; Import-export sum of all phases |
[67..69]float (kWh) | Active energy (import; consumed by vehicle) |
[70..72]float (kWh) | Active energy (export; supplied by vehicle) |
[73..75]float (kWh) | Total active energy; Import-export sum |
[76..78]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[79..81]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[82..84]float (kvarh) | Total reactive energy; Import-export sum |
meter/reset
Resets the energy meter.
Empty payload. One of the following values must be passed: null, "", false, 0, [] or {}
meter/last_reset
The time of the last meter reset (see meter/reset) as Unix timestamp. 0 if no reset was performed, or if no network time synchronization was available at the time of the reset.
| Name | Description |
|---|---|
last_resetint (s) | Unix timestamp of the time of the last meter reset. |
meter/history
A 48-hour history of charging power in watts. Missing values are indicated by null. The history is filled from back to front, so null values only occur consecutively at the beginning of the array if the ESP was restarted within the last 48 hours. Up to 720 values are output, which corresponds to one measurement value every 4 minutes. These measurement values are the respective average of these 4 minutes.
# $HOST e.g. 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
]
}
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samplesint[..] | The measured values. |
meter/live
The last charging power measurement values. Based on these values, the average values for meter/history are generated.
# $HOST e.g. 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.
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samples_per_secondfloat (Hz) | The number of measured values per second. |
samplesint[..] | The measured values. Depending on the length of the array and the samples_per_second value, it can be determined how far back in time the measurement values reach. |
meter/state
The state of the electricity meter.
| Name | Description |
|---|---|
stateint | State of the electricity meter
|
typeint | Type of the installed electricity meter. Not every meter is supported by every device!
|
meter/values
The measurement values of the electricity meter. Requires the feature "meter"
# $HOST e.g. warp3-AbCd
Read
curl http://$HOST/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp3/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
With MQTT on $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 | Description |
|---|---|
powerfloat (W) | The current charging power. |
energy_relfloat (kWh) | The charged energy since the last reset. |
energy_absfloat (kWh) | The charged energy since the manufacture of the electricity meter. |
meter/phases
Connected and active phases. Requires the feature "meter_phases".
# $HOST e.g. warp3-AbCd
Read
curl http://$HOST/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
curl http://$HOST/meter/phases -d '{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp3/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
With MQTT on $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 | Description |
|---|---|
phases_activebool[3] | The currently active phases
|
phases_connectedbool[3] | The connected phases
|
meter/error_counters
Error counters for communication with the electricity meter.
| Name | Description |
|---|---|
local_timeoutint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Local Timeout |
global_timeoutint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Global Timeout |
illegal_functionint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Function |
illegal_data_accessint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Data Access |
illegal_data_valueint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Data Value |
slave_device_failureint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Slave Device Failure |
meter/all_values
All measurement values measured by the built-in electricity meter. Requires the feature "meter_all_values". Consecutive values marked with .. refer to the three phases L1, L2 and L3.
# $HOST e.g. warp3-AbCd
Read
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
]
Write
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
]'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp3/AbCd
Read
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
]
Write
With MQTT on $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 | Description |
|---|---|
[0..2]float (V) | Voltage to neutral |
[3..5]float (A) | Current |
[6..8]float (W) | Active power |
[9..11]float (VA) | Apparent power |
[12..14]float (var) | Reactive power |
[15..17]float | Power factor; The sign of the power factor indicates the direction of current flow. |
[18..20]float (°) | Relative phase shift |
[21]float (V) | Average voltage to neutral |
[22]float (A) | Average current |
[23]float (A) | Sum of phase currents |
[24]float (W) | Total active power |
[25]float (VA) | Total apparent power |
[26]float (var) | Total reactive power |
[27]float | Total power factor |
[28]float (°) | Total phase shift |
[29]float (Hz) | Supply voltage frequency |
[30]float (kWh) | Active energy (import; consumed by vehicle) |
[31]float (kWh) | Active energy (export; supplied by vehicle) |
[32]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[33]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[34]float (kVAh) | Total apparent energy |
[35]float (Ah) | Transported electric charge |
[36]float (W) | Consumed active power; Equals import-export difference |
[37]float (W) | Max. consumed active power; Highest measured value |
[38]float (VA) | Consumed apparent power; Equals import-export difference |
[39]float (VA) | Max. consumed apparent power; Highest measured value |
[40]float (A) | Consumed neutral current |
[41]float (A) | Max. consumed neutral current; Highest measured value |
[42]float (V) | Voltage L1 to L2 |
[43]float (V) | Voltage L2 to L3 |
[44]float (V) | Voltage L3 to L1 |
[45]float (V) | Average voltage between phases |
[46]float (A) | Neutral current |
[47..49]float (%) | Total Harmonic Distortion (THD) of voltage |
[50..52]float (%) | Total Harmonic Distortion (THD) of current |
[53]float (%) | Average voltage THD |
[54]float (%) | Average current THD |
[55..57]float (A) | Consumed current |
[58..60]float (A) | Max. consumed current; Highest measured value |
[61]float (%) | Voltage THD L1 to L2 |
[62]float (%) | Voltage THD L2 to L3 |
[63]float (%) | Voltage THD L3 to L1 |
[64]float (%) | Average voltage THD between phases |
[65]float (kWh) | Sum of total active energies; Import-export sum of all phases |
[66]float (kvarh) | Sum of total reactive energies; Import-export sum of all phases |
[67..69]float (kWh) | Active energy (import; consumed by vehicle) |
[70..72]float (kWh) | Active energy (export; supplied by vehicle) |
[73..75]float (kWh) | Total active energy; Import-export sum |
[76..78]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[79..81]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[82..84]float (kvarh) | Total reactive energy; Import-export sum |
meter/reset
Resets the energy meter.
Empty payload. One of the following values must be passed: null, "", false, 0, [] or {}
meter/last_reset
The time of the last meter reset (see meter/reset) as Unix timestamp. 0 if no reset was performed, or if no network time synchronization was available at the time of the reset.
| Name | Description |
|---|---|
last_resetint (s) | Unix timestamp of the time of the last meter reset. |
meter/history
A 48-hour history of charging power in watts. Missing values are indicated by null. The history is filled from back to front, so null values only occur consecutively at the beginning of the array if the ESP was restarted within the last 48 hours. Up to 720 values are output, which corresponds to one measurement value every 4 minutes. These measurement values are the respective average of these 4 minutes.
# $HOST e.g. 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
]
}
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samplesint[..] | The measured values. |
meter/live
The last charging power measurement values. Based on these values, the average values for meter/history are generated.
# $HOST e.g. 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.
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samples_per_secondfloat (Hz) | The number of measured values per second. |
samplesint[..] | The measured values. Depending on the length of the array and the samples_per_second value, it can be determined how far back in time the measurement values reach. |
meter/state
The state of the electricity meter.
| Name | Description |
|---|---|
stateint | State of the electricity meter
|
typeint | Type of the installed electricity meter. Not every meter is supported by every device!
|
meter/values
The measurement values of the electricity meter. Requires the feature "meter"
# $HOST e.g. wem-AbCd
Read
curl http://$HOST/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
With MQTT on $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 | Description |
|---|---|
powerfloat (W) | The current charging power. |
energy_relfloat (kWh) | The charged energy since the last reset. |
energy_absfloat (kWh) | The charged energy since the manufacture of the electricity meter. |
meter/phases
Connected and active phases. Requires the feature "meter_phases".
# $HOST e.g. wem-AbCd
Read
curl http://$HOST/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
curl http://$HOST/meter/phases -d '{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
With MQTT on $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 | Description |
|---|---|
phases_activebool[3] | The currently active phases
|
phases_connectedbool[3] | The connected phases
|
meter/error_counters
Error counters for communication with the electricity meter.
{
"local_timeout": 0,
"global_timeout": 0,
"illegal_function": 0,
"illegal_data_access": 0,
"illegal_data_value": 0,
"slave_device_failure": 0
}
| Name | Description |
|---|---|
local_timeoutint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Local Timeout |
global_timeoutint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Global Timeout |
illegal_functionint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Function |
illegal_data_accessint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Data Access |
illegal_data_valueint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Data Value |
slave_device_failureint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Slave Device Failure |
meter/all_values
All measurement values measured by the built-in electricity meter. Requires the feature "meter_all_values". Consecutive values marked with .. refer to the three phases L1, L2 and L3.
# $HOST e.g. wem-AbCd
Read
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
]
Write
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
]'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem/AbCd
Read
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
]
Write
With MQTT on $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 | Description |
|---|---|
[0..2]float (V) | Voltage to neutral |
[3..5]float (A) | Current |
[6..8]float (W) | Active power |
[9..11]float (VA) | Apparent power |
[12..14]float (var) | Reactive power |
[15..17]float | Power factor; The sign of the power factor indicates the direction of current flow. |
[18..20]float (°) | Relative phase shift |
[21]float (V) | Average voltage to neutral |
[22]float (A) | Average current |
[23]float (A) | Sum of phase currents |
[24]float (W) | Total active power |
[25]float (VA) | Total apparent power |
[26]float (var) | Total reactive power |
[27]float | Total power factor |
[28]float (°) | Total phase shift |
[29]float (Hz) | Supply voltage frequency |
[30]float (kWh) | Active energy (import; consumed by vehicle) |
[31]float (kWh) | Active energy (export; supplied by vehicle) |
[32]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[33]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[34]float (kVAh) | Total apparent energy |
[35]float (Ah) | Transported electric charge |
[36]float (W) | Consumed active power; Equals import-export difference |
[37]float (W) | Max. consumed active power; Highest measured value |
[38]float (VA) | Consumed apparent power; Equals import-export difference |
[39]float (VA) | Max. consumed apparent power; Highest measured value |
[40]float (A) | Consumed neutral current |
[41]float (A) | Max. consumed neutral current; Highest measured value |
[42]float (V) | Voltage L1 to L2 |
[43]float (V) | Voltage L2 to L3 |
[44]float (V) | Voltage L3 to L1 |
[45]float (V) | Average voltage between phases |
[46]float (A) | Neutral current |
[47..49]float (%) | Total Harmonic Distortion (THD) of voltage |
[50..52]float (%) | Total Harmonic Distortion (THD) of current |
[53]float (%) | Average voltage THD |
[54]float (%) | Average current THD |
[55..57]float (A) | Consumed current |
[58..60]float (A) | Max. consumed current; Highest measured value |
[61]float (%) | Voltage THD L1 to L2 |
[62]float (%) | Voltage THD L2 to L3 |
[63]float (%) | Voltage THD L3 to L1 |
[64]float (%) | Average voltage THD between phases |
[65]float (kWh) | Sum of total active energies; Import-export sum of all phases |
[66]float (kvarh) | Sum of total reactive energies; Import-export sum of all phases |
[67..69]float (kWh) | Active energy (import; consumed by vehicle) |
[70..72]float (kWh) | Active energy (export; supplied by vehicle) |
[73..75]float (kWh) | Total active energy; Import-export sum |
[76..78]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[79..81]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[82..84]float (kvarh) | Total reactive energy; Import-export sum |
meter/reset
Resets the energy meter.
Empty payload. One of the following values must be passed: null, "", false, 0, [] or {}
meter/last_reset
The time of the last meter reset (see meter/reset) as Unix timestamp. 0 if no reset was performed, or if no network time synchronization was available at the time of the reset.
| Name | Description |
|---|---|
last_resetint (s) | Unix timestamp of the time of the last meter reset. |
meter/history
A 48-hour history of charging power in watts. Missing values are indicated by null. The history is filled from back to front, so null values only occur consecutively at the beginning of the array if the ESP was restarted within the last 48 hours. Up to 720 values are output, which corresponds to one measurement value every 4 minutes. These measurement values are the respective average of these 4 minutes.
# $HOST e.g. 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
]
}
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samplesint[..] | The measured values. |
meter/live
The last charging power measurement values. Based on these values, the average values for meter/history are generated.
# $HOST e.g. 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.
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samples_per_secondfloat (Hz) | The number of measured values per second. |
samplesint[..] | The measured values. Depending on the length of the array and the samples_per_second value, it can be determined how far back in time the measurement values reach. |
meter/state
The state of the electricity meter.
| Name | Description |
|---|---|
stateint | State of the electricity meter
|
typeint | Type of the installed electricity meter. Not every meter is supported by every device!
|
meter/values
The measurement values of the electricity meter. Requires the feature "meter"
# $HOST e.g. wem2-AbCd
Read
curl http://$HOST/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
With MQTT on $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 | Description |
|---|---|
powerfloat (W) | The current charging power. |
energy_relfloat (kWh) | The charged energy since the last reset. |
energy_absfloat (kWh) | The charged energy since the manufacture of the electricity meter. |
meter/phases
Connected and active phases. Requires the feature "meter_phases".
# $HOST e.g. wem2-AbCd
Read
curl http://$HOST/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
curl http://$HOST/meter/phases -d '{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
With MQTT on $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 | Description |
|---|---|
phases_activebool[3] | The currently active phases
|
phases_connectedbool[3] | The connected phases
|
meter/error_counters
Error counters for communication with the electricity meter.
| Name | Description |
|---|---|
local_timeoutint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Local Timeout |
global_timeoutint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Global Timeout |
illegal_functionint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Function |
illegal_data_accessint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Data Access |
illegal_data_valueint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Data Value |
slave_device_failureint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Slave Device Failure |
meter/all_values
All measurement values measured by the built-in electricity meter. Requires the feature "meter_all_values". Consecutive values marked with .. refer to the three phases L1, L2 and L3.
# $HOST e.g. wem2-AbCd
Read
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
]
Write
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
]'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd
Read
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
]
Write
With MQTT on $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 | Description |
|---|---|
[0..2]float (V) | Voltage to neutral |
[3..5]float (A) | Current |
[6..8]float (W) | Active power |
[9..11]float (VA) | Apparent power |
[12..14]float (var) | Reactive power |
[15..17]float | Power factor; The sign of the power factor indicates the direction of current flow. |
[18..20]float (°) | Relative phase shift |
[21]float (V) | Average voltage to neutral |
[22]float (A) | Average current |
[23]float (A) | Sum of phase currents |
[24]float (W) | Total active power |
[25]float (VA) | Total apparent power |
[26]float (var) | Total reactive power |
[27]float | Total power factor |
[28]float (°) | Total phase shift |
[29]float (Hz) | Supply voltage frequency |
[30]float (kWh) | Active energy (import; consumed by vehicle) |
[31]float (kWh) | Active energy (export; supplied by vehicle) |
[32]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[33]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[34]float (kVAh) | Total apparent energy |
[35]float (Ah) | Transported electric charge |
[36]float (W) | Consumed active power; Equals import-export difference |
[37]float (W) | Max. consumed active power; Highest measured value |
[38]float (VA) | Consumed apparent power; Equals import-export difference |
[39]float (VA) | Max. consumed apparent power; Highest measured value |
[40]float (A) | Consumed neutral current |
[41]float (A) | Max. consumed neutral current; Highest measured value |
[42]float (V) | Voltage L1 to L2 |
[43]float (V) | Voltage L2 to L3 |
[44]float (V) | Voltage L3 to L1 |
[45]float (V) | Average voltage between phases |
[46]float (A) | Neutral current |
[47..49]float (%) | Total Harmonic Distortion (THD) of voltage |
[50..52]float (%) | Total Harmonic Distortion (THD) of current |
[53]float (%) | Average voltage THD |
[54]float (%) | Average current THD |
[55..57]float (A) | Consumed current |
[58..60]float (A) | Max. consumed current; Highest measured value |
[61]float (%) | Voltage THD L1 to L2 |
[62]float (%) | Voltage THD L2 to L3 |
[63]float (%) | Voltage THD L3 to L1 |
[64]float (%) | Average voltage THD between phases |
[65]float (kWh) | Sum of total active energies; Import-export sum of all phases |
[66]float (kvarh) | Sum of total reactive energies; Import-export sum of all phases |
[67..69]float (kWh) | Active energy (import; consumed by vehicle) |
[70..72]float (kWh) | Active energy (export; supplied by vehicle) |
[73..75]float (kWh) | Total active energy; Import-export sum |
[76..78]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[79..81]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[82..84]float (kvarh) | Total reactive energy; Import-export sum |
meter/reset
Resets the energy meter.
Empty payload. One of the following values must be passed: null, "", false, 0, [] or {}
meter/last_reset
The time of the last meter reset (see meter/reset) as Unix timestamp. 0 if no reset was performed, or if no network time synchronization was available at the time of the reset.
| Name | Description |
|---|---|
last_resetint (s) | Unix timestamp of the time of the last meter reset. |
meter/history
A 48-hour history of charging power in watts. Missing values are indicated by null. The history is filled from back to front, so null values only occur consecutively at the beginning of the array if the ESP was restarted within the last 48 hours. Up to 720 values are output, which corresponds to one measurement value every 4 minutes. These measurement values are the respective average of these 4 minutes.
# $HOST e.g. wem2-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
]
}
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samplesint[..] | The measured values. |
meter/live
The last charging power measurement values. Based on these values, the average values for meter/history are generated.
# $HOST e.g. wem2-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.
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samples_per_secondfloat (Hz) | The number of measured values per second. |
samplesint[..] | The measured values. Depending on the length of the array and the samples_per_second value, it can be determined how far back in time the measurement values reach. |
meter/state
The state of the electricity meter.
| Name | Description |
|---|---|
stateint | State of the electricity meter
|
typeint | Type of the installed electricity meter. Not every meter is supported by every device!
|
meter/values
The measurement values of the electricity meter. Requires the feature "meter"
# $HOST e.g. warp-AbCd
Read
curl http://$HOST/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
curl http://$HOST/meter/values -d '{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/values
{ "power": 6740.49707, "energy_rel": 4636.320801, "energy_abs": 4636.320801 }
Write
With MQTT on $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 | Description |
|---|---|
powerfloat (W) | The current charging power. |
energy_relfloat (kWh) | The charged energy since the last reset. |
energy_absfloat (kWh) | The charged energy since the manufacture of the electricity meter. |
meter/phases
Connected and active phases. Requires the feature "meter_phases".
# $HOST e.g. warp-AbCd
Read
curl http://$HOST/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
curl http://$HOST/meter/phases -d '{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/phases
{
"phases_connected": [true, false, false],
"phases_active": [true, false, false]
}
Write
With MQTT on $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 | Description |
|---|---|
phases_activebool[3] | The currently active phases
|
phases_connectedbool[3] | The connected phases
|
meter/error_counters
Error counters for communication with the electricity meter.
| Name | Description |
|---|---|
meterint | (Only WARP 1) Communication errors between RS485 Bricklet and electricity meter. |
brickletint | (Only WARP 1) Communication errors between ESP Brick and RS485 Bricklet. |
bricklet_resetint | (Only WARP 1) Unexpected resets of the RS485 Bricklet. |
local_timeoutint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Local Timeout |
global_timeoutint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Global Timeout |
illegal_functionint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Function |
illegal_data_accessint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Data Access |
illegal_data_valueint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Illegal Data Value |
slave_device_failureint | (Only WARP 2 and WARP 3 and Energy Manager and Energy Manager 2.0) Slave Device Failure |
meter/all_values
All measurement values measured by the built-in electricity meter. Requires the feature "meter_all_values". Consecutive values marked with .. refer to the three phases L1, L2 and L3.
# $HOST e.g. warp-AbCd
Read
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
]
Write
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
]'
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd
Read
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
]
Write
With MQTT on $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 | Description |
|---|---|
[0..2]float (V) | Voltage to neutral |
[3..5]float (A) | Current |
[6..8]float (W) | Active power |
[9..11]float (VA) | Apparent power |
[12..14]float (var) | Reactive power |
[15..17]float | Power factor; The sign of the power factor indicates the direction of current flow. |
[18..20]float (°) | Relative phase shift |
[21]float (V) | Average voltage to neutral |
[22]float (A) | Average current |
[23]float (A) | Sum of phase currents |
[24]float (W) | Total active power |
[25]float (VA) | Total apparent power |
[26]float (var) | Total reactive power |
[27]float | Total power factor |
[28]float (°) | Total phase shift |
[29]float (Hz) | Supply voltage frequency |
[30]float (kWh) | Active energy (import; consumed by vehicle) |
[31]float (kWh) | Active energy (export; supplied by vehicle) |
[32]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[33]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[34]float (kVAh) | Total apparent energy |
[35]float (Ah) | Transported electric charge |
[36]float (W) | Consumed active power; Equals import-export difference |
[37]float (W) | Max. consumed active power; Highest measured value |
[38]float (VA) | Consumed apparent power; Equals import-export difference |
[39]float (VA) | Max. consumed apparent power; Highest measured value |
[40]float (A) | Consumed neutral current |
[41]float (A) | Max. consumed neutral current; Highest measured value |
[42]float (V) | Voltage L1 to L2 |
[43]float (V) | Voltage L2 to L3 |
[44]float (V) | Voltage L3 to L1 |
[45]float (V) | Average voltage between phases |
[46]float (A) | Neutral current |
[47..49]float (%) | Total Harmonic Distortion (THD) of voltage |
[50..52]float (%) | Total Harmonic Distortion (THD) of current |
[53]float (%) | Average voltage THD |
[54]float (%) | Average current THD |
[55..57]float (A) | Consumed current |
[58..60]float (A) | Max. consumed current; Highest measured value |
[61]float (%) | Voltage THD L1 to L2 |
[62]float (%) | Voltage THD L2 to L3 |
[63]float (%) | Voltage THD L3 to L1 |
[64]float (%) | Average voltage THD between phases |
[65]float (kWh) | Sum of total active energies; Import-export sum of all phases |
[66]float (kvarh) | Sum of total reactive energies; Import-export sum of all phases |
[67..69]float (kWh) | Active energy (import; consumed by vehicle) |
[70..72]float (kWh) | Active energy (export; supplied by vehicle) |
[73..75]float (kWh) | Total active energy; Import-export sum |
[76..78]float (kvarh) | Reactive energy (import; consumed by vehicle) |
[79..81]float (kvarh) | Reactive energy (export; supplied by vehicle) |
[82..84]float (kvarh) | Total reactive energy; Import-export sum |
meter/reset
Resets the energy meter.
Empty payload. One of the following values must be passed: null, "", false, 0, [] or {}
meter/last_reset
The time of the last meter reset (see meter/reset) as Unix timestamp. 0 if no reset was performed, or if no network time synchronization was available at the time of the reset.
| Name | Description |
|---|---|
last_resetint (s) | Unix timestamp of the time of the last meter reset. |
meter/type_override
(Only WARP 1) Allows overriding the installed meter type if auto-detection does not work.
# $HOST e.g. warp-AbCd
Read
curl http://$HOST/meter/type_override
Write
curl http://$HOST/meter/type_override -d ''
or abbreviated:
curl http://$HOST/meter/type_override -d ''
# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd
Read
mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/meter/type_override
Write
With MQTT on $PREFIX/meter/type_override_update
mosquitto_pub -h $BROKER -t $PREFIX/meter/type_override_update -m ''
or abbreviated:
mosquitto_pub -h $BROKER -t $PREFIX/meter/type_override_update -m ''
| Name | Description |
|---|---|
typeint | Electricity meter type to be used
|
meter/history
A 48-hour history of charging power in watts. Missing values are indicated by null. The history is filled from back to front, so null values only occur consecutively at the beginning of the array if the ESP was restarted within the last 48 hours. Up to 720 values are output, which corresponds to one measurement value every 4 minutes. These measurement values are the respective average of these 4 minutes.
# $HOST e.g. 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
]
}
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samplesint[..] | The measured values. |
meter/live
The last charging power measurement values. Based on these values, the average values for meter/history are generated.
# $HOST e.g. 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.
Only supported by the HTTP API
| Name | Description |
|---|---|
offsetint (ms) | The age of the last measured value. |
samples_per_secondfloat (Hz) | The number of measured values per second. |
samplesint[..] | The measured values. Depending on the length of the array and the samples_per_second value, it can be determined how far back in time the measurement values reach. |