LS/T 1812-2017糧油儲(chǔ)藏糧情測(cè)控信息交換接口協(xié)議技術(shù)要求

ICS3524099

B20..

中華人民共和國(guó)糧食行業(yè)標(biāo)準(zhǔn)

LS/T1812—2017

糧油儲(chǔ)藏

糧情測(cè)控信息交換接口協(xié)議技術(shù)要求

Grainandoilstorage—Monitoringandcontrolsystemofstored-graincondition

technicalrequirementsforinformationexchangeinterfaceprotocol

2017-03-10發(fā)布2017-06-01實(shí)施

國(guó)家糧食局發(fā)布

LS/T1812—2017

目次

前言

…………………………Ⅲ

范圍

1………………………1

規(guī)范性引用文件

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

術(shù)語(yǔ)和定義

3………………1

糧情測(cè)控系統(tǒng)通信和信息交換

4…………2

接口定義

5…………………2

附錄資料性附錄接口示例

A()…………18

Ⅰ

LS/T1812—2017

前言

本標(biāo)準(zhǔn)按照給出的規(guī)則起草

GB/T1.1—2009。

本標(biāo)準(zhǔn)由國(guó)家糧食局提出

。

本標(biāo)準(zhǔn)由全國(guó)糧油標(biāo)準(zhǔn)化技術(shù)委員會(huì)歸口

(SAC/TC270)。

本標(biāo)準(zhǔn)負(fù)責(zé)起草單位河南工業(yè)大學(xué)

:。

本標(biāo)準(zhǔn)參與起草單位國(guó)家糧食局科學(xué)研究院中儲(chǔ)糧成都糧食儲(chǔ)藏科學(xué)研究所株洲華邦科技發(fā)

:、、

展有限公司北京佳華儲(chǔ)糧科技有限公司赤峰金辰電子公司湖北葉威集團(tuán)智能科技有限公司湖南

、、、()、

萬(wàn)通科技股份有限公司

。

本標(biāo)準(zhǔn)主要起草人肖樂(lè)甄彤趙會(huì)義祝玉華趙小軍吳建軍呂宗旺許德剛朱世華王強(qiáng)

:、、、、、、、、、、

葉維林朱江洪陳衛(wèi)東孫福艷吳軍里蔡軍吳秋生劉自力林榮華薛淵李智慧

、、、、、、、、、、。

Ⅲ

LS/T1812—2017

糧油儲(chǔ)藏

糧情測(cè)控信息交換接口協(xié)議技術(shù)要求

1范圍

本標(biāo)準(zhǔn)規(guī)定了糧情測(cè)控信息交換接口協(xié)議的術(shù)語(yǔ)和定義系統(tǒng)基本框架接口定義等技術(shù)內(nèi)容

、、。

本標(biāo)準(zhǔn)適用于糧情測(cè)控系統(tǒng)信息交換體系的設(shè)計(jì)與建設(shè)

。

2規(guī)范性引用文件

下列文件對(duì)于本文件的應(yīng)用是必不可少的凡是注日期的引用文件僅注日期的版本適用于本文

。,

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

。,()。

糧食倉(cāng)儲(chǔ)業(yè)務(wù)數(shù)據(jù)元

LS/T1802—2016

3術(shù)語(yǔ)和定義

下列術(shù)語(yǔ)和定義適用于本文件

。

31

.

數(shù)據(jù)data

對(duì)事實(shí)概念或指令的一種形式化表示適用于以人或自動(dòng)方式進(jìn)行通信解釋或處理

、,、。

32

.

表示representation

值域和數(shù)據(jù)類(lèi)型的組合必要時(shí)也包括計(jì)量單位或字符集

,。

33

.

數(shù)據(jù)交換接口dataexchangeinterface

不同系統(tǒng)之間為實(shí)現(xiàn)數(shù)據(jù)交換所規(guī)定的一組約定在糧情測(cè)控系統(tǒng)中數(shù)據(jù)交換接口負(fù)責(zé)訪(fǎng)問(wèn)糧

。,

情測(cè)控系統(tǒng)和其他系統(tǒng)的數(shù)據(jù)資源調(diào)用實(shí)現(xiàn)及反饋結(jié)果集等糧情測(cè)控系統(tǒng)和其他系統(tǒng)之間可以通

、。

過(guò)該接口的請(qǐng)求方法訪(fǎng)問(wèn)對(duì)方數(shù)據(jù)對(duì)方負(fù)責(zé)提供響應(yīng)服務(wù)

