|
|
@@ -1,4 +1,4 @@
|
|
|
-# 杀虫灯与服务器端交互的通讯细节
|
|
|
+# 杀虫灯http协议
|
|
|
|
|
|
## 1. 简要描述
|
|
|
|
|
|
@@ -48,34 +48,37 @@
|
|
|
"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 用于内部调试
|
|
|
+字段说明
|
|
|
+
|
|
|
+| 字段 | 描述 |
|
|
|
+|----------|-------------------------------|
|
|
|
+| 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
|
|
|
@@ -113,32 +116,35 @@ info 用于内部调试
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-字段说明
|
|
|
-字段 描述
|
|
|
-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. 遗愿消息
|
|
|
+字段说明
|
|
|
+
|
|
|
+| 字段 | 描述 |
|
|
|
+|----------|-------------------------------|
|
|
|
+| 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 |
|
|
|
+
|
|
|
+### 遗愿消息
|
|
|
设备默认设置了 MQTT 遗愿消息。当设备异常下线时（客户端断开前未向服务器发送 DISCONNECT 消息），MQTT 消息服务器会发布异常下线设备的遗愿消息。
|
|
|
|
|
|
订阅设备遗愿消息，可实现对设备在线和离线状态的监控。
|
|
|
@@ -172,11 +178,7 @@ stamp 时间戳：20180301211805
|
|
|
|
|
|
|
|
|
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-# 物联网杀虫灯通讯约定
|
|
|
+# 杀虫灯mqtt协议
|
|
|
|
|
|
## 1. 物联网杀虫灯通讯约定
|
|
|
|
|
|
@@ -213,7 +215,7 @@ stamp 时间戳：20180301211805
|
|
|
|
|
|
## 2. 通信协议
|
|
|
|
|
|
-### 2.1. MQTT 协议版本
|
|
|
+### 2.1. MQTT协议版本
|
|
|
|
|
|
物联网杀虫灯使用主流公开的 MQTT 协议 V3.1.1 版本作为通讯协议，默认 QOS 质量等级为 0。服务器端需要实现 MQTT 协议的转发和解析，数据的上报为 JSON 格式。
|
|
|
|
|
|
@@ -255,14 +257,10 @@ MQTT V3.1.1 协议详见附件。
|
|
|
协议命令字 cmd：为报文分类定义的英文标识。
|
|
|
ext：为各个命令字对应的信息内容。
|
|
|
以上数据内容为 JSON 格式。
|
|
|
-这个 Markdown 文档包含了所有你需要的信息，并且格式清晰易读。如果有任何进一步的需求或问题，请随时告诉我！
|
|
|
-
|
|
|
-
|
|
|
|
|
|
|
|
|
|
|
|
-
|
|
|
-2.4. 上行通信
|
|
|
+### 上行通信
|
|
|
2.4.1. 状态报告
|
|
|
报文结构
|
|
|
```json
|
|
|
@@ -296,32 +294,35 @@ ext：为各个命令字对应的信息内容。
|
|
|
}
|
|
|
}
|
|
|
```
|
|
|
-字段说明
|
|
|
-字段 描述
|
|
|
-imei 通讯板唯一 ID
|
|
|
-iccid SIM 卡卡号
|
|
|
-csq 信号强度
|
|
|
-dtype 设备类型（杀虫灯设备类型为 2）
|
|
|
-dver 设备固件版本
|
|
|
-stm8vs 主板代码版本号
|
|
|
-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 时控结束时间 (单位:小时)
|
|
|
-info 重启信息 (1: 正常, 2: socket 重连, 3: MQTT 重连)
|
|
|
-clt 清虫间隔时间 (单位:分钟)
|
|
|
-dattim 数据上传时间 (单位:分钟)
|
|
|
-lng 经度
|
|
|
-lat 纬度
|
|
|
-stamp 时间戳：20180301211805
|
|
|
+字段说明
|
|
|
+
|
|
|
+
|
|
|
+| 字段 | 描述 |
|
|
|
+|----------|-------------------------------|
|
|
|
+| imei | 通讯板唯一 ID |
|
|
|
+| iccid | SIM 卡卡号 |
|
|
|
+| csq | 信号强度 |
|
|
|
+| dtype | 设备类型（杀虫灯设备类型为 2）|
|
|
|
+| dver | 设备固件版本 |
|
|
|
+| stm8vs | 主板代码版本号 |
|
|
|
+| 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 | 时控结束时间 (单位:小时) |
|
|
|
+| info | 重启信息 (1: 正常, 2: socket 重连, 3: MQTT 重连) |
|
|
|
+| clt | 清虫间隔时间 (单位:分钟) |
|
|
|
+| dattim | 数据上传时间 (单位:分钟) |
|
|
|
+| lng | 经度 |
|
|
|
+| lat | 纬度 |
|
|
|
+| stamp | 时间戳：20180301211805 |
|
|
|
|
|
|
2.4.2. 数据报告
|
|
|
报文结构：
|
|
|
@@ -356,55 +357,35 @@ stamp 时间戳：20180301211805
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-字段说明：
|
|
|
-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
|
|
|
-电击次数 (每上报一次数据消息（data 消息）后清零)
|
|
|
-clt
|
|
|
-清虫间隔时间 （单位：分钟）
|
|
|
-lat
|
|
|
-纬度
|
|
|
-lng
|
|
|
-经度
|
|
|
-rcnt
|
|
|
-设备重启次数
|
|
|
-err
|
|
|
-重启原因
|
|
|
-tcs
|
|
|
-时控开关 0：关闭时控, 1：开启时控
|
|
|
-st
|
|
|
-时控开始时间
|
|
|
-et
|
|
|
-时控结束时间
|
|
|
-stamp
|
|
|
-时间戳：20180301211805
|
|
|
-
|
|
|
-3.交互协议
|
|
|
+字段说明
|
|
|
+
|
|
|
+| 字段 | 描述 |
|
|
|
+|----------|-------------------------------|
|
|
|
+| 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 | 电击次数 (每上报一次数据消息（data 消息）后清零) |
|
|
|
+| clt | 清虫间隔时间 （单位：分钟） |
|
|
|
+| lat | 纬度 |
|
|
|
+| lng | 经度 |
|
|
|
+| rcnt | 设备重启次数 |
|
|
|
+| err | 重启原因 |
|
|
|
+| tcs | 时控开关 (0: 关闭时控, 1: 开启时控) |
|
|
|
+| st | 时控开始时间 (单位:小时) |
|
|
|
+| et | 时控结束时间 (单位:小时) |
|
|
|
+| stamp | 时间戳：20180301211805 |
|
|
|
+
|
|
|
+### 交互协议
|
|
|
3.1.下行通信
|
|
|
3.1.1. 下发查询请求：
|
|
|
查询状态报文结构：
|
|
|
@@ -414,13 +395,13 @@ stamp
|
|
|
"ext": "status"
|
|
|
}
|
|
|
```
|
|
|
-字段说明：
|
|
|
-status
|
|
|
-请求读取状态信息
|
|
|
-data
|
|
|
-请求读取数据信息
|
|
|
-paramconf
|
|
|
-请求读取参数配置信息
|
|
|
+字段说明
|
|
|
+
|
|
|
+| 命令字 | 描述 |
|
|
|
+|------------|-------------------------------|
|
|
|
+| status | 请求读取状态信息 |
|
|
|
+| data | 请求读取数据信息 |
|
|
|
+| paramconf | 请求读取参数配置信息 |
|
|
|
|
|
|
3.1.2. 参数配置
|
|
|
报文结构：
|
|
|
@@ -447,41 +428,28 @@ paramconf
|
|
|
}
|
|
|
}
|
|
|
```
|
|
|
-字段说明：
|
|
|
-imei
|
|
|
-通讯板唯一 ID
|
|
|
-tt
|
|
|
-定时时长 (0~ 7)小时, 0：表示常亮
|
|
|
-uvon
|
|
|
-电池欠压锁定电压 (单位：mv)
|
|
|
-uvoff
|
|
|
-电池欠压解锁电压 (单位：mv)
|
|
|
-vfloat
|
|
|
-电池浮充电压 (单位：mv)
|
|
|
-vcutof
|
|
|
-电池充电截至电压 (单位：mv)
|
|
|
-overtemp
|
|
|
-高温保护 (单位：℃) (默认：70)
|
|
|
-lowtemp
|
|
|
-低温保护 (单位：℃) (默认：5)
|
|
|
-battype
|
|
|
-电池类型 0：铅蓄电池，1：锂电池
|
|
|
-stamp
|
|
|
-时间戳：20180301211805
|
|
|
-vsunset
|
|
|
-日出电压 (单位：mv)
|
|
|
-vsunrise
|
|
|
-日落电压 (单位：mv)
|
|
|
-vrecharge
|
|
|
-充电回滞电压 (单位：mv)
|
|
|
-vstart
|
|
|
-开机电压 (单位：mv)
|
|
|
-unover
|
|
|
-解除高温保护(单位：℃) (默认：50)
|
|
|
-unlowt
|
|
|
-解除低温保护(单位：℃) (默认：10)
|
|
|
-
|
|
|
-3.1.3. 控制指令下发
|
|
|
+字段说明
|
|
|
+
|
|
|
+| 字段 | 描述 |
|
|
|
+|------------|-------------------------------|
|
|
|
+| imei | 通讯板唯一 ID |
|
|
|
+| tt | 定时时长 (0~7 小时), 0 表示常亮 |
|
|
|
+| uvon | 电池欠压锁定电压 (单位：mV) |
|
|
|
+| uvoff | 电池欠压解锁电压 (单位：mV) |
|
|
|
+| vfloat | 电池浮充电压 (单位：mV) |
|
|
|
+| vcutof | 电池充电截至电压 (单位：mV) |
|
|
|
+| overtemp | 高温保护 (单位：℃) (默认：70) |
|
|
|
+| lowtemp | 低温保护 (单位：℃) (默认：5) |
|
|
|
+| battype | 电池类型 (0: 铅蓄电池, 1: 锂电池) |
|
|
|
+| stamp | 时间戳：20180301211805 |
|
|
|
+| vsunset | 日出电压 (单位：mV) |
|
|
|
+| vsunrise | 日落电压 (单位：mV) |
|
|
|
+| vrecharge | 充电回滞电压 (单位：mV) |
|
|
|
+| vstart | 开机电压 (单位：mV) |
|
|
|
+| unover | 解除高温保护 (单位：℃) (默认：50) |
|
|
|
+| unlowt | 解除低温保护 (单位：℃) (默认：10) |
|
|
|
+
|
|
|
+### 控制指令下发
|
|
|
下发开机控制报文结构：
|
|
|
```json
|
|
|
{
|
|
|
@@ -535,22 +503,20 @@ unlowt
|
|
|
"cmd": "dattim"
|
|
|
}
|
|
|
```
|
|
|
-字段说明：
|
|
|
-cmd
|
|
|
-请求的内容类别，分别如下
|
|
|
-power
|
|
|
-设备电源开关 ds=1：为开；ds=0：为关；
|
|
|
-timer
|
|
|
-设备工作时长 tt=0：为常亮模式，tt(1~7)：为设置的定时工作时长
|
|
|
-timectr
|
|
|
-时控参数
|
|
|
-clear
|
|
|
-清虫时间
|
|
|
-reboot
|
|
|
-重启
|
|
|
-## timer 指令与参数配置指令的 tt 是一样的，此处单独列出来是方便光控模式的批量控制。
|
|
|
-
|
|
|
-3.2. 遗愿消息
|
|
|
+字段说明
|
|
|
+
|
|
|
+| 命令字 | 描述 |
|
|
|
+|------------|-------------------------------|
|
|
|
+| cmd | 请求的内容类别，分别如下： |
|
|
|
+| power | 设备电源开关 (ds=1：为开；ds=0：为关) |
|
|
|
+| timer | 设备工作时长 (tt=0：为常亮模式，tt(1~7)：为设置的定时工作时长) |
|
|
|
+| timectr | 时控参数 |
|
|
|
+| clear | 清虫时间 |
|
|
|
+| reboot | 重启 |
|
|
|
+timer 指令与参数配置指令的 tt 是一样的，此处单独列出来是方便光控模式的批量控制。
|
|
|
+
|
|
|
+### 遗愿消息
|
|
|
+
|
|
|
设备默认设置配置了 MQTT 遗愿消息。
|
|
|
当设备异常下线时(客户端断开前未向服务器发送 DISCONNECT 消息)，MQTT 消息服务器会 发布异常下线设备的遗愿消息
|
|
|
订阅设备遗愿消息，可实现对设备在线和离线状态的监控；
|
|
|
@@ -597,5 +563,4 @@ reboot
|
|
|
- 雨控状态
|
|
|
- 温控状态
|
|
|
- 工作状态
|
|
|
-- 定时模式等数据
|
|
|
-
|
|
|
+- 定时模式等数据
|
zhangwd