LS/T 1812-2017 粮油储藏 粮情测控信息交换接口协议技术要求

ICS35.240.99

B20

中华人民共和国粮食行业标准

/—

LST18122017

粮油储藏

粮情测控信息交换接口协议技术要求

—

GrainandoilstoraeMonitorinandcontrolsstemofstored-raincondition

ggyg

technicalreuirementsforinformationexchaneinterfacerotocol

qgp

2017-03-10发布2017-06-01实施

国家粮食局发布

/—

LST18122017

目次

前言…………………………Ⅲ

1范围………………………1

2规范性引用文件…………………………1

3术语和定义………………1

4粮情测控系统通信和信息交换…………2

5接口定义…………………2

()…………

附录资料性附录接口示例

A18

Ⅰ

/—

LST18122017

前言

本标准按照/—给出的规则起草。

GBT1.12009

本标准由国家粮食局提出。

(/)。

本标准由全国粮油标准化技术委员会SACTC270归口

:。

本标准负责起草单位河南工业大学

:、、

本标准参与起草单位国家粮食局科学研究院中储粮成都粮食储藏科学研究所株洲华邦科技发

、、、()、

展有限公司北京佳华储粮科技有限公司赤峰金辰电子公司湖北叶威集团智能科技有限公司湖南

万通科技股份有限公司。

:、、、、、、、、、、

本标准主要起草人肖乐甄彤赵会义祝玉华赵小军吴建军吕宗旺许德刚朱世华王强

、、、、、、、、、、。

叶维林朱江洪陈卫东孙福艳吴军里蔡军吴秋生刘自力林荣华薛渊李智慧

Ⅲ

/—

LST18122017

粮油储藏

粮情测控信息交换接口协议技术要求

1范围

、、。

本标准规定了粮情测控信息交换接口协议的术语和定义系统基本框架接口定义等技术内容

本标准适用于粮情测控系统信息交换体系的设计与建设。

2规范性引用文件

。,

下列文件对于本文件的应用是必不可少的凡是注日期的引用文件仅注日期的版本适用于本文

。,()。

件凡是不注日期的引用文件其最新版本包括所有的修改单适用于本文件

/—粮食仓储业务数据元

LST18022016

3术语和定义

下列术语和定义适用于本文件。

3.1

数据data

、,、。

对事实概念或指令的一种形式化表示适用于以人或自动方式进行通信解释或处理

3.2

表示reresentation

p

,。

值域和数据类型的组合必要时也包括计量单位或字符集

3.3

数据交换接口dataexchaneinterface

g

。,

不同系统之间为实现数据交换所规定的一组约定在粮情测控系统中数据交换接口负责访问粮

、。

情测控系统和其他系统的数据资源调用实现及反馈结果集等粮情测控系统和其他系统之间可以通

,。

过该接口的请求方法访问对方数据对方负责提供响应服务

3.4

数据项dataunit

、。

由数据项标识符数据项名称和数据项值三个元素组成

3.5

数据记录datarecord

,,。

组成数据集的基本单位表示一条记录数据记录由一个或多个数据项组成

3.6

数据集dataset

由一个或多个数据记录组成。

3.7

空白点blanksot

p

用于表示对应检测点位置无传感器的状态。

1

/—

LST18122017

4粮情测控系统通信和信息交换

4.1粮情测控系统上位机与分机的通信模式

()(),

粮情测控系统各部分主要包括粮情测控软件系统上位机与粮情测控硬件系统分机它们的通

信模式如下:

)上位机对分机发送读取或控制命令;

a

),。

b分机响应上位机命令发回相应数据或执行相应的控制

4.2粮情测控系统信息交换模式

粮情测控系统信息交换模式如下:

),;

a粮情测控系统和其他系统之间向对方请求服务调用对方服务接口

),。

b粮情测控系统或其他系统响应请求向对方返回利用数据集封装的结构化数据

5接口定义

5.1上位机与分机之间的通信接口

5.1.1字节传输格式

串口方式配置

、、、、、

粮食出入库业务信息系统一般由出入库登记扦样管理检验管理计量管理值仓管理结算管理

,,。

和统计分析等七个模块构成相关模块具有可扩展性如表所示

1

串口应按下列要求进行配置:

)位起始位;

a1

)位数据位;

b8

)无校验位;

c

)位停止位;

d1

)波特率。

e

:(:):、、。

注其中波特率的取值可以是但不限于下列数值单位Bs120048009600等

p

表1数据帧格式

字段名代码长度/

Bte

y

起始符55HAAH55HAAH4

分机地址KADDL1

控制符Command1

数据长度Lenth2

g

数据段DataSementL

g

校验a2

CRC-16

结束符16HE9H16HE9H4

a

其中CRC-16校验数据为从起始符开始到校验前的所有数据。

2

/—

LST18122017