,。

34

.

數(shù)據(jù)項(xiàng)dataunit

由數(shù)據(jù)項(xiàng)標(biāo)識(shí)符數(shù)據(jù)項(xiàng)名稱(chēng)和數(shù)據(jù)項(xiàng)值三個(gè)元素組成

、。

35

.

數(shù)據(jù)記錄datarecord

組成數(shù)據(jù)集的基本單位表示一條記錄數(shù)據(jù)記錄由一個(gè)或多個(gè)數(shù)據(jù)項(xiàng)組成

,,。

36

.

數(shù)據(jù)集dataset

由一個(gè)或多個(gè)數(shù)據(jù)記錄組成

。

37

.

空白點(diǎn)blankspot

用于表示對(duì)應(yīng)檢測(cè)點(diǎn)位置無(wú)傳感器的狀態(tài)

。

1

LS/T1812—2017

4糧情測(cè)控系統(tǒng)通信和信息交換

41糧情測(cè)控系統(tǒng)上位機(jī)與分機(jī)的通信模式

.

糧情測(cè)控系統(tǒng)各部分主要包括糧情測(cè)控軟件系統(tǒng)上位機(jī)與糧情測(cè)控硬件系統(tǒng)分機(jī)它們的通

()(),

信模式如下

:

上位機(jī)對(duì)分機(jī)發(fā)送讀取或控制命令

a);

分機(jī)響應(yīng)上位機(jī)命令發(fā)回相應(yīng)數(shù)據(jù)或執(zhí)行相應(yīng)的控制

b),。

42糧情測(cè)控系統(tǒng)信息交換模式

.

糧情測(cè)控系統(tǒng)信息交換模式如下

:

糧情測(cè)控系統(tǒng)和其他系統(tǒng)之間向?qū)Ψ秸?qǐng)求服務(wù)調(diào)用對(duì)方服務(wù)接口

a),;

糧情測(cè)控系統(tǒng)或其他系統(tǒng)響應(yīng)請(qǐng)求向?qū)Ψ椒祷乩脭?shù)據(jù)集封裝的結(jié)構(gòu)化數(shù)據(jù)

b),。

5接口定義

51上位機(jī)與分機(jī)之間的通信接口

.

511字節(jié)傳輸格式

..

5111串口方式配置

...

糧食出入庫(kù)業(yè)務(wù)信息系統(tǒng)一般由出入庫(kù)登記扦樣管理檢驗(yàn)管理計(jì)量管理值倉(cāng)管理結(jié)算管理

、、、、、

和統(tǒng)計(jì)分析等七個(gè)模塊構(gòu)成相關(guān)模塊具有可擴(kuò)展性如表所示

,,1。

串口應(yīng)按下列要求進(jìn)行配置

:

位起始位

a)1;

位數(shù)據(jù)位

b)8;

無(wú)校驗(yàn)位

c);

位停止位

d)1;

波特率

e)。

注其中波特率的取值可以是但不限于下列數(shù)值單位等

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

表1數(shù)據(jù)幀格式

字段名代碼長(zhǎng)度

/Byte

起始符

55HAAH55HAAH4

分機(jī)地址

KADDL1

控制符

Command1

數(shù)據(jù)長(zhǎng)度

Length2

數(shù)據(jù)段

DataSegmentL

校驗(yàn)a

CRC-162

結(jié)束符

16HE9H16HE9H4

a其中校驗(yàn)數(shù)據(jù)為從起始符開(kāi)始到校驗(yàn)前的所有數(shù)據(jù)

CRC-16。

2

LS/T1812—2017

5112以太網(wǎng)方式配置

...

以太網(wǎng)配置如下

:

服務(wù)器地址與測(cè)控分機(jī)地址設(shè)為同一網(wǎng)段

a)IPIP;

服務(wù)器端口端口

b)TCP:1238;UDP:1240;

服務(wù)器以廣播方式發(fā)送各種查詢(xún)指令目標(biāo)為全體目標(biāo)端口

c)UPD。IP:55;:

5000;

測(cè)控分機(jī)以方式返回?cái)?shù)據(jù)測(cè)控分機(jī)的端口

d)TCP,TCP:3000。

5113數(shù)據(jù)幀格式

...

通信接口的數(shù)據(jù)幀應(yīng)符合表格式

1。

5114命令響應(yīng)時(shí)間

...

