GB/T 26882.4-2024 粮油储藏 粮情测控系统 第4部分：信息交换接口协议

ICS65.040.20
CCS B20
中华人民共和国国家标准
GB/T26882.4—2024
代替GB/T26882.4—2011
粮油储藏 粮情测控系统第4部分:信息交换接口协议
Grainandoilstorage—Monitoringandcontrolsystemofstored-grain
condition—Part4∶Informationexchangeinterfaceprotocol
2024-11-28发布2025-06-01实施
国家市场监督管理总局
国家标准化管理委员会发布

目 次
前言………………………………………………………………………………………………………… Ⅲ
引言………………………………………………………………………………………………………… Ⅳ
1 范围……………………………………………………………………………………………………… 1
2 规范性引用文件………………………………………………………………………………………… 1
3 术语和定义……………………………………………………………………………………………… 1
4 通信和信息交换模式…………………………………………………………………………………… 1
4.1 上位机与分机的通信模式………………………………………………………………………… 1
4.2 粮情测控系统信息交换模式……………………………………………………………………… 1
5 接口定义………………………………………………………………………………………………… 2
5.1 上位机与分机之间的通信接口…………………………………………………………………… 2
5.2 粮情测控系统与粮油仓库管理信息系统之间的信息交换接口………………………………… 7
Ⅰ
GB/T26882.4—2024

