update

zh-cn/_navbar.md

@@ -10,3 +10,8 @@
   * [性诱测报](zh-cn/xycb/xycb.md)
   * [性诱2.0](zh-cn/xy2/xy2.md)
   * [测报灯老](zh-cn/cbd-sq/cbd-sq.md)
+  * [新款风吸式杀虫灯](zh-cn/fxsnew/fxsnew.md)
+  * [孢子仪老](zh-cn/bzy-sq/bzy-sq.md)
+  * [气象站老](zh-cn/qxz-sq/qxz-sq.md)
+  * [性诱测报灯老](zh-cn/xycb-sq/xycb-sq.md)
+  * [杀虫灯老](zh-cn/scd-sq/scd-sq.md)

zh-cn/cbd-sq/_sidebar.md

@@ -1,13 +1,27 @@
-* [吸虫塔http协议](/zh-cn/xct/xct?id=吸虫塔http协议)
+* [测报灯http协议](/zh-cn/cbd-sq/cbd-sq?id=测报灯http协议)
 
-  * [简述](/zh-cn/xct/xct?id=简述)
+  * [简要描述](/zh-cn/cbd-sq/cbd-sq?id=简要描述)
 
-    * [通信描述](/zh-cn/xct/xct?id=通信描述)
+    * [接口说明](/zh-cn/cbd-sq/cbd-sq?id=接口说明)
 
-      * [对接说明](/zh-cn/xct/xct?id=对接说明)
+      * [数据接收接口](/zh-cn/cbd-sq/cbd-sq?id=数据接收接口)
 
-      * [设备数据、图片数据说明](/zh-cn/xct/xct?id=设备数据、图片数据说明)
+      * [status数据返回示例](/zh-cn/cbd-sq/cbd-sq?id=status数据返回示例)
 
-      * [设备对接说明](/zh-cn/xct/xct?id=设备对接说明)
+      * [data数据返回示例](/zh-cn/cbd-sq/cbd-sq?id=data数据返回示例)
 