命令響應(yīng)時(shí)間命令發(fā)送結(jié)束到接收到分機(jī)返回?cái)?shù)據(jù)的第一個(gè)字節(jié)的時(shí)間小于或等于

()200ms。

512通訊格式

..

5121讀取分機(jī)狀態(tài)指令

...

上位機(jī)讀取分機(jī)狀態(tài)指令應(yīng)按照表的格式發(fā)送

a)2。

表2上位機(jī)讀取分機(jī)狀態(tài)指令格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthCRC-16

Command=A0H,Length=0000H。

分機(jī)應(yīng)按照表的格式返回狀態(tài)數(shù)據(jù)

b)3。

表3分機(jī)返回分機(jī)狀態(tài)數(shù)據(jù)格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthStateCRC-16

為狀態(tài)數(shù)據(jù)段占兩個(gè)字節(jié)

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

5122讀取倉(cāng)外溫濕度

...

上位機(jī)讀取倉(cāng)外溫濕度指令應(yīng)按照表的格式發(fā)送

a)4。

表4上位機(jī)讀取倉(cāng)外溫濕度指令格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthCRC-16

Command=A1H,Length=0000H。

分機(jī)應(yīng)按照表的格式返回倉(cāng)外溫濕度數(shù)據(jù)

b)5。

表5分機(jī)返回倉(cāng)外溫濕度數(shù)據(jù)格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthCwtlCwthCwslCwshCRC-16

3

LS/T1812—2017

共同組成數(shù)據(jù)段為倉(cāng)

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

外溫度其中為低字節(jié)為高字節(jié)為倉(cāng)外濕度其中為低字節(jié)為

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

高字節(jié)

。

5123讀取倉(cāng)內(nèi)溫濕度

...

上位機(jī)讀取倉(cāng)內(nèi)溫濕度指令應(yīng)按照表的格式發(fā)送

a)6。

表6上位機(jī)讀取倉(cāng)內(nèi)溫濕度指令格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthCRC-16

Command=A2H,Length=0000H。

分機(jī)應(yīng)按照表的格式返回倉(cāng)內(nèi)溫濕度數(shù)據(jù)

b)7。

表7分機(jī)返回倉(cāng)內(nèi)溫濕度數(shù)據(jù)格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthDataSegmentCS-16

NNNN

Cnt1lCnt1hCns1lCns1h…CntlCnthCnslCnsh

NN為第N個(gè)倉(cāng)內(nèi)溫度檢測(cè)點(diǎn)值其中

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

N為低字節(jié)N為高字節(jié)NN為第N個(gè)倉(cāng)內(nèi)濕度檢測(cè)點(diǎn)值其中N為低字

Cntl,Cnth。Cnsl、Cnsh,Cnsl

節(jié)N為高字節(jié)

,Cnsh。

5124讀取糧堆溫度

...

上位機(jī)讀取糧堆溫度指令應(yīng)按照表的格式發(fā)送

a)8。

表8上位機(jī)讀取糧堆溫度指令格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthCRC-16

Command=A3H,Length=0000H。

分機(jī)應(yīng)按照表或表的格式返回糧堆溫度數(shù)據(jù)

b)910。

表9分機(jī)返回糧堆溫度的數(shù)據(jù)格式1

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthDataSegmentCRC-16

nnnnn

L1T0lT0h……TlThLT0lT0h…TlTh

n為第n個(gè)傳感器電纜的編號(hào)長(zhǎng)度為兩個(gè)字節(jié)n

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

n為某根電纜的第n個(gè)檢測(cè)點(diǎn)值同一條電纜的檢測(cè)點(diǎn)排序?yàn)閺纳系较马樞蚺帕衅渲衝為低字

Th,,Tl

節(jié)n為高字節(jié)

,Th。

4

LS/T1812—2017

表10分機(jī)返回糧堆溫度的數(shù)據(jù)格式2

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthDataSegmentCRC-16

nn

T0lT0h…TlTh

nn為某倉(cāng)的第n個(gè)溫度檢測(cè)點(diǎn)值其中n為低

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

字節(jié)n為高字節(jié)

,Th。

5125讀取倉(cāng)內(nèi)儲(chǔ)糧害蟲(chóng)信息數(shù)據(jù)

...

上位機(jī)讀取倉(cāng)內(nèi)儲(chǔ)糧害蟲(chóng)信息數(shù)據(jù)指令應(yīng)按照表的格式發(fā)送

a)11。

表11上位機(jī)讀取倉(cāng)內(nèi)儲(chǔ)糧害蟲(chóng)信息數(shù)據(jù)指令格式

