English
English
简体中文
Contact Us
Register
Log In
layoutIndex

Standard Status Set

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”]}

Examples of standard status

energy_month

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}"
    }
    

energy_daily

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}"
    
    }
    

frozen_time_set

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}"
    }
    

phase_a

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}"
	}

phase_b

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}"
    }
    

phase_c

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}"
    }
    

alarm_set_2

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_imsi

IMEI and IMSI of the electricity meter.

  • Value description

    • IMEI: International Mobile Equipment Identity of the electricity meter.
    • IMSI: International Mobile Subscriber Identity of the electricity meter.
  • Sample code

    
    {
    	"code": "imei_imsi",
    	"value": "{\"IMEI\":\"86423704007****\",\"IMSI\":\"46011304608****\"}"
    },
    

for_energy_t1_stamp

Active electricity of tier 1 rate plus a timestamp

Note: The parsing methods of for_energy_t2_stamp, for_energy_t3_stamp, and for_energy_t4_stamp, and for_energy_tal_stamp are the same as that of for_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}"
    },