Last Updated on : 2022-01-13 06:22:06download
This topic describes the standard status set of smart electricity meters (zndb).
Code |
Name |
Type | Value description |
---|---|---|---|
alarm_set_2 | Alarm settings | Json | {} |
balance_energy | Remaining battery capcacity | Integer | {“unit”:“kW·h”,“min”:0,“max”:5000, “scale”:0,“step”:1} |
charge_energy | Topup | Integer | {“unit”:“kW·h”,“min”:0,“max”:5000, “scale”:0,“step”:1} |
clear_energy | Clearing of the reading | Boolean | {} |
event_clear | Clearing of events | Boolean | {} |
energy_daily | Daily electricity consumption data | Json | {} |
frozen_time_set | Freezing time settings | Json | {} |
imei_imsi | International Mobile Equipment Identity (IMEI) and International Mobile Subscriber Identity (IMSI) | Json | {} |
meter_id | Meter ID | String | {“maxlen”:255} |
energy_month | Monthly electricity consumption data | Json | {} |
phase_a | Report phase-A voltage, current, and power | Json | {} |
phase_b | Report phase-B voltage, current, and power | Json | {} |
phase_c | Report phase-C voltage, current, and power | Json | {} |
switch | Switch | Boolean | {} |
switch_prepayment | Prepaid function switch | Boolean | {} |
forward_energy_total | Forward total active electricity | Integer | { “unit”: “kW·h”, “min”: 0, “max”: 99999999, “scale”: 2, “step”: 1 } |
reverse_energy_total | Reverse total active electricity | Integer | { “unit”: “kW·h”, “min”: 0, “max”: 99999999, “scale”: 2, “step”: 1 } |
total_power | Total power | Integer | {“unit”:“kW”,“min”:0,“max”:900000, “scale”:3,“step”:1} |
forward_energy_t1 | Active electricity of tier 1 rate | Integer | {“unit”:“kWh”,“min”:0,“max”:99999999, “scale”:2,“step”:1} |
forward_energy_t2 | Active electricity of tier 2 rate | Integer | {“unit”:“kWh”,“min”:0,“max”:99999999, “scale”:2,“step”:1} |
forward_energy_t3 | Active electricity of tier 3 rate | Integer | {“unit”:“kWh”,“min”:0,“max”:99999999, “scale”:2,“step”:1} |
forward_energy_t4 | Active electricity of tier 4 rate | Integer | {“unit”:“kWh”,“min”:0,“max”:99999999, “scale”:2,“step”:1} |
for_energy_t1_stamp | Active electricity of tier 1 rate plus a timestamp | String | {} |
for_energy_t2_stamp | Active electricity of tier 2 rate plus a timestamp | String | {} |
for_energy_t3_stamp | Active electricity of tier 3 rate plus a timestamp | String | {} |
for_energy_t4_stamp | Active electricity of tier 4 rate plus a timestamp | String | {} |
for_energy_tal_stamp | Active electricity of total plus a timestamp | String | {} |
fault | Fault alarm | Bitmap | {“label”:[“ov_cr”,“unbalance_alarm”,“ov_vol”,“undervoltage_alarm”,“miss_phase_alarm”,“outage_alarm”,“magnetism_alarm”,“terminal_alarm”,“cover_alarm”,“credit_alarm”,“no_balance_alarm”,“battery_alarm”,“meter_hardware_alarm”]} |
Display the monthly electricity consumption.
Value description
startYear
: the year when the statistics start, an integer type.startMonth
: the month when the statistics start, an integer type.endYear
: the year when the statistics end, an integer type.endMonth
: the month when the statistics end, an integer type.electricTotal
: the total electricity consumption in kWh that is rounded to two decimal places.Sample code
The total electricity consumption from December 2020 to January 2021 was 20.38 kWh.
{
"code": "energy_month",
"value": "{\"startYear\":20,\"startMonth\":12,\"endYear\":21,\"endMonth\":1,\"electricTotal\":20.38}"
}
Display the daily electricity consumption.
Value description
startMonth
: the month when the statistics start, an integer type.startDay
: the day when the statistics start, an integer type.endMonth
: the month when the statistics end, an integer type.endDay
: the date when the statistics end, an integer type.electricTotal
: the total electricity consumption in kWh that is rounded to two decimal places.Sample code
The total electricity consumption from January 31 to February 15 was 9.58 kWh.
{
"code": "energy_daily",
"value": "{\"startMonth\":1,\"startDay\":31,\"endMonth\":2,\"endDay\":15,\"electricTotal\":9.58}"
}
Set the monthly and daily freezing times of the electricity meter. The freezing time is the time for the meter to automatically record the current meter information.
Value description
day
: monthly freezing time. The value is an integer. Valid values: 1 to 28. Default value: 1.hour
: daily freezing time. The value is an integer. Valid values: 0 to 23. Default value: 0.Sample code
Record the meter information at 23:00 on the 28th day of each month.
{
"code": "frozen_time",
"value": "{\"day\":28,\"hour\":23}"
}
Report phase-A voltage, current, and power.
Value description
voltage
: voltage in the unit of V. The value is rounded to one decimal place.electricCurrent
: current in the unit of A. The value is rounded to three decimal places.power
: power in the unit of kW. The value is rounded to three decimal places.Sample code
Phase-A voltage is 217.6V, the current is 1.000A, and the power is 10.000 kW.
{
"code": "phase_a",
"value": "{\"voltage\":217.6,\"electricCurrent\":1.000,\"power\":10.000}"
}
Report phase-B voltage, current, and power.
Value description
voltage
: voltage in the unit of V. The value is rounded to one decimal place.electricCurrent
: current in the unit of A. The value is rounded to three decimal places.power
: power in the unit of kW. The value is rounded to three decimal places.Sample code
Phase-B voltage is 217.6V, the current is 1.000A, and the power is 10.000 kW.
{
"code": "phase_b",
"value": "{\"voltage\":217.6,\"electricCurrent\":1.000,\"power\":10.000}"
}
Report phase-C voltage, current, and power.
Value description
voltage
: voltage in the unit of V. The value is rounded to one decimal place.electricCurrent
: current in the unit of A. The value is rounded to three decimal places.power
: power in the unit of kW. The value is rounded to three decimal places.Sample code
Phase-C voltage is 217.6V, the current is 1.000A, and the power is 10.000 kW.
{
"code": "phase_c",
"value": "{\"voltage\":217.6,\"electricCurrent\":1.000,\"power\":10.000}"
}
Set alarm rules for the electricity meter.
Value description
alarmCode
: alarm type.[" overcurrent",“three_phase_current_imbalance”,“ammeter_overvoltage”,“under_voltage”,“three_phase_current_loss”,“power_failure”,“magnetic”,“insufficient_balance”,"arrears,“battery_overvoltage”,“cover_open”,“meter_cover_open”,“fault”]doAction
: Boolean type.
true
: switch off the meter when an alarm is triggered.false
: do not switch off the meter when an alarm is triggered.threshold
: the threshold that is supported by specific alarm types.alarmCode
parameter description
overcurrent
: the overcurrent alarm in integer type. Valid values: 10A to 100A. Default value: 60A.three_phase_current_imbalance
: the alarm of imbalanced three-phase current. Valid values: 10% to 100%. Default value: 10%. In integer type.ammeter_overvoltage
: overvoltage alarm. The value is an integer. Valid values: 100V to 270V. Default value: 245V.under_voltage
: under-voltage alarm. The value is an integer. Valid values: 90V to 250V. Default value: 180V.three_phase_current_loss
: the alarm of three-phase phase loss.power_failure
: the alarm of a power failure event. A power fault that is followed by powering on is regarded as an event.magnetic
: magnetic influence alarm.insufficient_balance
: insufficient balance alarm. The value is an integer. Valid values: 10 kWh to 500 kWh. Default value: 30 kWh.arrears
: the alarm of an outstanding payment.battery_overvoltage
: battery under-voltage alarm. Valid values: 2V to 10V. Default value: 3.30V. The value is rounded to two decimal places.cover_open
: An alarm is triggered when the end cover is opened.meter_cover_open
: An alarm is triggered when the meter cover is opened.fault
: the alarm of a meter hardware fault. For example, a fault might occur in the storage, relay, or real-time clock (RTC).Sample code
The smart meter has an overcurrent alarm, magnetic influence alarm, and battery under-voltage alarm. When the current is higher than 11A, an alarm is triggered and the switch is opened. The switch will not be opened in case of a magnetic influence alarm. When the battery voltage is lower than 2.10V, an alarm is triggered and the switch is opened.
{
"code": "alarm_set_2",
"value": "[ {\"alarmCode\":\"overcurrent\",\"doAction\":true,\"threshold\":\"11\"}, {\"alarmCode\":\"magnetic\",\"doAction\":false}, {\"alarmCode\":\"battery_overvoltage\",\"doAction\":false,\"threshold\":\"2.10\"} ]"
}
IMEI and IMSI of the electricity meter.
Value description
Sample code
{
"code": "imei_imsi",
"value": "{\"IMEI\":\"86423704007****\",\"IMSI\":\"46011304608****\"}"
},
Active electricity of tier 1 rate plus a timestamp
Note: The parsing methods of
for_energy_t2_stamp
,for_energy_t3_stamp
, andfor_energy_t4_stamp
, andfor_energy_tal_stamp
are the same as that offor_energy_t1_stamp
.
Sample code
{
"code": "for_energy_t1_stamp",
"value": "{\"year\":20,\"month\":12,\"date\":1,\"hour\":12,\"minute\":16,\"second\":50,\"power\":1.95}"
},
Is this page helpful?
YesFeedbackIs this page helpful?
YesFeedback