起始符分機(jī)地址蟲(chóng)害分支器號(hào)m結(jié)束符

KADDL()CommandCRC-16

蟲(chóng)害分支器號(hào)

Command=A4H。=××××H。

分機(jī)應(yīng)按照表的格式返回其他糧情信息數(shù)據(jù)

b)12。

表12分機(jī)返回倉(cāng)內(nèi)儲(chǔ)糧害蟲(chóng)信息數(shù)據(jù)格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthDataSegmentCRC-16

落蟲(chóng)次數(shù)n蟲(chóng)害分支器號(hào)m

I0…I

n表明某倉(cāng)m號(hào)蟲(chóng)害分支器在n時(shí)刻有蟲(chóng)落入其長(zhǎng)度

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

為格式與時(shí)間的前個(gè)字節(jié)相同如果落蟲(chóng)次數(shù)為則不存在到n字段

7Byte,DS13077。0,I0I。

5126讀取其他糧情信息數(shù)據(jù)

...

其他糧情信息數(shù)據(jù)的讀取應(yīng)符合下述規(guī)定的格式

:

上位機(jī)讀取其他糧情信息數(shù)據(jù)指令應(yīng)按照表的格式發(fā)送

a)13。

表13上位機(jī)讀取其他糧情信息數(shù)據(jù)指令格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthCRC-16

的取值范圍從到一種糧情信息使用一個(gè)命令控制符依此類(lèi)推

CommandA5HBFH,,。Length

=0000H。

分機(jī)應(yīng)按照表的格式返回其他糧情信息數(shù)據(jù)

b)14。

5

LS/T1812—2017

表14分機(jī)返回其他糧情信息數(shù)據(jù)格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthDataSegmentCRC-16

nn

X0lX0h…XlXh

的取值范圍從到一種糧情信息使用一個(gè)命令控制符依此類(lèi)推

Command85H9FH,,。Length=

nn為某倉(cāng)的第n個(gè)某糧情信息檢測(cè)點(diǎn)值其中n為低字節(jié)n為高字節(jié)

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

5127糧情信息數(shù)據(jù)計(jì)算公式

...

溫度計(jì)算公式nn保留一位小數(shù)

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

濕度計(jì)算公式nn保留一位小數(shù)

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

其他糧情信息數(shù)據(jù)計(jì)算公式nn保留一位小數(shù)

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

若某檢測(cè)點(diǎn)無(wú)數(shù)據(jù)回復(fù)表示有誤其中開(kāi)路為短路為

d),7777H,8888H;

空白點(diǎn)的值為

e)9999H。

5128糧情控制

...

上位機(jī)讀取糧情控制設(shè)備狀態(tài)信息數(shù)據(jù)指令應(yīng)按照表的格式發(fā)送

a)15。

表15上位機(jī)讀取糧情控制設(shè)備狀態(tài)信息數(shù)據(jù)指令格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthCRC-16

Command=C1H,Length=0000H。

分機(jī)應(yīng)按照表的格式返回糧情控制設(shè)備狀態(tài)信息數(shù)據(jù)

b)16。

表16分機(jī)返回糧情控制設(shè)備狀態(tài)信息數(shù)據(jù)格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthDataSegmentCRC-16

n

EC0…EC

n為第n個(gè)設(shè)備的當(dāng)前狀態(tài)

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

上位機(jī)設(shè)定糧情控制設(shè)備狀態(tài)的指令應(yīng)按照表的格式發(fā)送

c)17。

表17上位機(jī)設(shè)定糧情控制設(shè)備狀態(tài)指令格式

起始符分機(jī)地址結(jié)束符

KADDL()CommandLengthDataSegmentCRC-16

n

EC0…EC

6

LS/T1812—2017

n為第n個(gè)設(shè)備將要設(shè)定的狀態(tài)

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

52糧情測(cè)控系統(tǒng)與其他系統(tǒng)之間的信息交換

.

521糧油倉(cāng)庫(kù)管理信息系統(tǒng)提供的數(shù)據(jù)交換接口

..

5211獲取庫(kù)點(diǎn)基本信息數(shù)據(jù)方法的接口定義

...:

服務(wù)請(qǐng)求方糧情測(cè)控系統(tǒng)

a):;

服務(wù)響應(yīng)方糧油倉(cāng)庫(kù)管理信息系統(tǒng)

b):;

方法名稱(chēng)

c):Get_DepotInfoData;

