|
|
@@ -1,71 +1,59 @@
|
|
|
-# 性诱2.0http协议
|
|
|
+# 管式墒情协议
|
|
|
|
|
|
-## 简述
|
|
|
+## 简述
|
|
|
|
|
|
-本文档主要用于阐述性诱测报与服务端进行交互的通讯细节。
|
|
|
+本文档主要用于阐述物联网管式墒情设备与服务器端进行交互的通讯细节，其中包括物联网管式墒情设备与服务器之间使用的通信协议和交互通讯协议两部分。
|
|
|
|
|
|
-## 通信描述
|
|
|
+## 适用范围
|
|
|
|
|
|
-对接采用 HTTP 协议，由接收方写接口来接收 HTTP POST 数据（需从 request 的 body（字节流类型）中取数据，取到之后进行 JSON 解析）。
|
|
|
+适用于【通用物联网管式墒情设备】与服务器之间的通讯。
|
|
|
|
|
|
-## 对接说明
|
|
|
+## 对接说明
|
|
|
|
|
|
-### 设备数据说明
|
|
|
+### 设备数据说明
|
|
|
|
|
|
-1. **设备数据分为两种**：
|
|
|
- - **第一种（设备数据）**：30 分钟上传一次。
|
|
|
- - **第二种（击杀计数）**：只要捕获到害虫就会触发上传一次。
|
|
|
-2. **设备数据包含**：设备号、环境温湿度、工作状态、电压等。
|
|
|
-3. **数据格式不可变**：设备数据格式不可变，不能按接收方增加或者减少字段，如有需求请联系销售经理。
|
|
|
-4. **接口安全**：可以针对传输方 IP 做限制，非传输方 IP 不允许调用接口（传输方 IP 可以联系对接人员提供）。
|
|
|
-5. **设备离线问题**：如果未及时收到 30 分钟上传一次的设备数据，说明设备离线。
|
|
|
-6. **接口设置**：由我们这边进行配置，您只需要把接口发给对接人员就可以了。
|
|
|
+- 数据上传时间为30分钟一次。
|
|
|
|
|
|
-## 设备数据报文结构
|
|
|
+### 设备对接说明
|
|
|
|
|
|
-### 设备数据
|
|
|
+- 对接采用HTTP协议，由接收方写接口来接收HTTP POST数据（需从requests的body（字节流类型）中取数据，取到之后进行JSON解析）。
|
|
|
+- 设备数据包含（设备号、设备电量、最近更新时间、不同深度温度、不同深度湿度、不同深度电导率等）。
|
|
|
+- 由接收方提供接口接收数据，设备方推送数据，需要提供一个接口（可以外网访问的接口）接收数据。
|
|
|
|
|
|
-```json
|
|
|
-{
|
|
|
- "b_v": "23.5",
|
|
|
- "b_c": "23.7",
|
|
|
- "p_v": "23.8",
|
|
|
- "p_c": "23.9",
|
|
|
- "uptime": "2021-05-25 17:41:26",
|
|
|
- "at": "35",
|
|
|
- "ah": "23",
|
|
|
- "warn": "",
|
|
|
- "imei": "e20210106947931",
|
|
|
- "protocoltype": 2
|
|
|
-}
|
|
|
-```
|
|
|
-字段说明
|
|
|
+## 设备数据报文结构
|
|
|
|
|
|
-| 字段名 | 描述 |
|
|
|
-| -------- | ------------------------ |
|
|
|
-| imei | 通讯板唯一 ID |
|
|
|
-| uptime | 数据采集时间 |
|
|
|
-| protocoltype | 数据类型 2：设备数据 |
|
|
|
-| at | 环境温度 |
|
|
|
-| ah | 环境湿度 |
|
|
|
-| b_v | 电池电压 |
|
|
|
-| b_c | 电池电流 |
|
|
|
-| p_v | 太阳能板电压 |
|
|
|
-| p_c | 太阳能板电流 |
|
|
|
-| warn | 警告信息 |
|
|
|
+### 报文结构
|
|
|
|
|
|
-设备击杀计数
|
|
|
```json
|
|
|
{
|
|
|
- "pest": 1,
|
|
|
- "imei": "e20210106947931",
|
|
|
- "protocoltype": 3
|
|
|
+ "IsSuccess": true,
|
|
|
+ "devLastData": [{
|
|
|
+ "POWER": 100,
|
|
|
+ "TIME": "2022-11-18 14:51:48",
|
|
|
+ "CSQ": 30,
|
|
|
+ "DataTEMPStr": "14.82, 13.79, 13.05",
|
|
|
+ "DataSWCStr": "0,0,21.58",
|
|
|
+ "DataATM": 0,
|
|
|
+ "DataAT": 16.4,
|
|
|
+ "DataATS": 0,
|
|
|
+ "devID": "868618056286065"
|
|
|
+ }]
|
|
|
}
|
|
|
```
|
|
|
-字段说明
|
|
|
|
|
|
-| 字段名 | 描述 |
|
|
|
-| ------------ | ------------------------ |
|
|
|
-| imei | 通讯板唯一 ID |
|
|
|
-| protocoltype | 数据类型 3：杀虫计数 |
|
|
|
-| pest | 击杀计数 |
|
|
|
+### 字段说明
|
|
|
+
|
|
|
+| 参数名 | 类型 | 说明 |
|
|
|
+| ----------- | ------ | ------------------------ |
|
|
|
+| IsSuccess | 布尔 | true: 成功，false: 失败 |
|
|
|
+| devLastData | 数组 | 设备数据数组 |
|
|
|
+| ErrMsg | 字符串 | 错误信息 |
|
|
|
+| devID | 字符串 | 设备ID号 |
|
|
|
+| POWER | 数值 | 设备电量 |
|
|
|
+| TIME | 字符串 | 最近更新时间 |
|
|
|
+| DataTEMPStr | 字符串 | 不同深度温度 |
|
|
|
+| DataSWCStr | 字符串 | 不同深度湿度 |
|
|
|
+| DataECStr | 字符串 | 不同深度电导率 |
|
|
|
+| DataATM | 数值 | 大气压强 |
|
|
|
+| DataAT | 数值 | 空气温度 |
|
|
|
+| DataATS | 数值 | 空气湿度 |
|
zhangwd