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

ICS3524099

B20..

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

LS/T1812—2017

粮油储藏

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

Grainandoilstorage—Monitoringandcontrolsystemofstored-graincondition

technicalrequirementsforinformationexchangeinterfaceprotocol

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

国家粮食局发布

LS/T1812—2017

目次

前言

…………………………Ⅲ

范围

1………………………1

规范性引用文件

2…………………………1

术语和定义

3………………1

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

4…………2

接口定义

5…………………2

附录资料性附录接口示例

A()…………18

Ⅰ

LS/T1812—2017

前言

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

GB/T1.1—2009。

本标准由国家粮食局提出

。

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

(SAC/TC270)。

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

:。

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

:、、

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

、、、()、

万通科技股份有限公司

。

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

:、、、、、、、、、、

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

、、、、、、、、、、。

Ⅲ

LS/T1812—2017

粮油储藏

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

1范围

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

、、。

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

。

2规范性引用文件

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

。,

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

。,()。

粮食仓储业务数据元

LS/T1802—2016

3术语和定义

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

。

31

.

数据data

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

、,、。

32

.

表示representation

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

,。

33

.

数据交换接口dataexchangeinterface

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

。,

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

、。

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

,。

34

.

数据项dataunit

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

、。

35

.

数据记录datarecord

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

,,。

36

.

数据集dataset

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

。

37

.

空白点blankspot

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

。

1

LS/T1812—2017

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

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

.

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

()(),

信模式如下

:

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

a);

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

b),。

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

.

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

:

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

a),;

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

b),。

5接口定义

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

.

511字节传输格式

..

5111串口方式配置

...

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

、、、、、

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

,,1。

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

:

位起始位

a)1;

位数据位

b)8;

无校验位

c);

位停止位

d)1;

波特率

e)。

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

:(:Bps):1200、4800、9600。

表1数据帧格式

字段名代码长度

/Byte

起始符

55HAAH55HAAH4

分机地址

KADDL1

控制符

Command1

数据长度

Length2

数据段

DataSegmentL

校验a

CRC-162

结束符

16HE9H16HE9H4

a其中校验数据为从起始符开始到校验前的所有数据

CRC-16。

2

LS/T1812—2017

5112以太网方式配置

...

以太网配置如下

:

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

a)IPIP;

服务器端口端口

b)TCP:1238;UDP:1240;

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

c)UPD。IP:55;:

5000;

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

d)TCP,TCP:3000。

5113数据帧格式

...

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

1。

5114命令响应时间

...

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

()200ms。

512通讯格式

..

5121读取分机状态指令

...

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

a)2。

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

起始符分机地址结束符

KADDL()CommandLengthCRC-16

Command=A0H,Length=0000H。

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

b)3。

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

起始符分机地址结束符

KADDL()CommandLengthStateCRC-16

为状态数据段占两个字节

Command=80H,Length=0002H。State,。

5122读取仓外温湿度

...

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

a)4。

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

起始符分机地址结束符

KADDL()CommandLengthCRC-16

Command=A1H,Length=0000H。

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

b)5。

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

起始符分机地址结束符

KADDL()CommandLengthCwtlCwthCwslCwshCRC-16

3

LS/T1812—2017

共同组成数据段为仓

Command=81H,Length=0004H。Cwtl、Cwth、Cwsl、Cwsh。Cwtl、Cwth

外温度其中为低字节为高字节为仓外湿度其中为低字节为

,Cwtl,Cwth。Cwsl、Cwsh,Cwsl,Cwsh

高字节

。

5123读取仓内温湿度

...

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

a)6。

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

起始符分机地址结束符

KADDL()CommandLengthCRC-16

Command=A2H,Length=0000H。

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

b)7。

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

起始符分机地址结束符

KADDL()CommandLengthDataSegmentCS-16

NNNN

Cnt1lCnt1hCns1lCns1h…CntlCnthCnslCnsh

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

Command=82H,Length=××××H。Cntl、Cnth,

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

Cntl,Cnth。Cnsl、Cnsh,Cnsl

节N为高字节

,Cnsh。

5124读取粮堆温度

...

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

a)8。

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

起始符分机地址结束符

KADDL()CommandLengthCRC-16

Command=A3H,Length=0000H。

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

b)910。

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

起始符分机地址结束符

KADDL()CommandLengthDataSegmentCRC-16

nnnnn

L1T0lT0h……TlThLT0lT0h…TlTh

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

Command=53H;Length=××××H。L,。Tl、

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

