LS/T 1812-2017
基本信息
标准号:
LS/T 1812-2017
中文名称:粮油储藏 粮情测控信息交换接口协议技术要求
标准类别:粮食行业标准(LS)
标准状态:现行
出版语种:简体中文
下载格式:.rar .pdf
下载大小:998KB
相关标签:
粮油
储藏
测控
信息
交换
接口协议
技术
标准分类号
关联标准
出版信息
相关单位信息
标准简介
LS/T 1812-2017 粮油储藏 粮情测控信息交换接口协议技术要求
LS/T1812-2017
标准压缩包解压密码:www.bzxz.net
标准内容
ICS35.240.99
中华人民共和国粮食行业标准
LS/T1812—2017
粮油储藏
粮情测控信息交换接口协议技术要求Grain and oil storage-Monitoring and control system of stored-grain conditiontechnical requirements for information exchange interface protocol2017-03-10发布
国家粮食局
2017-06-01实施
规范性引用文件wwW.bzxz.Net
术语和定义
粮情测控系统通信和信息交换
接口定义
附录A(资料性附录)
接口示例
LS/T 1812—2017
本标准按照GB/T1.1-2009给出的规则起草本标准由国家粮食局提出。
本标准由全国粮油标准化技术委员会(SAC/TC270)归口。本标准负责起草单位:河南工业大学LS/T1812—2017
本标准参与起草单位:国家粮食局科学研究院、中储粮成都粮食储藏科学研究所、株洲华邦科技发展有限公司、北京佳华储粮科技有限公司、赤峰金辰电子公司、湖北叶威(集团)智能科技有限公司、湖南万通科技股份有限公司。
本标准主要起草人:肖乐、甄彤、赵会义、祝玉华、赵小军、吴建军、吕宗旺、许德刚、朱世华、王强、叶维林、朱江洪、陈卫东、孙福艳、吴军里、蔡军、吴秋生、刘自力、林荣华、薛渊、李智慧。m
1范围
粮油储藏
粮情测控信息交换接口协议技术要求LS/T1812—2017
本标准规定了粮情测控信息交换接口协议的术语和定义、系统基本框架、接口定义等技术内容本标准适用于粮情测控系统信息交换体系的设计与建设规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。LS/T1802—2016粮食仓储业务数据元术语和定义
下列术语和定义适用于本文件。3.1
数据data
对事实、概念或指令的一种形式化表示,适用于以人或自动方式进行通信、解释或处理。3.2
representation
值域和数据类型的组合,必要时也包括计量单位或字符集。3.3
数据交换接口dataexchangeinterface不同系统之间为实现数据交换所规定的一组约定。在粮情测控系统中,数据交换接口负责访问粮情测控系统和其他系统的数据资源调用、实现及反馈结果集等。粮情测控系统和其他系统之间可以通过该接口的请求方法访问对方数据,对方负责提供响应服务。3.4
数据项dataunit
由数据项标识符、数据项名称和数据项值三个元素组成。3.5
数据记录
datarecord
组成数据集的基本单位,表示一条记录,数据记录由一个或多个数据项组成。3.6
数据集
dataset
由一个或多个数据记录组成。
空白点blankspot
用于表示对应检测点位置无传感器的状态。LS/T1812—2017
4粮情测控系统通信和信息交换
粮情测控系统上位机与分机的通信模式粮情测控系统各部分主要包括粮情测控软件系统(上位机)与粮情测控硬件系统(分机),它们的通信模式如下:
a)上位机对分机发送读取或控制命令;b)
分机响应上位机命令,发回相应数据或执行相应的控制。4.2
粮情测控系统信息交换模式
粮情测控系统信息交换模式如下:a)
粮情测控系统和其他系统之间向对方请求服务,调用对方服务接口;粮情测控系统或其他系统响应请求,向对方返回利用数据集封装的结构化数据。5接口定义
上位机与分机之间的通信接口
5.1.1字节传输格式
串口方式配置
粮食出入库业务信息系统一般由出人库登记、扦样管理、检验管理、计量管理、值仓管理、结算管理和统计分析等七个模块构成,相关模块具有可扩展性,如表1所示。串口应按下列要求进行配置:
a)1位起始位;
b)8位数据位;
无校验位;
d)1位停止位;
波特率。
注:其中波特率的取值可以是但不限于下列数值(单位:Bps):1200、4800、9.600等。表1
数据顿格式
字段名
起始符
分机地址
控制符
数据长度
数据段
结束符
55HAAH55HAAH
Command
Length
Data Segment
CRC-16
16HE9H16HE9H
其中CRC-16校验数据为从起始符开始到校验前的所有数据。2
度/Byte
2以太网方式配置
以太网配置如下:
服务器IP地址与测控分机IP地址设为同一网段;b)
服务器TCP端口:1238:UDP端口:1240;c)
LS/T1812—2017
服务器以UPD广播方式发送各种查询指令。目标IP为全体:255.255.255.255;目标端口:5000;
测控分机以TCP方式返回数据,测控分机的TCP端口:3OO0。5.1.1.3
数据顿格式
通信接口的数据顿应符合表1格式。5.1.1.4
命令响应时间
命令响应时间(命令发送结束到接收到分机返回数据的第一个字节的时间)小于或等于200ms5.1.2通讯格式
读取分机状态指令
上位机读取分机状态指令应按照表2的格式发送表2上位机读取分机状态指令格式起始符
KADDL(分机地址)
Command=AoH,Length=00o0H
Command
分机应按照表3的格式返回状态数据。b)
Length
表3分机返回分机状态数据格式
起始符
KADDL(分机地址)
Command
Length
Command=80H,Length=0002H。State为状态数据段,占两个字节。5.1.2.2
读取仓外温湿度
上位机读取仓外温湿度指令应按照表4的格式发送。表4上位机读取仓外温湿度指令格式起始符
KADDL(分机地址)
Command=A1H,Length=0000H。
Command
b)分机应按照表5的格式返回仓外温湿度数据。Length
表5分机返回仓外温湿度数据格式起始符
KADDL(分机地址)
Command
Length
CRC-16
CRC-16
CRC-16
结束符
结束符
结束符
CRC-16结束符
LS/T1812—2017
Command=81H.Length=0004H。Cwtl、Cwth、Cwsl、Cwsh共同组成数据段。CwtlCwth为仓外温度,其中Cwtl为低字节,Cwth为高字节。Cwsl、Cwsh为仓外湿度,其中Cwsl为低字节,Cwsh为高字节。
读取仓内温湿度
上位机读取仓内温湿度指令应按照表6的格式发送。a)
上位机读取仓内温湿度指令格式起始符
KADDL(分机地址)
Command=A2H,Length=0000H。
Command
分机应按照表7的格式返回仓内温湿度数据b)
Length
分机返回仓内温湿度数据格式
起始符
KADDL(分机地址)
Command
CntllCntlhCnsll
Length
Data Segment
CRC-16
CntNiCntNh CnsN1CnsNh
结束符
结束符
Command=82H,Length=X×××H。CntNl、CntNh为第N个仓内温度检测点值,其中CntNl为低字节.CntNh为高字节,CnsNl.CnsNh为第N个仓内湿度检测点值,其中CnsNl为低字节,CnsNh为高字节。
5.1.2.4读取粮堆温度
上位机读取粮堆温度指令应按照表8的格式发送表8上位机读取粮堆温度指令格式起始符
KADDL(分机地址)
Command=A3H,Length=0000H。
Command
Length
分机应按照表9或表10的格式返回粮堆温度数据b)
分机返回粮堆温度的数据格式1
起始符
KADDL(分机地址)
Command
Length
Data Segment
CRC-16
CRC-16
结束符
结束符
Command=53H;Length=XXXXH。Ln为第n个传感器电缆的编号,长度为两个字节。Tnl、Tnh为某根电缆的第n个检测点值,同一条电缆的检测点排序为从上到下顺序排列,其中Tn1为低字节,Tnh为高字节。
起始符
KADDL(分机地址)
分机返回粮堆温度的数据格式2
Command
Length
Data Segment
LS/T1812—2017
CRC-16
结束符
Command=83H;Length=XXXXH。Tnl、Tnh为某仓的第n个温度检测点值,其中Tnl为低字节,Tnh为高字节。
读取仓内储粮害虫信息数据
上位机读取仓内储粮害虫信息数据指令应按照表11的格式发送。表11上位机读取仓内储粮害虫信息数据指令格式起始符
KADDL(分机地址)
Command
Command=A4H。虫害分支器号=XXXXH虫害分支器号m
分机应按照表12的格式返回其他粮情信息数据b)
分机返回仓内储粮害虫信息数据格式表12
起始符
KADDL(分机地址)
落虫次数
Command
Length
Data Segment
CRC-16
CRC-16
虫害分支器号m
结束符
结束符
Command=84H;Length=××××H;In表明某仓m号虫害分支器在In时刻有虫落入,其长度为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的格式返回其他粮情信息数据。5
LS/T1812—2017
起始符
KADDL(分机地址)
表14分机返回其他粮情信息数据格式Command
Length
Data Segment
CRC-16
结束符
Command的取值范围从85H到9FH,一种粮情信息使用一个命令控制符.依此类推。Length=XXXXH。Xnl、Xnh为某仓的第n个某粮情信息检测点值,其中Xnl为低字节,Xnh为高字节5.1.2.7
粮情信息数据计算公式
温度计算公式:(Tnh×256十Tnl)/10,保留一位小数;湿度计算公式:(Snh×256十Snl)/10,保留一位小数:其他粮情信息数据计算公式:(Xnh×256+Xnl)/10.保留一位小数;d)
若某检测点无数据回复表示有误,其中开路为7777H.短路为8888H:e)
空白点的值为9999H。
粮情控制
上位机读取粮情控制设备状态信息数据指令应按照表15的格式发送。表15上位机读取粮情控制设备状态信息数据指令格式起始符
KADDL(分机地址)
Command=C1H,Length=0000H.
Command
Length
分机应按照表16的格式返回粮情控制设备状态信息数据。表16
起始符
KADDL(分机地址)
CRC-16
分机返回粮情控制设备状态信息数据格式Command
Length
Data Segment
Command=C2H,Length=X×X×H。ECn为第n个设备的当前状态。c)上位机设定粮情控制设备状态的指令应按照表17的格式发送,表17
上位机设定粮情控制设备状态指令格式起始符
KADDL(分机地址)
Command
Length
Data Segment
CRC-16
CRC-16
结束符
结束符
结束符
Command=C3H,Length=XXXXH。ECn为第n个设备将要设定的状态。粮情测控系统与其他系统之间的信息交换5.2.1
粮油仓库管理信息系统提供的数据交换接口获取库点基本信息数据方法的接口定义:服务请求方:粮情测控系统;
服务响应方:粮油仓库管理信息系统;方法名称:Get_DepotInfoData;返回类型:复合型;
参数应参照表18的要求;
库点代码
返回值应参照表19的要求
所属企业组织机构代码
所属企业统一社会信用代码
所属企业名称
库点代码
库点名称
库点简称
库点企业性质
库点类别
建成日期
库点设计仓容
库点面积
库点电话
库点传真
库点地址
库点邮政编码
库点行政区划名称
库点行政区划代码
获取仓点基本信息数据方法参数表短名
数据类型
字符型
获取库点基本信息数据方法返回值表短名
ssqyzzjgdm
ssqytyshxydm
ssqyme
kdqyxz
kdsjcr
kdyzbm
kdxzqhmc
kdxzqhdm
获取仓房基本信息数据方法的接口定义:服务请求方:粮情测控系统;
数据类型
字符型
字符型
字符型
字符型
字符型
字符型
字符型
字符型
日期型
数值型
数值型
字符型
字符型
字符型
字符型
字符型
字符型
数据格式
YYYYMMDD
LS/T1812—2017
数据格式
含义及类型参见
LS/T1802—2016
LS/T1812—2017
服务响应方:粮油仓库管理信息系统;方法名称:Get_BarnBaseInfoData返回类型:复合型;
参数应参照表20的要求;
库点代码
仓房编号
返回值应参照表21的要求。
所属库点
仓房编号
仓房名称
仓房类型
仓房结构
建筑类型
仓房长度(直径)
仓房宽度
仓房高度
仓房设计仓容
仓房实际仓容
启用日期
仓房状态
仓房使用状态
简易围
简易仓
获取仓房基本信息数据方法参数表数据类型
字符型
字符型
数据格式
获取仓房基本信息数据方法返回值表短名
cfedzj
cfsjcr
cfsjcro1
efsyzt
获取廠间基本信息数据方法的接口定义:服务请求方:粮情测控系统;
服务响应方:粮油仓库管理信息系统;方法名称:Get_SeparateSpaceBaseInfoData;返回类型:复合型;
参数应参照表22的要求;
数据类型
字符型
字符型
字符型
字符型
字符型
字符型
数值型
数值型
数值型
数值型
数值型
日期型
字符型
字符型
数值型
数值型
数值型
为空时返回所有仓房信息
数据格式
YYYYMMDD
含义及类型参见
LS/T18022016
库点代码
廠间编号
返回值应参照表23的要求。
所属仓房
所属仓房编号
间编号
廠间名称
廠间长度
廠间宽度
廠间高度
廠间设计仓容
廠间实际仓容
廠间启用日期
廠间状态
搬间使用状态
获取间基本信息数据方法参数表数据类型
字符型
字符型
数据格式
获取廠间基本信息数据方法返回值表短名
ssefbh
ajsjcr
ajsjcro1
ajqyrq
ajsyzt
获取间储粮信息数据方法的接口定义:服务请求方:粮情测控系统;
服务响应方:粮油仓库管理信息系统;方法名称:Get_GrainInfoData;返回类型:复合型;
参数应参照表24的要求;
库点代码
间编号
查询日期
返回值应参照表25的要求
数据类型
字符型
字符型
字符型
字符型
数值型
数值型
数值型
数值型
数值型
日期型
字符型
字符型
LS/T 1812—2017
为空时返回所有戚间信息
数据格式
YYYYMMDD
获取傲间储粮信息数据方法参数表数据类型
字符型
字符型
字符型
数据格式
YYYYMMDD
含义及类型参见
LS/T1802—2016
为空时返回所有廠间的储粮信息
小提示:此标准内容仅展示完整标准里的部分截取内容,若需要完整标准请到上方自行免费下载完整标准文档。