返回類(lèi)型復(fù)合型

d):;

參數(shù)應(yīng)參照表的要求

e)18;

表18獲取倉(cāng)點(diǎn)基本信息數(shù)據(jù)方法參數(shù)表

序號(hào)參數(shù)短名數(shù)據(jù)類(lèi)型數(shù)據(jù)格式

庫(kù)點(diǎn)代碼字符型

1kddma.3

返回值應(yīng)參照表的要求

f)19。

表19獲取庫(kù)點(diǎn)基本信息數(shù)據(jù)方法返回值表

序號(hào)參數(shù)短名數(shù)據(jù)類(lèi)型數(shù)據(jù)格式備注

所屬企業(yè)組織機(jī)構(gòu)代碼字符型

1ssqyzzjgdma.9

所屬企業(yè)統(tǒng)一社會(huì)信用代碼字符型

2ssqytyshxydma.18

所屬企業(yè)名稱(chēng)字符型

3ssqymca..50

庫(kù)點(diǎn)代碼字符型

4kddma.3

庫(kù)點(diǎn)名稱(chēng)字符型

5kdmca..50

庫(kù)點(diǎn)簡(jiǎn)稱(chēng)字符型

6kdjca..20

庫(kù)點(diǎn)企業(yè)性質(zhì)字符型

7kdqyxza.1

庫(kù)點(diǎn)類(lèi)別字符型

8kdlba..20含義及類(lèi)型參見(jiàn)

建成日期日期型

9jcrqYYYYMMDDLS/T1802—2016

庫(kù)點(diǎn)設(shè)計(jì)倉(cāng)容數(shù)值型中

10kdsjcrn..86.1.3

庫(kù)點(diǎn)面積數(shù)值型

11kdmjn..10,2

庫(kù)點(diǎn)電話(huà)字符型

12kddha..50

庫(kù)點(diǎn)傳真字符型

13kdcza..50

庫(kù)點(diǎn)地址字符型

14kddza..200

庫(kù)點(diǎn)郵政編碼字符型

15kdyzbma.6

庫(kù)點(diǎn)行政區(qū)劃名稱(chēng)字符型

16kdxzqhmca..50

庫(kù)點(diǎn)行政區(qū)劃代碼字符型

17kdxzqhdma.6

5212獲取倉(cāng)房基本信息數(shù)據(jù)方法的接口定義

...:

服務(wù)請(qǐng)求方糧情測(cè)控系統(tǒng)

a):;

7

LS/T1812—2017

服務(wù)響應(yīng)方糧油倉(cāng)庫(kù)管理信息系統(tǒng)

b):;

方法名稱(chēng)

c):Get_BarnBaseInfoData;

返回類(lèi)型復(fù)合型

d):;

參數(shù)應(yīng)參照表的要求

e)20;

表20獲取倉(cāng)房基本信息數(shù)據(jù)方法參數(shù)表

序號(hào)參數(shù)短名數(shù)據(jù)類(lèi)型數(shù)據(jù)格式備注

庫(kù)點(diǎn)代碼字符型

1kddma.3

倉(cāng)房編號(hào)字符型為空時(shí)返回所有倉(cāng)房信息

2cfbha.3

返回值應(yīng)參照表的要求

f)21。

表21獲取倉(cāng)房基本信息數(shù)據(jù)方法返回值表

序號(hào)參數(shù)短名數(shù)據(jù)類(lèi)型數(shù)據(jù)格式備注

所屬庫(kù)點(diǎn)字符型

1sskda..20

倉(cāng)房編號(hào)字符型

2cfbha.3

倉(cāng)房名稱(chēng)字符型

3cfmca..20

倉(cāng)房類(lèi)型字符型

4cflxa.7

倉(cāng)房結(jié)構(gòu)字符型

5cfjga..20

建筑類(lèi)型字符型

6jzlxa..20

倉(cāng)房長(zhǎng)度直徑數(shù)值型

7()cfcdzjn..5,1

倉(cāng)房寬度數(shù)值型

8cfkdn..5,1含義及類(lèi)型參見(jiàn)

倉(cāng)房高度數(shù)值型

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

倉(cāng)房設(shè)計(jì)倉(cāng)容數(shù)值型中

10cfsjcrn..86.1.4

倉(cāng)房實(shí)際倉(cāng)容數(shù)值型

11cfsjcr01n..8

啟用日期日期型

12qyrqYYYYMMDD

倉(cāng)房狀態(tài)字符型

13