-      * [设备数据报文结构](/zh-cn/xct/xct?id=设备数据报文结构)
+      * [offline参数返回说明](/zh-cn/cbd-sq/cbd-sq?id=offline参数返回说明)
+
+      * [设备带害虫识别图片传输说明](/zh-cn/cbd-sq/cbd-sq?id=设备带害虫识别图片传输说明)
+
+      * [设备不带害虫识别图片传输说明](/zh-cn/cbd-sq/cbd-sq?id=设备不带害虫识别图片传输说明)
+
+      * [设备温控雨控说明](/zh-cn/cbd-sq/cbd-sq?id=设备温控雨控说明)
+
+      * [C#语言接收数据案例](/zh-cn/cbd-sq/cbd-sq?id=C#语言接收数据案例)
+
+      * [java语言接收数据案例](/zh-cn/cbd-sq/cbd-sq?id=java语言接收数据案例)
+
+      * [nodejs语言接收数据案例](/zh-cn/cbd-sq/cbd-sq?id=nodejs语言接收数据案例)
+
+      * [python语言接收数据案例](/zh-cn/cbd-sq/cbd-sq?id=python语言接收数据案例)

zh-cn/cbd-sq/cbd-sq.md

@@ -1,4 +1,4 @@
-# 虫情测报灯与服务器端交互通讯细节
+# 测报灯http协议
 
 ## 简要描述
 
@@ -6,11 +6,11 @@
 
 ## 接口说明
 
-### 1. 数据接收接口
+### 数据接收接口
 
 需要接收方写接口接收数据 POST 请求，数据分为 `status`、`data`、`offline` 类型，可共用一个接口，根据 `cmd` 字段进行解析。
 
-#### status 数据返回示例
+#### status数据返回示例
 
 ```json
 {
@@ -73,7 +73,7 @@ status 参数说明
 | proj   | 内部版本名称 |
 | gps    | 定位说明, 0: 手动定位, 1: GPS 定位, 2: 基站定位 |
 
-2. data 数据返回示例  
+### data数据返回示例  
 ```json
 {
   "topic": "/yfkj/cbd/pub/865650043207246",
@@ -119,7 +119,7 @@ data 参数说明
 | batStatus | 电池状态 0：正常, 1：欠压                                             |
 | vbat      | 电池电压                                                           |  
 
-3. offline 参数返回说明  
+### offline参数返回说明  
 会发布异常下线设备的遗愿消息。注意：设备离线会发送一条设备下线消息，设备上线后发送正常数据（data 和 status）。
 
 设备默认设置配置了 MQTT 遗愿消息。当设备异常下线时（客户端断开前未向服务器发送 DISCONNECT 消息），MQTT 消息服务器会发布异常下线设备的遗愿消息。订阅设备遗愿消息，可实现对设备在线和离线状态的监控。
@@ -148,7 +148,7 @@ offline 参数返回示例
   "topic": "/yfkj/cbd/pub/865650043207246"
 }
 ```
-设备带害虫识别图片传输说明  
+### 设备带害虫识别图片传输说明  
 注意事项  
 数据上传时间默认是 20 分钟上传一次。  
 图片数据上传时间受落虫时间、加热时间影响，默认是 30 分钟上传一次。  
@@ -181,7 +181,7 @@ offline 参数返回示例
 | Result_image | 识别结果图片（图片链接，建议下载保存）                               |
 | Result       | 结果字符串，用“种类 1,种类 1 数目#种类 2,种类 2 数目…”表示，如 “10,1#12,2”，表示种类 10 的数目是 1，种类 12 的数目是 2 |  
 
-设备不带害虫识别图片传输说明  
+### 设备不带害虫识别图片传输说明  
 接口说明: 
 对接采用 HTTP 协议，由接收方写接口来接收 HTTP POST 数据（需从 request 的 body（字节流类型）中取数据，取到之后进行 JSON 解析）。图片和设备数据为相互独立的两种数据。  
 图片保存的时候不要直接保存图片链接到数据库，有可能图片链接会失效，导致图片展示不了的问题，需要下载保存到本地。
@@ -200,10 +200,19 @@ offline 参数返回示例
 | imei   | 设备序列号 |
 | Image  | 拍照图片（图片链接，建议下载保存） |  
 
-设备温控、雨控说明  
+### 设备温控雨控说明  
 温控：为了冬季保护电池。即使供电系统是市电，在这种温度条件下，并不会发生虫情，因此设计为系统待机，不再拍照，也比较符合节能降耗的思想。  
 雨控：为了防止设备进水而设计，发生雨控也进入待机，不再工作和拍照。  
 
-6.C#语言接收数据案例  
+###  C#语言接收数据案例  
 ![C#语言接收数据案例图](../zh-cn/images/c语言接收数据案例.png)
 
+###  java语言接收数据案例  
+![java语言接收数据案例](../zh-cn/images/java语言接收数据案例.png)
+
+###  nodejs语言接收数据案例  
+![nodejs语言接收数据案例](../zh-cn/images/nodejs语言接收数据案例.png)
+
+###  python语言接收数据案例  
+![python语言接收数据案例](../zh-cn/images/python语言接收数据案例.png)
+

zh-cn/fxsnew/_sidebar.md

@@ -1,4 +1,4 @@
-* [性诱2.0http协议](/zh-cn/fxsnew/fxsnew?id=性诱2.0http协议)
+* [新款风吸式杀虫灯http协议](/zh-cn/fxsnew/fxsnew?id=新款风吸式杀虫灯http协议)
 
   * [简述](/zh-cn/fxsnew/fxsnew?id=简述)
 
@@ -8,6 +8,20 @@
 
       * [设备数据说明](/zh-cn/fxsnew/fxsnew?id=设备数据说明)
 
+      * [设备对接说明](/zh-cn/fxsnew/fxsnew?id=设备对接说明)
+
       * [设备数据报文结构](/zh-cn/fxsnew/fxsnew?id=设备数据报文结构)
 
-      * [设备数据](/zh-cn/fxsnew/fxsnew?id=设备数据)
+      * [报文结构](/zh-cn/fxsnew/fxsnew?id=报文结构)
+
+* [新款风吸式杀虫灯MQTT协议](/zh-cn/fxsnew/fxsnew?id=新款风吸式杀虫灯MQTT协议)
+
+  * [设备主题说明](/zh-cn/fxsnew/fxsnew?id=设备主题说明)
+
+    * [MQTT消息格式](/zh-cn/fxsnew/fxsnew?id=MQTT消息格式)
+
+      * [参数配置](/zh-cn/fxsnew/fxsnew?id=参数配置)
+
+      * [通讯协议上报字段](/zh-cn/fxsnew/fxsnew?id=通讯协议上报字段)
+
+      * [遗愿消息](/zh-cn/fxsnew/fxsnew?id=遗愿消息)

zh-cn/fxsnew/fxsnew.md

@@ -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"
+  }
+}
 ```