以太网方式配置

以太网配置如下:

)服务器地址与测控分机地址设为同一网段;

aIPIP

)服务器端口:;端口:;

bTCP1238UDP1240

)。:;:

服务器以广播方式发送各种查询指令目标为全体目标端口

cUPDIP55

5000;

),:。

d测控分机以TCP方式返回数据测控分机的TCP端口3000

数据帧格式

通信接口的数据帧应符合表格式。

1

命令响应时间

()。

命令响应时间命令发送结束到接收到分机返回数据的第一个字节的时间小于或等于200ms

5.1.2通讯格式

读取分机状态指令

)上位机读取分机状态指令应按照表的格式发送。

a2

表2上位机读取分机状态指令格式

()

起始符KADDL分机地址CommandLenthCRC-16结束符

g

,。

Command=A0HLenth=0000H

g

)分机应按照表的格式返回状态数据。

b3

表3分机返回分机状态数据格式

()

起始符KADDL分机地址CommandLenthStateCRC-16结束符

g

,。,。

Command=80HLenth=0002HState为状态数据段占两个字节

g

读取仓外温湿度

)上位机读取仓外温湿度指令应按照表的格式发送。

a4

表4上位机读取仓外温湿度指令格式

()

起始符KADDL分机地址CommandLenthCRC-16结束符

g

,。

Command=A1HLenth=0000H

g

)分机应按照表的格式返回仓外温湿度数据。

b5

表5分机返回仓外温湿度数据格式

()

起始符KADDL分机地址CommandLenthCwtlCwthCwslCwshCRC-16结束符

g

3

/—

LST18122017

,。、、、共同组成数据段。、为仓

Command=81HLenth=0004HCwtlCwthCwslCwshCwtlCwth

g

,,。、,,

外温度其中Cwtl为低字节Cwth为高字节CwslCwsh为仓外湿度其中Cwsl为低字节Cwsh为

高字节。

读取仓内温湿度

)上位机读取仓内温湿度指令应按照表的格式发送。

a6

表6上位机读取仓内温湿度指令格式

()

起始符KADDL分机地址CommandLenthCRC-16结束符

g

,。

Command=A2HLenth=0000H

g

)分机应按照表的格式返回仓内温湿度数据。

b7

表7分机返回仓内温湿度数据格式

()

起始符KADDL分机地址CommandLenthDataSementCS-16结束符

gg

Cnt1lCnt1hCns1lCns1h…CntNlCntNhCnsNlCnsNh

,。、,

为第个仓内温度检测点值其中

Command=82HLenth=××××HCntNlCntNhN

g

,。、,

为低字节为高字节为第个仓内湿度检测点值其中为低字

CntNlCntNhCnsNlCnsNhNCnsNl

节,为高字节。

CnsNh

读取粮堆温度

)上位机读取粮堆温度指令应按照表的格式发送。

a8

表8上位机读取粮堆温度指令格式

()

起始符KADDL分机地址CommandLenthCRC-16结束符

g

,。

Command=A3HLenth=0000H

g

)分机应按照表或表的格式返回粮堆温度数据。

b910

表9分机返回粮堆温度的数据格式1

()

起始符KADDL分机地址CommandLenthDataSementCRC-16结束符

gg

L1T0lT0h……TnlTnhLnT0lT0h…TnlTnh

;。,。、

为第个传感器电缆的编号长度为两个字节

Command=53HLenth=××××HLnnTnl

g

,,

为某根电缆的第个检测点值同一条电缆的检测点排序为从上到下顺序排列其中为低字

TnhnTnl

节,为高字节。

Tnh

4

/—

LST18122017

表10分机返回粮堆温度的数据格式2

()

起始符KADDL分机地址CommandLenthDataSementCRC-16结束符

gg

T0lT0h…TnlTnh

;。、,

为某仓的第个温度检测点值其中为低

Command=83HLenth=××××HTnlTnhnTnl

g

字节,为高字节。

Tnh

读取仓内储粮害虫信息数据

)上位机读取仓内储粮害虫信息数据指令应按照表的格式发送。

a11

表11上位机读取仓内储粮害虫信息数据指令格式

()

起始符KADDL分机地址Command虫害分支器号mCRC-16结束符

Command=A4H。虫害分支器号=××××H。

)分机应按照表的格式返回其他粮情信息数据。

b12

表12分机返回仓内储粮害虫信息数据格式

()

起始符KADDL分机地址CommandLenthDataSementCRC-16结束符

gg

落虫次数I0…In虫害分支器号m

;;,

表明某仓号虫害分支器在时刻有虫落入其长度

Command=84HLenth=××××HInmIn

g

,。,。

为格式与时间的前个字节相同如果落虫次数为则不存在到字段

7BteDS130770I0In

y

读取其他粮情信息数据

