Tuya Developer PlatformCloud DevelopmentStandard Instruction SetEnergySmart Electricity Meter (zndb)Status Set: zndb

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

Prev DocInstruction Set: zndb

Next DocSmart Water Meter (znsb)