智能水表(znsb)标准指令集

更新时间:2022-01-13 06:22:21下载pdf

Code 名称 取值类型 取值说明
switch_code 阀门开关 Boolean {}
frozen_time 月冻结、日冻结设置 Json {}
active_time 生效时间 Json {}
alarm_set_water 水表告警设置 Json {}
auto_clean 阀门清洗开关 Boolean {}
charge_money 水费充值 Integer {“unit”:“¥”,“min”:0,“max”:999999,“scale”:2,“step”:1}
clear_balance 剩余可用金额清零 Boolean {}
water_data_daily 日用水量 Json {}
water_data_month 月用水量 Json {}
step_tariff_price 阶梯用水量阈值及单价 Json {}
switch_prepayment 预付费功能开关 Boolean {}

标准指令示例

water_data_month

表示水表的月间用水量。

  • 取值说明

    • startYear:开始的年份,整数型。
    • startMonth:开始的月份,整数型。
    • endYear:结束的年份,整数型。
    • endMonth:结束的月份,整数型。
  • 代码示例
    从20年12月到21年1月的总用水量。

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

water_data_daily

表示水表的日用水量。

  • 取值说明

    • “startMonth”:开始月份,整数型。
    • “startDay”:开始日期,整数型。
    • “endMonth”:结束月份,整数型。
    • “endDay” :结束日期,整数型。
  • 代码示例
    从1月31号到2月15号的总用水量。

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

frozen_time

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

  • 取值说明

    • “day”:月冻结时间,默认为 1 日,可选择 1~28 日,整数型。
    • “hour”:日冻结时间,默认为 0 时,可选择 0~23 时,整数型。
  • 代码示例
    每月 1 日 10 点记录水表信息。

    { "code": "frozen_time", "value": { "day":1, "hour":10 } }

step_tariff_price

水表的阶梯用水量阈值及单价设置。

  • 取值说明
    用水量阈值为整数,单位立方米。单价保留两位小数,单位元

    • “firstStep”:第一阶梯用水量阈值。
    • “firstPrice”:第一阶梯用单价。
    • “secondStep”:第二阶梯用水量阈值。
    • “secondPrice”:第二阶梯用单价。
    • “thirdStep”:第三阶梯用水量阈值。
    • “thirdPrice”:第三阶梯用单价。
  • 代码示例
    表示第一阶梯水量 5 立方米,单价 3.50 元,第二阶梯水量 10 立方米,单价 4.00 元。第三阶梯水量 20 立方米,单价 5.20 元。

    { "code":"step_tariff_price", "value":{ "firstStep":5, "firstPrice":3.50, "secondStep":10, "secondPrice":4.00, "thirdStep":20, "thirdPrice":5.20 } }

active_time

水表新阶梯费用生效时间设置 。

  • 取值说明

    • year:生效年份,整数型。
    • month:生效月份,整数型。
    • day:生效日期,整数型。
    • hour:生效整点,整数型。
    • minue:生效分,整数型。
  • 代码示例
    新的生效时间为 2020 年 5 月 18 日 23 时 55 分。

    { "code":"active_time", "value":{ "year":20, "month":5, "day":18, "hour":23, "minute":55 } }

alarm_set_water

设置水表的告警

  • 取值说明

    • alarmCode:告警类型,[“voltage”,“magnetic”,“valve”,“remove”,“fault”,“balance”,“arrears”,“daily”,“month”]。
    • doAction:布尔类型。
      • true:告警时关闭阀门
      • false:告警时不关闭阀门
    • threshold:阈值,部分告警类型支持。
  • alarmCode参数说明
    * voltage: 电池欠压告警 ,阈值默认 2.50V,范围 1.00~10.00V,小数点两位。
    * magnetic: 磁影响告警。
    * valve: 阀不到位告警。默认10,范围1~100,单位%,整数。
    * remove: 防拆告警。
    * fault: 水表硬件故障告警。
    * balance: 余额不足告警(预付费功能)默认20.00,范围1.00~200.00,小数点两位,单位元。
    * arrears: 欠费告警。
    * daily: 日用水过量阀值设置。默认 1.0,范围 0.1~10.0,精确到小数点后 1 位,单位立方米。
    * month: 月用水过量阀值设置。默认 1.0,范围 0.1~300.0,精确到小数点后 1 位,单位立方米。

  • 代码示例
    该水表具备电池欠压告警和磁影响告警告警。电池电压低于 2.50V 时告警,会关闭阀门。磁影响告警时不关闭阀门,其余报警不具备。

    { "code":"alarm_set_water", "value":[ { "alarmCode":"voltage", "doAction":true, "threshold":2.5 }, { "alarmCode":"magnetic", "doAction":false } ] }