|
|
@@ -1,4 +1,4 @@
|
|
|
-# 风吸式杀虫灯通讯约定
|
|
|
+# 新款风吸式杀虫灯http协议
|
|
|
|
|
|
## 1.1 简述
|
|
|
本文档主要用于阐述风吸式杀虫灯与服务器端进行交互的通讯细节。
|
|
|
@@ -69,40 +69,43 @@
|
|
|
```
|
|
|
1.4.2 字段说明
|
|
|
|
|
|
-字段 含义或表示的内容
|
|
|
-dver 物联网模块代码版本号
|
|
|
-lcm 光控类型 0 太阳能板光控 1 光敏二极管光控
|
|
|
-dat_f 数据上报时间间隔
|
|
|
-st 时控开始时间
|
|
|
-tt 光控工作时长 默认4小时
|
|
|
-lng 经度
|
|
|
-imei 唯一ID
|
|
|
-ah 环境湿度
|
|
|
-cv 充电电压 单位:V 字符串
|
|
|
-iccid SIM卡卡号
|
|
|
-rcnt 设备启动次数
|
|
|
-vps 欠压保护
|
|
|
-voltval 灯管状态
|
|
|
-stamp 系统时间
|
|
|
-stm8vs 主板代码版本
|
|
|
-tps 温控保护
|
|
|
-gps 定位方式 0 手动定位 1 GPS定位 2 基站定位
|
|
|
-ts 时控开关
|
|
|
-ws 工作状态 0待机，1工作, 2充电
|
|
|
-et 时控结束时间
|
|
|
-csq 信号强度
|
|
|
-dps 倾倒保护
|
|
|
-ct 风扇状态
|
|
|
-dtype 设备类型 2:4G杀虫灯
|
|
|
-at 环境温度
|
|
|
-bt 主板温度 默认25度
|
|
|
-bv 电池电压 单位:V 字符串
|
|
|
-rps 雨控保护
|
|
|
-clt_t 自清虫时间间隔
|
|
|
-lps 是否光控 0 晚上 1 白天
|
|
|
-cycle_off 放电截止频率
|
|
|
-clear_on 自清虫标志位
|
|
|
-1.5 遗愿消息
|
|
|
+
|
|
|
+| 字段 | 含义或表示的内容 |
|
|
|
+|----------|--------------------------------------|
|
|
|
+| dver | 物联网模块代码版本号 |
|
|
|
+| lcm | 光控类型 0 太阳能板光控 1 光敏二极管光控 |
|
|
|
+| dat_f | 数据上报时间间隔 |
|
|
|
+| st | 时控开始时间 |
|
|
|
+| tt | 光控工作时长 默认4小时 |
|
|
|
+| lng | 经度 |
|
|
|
+| imei | 唯一ID |
|
|
|
+| ah | 环境湿度 |
|
|
|
+| cv | 充电电压 单位:V 字符串 |
|
|
|
+| iccid | SIM卡卡号 |
|
|
|
+| rcnt | 设备启动次数 |
|
|
|
+| vps | 欠压保护 |
|
|
|
+| voltval | 灯管状态 |
|
|
|
+| stamp | 系统时间 |
|
|
|
+| stm8vs | 主板代码版本 |
|
|
|
+| tps | 温控保护 |
|
|
|
+| gps | 定位方式 0 手动定位 1 GPS定位 2 基站定位 |
|
|
|
+| ts | 时控开关 |
|
|
|
+| ws | 工作状态 0待机，1工作, 2充电 |
|
|
|
+| et | 时控结束时间 |
|
|
|
+| csq | 信号强度 |
|
|
|
+| dps | 倾倒保护 |
|
|
|
+| ct | 风扇状态 |
|
|
|
+| dtype | 设备类型 2:4G杀虫灯 |
|
|
|
+| at | 环境温度 |
|
|
|
+| bt | 主板温度 默认25度 |
|
|
|
+| bv | 电池电压 单位:V 字符串 |
|
|
|
+| rps | 雨控保护 |
|
|
|
+| clt_t | 自清虫时间间隔 |
|
|
|
+| lps | 是否光控 0 晚上 1 白天 |
|
|
|
+| cycle_off| 放电截止频率 |
|
|
|
+| clear_on | 自清虫标志位 |
|
|
|
+
|
|
|
+1.5 遗愿消息
|
|
|
设备默认设置配置了 MQTT 遗愿消息。当设备异常下线时（客户端断开前未向服务器发送 DISCONNECT 消息），MQTT 消息服务器会发布异常下线设备的遗愿消息。
|
|
|
|
|
|
1.5.1 报文结构
|
|
|
@@ -116,4 +119,272 @@ clear_on 自清虫标志位
|
|
|
},
|
|
|
"topic": "/yfkj/fxs/pub/867435052203452"
|
|
|
}
|
|
|
+```
|
|
|
+
|
|
|
+
|
|
|
+# 新款风吸式杀虫灯MQTT协议
|
|
|
+
|
|
|
+## 设备主题说明
|
|
|
+
|
|
|
+- **离线消息主题**：`/yfkj/fxs/offline/<imei>`
|
|
|
+- **所有上行通信的主题**：`/yfkj/fxs/pub/<imei>` （设备到服务器）
|
|
|
+- **所有下行通信的主题**：`/yfkj/fxs/sub/<imei>` （服务器到设备）
|
|
|
+
|
|
|
+其中 `<imei>` 是设备的唯一标识符。
|
|
|
+
|
|
|
+
|
|
|
+## MQTT消息格式
|
|
|
+
|
|
|
+### 参数配置
|
|
|
+
|
|
|
+整合参数配置示例
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "paramconf",
|
|
|
+ "ext": {
|
|
|
+ "ts": "1",
|
|
|
+ "st": "20",
|
|
|
+ "et": "2",
|
|
|
+ "dattim": "10",
|
|
|
+ "clt": "30",
|
|
|
+ "tt": "4",
|
|
|
+ "ds": "1"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+单条测试命令示例
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "paramconf",
|
|
|
+ "ext": {
|
|
|
+ "ts": "1",
|
|
|
+ "st": "20",
|
|
|
+ "et": "2"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+常用配置命令：
|
|
|
+下发配置定时控制参数
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "paramconf",
|
|
|
+ "ext": {
|
|
|
+ "ts": "1",
|
|
|
+ "st": "20",
|
|
|
+ "et": "2"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+下发配置数据上报时间间隔
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "paramconf",
|
|
|
+ "ext": {
|
|
|
+ "dattim": "10"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+下发配置清虫时间间隔
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "paramconf",
|
|
|
+ "ext": {
|
|
|
+ "clt": "30"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+下发配置光控工作时长
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "paramconf",
|
|
|
+ "ext": {
|
|
|
+ "tt": "4"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+下发配置设备开关机
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "paramconf",
|
|
|
+ "ext": {
|
|
|
+ "ds": "1"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+重启
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "reboot"
|
|
|
+}
|
|
|
+```
|
|
|
+开关机
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "power",
|
|
|
+ "ext": {
|
|
|
+ "ds": "1"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+光控定时修改
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "timer",
|
|
|
+ "ext": {
|
|
|
+ "tt": "4"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+时控设置
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "timectr",
|
|
|
+ "ext": {
|
|
|
+ "timctrl": "1",
|
|
|
+ "st": "21",
|
|
|
+ "et": "2"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+数据上报时间间隔
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "dattim",
|
|
|
+ "ext": {
|
|
|
+ "dattim": "15"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+读取数据
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "read",
|
|
|
+ "ext": "data"
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+字段说明
|
|
|
+
|
|
|
+| 字段名 | 描述 |
|
|
|
+| ------- | -------------------------------------------------------------------- |
|
|
|
+| cmd | 协议命令字标识，为消息报文分类 |
|
|
|
+| timctrl | 下发配置定时控制参数 `timctrl` 时控开关 0：关闭时控 1：开启时控 `st`：开始时间 `et`：结束时间 |
|
|
|
+| dattim | 下发配置数据上报时间间隔，单位：分钟 |
|
|
|
+| clt | 下发配置清虫时间间隔，单位：分钟 |
|
|
|
+| tt | 下发配置光控工作时间，单位：小时 |
|
|
|
+| ds | 下发配置设备开关机 0：关机 1：开机 |
|
|
|
+| reboot | 重启 |
|
|
|
+
|
|
|
+
|
|
|
+### 通讯协议上报字段
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "data",
|
|
|
+ "ext": {
|
|
|
+ "stamp": "20231113133557",
|
|
|
+ "imei": "861551054678511",
|
|
|
+ "iccid": "898604D4112390689954",
|
|
|
+ "dver": "4.0.08-4G-FXS-uart",
|
|
|
+ "stm8vs": "FXS-Beta-V2.0.2",
|
|
|
+ "csq": "31",
|
|
|
+ "dtype": "2",
|
|
|
+ "rcnt": "100",
|
|
|
+ "ws": "1",
|
|
|
+ "ds": "1",
|
|
|
+ "tt": "4",
|
|
|
+ "ts": "0",
|
|
|
+ "st": "7",
|
|
|
+ "et": "10",
|
|
|
+ "vps": "0",
|
|
|
+ "tps": "0",
|
|
|
+ "dps": "0",
|
|
|
+ "rps": "0",
|
|
|
+ "lps": "0",
|
|
|
+ "lcm": "0",
|
|
|
+ "ct": "0",
|
|
|
+ "cv": "0",
|
|
|
+ "bv": "12.379",
|
|
|
+ "bt": "19.7",
|
|
|
+ "at": 5,
|
|
|
+ "ah": 34,
|
|
|
+ "voltval": "1",
|
|
|
+ "cycle_off": 0,
|
|
|
+ "dat_f": "15",
|
|
|
+ "clt_t": "30",
|
|
|
+ "clear_on": 1,
|
|
|
+ "gps": "1",
|
|
|
+ "lng": "113.6605938",
|
|
|
+ "lat": "34.8101481"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+字段含义表
|
|
|
+
|
|
|
+| 字段 | 含义或表示的内容 |
|
|
|
+|-----------|--------------------------------------|
|
|
|
+| stamp | 系统时间 |
|
|
|
+| imei | 唯一ID |
|
|
|
+| iccid | SIM卡卡号 |
|
|
|
+| dver | 物联网模块代码版本号 |
|
|
|
+| stm8vs | 主板代码版本 |
|
|
|
+| csq | 信号强度 |
|
|
|
+| dtype | 设备类型 2:4G杀虫灯 |
|
|
|
+| rcnt | 设备启动次数 |
|
|
|
+| ws | 工作状态 0待机，1工作, 2充电 |
|
|
|
+| ds | 设备是否开机 0关机，1开机 |
|
|
|
+| tt | 光控工作时长 默认4小时 |
|
|
|
+| ts | 时控开关 |
|
|
|
+| st | 时控开始时间 |
|
|
|
+| et | 时控结束时间 |
|
|
|
+| vps | 欠压保护 |
|
|
|
+| tps | 温控保护 |
|
|
|
+| dps | 倾倒保护 |
|
|
|
+| rps | 雨控保护 |
|
|
|
+| lps | 是否光控 0 晚上 1 白天 |
|
|
|
+| lcm | 光控类型 0 太阳能板光控 1 光敏二极管光控 |
|
|
|
+| ct | 风扇状态 |
|
|
|
+| cv | 充电电压 单位:V 字符串 |
|
|
|
+| bv | 电池电压 单位:V 字符串 |
|
|
|
+| bt | 主板温度 默认25度 |
|
|
|
+| at | 环境温度 |
|
|
|
+| ah | 环境湿度 |
|
|
|
+| voltval | 灯管状态 |
|
|
|
+| cycle_off | 放电截止频率 |
|
|
|
+| dat_f | 数据上报时间间隔 |
|
|
|
+| clt_t | 自清虫时间间隔 |
|
|
|
+| clear_on | 自清虫标志位 |
|
|
|
+| gps | 定位方式 0 手动定位 1 GPS定位 2 基站定位 |
|
|
|
+| lng | 经度 |
|
|
|
+| lat | 维度 |
|
|
|
+
|
|
|
+
|
|
|
+### 遗愿消息
|
|
|
+当设备异常下线时（客户端断开前未向服务器发送 DISCONNECT 消息），MQTT 消息服务器会发布异常下线设备的遗愿消息。订阅设备遗愿消息，可实现对设备在线和离线状态的监控。
|
|
|
+
|
|
|
+离线消息主题
|
|
|
+/yfkj/fxs/offline/<imei>
|
|
|
+
|
|
|
+报文结构
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "cmd": "offline",
|
|
|
+ "ext": {
|
|
|
+ "imei": "868575028xxxxxx"
|
|
|
+ }
|
|
|
+}
|
|
|
```
|
zhangwd
