农产品仓储保鲜冷链信息系统技术参数和指标Word格式.docx
《农产品仓储保鲜冷链信息系统技术参数和指标Word格式.docx》由会员分享，可在线阅读，更多相关《农产品仓储保鲜冷链信息系统技术参数和指标Word格式.docx（14页珍藏版）》请在冰点文库上搜索。
STRING
GBK编码，若无数据，置空
FLOAT
单精度浮点型；
4字节（32位）
3.传输规则
协议采用大端模式（big-endian）的网络字节序来传递字和双字。
约定如下：
——字节（BYTE）的传输约定：
按照字节流的方式传输；
——字（WORD）的传输约定：
先传递高8位，再传递低8位；
——双字（DWORD）的传输约定：
先传递高24位，然后传高16位，再传递高8位，最后传递低8位
4.消息的组成
（1）消息结构。
每条消息由标识位、消息头、消息体和校验码组成，消息结构下图所示：
标识位[BYTE]
消息头
[16BYTESJ
消息体
[NBYTES]
检验码[BYTE]
（2）标识位。
釆用0x6c表示，若校验码、消息头以及消息体中出现0x6c，则要进行转义处理，转义规则定义如下：
0x6c<
----------------->
0x6b后紧跟一个0x02；
0x6b后紧跟一个0x01。
（3）消息头。
消息头内容详见下表：
（消息头的长度不定，主要是消息体属性长度和消惠包封装项会变）
消息头内容
起始字母
字段
消息ID
2
消息体属性
消息体属性格式结构图见图2
4
终端序列号
BYTE[6]
该终端设备的唯一码：
（仅使用
前4个字节（0-3）
10
消息流水号
按发送顺序从0开始循环累加
12
消息包封装项
如果消息体属性中相关标识位确定消息分包处理，则该项有内容，否则无该项
消息体属性格式结构图下图所示：
（以下为16bit位方式）
15
14
13
11
9
8
7
6
5
3
1
保留
消息体长度
消息体属性格式结构图消息体长度：
bit0-bit9，最长1023。
（4）消息体
数据透传消息体数据格式如下图所示：
起始字节
透传消息类型
透传消息类型定义见表格18
透传消息内容
透传消息类型定义表如下图所示：
定义
检测数据
0xFC
透传消息类型定义见表格19
5.数据格式
（1）数据上行透传
消息ID：
0x0900。
监测数据：
透传消息类型：
0xFC。
透传消息内容数据格式如下表（透传消息内容：
打包数据包括多设备多条数据）
0：
实时数据；
1：
历坐数据；
数据条数
C
发送的一包数据包含几个（比如）单温数据（和消息包封装项里面的息总包数和包序号区别！
）
数据内容
BYTE[C*（16+4N）]
数据内容定义见数据内容定义表
数据内容定义
终端设备唯一码
外接电源状态
无外接电（报警）1：
有外接电
信号强度
0-31
网络类型
00—未知
01—移动20
02—移动2.5G
03—移动3G
04—移动4G
05—移动混合网络
06—联通2G
07—联通3G
08—联通4G
09—电信2G
10—电信3G
11—电信4G
12—移动NB-IOT
13—联通NB-IOT
14—电信NB-IOT
15—WiFi
电池电量百分比
00-100
时间戳
BCD[6]
本条数据时间点：
YY-MM-DD-hh-mm-ss
19-09-06-15-32-01
透道数量
N
传感器类型
默认：
00
16
数据值
实际值（-1000为ERR）
…
现在假设终端发送一包数据最大的是1024字节，除去2字节的标识位，16字节的消息头（分包发送数据），1字节校验码，消息体里面的3字节：
1字节的透传消息类型，1字节的数据类型，1字节的数据条数；
还剩下1024-22=1002字节留给数据内容。
6.平台通用应答（上位机向设备发）
0x8001。
平台通用应答消息体数据格式如下表：
应答流水号（平台给设备流水号
对应的终端消息的流水号
应答ID
对应的终端消总的ID
结果
成功确认：
失数；
2：
消息有误：
3：
不支持：
4：
报警处理确认
7.校验码指从消息头开始，同后一字节异或，直到校验码前个字节，占用一个字节。
三、移动端数据传输接口规范
（一）目的范围。
本接口文档为移动端与平台进行数据交互时使用到的接口文档。
（二）接口描述
1.协议约定
接口方式
hitpPOST
Content-Type:
application/json
编码格式
UTF-8
传输格式
JSON
2.接口地址，http:
//应用服务器IP地址路由地址
3.接口说明
（1）获取授权码
路由地址：
loginApp
描述：
根据用户登录信息获取投权码，其他所有功能接口需要使用该授权码方可正常使用对应功能。
请求参数：
参数项
是否必填
参数说明
user
String
是
用户名（需base64加密）
pwd
密码（需base64加密）
返回字段：
success
boolean
响应结果：
true-成功，false-失败
sessid
授权码
（2）添加库房信息
warehouse/add
请求参数
授权码（由2.3.1接口获取）
name
库房名称
manager
管理员姓名
location
库房位置描述
lng
Float
库房所在地经度
lat
库房所在地纬度
error
异常信息（仅响应结果为失败时有效）
（3）修改库房信息
warehouse/edit
Id
库房id
（4）删除库房信息
warehouse/delete
（5）获取库房信息
warehouse/list
结构参考1.5通用响应消息，其中数据集合中的每项数据格式如下：
（6）获取库房环境信息
warehouse/environment
time
实时数据时间（yyyy-MM-ddhh:
mm:
ss）
channel
Json
通道数据key：
通道id
通道数据的数据结构：
属性名称
通道名称
date
监测数据
warm
是否异常
（7）入库
warehouse/in
production
商品id
weight
重量
number
数量
price
价格
photo
照片
deadline
到期时间（yyyy-MM-dd）
batch
入库商品批号
（8）出库
warehouse/out
bath
商品批号
（9）获取农产品信息
production/list
结构参考1.5通用响应消息，其中数据集合中的每项数据格式如下
type
品类
产地
（10）添加商品信息
production/add
（11）修改商品信息
production/edit
（12）删除商品信息
production/delete
升级会员 