|
|
@@ -0,0 +1,162 @@
|
|
|
+# 杀虫灯与服务器端交互的通讯细节
|
|
|
+
|
|
|
+## 1. 简要描述
|
|
|
+
|
|
|
+本文档主要用于阐述杀虫灯与服务器端进行交互的通讯细节。
|
|
|
+
|
|
|
+## 2. 通信描述
|
|
|
+
|
|
|
+需要接收方编写接口以接收数据，使用 POST 请求。数据分为 `status`、`data` 和 `offline` 类型，可以共用一个接口，并根据 `cmd` 字段进行解析。
|
|
|
+
|
|
|
+## 3. 状态报告
|
|
|
+
|
|
|
+### 报文结构
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "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 用于内部调试
|
|
|
+4. 数据报告
|
|
|
+报文结构
|
|
|
+```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
|
|
|
+5. 遗愿消息
|
|
|
+设备默认设置了 MQTT 遗愿消息。当设备异常下线时（客户端断开前未向服务器发送 DISCONNECT 消息），MQTT 消息服务器会发布异常下线设备的遗愿消息。
|
|
|
+
|
|
|
+订阅设备遗愿消息，可实现对设备在线和离线状态的监控。
|
|
|
+
|
|
|
+离线消息主题
|
|
|
+/yfkj/scd/offline/<imei>
|
|
|
+
|
|
|
+报文结构
|
|
|
+```json
|
|
|
+{
|
|
|
+ "payload": {
|
|
|
+ "cmd": "offline",
|
|
|
+ "ext": {
|
|
|
+ "imei": "865650043207246"
|
|
|
+ }
|
|
|
+ },
|
|
|
+ "topic": "/yfkj/scd/pub/865650043207246"
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+
|
zhangwd
