Standard Instruction Set

This topic describes the standard instruction set of smart electricity meters (zndb).

Examples of standard instructions

energy_month

Display the monthly electricity consumption.

• Description

  • startYear: the year when the statistics starts, in integer type.
  • startMonth: the month when the statistics starts, in integer type.
  • endYear: the year when the statistics ends, in integer type.
  • endMonth: the month when the statistics ends, in integer type.

• Code example
  Get the total electricity consumption from December 2020 to January 2021.

  {
  	"code": "energy_month",
  	"value": "{\"startYear\":20,\"startMonth\":12,\"endYear\":21,\"endMonth\":1}"
  }
  

energy_daily

Display the daily electricity consumption.

• Description

  • startMonth: the month when the statistics starts, in integer type.
  • startDay: the day when the statistics starts, in integer type.
  • endMonth: the month when the statistics ends, in integer type.
  • endDay: the day when the statistics ends, in integer type.

• Code example
  Get the total electricity consumption from January 31 to February 15.

  {
  
  	"code": "energy_daily",
  	"value": "{\"startMonth\":1,\"startDay\":31,\"endMonth\":2,\"endDay\":15}"
  
  }
  

frozen_time_set

Set the monthly and daily freezing time of the electricity meter. The freezing time is the time for the meter to automatically record the current meter information.

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

• Code example
  Record the meter information at 23:00 on the 28th of each month.

  {
  	"code": "frozen_time",
  	"value": "{\"day\":28,\"hour\":23}"
  }
  

alarm_set_2

Set the alarm of the electricity meter.

• 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: overcurrent alarm. The value is an integer. Valid values: 10A to 100A. Default value: 60A.
  • three_phase_current_imbalance: the alarm of imbalanced three-phase current. The value is an integer. Valid values: 10% to 100%. Default value: 10%.
  • 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).

• Code example
  The meter supports overcurrent alarms, magnetic influence alarms, and battery under-voltage alarms. If 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. If 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\"}]"
  }