update

zh-cn/cbd.md

@@ -1,2 +1,180 @@
-# 测报灯
---sssss
+# 虫情测报灯与服务器端交互通讯细节
+
+## 通信描述
+
+对接采用 HTTP 协议，由接收方写接口来接收 http post 数据（需从 request 的 body （字节流类型）中取数据，取到之后进行 json 解析）。
+
+## 对接说明
+
+### 设备数据、图片数据说明
+
+1. **设备数据默认是 30 分钟上传一次数据**，图片是在设备工作时间段内 20 分钟上传一次。如果设备处于温控、雨控状态，不拍照但数据正常上传。
+2. **温控、雨控**：温控是为了冬季保护电池；雨控是为了防止设备进水而设计，发生时设备进入待机不再工作和拍照。
+3. **图片数据中的为图片链接**，需要下载保存到本地。建议不要直接保存图片链接到数据库，以防失效，下载后的链接存入数据库。
+4. **设备数据包含**：设备号、SIM 卡号、境温湿度、工作状态、经纬度、电压等。
+5. **图片数据包含**：不识别（原图链接、设备号），识别（设备号、原图链接、识别后的图片链接、害虫名称和数量）。
+6. **设备收集时间+加热时间** 等于设备拍照时间。
+7. **设备数据格式不可变**，如有需求请联系销售经理。
+8. **接口安全问题**：可以针对传输方 IP 做限制,不是传输方的 IP 不让其调用接口。
+9. 接口设置是我们这边进行配置，您只需要把接口发给对接人员。
+
+### 设备对接说明
+
+1. 图片和设备数据为相互独立的两种数据。
+2. 需要提供两个接口接收数据（一个用于接收数据，一个用于接收图片）。
+3. 如果对接完成后设备未收到数据与图片，请先检查所提供的接口是否有问题，再联系对接人员。
+4. 先进行接口测试，没问题后才能发正式数据。
+5. 设备上线后会自动发送 data 数据。
+6. 接口设置是我们这边进行配置，您只需要把接口发给对接人员。
+
+## 设备数据报文结构
+
+```
+{
+  "topic": "/yfkj/cbd/pub/867435052203452",
+  "payload": {
+    "cmd": "data",
+    "ext": {
+      "hst": "100",
+      "ds": "1",
+      "gs": "0",
+      "dver": "1.F.4(144)HK",
+      "hs": "0",
+      "shake_sec": "1",
+      "tpl": "5",
+      "dat_f": "30",
+      "tph": "70",
+      "lat": "037.0167465",
+      "st": "20",
+      "tt": "8",
+      "lng": "122.0813903",
+      "vbat": "26.103",
+      "imei": "867435052203452",
+      "htim": "10",
+      "collt": "10",
+      "et": "0",
+      "iccid": "89860491102192155079",
+      "dtype": "3",
+      "batStatus": "0",
+      "dnds": "0",
+      "hrt": "31",
+      "proj": "DCCBD-2_HK",
+      "gps": "2",
+      "ts": "1",
+      "ws": "0",
+      "vs": "144",
+      "shake": "1",
+      "current": "0.0",
+      "ah": "72.0",
+      "at": "29.0",
+      "stamp": "20230725183835",
+      "lamp": "0",
+      "rps": "0",
+      "upds": "0",
+      "lps": "1",
+      "tps": "0",
+      "csq": "20"
+    }
+  }
+}
+```
+
+字段说明
+字段名	描述
+imei	通讯板唯一 ID
+iccid	物联网卡的 iccid 号
+csq	信号强度
+lat	纬度
+lng	经度
+dtype	设备类型 (测报灯设备类型为 3)
+ws	工作状态 0: 待机， 1: 工作
+dver	设备固件版本
+vbat	电压
+st	时控开始时间：0-23 单位(h)
+et	时控结束时间：0-23 单位(h)
+tps	温控：0: 正常，1: 保护
+lps	光控：0: 正常，1: 保护
+rps	雨控：0: 正常，1: 保护
+collt	收集时间：1-30 单位(分钟)
+current	功率：单位(mA)
+hrt	加热仓实时温度（℃）
+hst	加热仓设定温度：70-200(℃)
+at	环境温度（℃）
+ah	环境湿度（℃）
+stamp	时间 20180301211805(时间字符串: 2018/03/01/21:18:05)
+dat_f	数据上传时间间隔，单位：分钟
+htim	加热时间：1-30 分钟
+batStatus	电压状态 0: 正常 1: 欠压
+tt	光控定时时间 1~10
+shake	震动开关: 0: 关，1: 开
+shake_sec	震动时间：1~20(步长：100ms)
+ts	定时模式: 0: 光控，1: 时控
+upds	上仓门状态 1: 打开，0: 关闭
+dnds	下仓门状态 1: 打开，0: 关闭
+lamp	灯管/工作状态 0: 工作 1: 未工作
+fuse_voltage	保险丝电压
+ds	设备开关状态 0: 关机 1: 开机
+gps	定位说明,0-手动定位,1-GPS 定位,2-基站定位
+gs	通道状态 1：落虫，0：排水
+hs	加热状态
+tpl	低温保护值
+tph	高温保护
+proj	版本号
+vs	内部版本号
+设备下线消息
+设备默认配置了遗愿消息，当设备异常下线时，会发布异常下线设备的遗愿消息。
+```
+{
+  "payload": {
+    "cmd": "offline",
+    "ext": {
+      "imei": "867435052203452"
+    }
+  },
+  "topic": "/yfkj/cbd/offline/867435052203452"
+}
+```
+注意：设备离线会发送一条设备下线消息，设备上线后发送正常数据。
+
+图片传输
+对接采用 HTTP 协议
+由接收方写接口来接收 http post 数据（需从 request 的 body（字节流类型）中取数据，取到之后进行 json 解析）。图片需要下载保存到本地，不要直接保存图片链接到数据库。
+
+带害虫识别图片传输案例
+参数案例 1
+```
+{
+  "Image": "https://bigdata-image.oss-cn-hangzhou.aliyuncs.com/Basics/cbd/866547058605406/2023/5/30/192.168.1.106_01_20230414142111449_ALARM_INPUT.jpg",
+  "Result": "158,1#260,5#21,1",
+  "Result_image": "https://bigdata-image.oss-cn-hangzhou.aliyuncs.com/ResultB/cbd/866547058626857/2023/6/28/192.168.1.117_01_19700119100324405_ALARM_INPUT.jpg",
+  "imei": "866547058604524"
+}
+```
+参数案例 2
+```
+{
+  "Result": "0",
+  "Result_image": "0",
+  "Image": "https://bigdata-image.oss-cn-hangzhou.aliyuncs.com/Basics/cbd/861551058865106/2023/8/29/861551058865106-20230829234037.jpg",
+  "imei": "861551058865106"
+}
+```
+不带害虫识别图片传输案例
+```
+{
+  "Image": "http://www.yfzhwlw.com/pyftp/ftp_file/ykm_cbd/868956048817419/192.168.1.100_01_20200623233048184_ALARM_INPUT.jpg ",
+  "imei": "867435052203452"
+}
+```
+## 参数说明
+接口地址
+http://xxxxxxxxxx/xxxxx
+
+接口方式
+Post
+
+参数说明
+imei: 设备序列号
+Image: 拍照图片（图片链接，建议下载保存）
+Result_image: 识别结果图片（图片链接，建议下载保存）
+Result: 昆虫种类及数目（如模型未识别到害虫，Result_image 与 Result 数据为 0）