yfdoc/zh-cn/scd-sq/scd-sq.md

杀虫灯与服务器端交互的通讯细节

1. 简要描述

本文档主要用于阐述杀虫灯与服务器端进行交互的通讯细节。

2. 通信描述

需要接收方编写接口以接收数据，使用 POST 请求。数据分为 status、data 和 offline 类型，可以共用一个接口，并根据 cmd 字段进行解析。

3. 状态报告

报文结构

{
  "payload": {
    "cmd": "status",
    "ext": {
      "imei": "865650043207246",
      "iccid": "89860401101700076471",
      "csq": 29,
      "dtype": 1,
      "dver": "1.0.0",
      "stm8vs": "100",
      "ws": 0,
      "ds": 1,
      "tt": 7,
      "tbs": 0,
      "lps": 0,
      "rps": 0,
      "tps": 0,
      "dps": 0,
      "bt": 25,
      "tcs": 0,
      "st": 20,
      "et": 2,
      "clt": 30,
      "dattim": 30,
      "voltval": 40,
      "gps": 1,
      "lng": "113.67336",
      "lat": "34.815187",
      "stamp": "20180301211805",
      "info": 2
    }
  },
  "topic": "/yfkj/scd/pub/865650043207246"
}

字段说明 字段 描述 imei 通讯板唯一 ID iccid SIM 卡卡号 csq 信号强度 dtype 设备类型（杀虫灯设备类型为 2） dver 设备固件版本 stm8vs STM8 主板代码版本号 ws 工作状态 (0: 待机, 1: 工作, 2: 充电) ds 设备开关 (0: 关机, 1: 开机) tt 定时时长 (0~7 小时), 0 表示常亮 tbs 灯管状态 (0: 正常, 1: 保护) lps 光控状态 (0: 正常, 1: 保护) rps 雨控状态 (0: 正常, 1: 保护) tps 温控状态 (0: 正常, 1: 保护) dps 倾倒状态 (0: 正常, 1: 保护) bt 主板温度 (默认主板温度：25) tcs 时控开关 (0: 关闭, 1: 开启) st 时控开始时间 (单位:小时) et 时控结束时间 (单位:小时) clt 清虫时间间隔 (单位:分钟) dattim 数据上报时间间隔 (单位:分钟) voltval 用于内部调试 gps 定位方式 (0: 手动定位, 1: GPS 定位, 2: LBS 定位) lng 经度 lat 纬度 stamp 时间戳：20180301211805 info 用于内部调试

1. 数据报告 报文结构 json { "payload": { "cmd": "data", "ext": { "imei": "865650043207246", "ds": 1, "ws": 0, "tt": 7, "tbs": 0, "lps": 0, "rps": 0, "tps": 0, "dps": 0, "cv": 18000, "bv": 12800, "at": "0", "ah": "0", "ct": 200, "clt": 30, "gps": 1, "lng": "113.67336", "lat": "34.815187", "rcnt": "1", "err": 2, "tcs": 0, "st": 20, "et": 2, "stamp": "20180301211805" } }, "topic": "/yfkj/scd/pub/865650043207246" }

字段说明 字段 描述 imei 通讯板唯一 ID ds 设备开关 (0: 关机, 1: 开机) ws 工作状态 (0: 待机, 1: 工作, 2: 充电) tt 定时时长 (0~7 小时), 0 表示常亮 tbs 灯管状态 (0: 正常, 1: 保护) lps 光控状态 (0: 正常, 1: 保护) rps 雨控状态 (0: 正常, 1: 保护) tps 温控状态 (0: 正常, 1: 保护) dps 倾倒状态 (0: 正常, 1: 保护) cv 充电电压 mV bv 电池电压 mV at 环境温度 ah 环境湿度 ct 电击次数 范围 0~255 (每上报一次数据消息后清零) clt 清虫时间间隔 (单位:分钟) gps 定位方式 (0: 手动定位, 1: GPS 定位, 2: LBS 定位) lat 纬度 lng 经度 rcnt 设备重启次数 err 用于内部调试 st 时控开始时间 (单位:小时) et 时控结束时间 (单位:小时) stamp 时间戳：20180301211805

1. 遗愿消息 设备默认设置了 MQTT 遗愿消息。当设备异常下线时（客户端断开前未向服务器发送 DISCONNECT 消息），MQTT 消息服务器会发布异常下线设备的遗愿消息。

订阅设备遗愿消息，可实现对设备在线和离线状态的监控。

离线消息主题 /yfkj/scd/offline/

报文结构

{
  "payload": {
    "cmd": "offline",
    "ext": {
      "imei": "865650043207246"
    }
  },
  "topic": "/yfkj/scd/pub/865650043207246"
}