# 虫情测报灯与服务器端交互通讯细节

## 通信描述

对接采用 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       | 数据上传时间间隔，单位：分钟 (默认上传时间为 20 分钟)                                        |
| turnon      | 开机次数，每次重启加 1                                                                    |
| htim        | 加热时间：1-30 分钟                                                                       |
| batStatus   | 电压状态 0: 正常 1: 欠压                                                                   |
| tt          | 光控定时时间 1~10 (当设备处于光控状态时，该字段为设备工作时间)                              |
| shake       | 震动开关: 0: 关，1: 开                                                                    |
| shake_sec   | 震动时间：1~20 (步长：100ms)                                                              |
| ts          | 定时模式: 0: 光控，1: 时控 (设备工作状态，光控默认工作时间为天黑后8小时，时控可以设置工作时间范围) |
| 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）     |