前 言
本文件按照GB/T1.1—2020《标准化工作导则 第1部分:标准化文件的结构和起草规则》的规定
起草。
本 文件是GB/T26882《粮油储藏 粮情测控系统》的第4部分。GB/T26882已经发布了以下
部分:
———第1部分:通则;
———第2部分:分机;
———第3部分:软件;
———第4部分:信息交换接口协议。
本文件代替GB/T26882.4—2011《粮油储藏 粮情测控系统 第4部分:信息交换接口协议》,与
GB/T26882.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/T26882.4—2011;
———本次为第一次修订。
Ⅲ
GB/T26882.4—2024
引 言
目前,通过粮情测控系统对粮情进行实时监测已成为粮食仓储作业中必不缺少的技术手段,粮情监
控系统还能配合各种储粮工艺对粮情进行控制,保障了粮食的存储安全。GB/T26882《粮油储藏 粮
情测控系统》的制定,使得粮情测控系统产品的生产和应用有据可依,对提高产品的质量、提升仓储应用
管理效率和数据的共享有着重要意义。
近年来,随着信息技术及绿色储粮工艺的发展,对粮情测控系统提出了新要求,粮情检测除常规的
测量温度和湿度外,增加了水分、气体和储粮害虫等指标,与粮情检测结果相关的通风、气调和环流等粮
情控制也逐步得到应用,同时粮库网络已逐步覆盖到全库区,针对这些变化和需求,对GB/T26882—
2011适时进行了修订。
按照粮情测控系统的通用要求、硬件、软件和信息交换的内容,GB/T26882拟由4个部分构成。
———第1部分:通则。目的在于确立粮情测控系统需要遵守的总体要求和相关规则。
———第2部分:分机。目的在于确立置于粮仓端的粮情测控系统分机的粮情检测、粮情控制的执行
网络接入等技术要求。
———第3部分:软件。目的在于确立粮情测控系统的应用软件功能和报表的基本内容。
———第4部分:信息交换接口协议。目的在于确立粮情测控系统的分机与上位机之间、粮情测控系
统与其他粮库应用系统之间信息交换的协议和相关规则。
Ⅳ
GB/T26882.4—2024
粮油储藏 粮情测控系统
第4部分:信息交换接口协议
1 范围
本文件规定了粮情测控信息交换接口协议的通信模式和信息交换模式以及接口定义的要求。
本文件适用于粮情测控系统信息交换体系的设计与建设。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文
件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于
本文件。
LS/T1802—2016 粮食仓储业务数据元
3 术语和定义
下列术语和定义适用于本文件。
3.1
数据交换接口 dataexchangeinterface
不同系统之间为实现数据交换所规定的一组约定。
注:在粮情测控系统中,数据交换接口负责访问粮情测控系统和粮油仓库管理信息系统的数据资源调用、实现及反
馈结果集等。粮情测控系统和粮油仓库管理信息系统之间通过该接口的请求方法访问对方数据,对方提供响
应服务。
4 通信和信息交换模式
4.1 上位机与分机的通信模式
粮情测控系统上位机与分机之间的通信模式包括:
a) 上位机对分机发送读取或控制命令;
b) 分机响应上位机命令,发回相应数据或执行相应的控制。
4.2 粮情测控系统信息交换模式
粮情测控系统信息交换模式包括:
a) 粮情测控系统和粮油仓库管理信息系统之间向对方请求服务,调用对方服务接口;
b) 粮情测控系统或粮油仓库管理信息系统响应请求,向对方返回利用数据集封装的结构化
数据。
1
GB/T26882.4—2024
5 接口定义
5.1 上位机与分机之间的通信接口
5.1.1 字节传输格式
5.1.1.1 串口方式配置
串口应按以下要求进行配置:
a) 1位起始位;
b) 8位数据位;
c) 无校验位;
d) 1位停止位;
e) 波特率(单位:bit/s),波特率的取值包括但不限于1200、4800和9600等。
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 AAH55H AAH 4
分机地址KADDL 1
控制符Command 1
数据长度Length 2
数据段DataSegment L
校验CRC-16a 2
结束符16HE9H16HE9H 4
a CRC-16校验数据为起始符开始到校验前的所有数据。
5.1.1.4 命令响应时间
命令响应时间≤200ms。
注:命令响应时间为命令发送结束到接收分机返回数据的第一个字节的时间。
2
GB/T26882.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/T26882.4—2024
表6 上位机读取仓内温湿度指令格式
起始符KADDL(分机地址) Command Length CRC-16 结束符
注:Command= A2H,Length=0000H。
表7 分机返回仓内温湿度数据格式
起始符KADDL(分机地址) Command Length DataSegment CS-16 结束符
Cnt1l Cnt1h Cns1l Cns1h … CntNl CntNh CnsNlCnsNh
注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 DataSegment 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/T26882.4—2024
表10 分机返回粮堆温度的数据格式2
起始符KADDL(分机地址) Command Length DataSegment 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 DataSegment CRC-16 结束符
落虫次数I0 … In 虫害检测点号m
注1:Command=84H;Length=xxxxH。
注2:In 表明某仓m 号虫害检测点在In 时刻有虫落入,其长度为7Byte,格式与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/T26882.4—2024
表14 分机返回其他粮情信息数据格式
起始符KADDL(分机地址) Command Length DataSegment 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 DataSegment CRC-16 结束符
EC0 … ECn
注:Command=C2H ,Length=xxxxH。ECn 为第n 个设备的当前状态。
表17 上位机设定粮情控制设备状态指令格式
起始符KADDL(分机地址) Command Length DataSegment CRC-16 结束符
EC0 … ECn
注:Command=C3H ,Length=xxxxH。ECn 为第n 个设备将要设定的状态。
6
GB/T26882.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 获取库区基本信息数据方法返回值
序号参数短名数据类型数据格式备注
123456789
10
11
12
13
14
15
16
所属企业组织机构代码
所属企业统一社会信用代码
所属企业名称
库区代码
库区名称
库区简称
库区企业性质
库区类别
建成日期
库区设计仓容
库区面积
库区电话
库区传真
库区地址
库区邮政编码
库区行政区划名称
ssqyzzjgdm
ssqytyshxydm
ssqymc
kqdm
kdmc
kdjc
kdqyxz
kdlb
jcrq
kdsjcr
kdmj
kddh
kdcz
kddz
kdyzbm
kdxzqhmc
字符型
字符型
字符型
字符型
字符型
字符型
字符型
字符型
日期型
数值型
数值型
字符型
字符型
字符型
字符型
字符型
a.9
a.18
a..50
a.3
a..50
a..20
a.1
a..20
YYYYMMDD
n..8
n..10,2
a..50
a..50
a..200
a.6
a..50
含义及类型按照
LS/T1802—2016
中6.1.3的规定
17 库区行政区划代码kdxzqhdm 字符型a.6 17
7
GB/T26882.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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
所属库区
仓房编号
仓房名称
仓房类型
仓房结构
建筑类型
仓房长度(直径)
仓房宽度
仓房高度
仓房设计仓容
仓房实际仓容
启用日期
仓房状态
仓房使用状态
罩棚
简易囤
简易仓
sskq
cfbh
cfmc
cflx
cfjg
jzlx
cfcdzj
cfkd
cfgd
cfsjcr
cfsjcr01
qyrq
cfzt
cfsyzt
zp
jyd
jyc
字符型
字符型
字符型
字符型
字符型
字符型
数值型
数值型
数值型
数值型
数值型
日期型
字符型
字符型
数值型
数值型
数值型
a..20
a.3
a..20
a.7
a..20
a..20
n..5,1
n..5,1
n..5,1
n..8
n..8
YYYYMMDD
a.1
a.1
a..15,2
a..15,2
a..15,2
含义及类型按照
LS/T1802—2016
中6.1.4的规定
8
GB/T26882.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 为空时返回所有廒间信息
表23 获取廒间基本信息数据方法返回值
序号参数短名数据类型数据格式备注
123456789
10
11
12
所属仓房
所属仓房编号
廒间编号
廒间名称
廒间长度
廒间宽度
廒间高度
廒间设计仓容
廒间实际仓容
廒间启用日期
廒间状态
廒间使用状态
sscf
sscfbh
ajbh
ajmc
ajcd
ajkd
ajgd
ajsjcr
ajsjcr01
ajqyrq
ajzt
ajsyzt
字符型
字符型
字符型
字符型
数值型
数值型
数值型
数值型
数值型
日期型
字符型
字符型
a..20
a.3
a.3
a..20
n..5,1
n..5,1
n..5,1
n..8
n..8
YYYYMMDD
a.1
a.1
含义及类型按照
LS/T1802—2016
中6.1.6的规定
5.2.1.4 获取廒间储粮信息数据方法的接口定义
接口定义如下。
a) 服务请求方:粮情测控系统。
b) 服务响应方:粮油仓库管理信息系统。
c) 方法名称:Get_GrainInfoData。
d) 返回类型:复合型。
e) 参数应符合表24的要求。
f) 返回值应符合表25的要求。
9
GB/T26882.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/T26882.4—2024
表27 获取油罐基本信息数据方法返回值
序号参数短名数据类型数据格式备注
1234567
油库等级
油罐名称
油罐编号
油罐总容
油罐组容
油罐状态
油罐使用状态
ykdj
ygmc
ygbh
ygzr
ygzr01
ygzt
ygsyzt
字符型
字符型
字符型
数值型
数值型
字符型
字符型
a.1
a..20
a..20
n..15,3
n..15,3
a.1
a.1
含义及类型按照
LS/T1802—2016
中6.1.5的规定
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 获取油罐储油信息数据方法返回值
序号参数短名数据类型数据格式备注
1234567
所属油罐编号
储油性质
品种代码
数量
产地代码
生产年份
等级代码
ygbh
cyxz
pzdm
sl
cddm
scnf
djdm
字符型
字符型
字符型
数值型
字符型
字符型
字符型
a.3
a.3
a.7
n..8
a.6
a.4
a.2
—
11
GB/T26882.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/T26882.4—2024
表33 获取廒间粮情检测点信息数据方法返回值
序号参数短名数据类型数据格式备注
12345678
廒间编号
采集类型
设备厂家
分机号
线缆号
采集点编号
采集点逻辑位置
采集点物理位置
ajbh
cjlx
sbcs
fjh
xlh
cjdbh
cjdljwz
cjdwlwz
字符型
字符型
字符型
数值型
数值型
数值型
结构化数据(x,y,z)
结构化数据(x,y,z)
a.3
a.30
a.50
n..4
n..4
n..4
(n..4,n..4,n..4)
(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 获取廒间粮情检测设备状态数据方法返回值
序号参数短名数据类型数据格式备注
12345678
廒间编号
采集类型
设备厂家
分机号
采集点编号
设备状态
信号强度
电池电压
ajbh
cjlx
sbcj
fjh
cjdbh
sbzt
xhqd
dcdy
字符型
字符型
字符型
数值型
数值型
字符型
数值型
数值型
a.3
a.30
a.50
n..4
n..4
a.30
n..4
n..4
—
13
GB/T26882.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 获取廒间粮情信息数据方法返回值
序号参数短名数据类型数据格式备注
123456
廒间编号
采集类型
采集点编号
采集数值
是否有效
采集时间
ajbh
cjlx
cjdbh
cjsz
sfyx
cjsj
字符型
字符型
数值型
数值型
字符型
日期时间型
a.3
a.30
n..4
n..8
a.4
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/T26882.4—2024
表39 获取廒间储粮预警信息数据方法返回值
序号参数短名数据类型数据格式备注
1234
5
廒间编号
预警类型
预警级别
预警内容
预警时间
ajbh
yjlx
yjjb
yjnr
yjsj
字符型
字符型
字符型
字符型
日期时间型
a.3
a.10
a.2
a.250
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
2
3
4
5
6
7
8
油罐编号
采集类型
设备厂家
分机号
线缆号
采集点编号
采集点逻辑位置
采集点物理位置
ygbh
cjlx
sbcs
fjh
xlh
cjdbh
cjdljwz
cjdwlwz
字符型
字符型
字符型
数值型
数值型
数值型
结构化数据(x,y,z)
结构化数据(x,y,z)
a.3
a.30
a.50
n..4
n..4
n..4
(n..4,n..4,n..4)
(n..4,n..4,n..4)
—
15
GB/T26882.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 获取油罐油情检测设备状态数据方法返回值
序号参数短名数据类型数据格式备注
12345678
油罐编号
采集类型
设备厂家
分机号
采集点编号
设备状态
信号强度
电池电压
ygbh
cjlx
sbcj
fjh
cjdbh
sbzt
xhqd
dcdy
字符型
字符型
字符型
数值型
数值型
字符型
数值型
数值型
a.3
a.30
a.50
n..4
n..4
a.30
n..4
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/T26882.4—2024
表45 获取油罐油情信息数据方法返回值
序号参数短名数据类型数据格式备注
123456
油罐编号
采集类型
采集点编号
采集数值
是否有效
采集时间
ygbh
cjlx
cjdbh
cjsz
sfyx
cjsj
字符型
字符型
数值型
数值型
字符型
日期时间型
a.3
a.30
n..4
n..8
a.4
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 获取油罐油情预警信息数据方法返回值
序号参数短名数据类型数据格式备注
12345
油罐编号
预警类型
预警级别
预警内容
预警时间
ygbh
yjlx
yjjb
yjnr
yjsj
字符型
字符型
字符型
字符型
日期时间型
a.3
a.10
a.2
a.250
YYYYMMDD HHMMSS
—