update

zh-cn/bzy-sq/_sidebar.md

@@ -0,0 +1,58 @@
+* [测报灯http协议](/zh-cn/cbd-sq/cbd-sq?id=测报灯http协议)
+
+  * [简要描述](/zh-cn/cbd-sq/cbd-sq?id=简要描述)
+
+    * [接口说明](/zh-cn/cbd-sq/cbd-sq?id=接口说明)
+
+      * [数据接收接口](/zh-cn/cbd-sq/cbd-sq?id=数据接收接口)
+
+      * [status数据返回示例](/zh-cn/cbd-sq/cbd-sq?id=status数据返回示例)
+
+      * [data数据返回示例](/zh-cn/cbd-sq/cbd-sq?id=data数据返回示例)
+
+      * [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语言接收数据案例)
+
+* [测报灯mqtt协议](/zh-cn/cbd-sq/cbd-sq?id=测报灯mqtt协议)
+
+  * [简要描述](/zh-cn/cbd-sq/cbd-sq?id=简要描述)
+
+    * [术语和缩略语](/zh-cn/cbd-sq/cbd-sq?id=术语和缩略语)
+
+      * [通信协议](/zh-cn/cbd-sq/cbd-sq?id=通信协议)
+
+      * [文本传输协议](/zh-cn/cbd-sq/cbd-sq?id=文本传输协议)
+
+      * [文件传输协议](/zh-cn/cbd-sq/cbd-sq?id=文件传输协议)
+
+      * [主题说明](/zh-cn/cbd-sq/cbd-sq?id=主题说明)
+
+      * [上行通信](/zh-cn/cbd-sq/cbd-sq?id=上行通信)
+
+      * [状态报告](/zh-cn/cbd-sq/cbd-sq?id=状态报告)
+
+      * [交互协议](/zh-cn/cbd-sq/cbd-sq?id=交互协议)
+
+      * [下发拍照指令](/zh-cn/cbd-sq/cbd-sq?id=下发拍照指令)
+
+      * [遗愿消息](/zh-cn/cbd-sq/cbd-sq?id=遗愿消息)
+
+      * [设备带害虫识别图片传输说明1](/zh-cn/cbd-sq/cbd-sq?id=设备带害虫识别图片传输说明1)
+
+      * [设备不带害虫识别图片传输说明1](/zh-cn/cbd-sq/cbd-sq?id=设备不带害虫识别图片传输说明1)
+
+* [常见问题解答](/zh-cn/cbd-sq/cbd-sq?id=常见问题解答)
+

zh-cn/bzy-sq/bzy-sq.md

@@ -0,0 +1,129 @@
+# 孢子捕捉仪与服务器端交互通讯细节
+
+## 1. 简要描述
+
+本文档主要用于阐述孢子捕捉仪与服务器端进行交互的通讯细节。
+
+## 2. 接口说明
+
+需要接收方写接口接收数据 POST请求。图片保存的时候不要直接保存图片链接到数据库，有可能图片链接会失效，导致图片展示不了的问题，需要下载保存到本地。
+
+## 3. 数据上报
+
+### 报文结构
+
+```json
+{
+  "payload": {
+    "ext": {
+      "stamp": "20200331143709",
+      "work_sta": 1,
+      "iccid": "89860401101700076471",
+      "cold_sw": 0,
+      "csq": 20,
+      "bat_sta": 0,
+      "alti": 0,
+      "proj": "BZY-V21",
+      "ah": 60,
+      "lat": "35.004301741512045",
+      "coll_time": [
+        "10-11",
+        "13-14",
+        "19-20"
+      ],
+      "lng": "113.7031044747238",
+      "on_off": 1,
+      "dtype": 7,
+      "at": 21,
+      "staytime": 0,
+      "set_temp": 25,
+      "rps": 0,
+      "dver": "2.5.9",
+      "box_tem": "24",
+      "imei": "865650043207246",
+      "v_bat": "23.937",
+      "pre_temp": 24,
+      "imgres": 0,
+      "datt": 20,
+      "usb_sta": 0,
+      "drop_time": 1,
+      "cul_time": 1,
+      "wind_sw": 0
+    },
+    "cmd": "status"
+  },
+  "topic": "/yfkj/bzy/c2s/865650043208251"
+}
+
+字段说明
+字段	含义或表示的内容
+imei	通讯板唯一 ID
+iccid	物联网卡的 ICCID 号，用于查询物联网卡的套餐、流量信息等
+csq	信号强度
+alti	海拔高度（单位：m）
+lat	纬度
+lng	经度
+dtype	设备类型 <孢子仪设备类型为 7>
+on_off	设备开关 0：关闭，1：开启
+dver	设备固件版本
+v_bat	电压（单位：V）
+bat_sta	电池状态 0：正常，1：电量过低
+usb_sta	摄像头状态 0：正常, 1：异常
+imgres	图片分辨率（默认为 7（最高））
+wind_sw	风机开关 0：关闭，1：开启
+cold_sw	制冷机开关 0：关闭，1：开启
+coll_time	采集开启和关闭时间（最多有 10 个）
+drop_time	滴液时间（单位：秒）
+set_temp	保温仓设定温度（单位：℃）
+pre_temp	保温仓当前温度（单位：℃）
+at	环境温度（单位：℃）
+ah	环境湿度（单位：%）
+rps	雨控状态 1：雨控，0：正常
+stamp	时间戳：20180301211805
+datt	数据上传时间间隔（单位：分钟）
+staytime	已培养时间（单位：小时）
+cul_time	培养时间（单位：小时）
+work_sta	工作状态 0：关闭，1：开启
+proj	版本号
+box_tem	机箱温度（单位：℃）
+4. 遗愿消息
+设备默认设置配置了MQTT遗愿消息。当设备异常下线时（客户端断开前未向服务器发送DISCONNECT消息），MQTT消息服务器会发布异常下线设备的遗愿消息。订阅设备遗愿消息，可实现对设备在线和离线状态的监控。
+
+离线消息主题
+/yfkj/bzy/offline/<imei>
+
+报文结构
+json
+深色版本
+{
+  "cmd": "offline",
+  "ext": {
+    "imei": "865650043207246"
+  }
+}
+
+
+## 5. 图片传输
+
+### 对接方式
+
+1. 对接采用 HTTP 协议，由接收方写接口来接收 HTTP POST 数据（需从 request 的 body （字节流类型）中取数据，取到之后进行 JSON 解析）。
+2. 图片数据中的 `Image` 字段为图片链接，图片需要下载保存到本地。保存的时候不要直接保存图片链接到数据库，有可能图片链接会失效，应直接下载保存到本地后的链接存到数据库中。
+
+#### 数据格式
+
+```json
+{
+  "Image": "https://bzypic.oss-cn-hangzhou.aliyuncs.com/202103/867814044582217/20210323151242.jpg",
+  "imei": "865650043172788"
+}
+参数说明
+接口地址: http://xxxxxxxxxx/xxxxx
+接口方式: POST
+参数说明:
+imei: 设备序列号
+Image: 图片链接
+6. C#语言接收数据案例
+7.java语言接收数据案例
+8.node.js语言接收数据案例
+9.python语言接收数据案例