路径: 主页 > MISC > 第226页 > LST1812-2017 | 标准编号 | LS/T 1812-2017 (LS/T1812-2017) | | 中文名称 | 粮油储藏 粮情测控信息交换接口协议技术要求 | | 英文名称 | Grain and oil storage. Monitoring and control system of stored-grain condition technical requirements for information exchange interface protocol | | 行业 | 粮食行业标准 (推荐) | | 中标分类 | B20 | | 国际标准分类 | 35.240.99 | | 字数估计 | 31,324 | | 发布日期 | 2017-03-10 | | 实施日期 | 2017-06-01 | | 引用标准 | LS/T 1802-2016 | | 标准依据 | State-Food-Communication No. 1 of 2017 | | 发布机构 | 国家粮食局 | | 范围 | 本标准规定了粮情测控信息交换接口协议的术语和定义、系统基本框架、接口定义等技术内容。本标准适用于粮情测控系统信息交换体系的设计与建设。 | LS/T 1812-2017
Grain and oil storage.Monitoring and control system of stored-grain condition technical requirements for information exchange interface protocol
ICS 35.240.99
B20
中华人民共和国粮食行业标准
粮油储藏
粮情测控信息交换接口协议技术要求
2017-03-10发布
2017-06-01实施
国 家 粮 食 局 发 布
目次
前言 Ⅲ
1 范围 1
2 规范性引用文件 1
3 术语和定义 1
4 粮情测控系统通信和信息交换 2
5 接口定义 2
附录A(资料性附录) 接口示例 18
前言
本标准按照GB/T 1.1-2009给出的规则起草。
本标准由国家粮食局提出。
本标准由全国粮油标准化技术委员会(SAC/TC270)归口。
本标准负责起草单位:河南工业大学。
本标准参与起草单位:国家粮食局科学研究院、中储粮成都粮食储藏科学研究所、株洲华邦科技发
展有限公司、北京佳华储粮科技有限公司、赤峰金辰电子公司、湖北叶威(集团)智能科技有限公司、湖南
万通科技股份有限公司。
本标准主要起草人:肖乐、甄彤、赵会义、祝玉华、赵小军、吴建军、吕宗旺、许德刚、朱世华、王强、
叶维林、朱江洪、陈卫东、孙福艳、吴军里、蔡军、吴秋生、刘自力、林荣华、薛渊、李智慧。
粮油储藏
粮情测控信息交换接口协议技术要求
1 范围
本标准规定了粮情测控信息交换接口协议的术语和定义、系统基本框架、接口定义等技术内容。
本标准适用于粮情测控系统信息交换体系的设计与建设。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文
件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
LS/T 1802-2016 粮食仓储业务数据元
3 术语和定义
下列术语和定义适用于本文件。
3.1
数据 data
对事实、概念或指令的一种形式化表示,适用于以人或自动方式进行通信、解释或处理。
3.2
表示 representation
值域和数据类型的组合,必要时也包括计量单位或字符集。
3.3
不同系统之间为实现数据交换所规定的一组约定。在粮情测控系统中,数据交换接口负责访问粮
情测控系统和其他系统的数据资源调用、实现及反馈结果集等。粮情测控系统和其他系统之间可以通
过该接口的请求方法访问对方数据,对方负责提供响应服务。
3.4
数据项 dataunit
由数据项标识符、数据项名称和数据项值三个元素组成。
3.5
数据记录 datarecord
组成数据集的基本单位,表示一条记录,数据记录由一个或多个数据项组成。
3.6
数据集 dataset
由一个或多个数据记录组成。
3.7
空白点 blankspot
用于表示对应检测点位置无传感器的状态。
4 粮情测控系统通信和信息交换
4.1 粮情测控系统上位机与分机的通信模式
粮情测控系统各部分主要包括粮情测控软件系统(上位机)与粮情测控硬件系统(分机),它们的通
信模式如下:
a) 上位机对分机发送读取或控制命令;
b) 分机响应上位机命令,发回相应数据或执行相应的控制。
4.2 粮情测控系统信息交换模式
粮情测控系统信息交换模式如下:
a) 粮情测控系统和其他系统之间向对方请求服务,调用对方服务接口;
b) 粮情测控系统或其他系统响应请求,向对方返回利用数据集封装的结构化数据。
5 接口定义
5.1 上位机与分机之间的通信接口
5.1.1 字节传输格式
5.1.1.1 串口方式配置
粮食出入库业务信息系统一般由出入库登记、扦样管理、检验管理、计量管理、值仓管理、结算管理
和统计分析等七个模块构成,相关模块具有可扩展性,如表1所示。
串口应按下列要求进行配置:
a) 1位起始位;
b) 8位数据位;
c) 无校验位;
d) 1位停止位;
e) 波特率。
注:其中波特率的取值可以是但不限于下列数值(单位:Bps):1200、4800、9600等。
表1 数据帧格式
字 段 名 代 码 长 度/Byte
起始符 55HAAH55HAAH 4
分机地址 KADDL 1
控制符 Command 1
数据长度 Length 2
数据段 DataSegment L
校验 CRC-16a 2
结束符 16HE9H16HE9H 4
a 其中CRC-16校验数据为从起始符开始到校验前的所有数据。
5.1.1.2 以太网方式配置
以太网配置如下:
a) 服务器IP地址与测控分机IP地址设为同一网段;
b) 服务器TCP端口:1238;UDP端口:1240;
c) 服务器以 UPD广播方式发送各种查询指令。目标IP为全体:255.255.255.255;目标端口:
5000;
d) 测控分机以TCP方式返回数据,测控分机的TCP端口:3000。
5.1.1.3 数据帧格式
通信接口的数据帧应符合表1格式。
5.1.1.4 命令响应时间
命令响应时间(命令发送结束到接收到分机返回数据的第一个字节的时间)小于或等于200ms。
5.1.2 通讯格式
5.1.2.1 读取分机状态指令
a) 上位机读取分机状态指令应按照表2的格式发送。
表2 上位机读取分机状态指令格式
起始符 KADDL(分机地址) Command Length CRC-16 结束符
Command=A0H,Length=0000H。
b) 分机应按照表3的格式返回状态数据。
表3 分机返回分机状态数据格式
起始符 KADDL(分机地址) Command Length State CRC-16 结束符
Command=80H,Length=0002H。State为状态数据段,占两个字节。
5.1.2.2 读取仓外温湿度
a) 上位机读取仓外温湿度指令应按照表4的格式发送。
表4 上位机读取仓外温湿度指令格式
起始符 KADDL(分机地址) Command Length CRC-16 结束符
Command=A1H,Length=0000H。
b) 分机应按照表5的格式返回仓外温湿度数据。
表5 分机返回仓外温湿度数据格式
起始符 KADDL(分机地址) Command Length Cwtl Cwth Cwsl Cwsh CRC-16 结束符
Command=81H,Length=0004H。Cwtl、Cwth、Cwsl、Cwsh共同组成数据段。Cwtl、Cwth为仓
外温度,其中Cwtl为低字节,Cwth为高字节。Cwsl、Cwsh为仓外湿度,其中Cwsl为低字节,Cwsh为
高字节。
5.1.2.3 读取仓内温湿度
a) 上位机读取仓内温湿度指令应按照表6的格式发送。
表6 上位机读取仓内温湿度指令格式
起始符 KADDL(分机地址) Command Length CRC-16 结束符
Command=A2H,Length=0000H。
b) 分机应按照表7的格式返回仓内温湿度数据。
表7 分机返回仓内温湿度数据格式
起始符 KADDL(分机地址) Command Length DataSegment CS-16 结束符
Cnt1l Cnt1h Cns1l Cns1h CntNlCntNh CnsNlCnsNh
CntNl为低字节,CntNh为高字节。CnsNl、CnsNh为第N 个仓内湿度检测点值,其中CnsNl为低字
节,CnsNh为高字节。
5.1.2.4 读取粮堆温度
a) 上位机读取粮堆温度指令应按照表8的格式发送。
表8 上位机读取粮堆温度指令格式
起始符 KADDL(分机地址) Command Length CRC-16 结束符
Command=A3H,Length=0000H。
b) 分机应按照表9或表10的格式返回粮堆温度数据。
表9 分机返回粮堆温度的数据格式1
起始符 KADDL(分机地址) Command Length DataSegment CRC-16 结束符
L1 T0l T0h Tnl Tnh Ln T0l T0h Tnl Tnh
Tnh为某根电缆的第n个检测点值,同一条电缆的检测点排序为从上到下顺序排列,其中Tnl为低字
节,Tnh为高字节。
表10 分机返回粮堆温度的数据格式2
起始符 KADDL(分机地址) Command Length DataSegment CRC-16 结束符
T0l T0h Tnl Tnh
字节,Tnh为高字节。
5.1.2.5 读取仓内储粮害虫信息数据
a) 上位机读取仓内储粮害虫信息数据指令应按照表11的格式发送。
表11 上位机读取仓内储粮害虫信息数据指令格式
起始符 KADDL(分机地址) Command 虫害分支器号m CRC-16 结束符
b) 分机应按照表12的格式返回其他粮情信息数据。
表12 分机返回仓内储粮害虫信息数据格式
起始符 KADDL(分机地址) Command Length DataSegment CRC-16 结束符
落虫次数 I0 In 虫害分支器号m
为7Byte,格式与DS1307时间的前7个字节相同。如果落虫次数为0,则不存在I0到In字段。
5.1.2.6 读取其他粮情信息数据
其他粮情信息数据的读取应符合下述规定的格式:
a) 上位机读取其他粮情信息数据指令应按照表13的格式发送。
表13 上位机读取其他粮情信息数据指令格式
起始符 KADDL(分机地址) Command Length CRC-16 结束符
Command的取值范围从 A5H 到BFH,一种粮情信息使用一个命令控制符,依此类推。Length
=0000H。
b) 分机应按照表14的格式返回其他粮情信息数据。
表14 分机返回其他粮情信息数据格式
起始符 KADDL(分机地址) Command Length DataSegment CRC-16 结束符
X0l X0h Xnl Xnh
Command的取值范围从85H到9FH,一种粮情信息使用一个命令控制符,依此类推。Length=
5.1.2.7 粮情信息数据计算公式
a) 温度计算公式:(Tnh×256+Tnl)/10,保留一位小数;
b) 湿度计算公式:(Snh×256+Snl)/10,保留一位小数;
c) 其他粮情信息数据计算公式:(Xnh×256+Xnl)/10,保留一位小数;
d) 若某检测点无数据回复表示有误,其中开路为7777H,短路为8888H;
e) 空白点的值为9999H。
5.1.2.8 粮情控制
a) 上位机读取粮情控制设备状态信息数据指令应按照表15的格式发送。
表15 上位机读取粮情控制设备状态信息数据指令格式
起始符 KADDL(分机地址) Command Length CRC-16 结束符
Command=C1H,Length=0000H。
b) 分机应按照表16的格式返回粮情控制设备状态信息数据。
表16 分机返回粮情控制设备状态信息数据格式
起始符 KADDL(分机地址) Command Length DataSegment CRC-16 结束符
EC0 ECn
c) 上位机设定粮情控制设备状态的指令应按照表17的格式发送。
表17 上位机设定粮情控制设备状态指令格式
起始符 KADDL(分机地址) Command Length DataSegment CRC-16 结束符
EC0 ECn
5.2 粮情测控系统与其他系统之间的信息交换
5.2.1 粮油仓库管理信息系统提供的数据交换接口
5.2.1.1 获取库点基本信息数据方法的接口定义:
a) 服务请求方:粮情测控系统;
b) 服务响应方:粮油仓库管理信息系统;
c) 方法名称:Get_DepotInfoData;
d) 返回类型:复合型;
e) 参数应参照表18的要求;
表18 获取仓点基本信息数据方法参数表
序号 参数 短名 数据类型 数据格式
1 库点代码 kddm 字符型 a.3
f) 返回值应参照表19的要求。
表19 获取库点基本信息数据方法返回值表
序号 参数 短名 数据类型 数据格式 备注
1 所属企业组织机构代码 ssqyzzjgdm 字符型 a.9
2 所属企业统一社会信用代码 ssqytyshxydm 字符型 a.18
3 所属企业名称 ssqymc 字符型 a.50
4 库点代码 kddm 字符型 a.3
5 库点名称 kdmc 字符型 a.50
6 库点简称 kdjc 字符型 a.20
7 库点企业性质 kdqyxz 字符型 a.1
8 库点类别 kdlb 字符型 a.20
9 建成日期 jcrq 日期型 YYYYMMDD
10 库点设计仓容 kdsjcr 数值型 n.8
11 库点面积 kdmj 数值型 n.10,2
12 库点电话 kddh 字符型 a.50
13 库点传真 kdcz 字符型 a.50
14 库点地址 kddz 字符型 a.200
15 库点邮政编码 kdyzbm 字符型 a.6
16 库点行政区划名称 kdxzqhmc 字符型 a.50
17 库点行政区划代码 kdxzqhdm 字符型 a.6
含义及类型参见
LS/T 1802-2016
中6.1.3
5.2.1.2 获取仓房基本信息数据方法的接口定义:
a) 服务请求方:粮情测控系统;
b) 服务响应方:粮油仓库管理信息系统;
c) 方法名称:Get_BarnBaseInfoData;
d) 返回类型:复合型;
e) 参数应参照表20的要求;
表20 获取仓房基本信息数据方法参数表
序号 参数 短名 数据类型 数据格式 备注
1 库点代码 kddm 字符型 a.3
2 仓房编号 cfbh 字符型 a.3 为空时返回所有仓房信息
f) 返回值应参照表21的要求。
表21 获取仓房基本信息数据方法返回值表
序号 参数 短名 数据类型 数据格式 备注
1 所属库点 sskd 字符型 a.20
2 仓房编号 cfbh 字符型 a.3
3 仓房名称 cfmc 字符型 a.20
4 仓房类型 cflx 字符型 a.7
5 仓房结构 cfjg 字符型 a.20
6 建筑类型 jzlx 字符型 a.20
7 仓房长度(直径) cfcdzj 数值型 n.5,1
8 仓房宽度 cfkd 数值型 n.5,1
9 仓房高度 cfgd 数值型 n.5,1
10 仓房设计仓容 cfsjcr 数值型 n.8
11 仓房实际仓容 cfsjcr01 数值型 n.8
12 启用日期 qyrq 日期型 YYYYMMDD
13 仓房状态 cfzt 字符型 a.1
14 仓房使用状态 cfsyzt 字符型 a.1
15 罩棚 zp 数值型 a.15,2
16 简易囤 jyd 数值型 a.15,2
17 简易仓 jyc 数值型 a.15,2
......
|