其他粮情信息数据的读取应符合下述规定的格式:

)上位机读取其他粮情信息数据指令应按照表的格式发送。

a13

表13上位机读取其他粮情信息数据指令格式

()

起始符KADDL分机地址CommandLenthCRC-16结束符

g

,,。

的取值范围从到一种粮情信息使用一个命令控制符依此类推

CommandA5HBFHLenth

g

=0000H。

)分机应按照表的格式返回其他粮情信息数据。

b14

5

/—

LST18122017

表14分机返回其他粮情信息数据格式

()

起始符KADDL分机地址CommandLenthDataSementCRC-16结束符

gg

X0lX0h…XnlXnh

,,。

的取值范围从到一种粮情信息使用一个命令控制符依此类推

Command85H9FHLenth=

g

。、,,。

为某仓的第个某粮情信息检测点值其中为低字节为高字节

××××HXnlXnhnXnlXnh

粮情信息数据计算公式

):()/,;

a温度计算公式Tnh×256+Tnl10保留一位小数

):()/,;

b湿度计算公式Snh×256+Snl10保留一位小数

):()/,;

c其他粮情信息数据计算公式Xnh×256+Xnl10保留一位小数

),,;

d若某检测点无数据回复表示有误其中开路为7777H短路为8888H

)空白点的值为。

e9999H

粮情控制

)上位机读取粮情控制设备状态信息数据指令应按照表的格式发送。

a15

表15上位机读取粮情控制设备状态信息数据指令格式

()

起始符KADDL分机地址CommandLenthCRC-16结束符

g

,。

Command=C1HLenth=0000H

g

)分机应按照表的格式返回粮情控制设备状态信息数据。

b16

表16分机返回粮情控制设备状态信息数据格式

()

起始符KADDL分机地址CommandLenthDataSementCRC-16结束符

gg

EC0…ECn

,。为第个设备的当前状态。

Command=C2HLenth=××××HECnn

g

)上位机设定粮情控制设备状态的指令应按照表的格式发送。

c17

表17上位机设定粮情控制设备状态指令格式

()

起始符KADDL分机地址CommandLenthDataSementCRC-16结束符

gg

EC0…ECn

6

/—

LST18122017

,。为第个设备将要设定的状态。

Command=C3HLenth=××××HECnn

g

5.2粮情测控系统与其他系统之间的信息交换

5.2.1粮油仓库管理信息系统提供的数据交换接口

获取库点基本信息数据方法的接口定义:

):;

a服务请求方粮情测控系统

):;

b服务响应方粮油仓库管理信息系统

)方法名称:_;

cGetDeotInfoData

p

):;

d返回类型复合型

)参数应参照表的要求;

e18

表18获取仓点基本信息数据方法参数表

序号参数短名数据类型数据格式

1库点代码kddm字符型a.3

)返回值应参照表的要求。

f19

表19获取库点基本信息数据方法返回值表

序号参数短名数据类型数据格式备注

1所属企业组织机构代码sszzdm字符型a.9

qyjg

2所属企业统一社会信用代码sstshxdm字符型a.18

qyyy

3所属企业名称ssmc字符型a..50

qy

4库点代码kddm字符型a.3

5库点名称kdmc字符型a..50

6库点简称kdc字符型a..20

j

7库点企业性质kdxz字符型a.1

qy

8库点类别kdlb字符型a..20含义及类型参见

建成日期日期型/—

9crYYYYMMDDLST18022016

jq

10库点设计仓容kdscr数值型n..8中6.1.3

j

库点面积数值型,

11kdmjn..102

12库点电话kddh字符型a..50

13库点传真kdcz字符型a..50

14库点地址kddz字符型a..200

15库点邮政编码kdzbm字符型a.6

y

16库点行政区划名称kdxzhmc字符型a..50

q

17库点行政区划代码kdxzhdm字符型a.6

q

获取仓房基本信息数据方法的接口定义:

):;

a服务请求方粮情测控系统

7

/—

LST18122017

):;

b服务响应方粮油仓库管理信息系统

)方法名称:_;

cGetBarnBaseInfoData

):;

d返回类型复合型

)参数应参照表的要求;

e20

表20获取仓房基本信息数据方法参数表

序号参数短名数据类型数据格式备注

1库点代码kddm字符型a.3

2仓房编号cfbh字符型a.3为空时返回所有仓房信息

)返回值应参照表的要求。

f21

表21获取仓房基本信息数据方法返回值表

序号参数短名数据类型数据格式备注

1所属库点sskd字符型a..20

2仓房编号cfbh字符型a.3

3仓房名称cfmc字符型a..20

4仓房类型cflx字符型a.7

5仓房结构cf字符型a..20

jg

6建筑类型zlx字符型a..20

j

(),

7仓房长度直径cfcdz数值型n..51

j

仓房宽度数值型,

8cfkdn..51含义及类型参见