GB/T 26882.4-2024 粮油储藏 粮情测控系统 第4部分：信息交换接口协议
- 名 称：GB/T 26882.4-2024 粮油储藏 粮情测控系统 第4部分：信息交换接口协议 - 下载地址1
- 下载地址：[下载地址1]
- 提 取 码：
- 浏览次数：3
发表评论 加入收藏夹 错误报告目录| 新闻评论（共有 0 条评论） |
资料介绍
ICS 65. 040.20 CCS B 20
中 华 人 民 共 和 国 国 家 标 准
GB/T 26882.4—2024代替 GB/T26882.4—2011
粮油储藏 粮情测控系统
第 4 部分:信息交换接口协议
Grain and oilstorage—Monitoring and controlsystem ofstored-grain
condition—Part4 :Information exchangeinterfaceprotocol
2024-11-28发布 2025-06-01实施
国家市场监督管理总局国家标准化管理委员会
发
布
GB/T 26882.4—2024
目 次
前言 Ⅲ
引言 Ⅳ
1 范围 1
2 规范性引用文件 1
3 术语和定义 1
4 通信和信息交换模式 1
4. 1 上位机与分机的通信模式 1
4. 2 粮情测控系统信息交换模式 1
5 接口定义 2
5. 1 上位机与分机之间的通信接 口 2
5. 2 粮情测控系统与粮油仓库管理信息系统之间的信息交换接 口 7
Ⅰ
GB/T 26882.4—2024
前 言
本文件按照 GB/T 1. 1—2020《标准化工作导则 第 1部分 :标准化文件的结构和起草规则》的规定起草 。
本文件是 GB/T 26882《粮 油 储 藏 粮 情 测 控 系 统》的 第 4 部 分 。 GB/T 26882 已 经 发 布 了以 下部分 :
— 第 1部分 :通则 ;
— 第 2部分 :分机 ;
— 第 3部分 :软件 ;
— 第 4部分 :信息交换接口协议 。
本文件代替 GB/T 26882. 4—2011《粮油储藏 粮情测控系统 第 4 部分 :信息交换接口协议》, 与GB/T 26882. 4—2011相比 ,除结构调整和编辑性改动外 ,主要技术变化如下 :
a) 更改了上位机与分机的通信模式和粮情测控系统信息交换模式(见 4. 1、4. 2,2011年版的 3. 1、 3. 2) ;
b) 更改了上位机与分机之间的通信接口定义(见 5. 1,2011年版的 4. 1) ;
c) 更改了粮 情 测 控 系 统 与 粮 油 仓 库 管 理 信 息 系 统 之 间 的 信 息 交 换 接 口 (见 5. 2, 2011 年 版 的4. 2) ;
d) 增加了粮情测控系统提供的数据交换接口(见 5. 2. 2) 。
请注意本文件的某些内容可能涉及专利 。本文件的发布机构不承担识别专利的责任 。
本文件由国家粮食和物资储备局提出 。
本文件由全国粮油标准化技术委员会(SAC/TC270)归 口 。
本文件起草单位 :河南工业大学 、无锡中粮工程科技有限公司 、国家粮食和物资储备局科学研究院 、江苏艾龙科技有限公司 、成都比斯特科技有限责任公司 、中储粮成都储藏研究院有限公司 、华信咨询设计研究院有限公司 、山东金钟科技集团股份有限公司 、上海达联电子科技有限公司 。
本文件主要起草人 :甄彤 、肖 乐 、李 智 慧 、祝 玉 华 、陈 鹏 、赵 会 义 、陈 化 东 、林 荣 华 、王 春 军 、吴 建 军 、王艳艳 、杨铁军 、马 海 华 、葛 宏 义 、吕 宗 旺 、姜 晓 林 、赵 小 军 、苑 江 浩 、陈 明 华 、张 继 勇 、姜 祖 新 、徐 翔 宇 、张兵 、王庚 。
本文件及其所代替文件的历次版本发布情况为 :
— 2011年首次发布为 GB/T 26882. 4—2011;
— 本次为第一次修订 。
Ⅲ
GB/T 26882.4—2024
引 言
目前 ,通过粮情测控系统对粮情进行实时监测已成为粮食仓储作业中必不缺少的技术手段 ,粮情监控系统还能配合各种储粮工艺对粮情进行控制 ,保障了粮食的存储安全 。GB/T 26882《粮油储藏 粮情测控系统》的制定 ,使得粮情测控系统产品的生产和应用有据可依 ,对提高产品的质量 、提升仓储应用管理效率和数据的共享有着重要意义 。
近年来 , 随着信息技术及绿色储粮工艺的发展 ,对粮情测控系统提出了新要求 ,粮情检测除常规的测量温度和湿度外 ,增加了水分 、气体和储粮害虫等指标 ,与粮情检测结果相关的通风 、气调和环流等粮情控制也逐步得到应用 , 同时粮库网络已逐步覆盖到全库区 , 针对这些变化和需求 ,对 GB/T 26882— 2011适时进行了修订 。
按照粮情测控系统的通用要求 、硬件 、软件和信息交换的内容 ,GB/T 26882拟由 4个部分构成 。
— 第 1部分 :通则 。 目的在于确立粮情测控系统需要遵守的总体要求和相关规则 。
— 第 2部分 :分机 。 目的在于确立置于粮仓端的粮情测控系统分机的粮情检测 、粮情控制的执行网络接入等技术要求 。
— 第 3部分 :软件 。 目的在于确立粮情测控系统的应用软件功能和报表的基本内容 。
— 第 4部分 :信息交换接口协议 。 目的在于确立粮情测控系统的分机与上位机之间 、粮情测控系统与其他粮库应用系统之间信息交换的协议和相关规则 。
Ⅳ
GB/T 26882.4—2024
粮油储藏 粮情测控系统
第 4 部分:信息交换接口协议
1 范围
本文件规定了粮情测控信息交换接口协议的通信模式和信息交换模式以及接口定义的要求 。
本文件适用于粮情测控系统信息交换体系的设计与建设 。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款 。其中 , 注 日期的引用文件 ,仅该日期对应的版本适用于本文件 ;不注日期的引用文件 ,其最新版本(包括所有的修改单) 适用于本文件 。
LS/T 1802—2016 粮食仓储业务数据元
3 术语和定义
下列术语和定义适用于本文件 。
3. 1
数据交换接口 data exchange interface
不同系统之间为实现数据交换所规定的一组约定 。
注 : 在粮情测控系统中 ,数据交换接口负责访问粮情测控系统和粮油仓库管理信息系统的数据资源调用 、实现及反馈结果集等 。粮情测控系统和粮油仓库管理信息系 统 之 间 通 过 该 接 口 的 请 求 方 法 访 问 对 方 数 据 ,对 方 提 供 响应服务 。
4 通信和信息交换模式
4. 1 上位机与分机的通信模式
粮情测控系统上位机与分机之间的通信模式包括 :
a) 上位机对分机发送读取或控制命令 ;
b) 分机响应上位机命令 ,发回相应数据或执行相应的控制 。
4.2 粮情测控系统信息交换模式
粮情测控系统信息交换模式包括 :
a) 粮情测控系统和粮油仓库管理信息系统之间向对方请求服务 ,调用对方服务接 口 ;
b) 粮情测控系统 或 粮 油 仓 库 管 理 信 息 系 统 响 应 请 求 , 向 对 方 返 回 利 用 数 据 集 封 装 的 结 构 化数据 。
1
GB/T 26882.4—2024
5 接口定义
5. 1 上位机与分机之间的通信接口
5. 1. 1 字节传输格式
5. 1. 1. 1 串 口方式配置
串口应按以下要求进行配置 :
a) 1位起始位 ;
b) 8位数据位 ;
c) 无校验位 ;
d) 1位停止位 ;
e) 波特率(单位 :bit/s) ,波特率的取值包括但不限于 1 200、4 800和 9 600等 。
5. 1. 1.2 以太网方式配置
以太网方式配置如下 。
a) 服务器网际互连协议(IP)地址与测控分机 IP地址设为同一网段 。
b) 服务器传输控制协议(TCP)端 口 :1238;用户数据报协议(UDP)端 口 :1240。
c) 服务器以 UDP广播方式发送各种查询指令 。 目标 IP:255. 255. 255. 255; 目标端 口 :5000。
d) 测控分机以 TCP方式返回数据 ,测控分机的 TCP端 口 :3000。
5. 1. 1.3 数据帧格式
通信接口的数据帧格式应符合表 1规定 。
表 1 数据帧格式
字段名
代码
长度Byte
起始符
55H AAH 55H AAH
4
分机地址
KADDL
1
控制符
Command
1
数据长度
Length
2
数据段
Data Segment
L
校验
CRC-16a
2
结束符
16H E9H 16H E9H
4
a CRC-16校验数据为起始符开始到校验前的所有数据 。
5. 1. 1.4 命令响应时间
命令响应时间 ≤200 ms。
注 : 命令响应时间为命令发送结束到接收分机返回数据的第一个字节的时间 。
2
GB/T 26882.4—2024
5. 1.2 通信格式
5. 1.2. 1 读取分机状态指令
读取分机状态指令和返回数据格式如下 :
a) 上位机读取分机状态指令应按照表 2 的格式发送 ;
b) 分机应按照表 3 的格式返回分机状态数据 。
= =
表 2 上位机读取分机状态指令格式
起始符
KADDL(分机地址)
Command
Length
CRC-16
结束符
注 : Command A0H ,Length 0000H。
= =
表 3 分机返回分机状态数据格式
起始符
KADDL(分机地址)
Command
Length
State
CRC-16
结束符
注 : Command 80H ,Length 0002H 。State为状态数据段 , 占两个字节 。
5. 1.2.2 读取仓外温湿度
读取仓外温湿度指令和返回数据格式如下 :
a) 上位机读取仓外温湿度指令应按照表 4 的格式发送 ;
b) 分机应按照表 5 的格式返回仓外温湿度数据 。
= =
表 4 上位机读取仓外温湿度指令格式
起始符
KADDL(分机地址)
Command
Length
CRC-16
结束符
注 : Command A1H ,Length 0000H 。
表 5 分机返回仓外温湿度数据格式
起始符
KADDL(分机地址)
Command
Length
Cwtl
Cwth
Cwsl
Cwsh
CRC-16
结束符
注 1: Command = 81H ,Length = 0004H。
注 2: Cwtl、Cwth、Cwsl、Cwsh共同组成数据段 。Cwtl、Cwth为 仓 外 温 度 ,其 中 Cwtl为 低 字 节 , Cwth为 高 字 节 。
Cwsl、Cwsh为仓外湿度 ,其中 Cwsl为低字节 ,Cwsh为高字节 。
5. 1.2.3 读取仓内温湿度
读取仓内温湿度指令和返回数据格式如下 :
a) 上位机读取仓内温湿度指令应按照表 6 的格式发送 ;
b) 分机应按照表 7 的格式返回仓内温湿度数据 。
3
GB/T 26882.4—2024
= =
表 6 上位机读取仓内温湿度指令格式
起始符
KADDL(分机地址)
Command
Length
CRC-16
结束符
注 : Command A2H ,Length 0000H。
表 7 分机返回仓内温湿度数据格式
起始符
KADDL(分机地址)
Command
Length
Data Segment
CS-16
结束符
Cnt1l
Cnt1h
Cns1l
Cns1h
…
CntNl
CntNh
CnsNl
CnsNh
注 1: Command = 82H ,Length = xxxxH。
注 2: CntNl、CntNh为第 N 个仓内温度检测点值 ,其中 CntNl为低字节 ,CntNh为高字节 。
注 3: CnsNl、CnsNh为第 N 个仓内湿度检测点值 ,其中 CnsNl为低字节 ,CnsNh为高字节 。
5. 1.2.4 读取粮堆温度
读取粮堆温度指令和返回数据格式如下 :
a) 上位机读取粮堆温度指令应按照表 8 的格式发送 ;
b) 分机应按照表 9 或表 10的格式返回粮堆温度数据 。
= =
表 8 上位机读取粮堆温度指令格式
起始符
KADDL(分机地址)
Command
Length
CRC-16
结束符
注 : Command A3H ,Length 0000H。
表 9 分机返回粮堆温度的数据格式 1
起始符
KADDL(分机地址)
Command
Length
Data Segment
CRC-16
结束符
L1
T0l
T0h
… …
Tnl
Tnh
Ln
T0l
T0h
…
Tnl
Tnh
注 1: Command = 53H;Length =xxxxH。
注 2: Ln 为第 n 个传感器电缆的编号 ,长度为两个字节 。
注 3: Tnl、Tnh为某根电缆的第 n 个检测点值 , 同一条电缆的检测点排序为从上到下顺序排列 ,其中 Tnl为低字节 ,Tnh为高字节 。
4
GB/T 26882.4—2024
表 10 分机返回粮堆温度的数据格式 2
起始符
KADDL(分机地址)
Command
Length
Data Segment
CRC-16
结束符
T0l
T0h
…
Tnl
Tnh
注 1: Command = 83H;Length =xxxxH。
注 2: Tnl、Tnh为某仓的第 n 个温度检测点值 ,其中 Tnl为低字节 ,Tnh为高字节 。
5. 1.2.5 读取仓内储粮害虫信息数据
读取仓内储粮害虫信息数据指令和返回数据格式如下 :
a) 上位机读取仓内储粮害虫信息数据指令应按照表 11的格式发送 ;
b) 分机应按照表 12的格式返回仓内储粮害虫信息数据 。
表 11 上位机读取仓内储粮害虫信息数据指令格式
起始符
KADDL(分机地址)
Command
虫害检测点号 m
CRC-16
结束符
= =
注 : Command A4H 。虫害检测点号 xxxxH。
表 12 分机返回仓内储粮害虫信息数据格式
起始符
KADDL(分机地址)
Command
Length
Data Segment
CRC-16
结束符
落虫次数
I0
…
In
虫害检测点号 m
注 1: Command = 84H;Length =xxxxH。
注 2: In 表明某仓 m 号虫害检测点在 In 时刻有虫落入 ,其长度为 7 Byte,格式与 DS1307时间的前 7 个 字 节 相同 。如果落虫次数为 0,则不存在 I0到 In 字段 。
5. 1.2.6 读取其他粮情信息数据
其他粮情信息数据的读取格式如下 :
a) 上位机读取其他粮情信息数据指令应按照表 13的格式发送 ;
b) 分机应按照表 14的格式返回其他粮情信息数据 。
表 13 上位机读取其他粮情信息数据指令格式
起始符
KADDL(分机地址)
Command
Length
CRC-16
结束符
注 : Command 的取值范围从 A5H 到 BFH ,一种粮情信息使用一个命令控制符 ,依此类推 。Length = 0000H。
5
GB/T 26882.4—2024
表 14 分机返回其他粮情信息数据格式
起始符
KADDL(分机地址)
Command
Length
Data Segment
CRC-16
结束符
X0l
X0h
…
Xnl
Xnh
注 1: Command 的取值范围从 85H 到 9FH ,一种粮情信息使用一个命令控制符 ,依此类推 。
注 2: Length =xxxxH。
注 3: Xnl、Xnh为某仓的第 n 个某粮情信息检测点值 ,其中 Xnl为低字节 ,Xnh为高字节 。
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的格式发送 ;
b) 分机应按照表 16的格式返回粮情控制设备状态信息数据 ;
c) 上位机设定粮情控制设备状态的指令应按照表 17的格式发送 。
表 15 上位机读取粮情控制设备状态信息数据指令格式
起始符
KADDL(分机地址)
Command
Length
CRC-16
结束符
注 : Command= C1H ,Length = 0000H。
表 16 分机返回粮情控制设备状态信息数据格式
起始符
KADDL(分机地址)
Command
Length
Data Segment
CRC-16
结束符
EC0
…
ECn
注 : Command= C2H ,Length =xxxxH 。ECn 为第 n 个设备的当前状态 。
表 17 上位机设定粮情控制设备状态指令格式
起始符
KADDL(分机地址)
Command
Length
Data Segment
CRC-16
结束符
EC0
…
ECn
注 : Command= C3H ,Length =xxxxH 。ECn 为第 n 个设备将要设定的状态 。
6
GB/T 26882.4—2024
5.2 粮情测控系统与粮油仓库管理信息系统之间的信息交换接口
5.2. 1 粮油仓库管理信息系统提供的数据交换接口
5.2. 1. 1 获取库区基本信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮情测控系统 。
b) 服务响应方 :粮油仓库管理信息系统 。
c) 方法名称 :Get_DepotInfoData。
d) 返回类型 :复合型 。
e) 参数应符合表 18的要求 。
f) 返回值应符合表 19的要求 。
表 18 获取库区基本信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
表 19 获取库区基本信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
所属企业组织机构代码
ssqyzzjgdm
字符型
a. 9
含义及类型按照
LS/T 1802—2016
中 6. 1. 3 的规定
2
所属企业统一社会信用代码
ssqytyshxydm
字符型
a. 18
3
所属企业名称
ssqymc
字符型
a. . 50
4
库区代码
kqdm
字符型
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
17
7
GB/T 26882.4—2024
5.2. 1.2 获取仓房基本信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮情测控系统 。
b) 服务响应方 :粮油仓库管理信息系统 。
c) 方法名称 :Get_BarnBaseInfoData。
d) 返回类型 :复合型 。
e) 参数应符合表 20的要求 。
f) 返回值应符合表 21的要求 。
表 20 获取仓房基本信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
仓房编号
cfbh
字符型
a. 3
为空时返回所有仓房信息
表 21 获取仓房基本信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
所属库区
sskq
字符型
a. . 20
含义及类型按照
LS/T 1802—2016
中 6. 1. 4 的规定
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
8
GB/T 26882.4—2024
5.2. 1.3 获取廒间基本信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮情测控系统 。
b) 服务响应方 :粮油仓库管理信息系统 。
c) 方法名称 :Get_SeparateSpaceBaseInfoData。
d) 返回类型 :复合型 。
e) 参数应符合表 22的要求 。
f) 返回值应符合表 23的要求 。
表 22 获取廒间基本信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
廒间编号
ajbh
字符型
a. 3
为空时返回所有廒间信息
9
表 23
获取廒间基本信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
所属仓房
sscf
字符型
a. . 20
含义及类型按照
LS/T 1802—2016
中 6. 1. 6 的规定
2
所属仓房编号
sscfbh
字符型
a. 3
3
廒间编号
ajbh
字符型
a. 3
4
廒间名称
ajmc
字符型
a. . 20
5
廒间长度
ajcd
数值型
n. . 5,1
6
廒间宽度
ajkd
数值型
n. . 5,1
7
廒间高度
ajgd
数值型
n. . 5,1
8
廒间设计仓容
ajsjcr
数值型
n. . 8
9
廒间实际仓容
ajsjcr01
数值型
n. . 8
10
廒间启用 日期
ajqyrq
日期型
YYYYMMDD
11
廒间状态
ajzt
字符型
a. 1
12
廒间使用状态
ajsyzt
字符型
a. 1
5.2. 1.4 获取廒间储粮信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮情测控系统 。
b) 服务响应方 :粮油仓库管理信息系统 。
c) 方法名称 :Get_GrainInfoData。
d) 返回类型 :复合型 。
e) 参数应符合表 24的要求 。
f) 返回值应符合表 25的要求 。
GB/T 26882.4—2024
表 24 获取廒间储粮信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
廒间编号
ajbh
字符型
a. 3
为空时返回所有廒间的储粮信息
3
查询 日期
cxrq
字符型
YYYYMMDD
—
表 25 获取廒间储粮信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
所属廒间编号
ajbh
字符型
a. 3
—
2
储粮性质
clxz
字符型
a. 3
—
3
生产年份
scnf
字符型
a.4
—
4
产地代码
cddm
字符型
a. 6
—
5
品种代码
pzdm
字符型
a. 7
—
6
等级代码
djdm
字符型
a.2
—
7
数量
Sl
数值型
n. . 8
—
8
杂质
Zzhl
数值型
n. . 4
%
9
入仓水分
Rcsf
数值型
n. . 4
%
10
储存方式
Ccfs
字符型
a. 30
—
11
装粮线高度
zlxgd
数值型
n. . 4
—
12
入仓日期
rcrq
日期型
YYYYMMDD
—
5.2. 1.5 获取油罐基本信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮情测控系统 。
b) 服务响应方 :粮油仓库管理信息系统 。
c) 方法名称 :Get_OiltankInfoData。
d) 返回类型 :复合型 。
e) 参数应符合表 26的要求 。
f) 返回值应符合表 27的要求 。
表 26 获取油罐基本信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
油罐编号
ygbh
字符型
a. 3
为空时返回所有油罐信息
10
GB/T 26882.4—2024
表 27 获取油罐基本信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
油库等级
ykdj
字符型
a. 1
含义及类型按照
LS/T 1802—2016
中 6. 1. 5 的规定
2
油罐名称
ygmc
字符型
a. . 20
3
油罐编号
ygbh
字符型
a. . 20
4
油罐总容
ygzr
数值型
n. . 15,3
5
油罐组容
ygzr01
数值型
n. . 15,3
6
油罐状态
ygzt
字符型
a. 1
7
油罐使用状态
ygsyzt
字符型
a. 1
5.2. 1.6 获取油罐储油信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮情测控系统 。
b) 服务响应方 :粮油仓库管理信息系统 。
c) 方法名称 :Get_OilInfoData。
d) 返回类型 :复合型 。
e) 参数应符合表 28的要求 。
f) 返回值应符合表 29的要求 。
表 28 获取油罐储油信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
油罐编号
ygbh
字符型
a. 3
为空时返回所有油罐的储油信息
3
查询 日期
cxrq
字符型
YYYYMMDD
—
表 29 获取油罐储油信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
所属油罐编号
ygbh
字符型
a. 3
—
2
储油性质
cyxz
字符型
a. 3
3
品种代码
pzdm
字符型
a. 7
4
数量
sl
数值型
n. . 8
5
产地代码
cddm
字符型
a. 6
6
生产年份
scnf
字符型
a.4
7
等级代码
djdm
字符型
a.2
11
GB/T 26882.4—2024
5.2. 1.7 获取粮情采集计划数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮情测控系统 。
b) 服务响应方 :粮油仓库管理信息系统 。
c) 方法名称 :Get_CollectionPlanData。
d) 返回类型 :复合型 。
e) 参数应符合表 30的要求 。
f) 返回值应符合表 31的要求 。
表 30 获取粮情采集计划数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
计划采集 日期
jhcjrq
字符型
YYYYMMDD
—
表 31 获取粮情采集计划数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
编号(廒间/油罐)
bh
字符型
a. 3
—
2
采集类型
cjlx
字符型
a. 30
如 :温度 、湿度 、温湿度 、液位
3
计划采集时间
Jhcjsj
日期时间型
YYYYMMDD
HHMMSS
—
5.2.2 粮情测控系统提供的数据交换接口
5.2.2. 1 获取廒间粮情检测点信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮油仓库管理信息系统 。
b) 服务响应方 :粮情测控系统 。
c) 方法名称 :Get_GrainTestingTags。
d) 返回类型 :复合型 。
e) 参数应符合表 32的要求 。
f) 返回值应符合表 33的要求 。
表 32 获取廒间粮情检测点信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
廒间编号
ajbh
字符型
a. 3
为空时返回所有廒间信息
12
GB/T 26882.4—2024
表 33 获取廒间粮情检测点信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
廒间编号
ajbh
字符型
a. 3
—
2
采集类型
cjlx
字符型
a. 30
3
设备厂家
sbcs
字符型
a. 50
4
分机号
fjh
数值型
n. . 4
5
线缆号
xlh
数值型
n. . 4
6
采集点编号
cjdbh
数值型
n. . 4
7
采集点逻辑位置
cjdljwz
结构化数据(x,y,≈)
(n. . 4, n. . 4, n. . 4)
8
采集点物理位置
cjdwlwz
结构化数据(x,y,≈)
(n. . 4, n. . 4, n. . 4)
5.2.2.2 获取廒间粮情检测设备状态数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮油仓库管理信息系统 。
b) 服务响应方 :粮情测控系统 。
c) 方法名称 :Get_GrainTestingTagsStatus。
d) 返回类型 :复合型 。
e) 参数应符合表 34的要求 。
f) 返回值应符合表 35的要求 。
表 34 获取廒间粮情检测设备状态数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
廒间编号
ajbh
字符型
a. 3
为空时返回所有廒间信息
表 35 获取廒间粮情检测设备状态数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
廒间编号
ajbh
字符型
a. 3
—
2
采集类型
cjlx
字符型
a. 30
3
设备厂家
sbcj
字符型
a. 50
4
分机号
fjh
数值型
n. . 4
5
采集点编号
cjdbh
数值型
n. . 4
6
设备状态
sbzt
字符型
a. 30
7
信号强度
xhqd
数值型
n. . 4
8
电池电压
dcdy
数值型
n. . 4
13
GB/T 26882.4—2024
5.2.2.3 获取廒间粮情信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮油仓库管理信息系统 。
b) 服务响应方 :粮情测控系统 。
c) 方法名称 :Get_GrainTestingData。
d) 返回类型 :复合型 。
e) 参数应符合表 36的要求 。
f) 返回值应符合表 37的要求 。
表 36 获取廒间粮情信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
廒间编号
ajbh
字符型
a. 3
为空时返回所有廒间信息
表 37 获取廒间粮情信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
廒间编号
ajbh
字符型
a. 3
—
2
采集类型
cjlx
字符型
a. 30
3
采集点编号
cjdbh
数值型
n. . 4
4
采集数值
cjsz
数值型
n. . 8
5
是否有效
sfyx
字符型
a.4
6
采集时间
cjsj
日期时间型
YYYYMMDDHHMMSS
5.2.2.4 获取廒间储粮预警信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮油仓库管理信息系统 。
b) 服务响应方 :粮情测控系统 。
c) 方法名称 :Get_GrainWarningData。
d) 返回类型 :复合型 。
e) 参数应符合表 38的要求 。
f) 返回值应符合表 39的要求 。
表 38 获取廒间储粮预警信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
廒间编号
ajbh
字符型
a. 3
为空时返回所有廒间信息
3
开始日期
ksrq
日期型
YYYYMMDD
—
4
结束 日期
jsrq
日期型
YYYYMMDD
—
14
GB/T 26882.4—2024
表 39 获取廒间储粮预警信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
廒间编号
ajbh
字符型
a. 3
—
2
预警类型
yjlx
字符型
a. 10
3
预警级别
yjjb
字符型
a.2
4
预警内容
yjnr
字符型
a.250
5
预警时间
yjsj
日期时间型
YYYYMMDD
HHMMSS
5.2.2.5 获取油罐油情检测点信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮油仓库管理信息系统 。
b) 服务响应方 :粮情测控系统 。
c) 方法名称 :Get_OilTestingTags。
d) 返回类型 :复合型 。
e) 参数应符合表 40的要求 。
f) 返回值应符合表 41的要求 。
表 40 获取油罐油情检测点信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
油罐编号
ygbh
字符型
a. 3
为空时返回所有油罐信息
表 41 获取油罐油情检测点信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
油罐编号
ygbh
字符型
a. 3
—
2
采集类型
cjlx
字符型
a. 30
3
设备厂家
sbcs
字符型
a. 50
4
分机号
fjh
数值型
n. . 4
5
线缆号
xlh
数值型
n. . 4
6
采集点编号
cjdbh
数值型
n. . 4
7
采集点逻辑位置
cjdljwz
结构化数据(x,y,≈)
(n. . 4, n. . 4, n. . 4)
8
采集点物理位置
cjdwlwz
结构化数据(x,y,≈)
(n. . 4, n. . 4, n. . 4)
15
GB/T 26882.4—2024
5.2.2.6 获取油罐油情检测设备状态数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮油仓库管理信息系统 。
b) 服务响应方 :粮情测控系统 。
c) 方法名称 :Get_OilTestingTagsStatus。
d) 返回类型 :复合型 。
e) 参数应符合表 42的要求 。
f) 返回值应符合表 43的要求 。
表 42 获取油罐油情检测设备状态数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
油罐编号
ygbh
字符型
a. 3
为空时返回所有油罐信息
表 43 获取油罐油情检测设备状态数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
油罐编号
ygbh
字符型
a. 3
—
2
采集类型
cjlx
字符型
a. 30
3
设备厂家
sbcj
字符型
a. 50
4
分机号
fjh
数值型
n. . 4
5
采集点编号
cjdbh
数值型
n. . 4
6
设备状态
sbzt
字符型
a. 30
7
信号强度
xhqd
数值型
n. . 4
8
电池电压
dcdy
数值型
n. . 4
5.2.2.7 获取油罐油情信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮油仓库管理信息系统 。
b) 服务响应方 :粮情测控系统 。
c) 方法名称 :Get_OilTestingData。
d) 返回类型 :复合型 。
e) 参数应符合表 44的要求 。
f) 返回值应符合表 45的要求 。
表 44 获取油罐油情信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
油罐编号
ygbh
字符型
a. 3
为空时返回所有油罐信息
16
GB/T 26882.4—2024
表 45 获取油罐油情信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
油罐编号
ygbh
字符型
a. 3
—
2
采集类型
cjlx
字符型
a. 30
3
采集点编号
cjdbh
数值型
n. . 4
4
采集数值
cjsz
数值型
n. . 8
5
是否有效
sfyx
字符型
a.4
6
采集时间
cjsj
日期时间型
YYYYMMDD HHMMSS
5.2.2. 8 获取油罐油情预警信息数据方法的接口定义
接口定义如下 。
a) 服务请求方 :粮油仓库管理信息系统 。
b) 服务响应方 :粮情测控系统 。
c) 方法名称 :Get_OilWarningData。
d) 返回类型 :复合型 。
e) 参数应符合表 46的要求 。
f) 返回值应符合表 47的要求 。
表 46 获取油罐油情预警信息数据方法参数
序号
参数
短名
数据类型
数据格式
备注
1
库区代码
kqdm
字符型
a. 3
—
2
油罐编号
ygbh
字符型
a. 3
为空时返回所有油罐信息
3
开始日期
ksrq
日期型
YYYYMMDD
—
4
结束 日期
jsrq
日期型
YYYYMMDD
—
表 47 获取油罐油情预警信息数据方法返回值
序号
参数
短名
数据类型
数据格式
备注
1
油罐编号
ygbh
字符型
a. 3
—
2
预警类型
yjlx
字符型
a. 10
3
预警级别
yjjb
字符型
a.2
4
预警内容
yjnr
字符型
a.250
5
预警时间
yjsj
日期时间型
YYYYMMDD HHMMSS
17
相关推荐
- GB/T 50779-2022 石油化工建筑物抗爆设计标准
- GB/T 40800-2021 铸钢件焊接工艺评定规范
- GB 50184-2011 工业金属管道工程施工质量验收规范 高清晰版
- GB∕T 40801-2021 钛、锆及其合金的焊接工艺评定试验
- GB/T 27065-2015 合格评定 产品、过程和服务认证机构要求
- GB/T 16674.2-2016 六角法兰面螺栓 细牙 小系列
- GB/T 23370-2009 硬质合金 压缩试验方法
- GB∕T 40802-2021 通用铸造碳钢和低合金钢铸件
- GB/T 16824.2-2016 六角法兰面自攻螺钉
- GB/Z 3480.4-2024 直齿轮和斜齿轮承载能力计算 第4部分：齿面断裂承载能力计算
