智能电表（zndb）标准指令集

标准指令示例

energy_month

以月为单位统计用电量。

• 取值说明
  • startYear：统计开始的年份，整数型。
  • startMonth：统计开始的月份，整数型。
  • endYear：统计结束的年份，整数型。
  • endMonth：统计结束的月份，整数型。
• 代码示例
  获取从 2020 年 12 月到 2021 年 1 月的总用电量。

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

energy_daily

以日为单位统计用电量。

• 取值说明

  • “startMonth”：统计开始月份，整数型。
  • “startDay”：统计开始日期，整数型。
  • “endMonth”：统计结束月份，整数型。
  • “endDay” ：统计结束日期，整数型。

• 代码示例
  获取从 1 月 31 日到 2 月 15 号的总用电量。

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

frozen_time_set

设置电表月冻结、日冻结时间。冻结时间为电表自动记录当前电表信息的时间。

• 取值说明

  • “day”：月冻结时间。默认为 1 日，可选择 1~28 日，整数型。
  • “hour”：日冻结时间。默认为 0 时，可选择 0~23 时，整数型。

• 代码示例
  每月 28 日 23 点记录电表信息。

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

alarm_set_2

设置电表的告警。

• 取值说明

  • alarmCode：告警类型，[“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：布尔类型。
    • true：告警时拉闸
    • false：告警时不拉闸
  • threshold：阈值，部分告警类型支持。

• alarmCode 参数说明

  • overcurrent： 过流告警 ，阈值默认 60A，范围 10~100，整数，单位 A。
  • three_phase_current_imbalance： 三相电流不平衡告警。默认阈值 10，范围 10~100，单位%，整数。
  • ammeter_overvoltage： 过压告警。默认 245，范围 100~270，单位 V，整数。
  • under_voltage： 欠压告警。默认 180，范围 90~250，单位 V，整数。
  • three_phase_current_loss： 三相缺相告警。
  • power_failure： 停电事件告警（停电再上电算一次事件）。
  • magnetic： 磁影响告警。
  • insufficient_balance： 余额不足告警。默认 30，范围 10~500，单位 kWh，整数。
  • arrears： 欠费告警。
  • battery_overvoltage：电池欠压告警。默认 3.30，范围 2~10,小数点后 2 位，单位 V。
  • cover_open： 开端盖告警。
  • meter_cover_open： 开表盖告警。
  • fault： 电表自身硬件故障告警（存储，继电器，RTC等）。

• 代码示例
  该电表具备过流告警，磁影响告警和电池欠压告警。流过的电流高于 11A 时告警，会拉闸。磁影响告警时不拉闸。电池电压低于 2.10V 时告警，会拉闸。

  {
  	"code":"alarm_set_2",
  	"value":"[{\"alarmCode\":\"overcurrent\",\"doAction\":true,\"threshold\":\"11\"},{\"alarmCode\":\"magnetic\",\"doAction\":false},{\"alarmCode\":\"battery_overvoltage\",\"doAction\":false,\"threshold\":\"2.10\"}]"
  }