Th,,Tl

节n为高字节

,Th。

4

LS/T1812—2017

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

起始符分机地址结束符

KADDL()CommandLengthDataSegmentCRC-16

nn

T0lT0h…TlTh

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

Command=83H;Length=××××H。Tl、Th,Tl

字节n为高字节

,Th。

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

...

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

a)11。

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

起始符分机地址虫害分支器号m结束符

KADDL()CommandCRC-16

虫害分支器号

Command=A4H。=××××H。

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

b)12。

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

起始符分机地址结束符

KADDL()CommandLengthDataSegmentCRC-16

落虫次数n虫害分支器号m

I0…I

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

Command=84H;Length=××××H;II,

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

7Byte,DS13077。0,I0I。

5126读取其他粮情信息数据

...

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

:

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

a)13。

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

起始符分机地址结束符

KADDL()CommandLengthCRC-16

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

CommandA5HBFH,,。Length

=0000H。

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

b)14。

5

LS/T1812—2017

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

起始符分机地址结束符

KADDL()CommandLengthDataSegmentCRC-16

nn

X0lX0h…XlXh

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

Command85H9FH,,。Length=

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

××××H。Xl、Xh,Xl,Xh。

5127粮情信息数据计算公式

...

温度计算公式nn保留一位小数

a):(Th×256+Tl)/10,;

湿度计算公式nn保留一位小数

b):(Sh×256+Sl)/10,;

其他粮情信息数据计算公式nn保留一位小数

c):(Xh×256+Xl)/10,;

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

d),7777H,8888H;

空白点的值为

e)9999H。

5128粮情控制

...

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

a)15。

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

起始符分机地址结束符

KADDL()CommandLengthCRC-16

Command=C1H,Length=0000H。

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

b)16。

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

起始符分机地址结束符

KADDL()CommandLengthDataSegmentCRC-16

n

EC0…EC

n为第n个设备的当前状态

Command=C2H,Length=××××H。EC。

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

c)17。

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

起始符分机地址结束符

KADDL()CommandLengthDataSegmentCRC-16

n

EC0…EC

6

LS/T1812—2017

n为第n个设备将要设定的状态

Command=C3H,Length=××××H。EC。

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

.

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

..

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

...:

服务请求方粮情测控系统

a):;

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

b):;

方法名称

c):Get_DepotInfoData;

返回类型复合型

d):;

参数应参照表的要求

e)18;

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

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

库点代码字符型

1kddma.3

返回值应参照表的要求

f)19。

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

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

所属企业组织机构代码字符型

1ssqyzzjgdma.9

所属企业统一社会信用代码字符型

2ssqytyshxydma.18

所属企业名称字符型

3ssqymca..50

库点代码字符型

4kddma.3

库点名称字符型

5kdmca..50

库点简称字符型

6kdjca..20

库点企业性质字符型

7kdqyxza.1

库点类别字符型

8kdlba..20含义及类型参见

建成日期日期型

9jcrqYYYYMMDDLS/T1802—2016

库点设计仓容数值型中

10kdsjcrn..86.1.3

库点面积数值型

11kdmjn..10,2

库点电话字符型

12kddha..50

库点传真字符型

13kdcza..50

库点地址字符型

14kddza..200

库点邮政编码字符型

15kdyzbma.6

库点行政区划名称字符型

16kdxzqhmca..50

库点行政区划代码字符型

17kdxzqhdma.6

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

...:

服务请求方粮情测控系统

a):;

7

LS/T1812—2017

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

b):;

方法名称

c):Get_BarnBaseInfoData;

返回类型复合型

d):;

参数应参照表的要求

e)20;

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

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

库点代码字符型

1kddma.3

仓房编号字符型为空时返回所有仓房信息

2cfbha.3

返回值应参照表的要求

f)21。

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

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

所属库点字符型

1sskda..20

仓房编号字符型

2cfbha.3

仓房名称字符型

3cfmca..20

仓房类型字符型

4cflxa.7

仓房结构字符型

5cfjga..20

建筑类型字符型

6jzlxa..20

仓房长度直径数值型

7()cfcdzjn..5,1

仓房宽度数值型

8cfkdn..5,1含义及类型参见

仓房高度数值型

9cfgdn..5,1LS/T1802—2016

仓房设计仓容数值型中

10cfsjcrn..86.1.4

仓房实际仓容数值型

11cfsjcr01n..8

启用日期日期型

12qyrqYYYYMMDD

仓房状态字符型

13