yfdoc/zh-cn/lsgssq/lsgssq.md

管式墒情协议

简述

本文档主要用于阐述物联网管式墒情设备与服务器端进行交互的通讯细节，其中包括物联网管式墒情设备与服务器之间使用的通信协议和交互通讯协议两部分。

适用范围

适用于【通用物联网管式墒情设备】与服务器之间的通讯。

对接说明

设备数据说明

• 数据上传时间为30分钟一次。

设备对接说明

• 对接采用HTTP协议，由接收方写接口来接收HTTP POST数据（需从requests的body（字节流类型）中取数据，取到之后进行JSON解析）。
• 设备数据包含（设备号、设备电量、最近更新时间、不同深度温度、不同深度湿度、不同深度电导率等）。
• 由接收方提供接口接收数据，设备方推送数据，需要提供一个接口（可以外网访问的接口）接收数据。

设备数据报文结构

报文结构

{
  "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"
  }]
}

字段说明

参数名	类型	说明
IsSuccess	布尔	true: 成功，false: 失败
devLastData	数组	设备数据数组
ErrMsg	字符串	错误信息
devID	字符串	设备ID号
POWER	数值	设备电量
TIME	字符串	最近更新时间
DataTEMPStr	字符串	不同深度温度
DataSWCStr	字符串	不同深度湿度
DataECStr	字符串	不同深度电导率
DataATM	数值	大气压强
DataAT	数值	空气温度
DataATS	数值	空气湿度