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