LS/T 1812-2017Grain and oil storage. Monitoring and control system of stored-grain condition technical requirements for information exchange interface protocol (English PDF)
This is a limited preview
Buy now to download the full PDF (21 pages)
Need quotation for your management?
Get a formal quotation for LS/T 1812-2017 in 30 minutes.
Issued by
National Grain Administration
Level / Type
National · Recommended
Issue date
March 10, 2017
Implementation date
June 1, 2017
Scope
LS/T 1812-2017 (Grain and oil storage. Monitoring and control system of stored-grain condition technical requirements for information exchange interface protocol) is available as an English-translated PDF.
LS/T 1812-2017 — This standard specifies the technical content of the terminology and definition of the grain condition measurement and control information exchange interface protocol, the basic framework of the system, and the interface definition.
This standard applies to the design and construction of the information exchange system for grain condition measurement and control systems.
Found what you need?
Document preview — LS/T 1812-2017
National Standard of the People's Republic of China
- ICS
- 35.240.99
- Classification
- B 20
Issued by: National Grain Administration
Contents
- Foreword
- 1 Scope
- 2 Normative references
- 3 Terms and definitions
- 4 Food situation monitoring and control system communication and information exchange
- 4.2 Information exchange control system information exchange mode
- 5 Interface definition
- 5.1 Communication interface between the host computer and the extension
- 5.2 Information exchange between the grain monitoring and control system and other systems
- 6 Library points referred to as kdjc character type a.20
- 7 Library point enterprise nature kdqyxz character type a.1
- 8 Library point category kdlb character type a.20
- 9 Built-in date jcrq date type YYYYMMDD
- 10 Library design warehouse kdsjcr numerical type n.8
- 12 Library point phone kddh character type a.50
- 13 Library point fax kdcz character type a.50
- 14 Library point address kddz character type a.200
- 15 Library point zip code kdyzbm character type a.6
- 16 Library point administrative division name kdxzqhmc character type a.50
- 17 Library administrative division code kdxzqhdm character type a.6
Foreword
This standard was drafted in accordance with the rules given in GB/T 1.1-2009.
This standard was proposed by the National Grain Administration.
This standard is under the jurisdiction of the National Grain and Oil Standardization Technical Committee (SAC/TC270).
1 Scope
This standard specifies the technical content of the terminology and definition of the grain condition measurement and control information exchange interface protocol, the basic framework of the system, and the interface definition.
This standard applies to the design and construction of the information exchange system for grain condition measurement and control systems.
2 Normative references
The following documents are indispensable for the application of this document. For dated references, only dated versions apply to this article.
Pieces. For undated references, the latest edition (including all amendments) applies to this document.
LS/T 1802-2016 Grain Warehousing Business Data Element
3 Terms and definitions
The following terms and definitions apply to this document.
Data
A formal representation of a fact, concept, or instruction that applies to communication, interpretation, or processing in a human or automated manner.
Representation
A combination of a range of values and a data type, including a unit of measure or a character set, if necessary.
Data exchange interface A set of conventions defined between different systems for data exchange. In the grain monitoring and control system, the data exchange interface is responsible for accessing the grain.
The data resource call, implementation and feedback result set of the situation control system and other systems. Between the grain monitoring and control system and other systems the request method of the interface accesses the other party's data, and the other party is responsible for providing the response service.
Data item dataunit
It consists of three elements. data item identifier, data item name, and data item value.
Data record
The basic unit that makes up a data set, representing a record, which consists of one or more data items.
Dataset
Consists of one or more data records.
Blank point blankspot it is used to indicate the state of the corresponding detection point where there is no sensor.
4 Food situation monitoring and control system communication and information exchange
4.1 The communication mode between the upper computer and the extension of the grain condition measurement and control system each part of the grain condition measurement and control system mainly includes the grain condition measurement and control software system (host computer) and the grain condition measurement and control hardware system (extension), and their communication the letter mode is as follows.
a) The host computer sends a read or control command to the extension;
b) The extension responds to the host computer command, sends back the corresponding data or performs the corresponding control.
4.2 Information exchange control system information exchange mode
The information exchange mode of the grain situation monitoring and control system is as follows.
a) The food situation monitoring system and other systems request service from the other party and call the other party's service interface;
b) The food condition monitoring system or other system responds to the request and returns structured data encapsulated with the data set to the other party.
5 Interface definition
5.1 Communication interface between the host computer and the extension
5.1.1 Byte Transfer Format
5.1.1.1 Serial Port Configuration
The grain inbound and outbound business information system generally consists of inbound and outbound registration, sample management, inspection management, measurement management, value warehouse management, and settlement management.
It consists of seven modules, such as statistical analysis, and the related modules are extensible, as shown in Table 1.
The serial port should be configured as follows.
a) 1 start position;
b) 8-bit data bits;
c) no check digits;
d) 1 stop position;
e) Baud rate.
Note. The value of the baud rate can be, but is not limited to, the following values (unit. Bps). 1200, 4800, 9600, etc.
Table 1 Data frame format
Field name code length/Byte Initial character 55HAAH55HAAH 4 Extension address KADDL 1 Control character Command 1 Data length Length 2 Data segment DataSegment L Verify CRC-16a 2 End character 16HE9H16HE9H 4 a where CRC-16 checksum data is all data from the start of the start to the check.
5.1.1.2 Ethernet Mode Configuration
The Ethernet configuration is as follows.
a) The IP address of the server and the IP address of the measurement and control extension are set to the same network segment;
b) server TCP port. 1238; UDP port. 1240;
c) The server sends various query commands in UPD broadcast mode. The target IP is all. 255.255.255.255; target port.
5000;
d) The measurement and control extension returns data in TCP mode, and the TCP port of the measurement and control extension. 3000.
5.1.1.3 Data frame format
The data frame of the communication interface shall conform to the format of Table 1.
5.1.1.4 Command response time
The command response time (the time from the end of the command transmission to the receipt of the first byte of the extension return data) is less than or equal to.200ms.
5.1.2 Communication format
5.1.2.1 Reading Extension Status Commands
a) The upper computer read extension status command shall be sent in the format of Table 2.
Table 2 Host computer read extension status command format
Start character KADDL (extension address) Command Length CRC-16 terminator Command=A0H, Length=0000H.
b) The extension shall return status data in the format of Table 3.
Table 3 Extension returns the extension status data format
Start character KADDL (extension address) Command Length State CRC-16 terminator Command=80H, Length=0002H. State is the state data segment, which occupies two bytes.
5.1.2.2 Reading the temperature and humidity outside the warehouse
a) The upper computer read temperature and humidity instructions should be sent according to the format of Table 4.
Table 4 The upper computer reads the temperature and humidity command format outside the warehouse
Start character KADDL (extension address) Command Length CRC-16 terminator Command=A1H, Length=0000H.
b) The extension shall return the temperature and humidity data outside the warehouse in the format of Table 5.
Table 5 Extension return temperature and humidity data format
Start character KADDL (extension address) Command Length Cwtl Cwth Cwsl Cwsh CRC-16 terminator Command=81H, Length=0004H. Cwtl, Cwth, Cwsl, and Cwsh together form a data segment. Cwtl, Cwth is the warehouse External temperature, where Cwtl is the low byte and Cwth is the high byte. Cwsl and Cwsh are the humidity outside the warehouse, where Cwsl is the low byte and Cwsh is High byte.
5.1.2.3 Reading the temperature and humidity in the warehouse
a) The upper computer read temperature and humidity instructions in the warehouse shall be sent in the format of Table 6.
Table 6 The upper computer reads the temperature and humidity command format in the warehouse
Start character KADDL (extension address) Command Length CRC-16 terminator Command=A2H, Length=0000H.
b) The extension shall return the temperature and humidity data in the warehouse according to the format of Table 7.
Table 7 Extension return temperature and humidity data format
Start character KADDL (extension address) Command Length DataSegment CS-16 terminator Cnt1l Cnt1h Cns1l Cns1h CntNlCntNh CnsNlCnsNh Command=82H, Length=××××H. CntNl and CntNh are the Nth temperature detection point values in the warehouse, wherein CntNl is the low byte and CntNh is the high byte. CnsNl and CnsNh are the Nth bin humidity detection point values, where CnsNl is a low word.
Section, CnsNh is the high byte.
5.1.2.4 Reading the grain temperature
a) The upper machine reading grain temperature command shall be sent in the format of Table 8.
Table 8 upper computer read grain reactor temperature command format
Start character KADDL (extension address) Command Length CRC-16 terminator Command=A3H, Length=0000H.
b) The extension shall return the grain temperature data in the format of Table 9 or Table 10.
Table 9 Data format of extension return grain temperature 1
Start character KADDL (extension address) Command Length DataSegment CRC-16 terminator L1 T0l T0h Tnl Tnh Ln T0l T0h Tnl Tnh Command=53H; Length=××××H. Ln is the number of the nth sensor cable and is two bytes long. Tnl, Tnh is the nth detection point value of a cable. The detection points of the same cable are sorted from top to bottom, where Tnl is a low word.
Section, Tnh is the high byte.
Table 10 Data format of extension return grain temperature 2
Start character KADDL (extension address) Command Length DataSegment CRC-16 terminator T0l T0h Tnl Tnh Command=83H; Length=××××H. Tnl, Tnh is the nth temperature detection point value of a bin, where Tnl is low Byte, Tnh is the high byte.
5.1.2.5 Reading the information data of stored grain pests in the warehouse
a) The upper computer will read the stored grain pest information data instructions in the warehouse and send it according to the format of Table 11.
Table 11. The upper computer reads the stored grain pest information data instruction format
Start character KADDL (extension address) Command pest branch number m CRC-16 terminator Command=A4H. Pest branch number = × × × × H.
b) The extension shall return other food information data in the format of Table 12.
Table 12. The information format of the stored grain pest information in the warehouse
Start character KADDL (extension address) Command Length DataSegment CRC-16 terminator Number of insects I0 In Insect branch number m Command=84H;Length=××××H;In indicates that a certain warehouse m number insect brancher has insects falling in at time, its length it is 7 bytes and the format is the same as the first 7 bytes of the DS1307 time. If the number of worms is 0, there is no I0 to In field.
5.1.2.6 Read other food information data
The reading of other food information data shall be in the format specified below.
a) The host computer reads other grain information data instructions should be sent according to the format of Table 13.
Table 13 The upper computer reads other grain information data command format
Start character KADDL (extension address) Command Length CRC-16 terminator the value of Command ranges from A5H to BFH, a grain control message uses a command control, and so on. Length =0000H.
b) The extension shall return other food information data in the format of Table 14.
Table 14 Extension returns other food information data format
Start character KADDL (extension address) Command Length DataSegment CRC-16 terminator X0l X0h Xnl Xnh the value of Command ranges from 85H to 9FH, a grain control message uses a command control, and so on. Length= ××××H. Xnl and Xnh are the nth grain information detection point value of a certain warehouse, where Xnl is the low byte and Xnh is the high byte.
5.1.2.7 Calculation formula for food information data
a) Temperature calculation formula. (Tnh × 256 Tnl)/10, retaining one decimal place;
b) Humidity calculation formula. (Snh × 256 Snl) /10, one decimal place is reserved;
c) Calculation formula for other food information data. (Xnh×256 Xnl)/10, one decimal place is reserved;
d) If there is no data reply at a certain detection point, the open circuit is 7777H and the short circuit is 8888H;
e) The value of the blank point is 9999H.
5.1.2.8 Grain control
a) The upper machine reads the grain control equipment status information data instructions should be sent according to the format of Table 15.
Table 15 The upper computer reads the grain control device status information data command format
Start character KADDL (extension address) Command Length CRC-16 terminator Command=C1H, Length=0000H.
b) The extension shall return the status information data of the grain control equipment in accordance with the format of Table 16.
Table 16 Extension return status control equipment status information data format
Start character KADDL (extension address) Command Length DataSegment CRC-16 terminator EC0 ECn Command=C2H, Length=××××H. ECn is the current state of the nth device.
c) The instructions for setting the status of the grain control equipment on the host computer shall be sent in the format of Table 17.
Table 17 The upper computer sets the grain control device status command format
Start character KADDL (extension address) Command Length DataSegment CRC-16 terminator EC0 ECn Command=C3H, Length=××××H. ECn is the state that the nth device will be set.
5.2 Information exchange between the grain monitoring and control system and other systems
5.2.1 Data exchange interface provided by the grain and oil warehouse management information system
5.2.1.1 Obtaining the interface definition of the library point basic information data method.
a) Service requester. grain situation measurement and control system;
b) Service responder. Grain and Oil Warehouse Management Information System;
c) Method name. Get_DepotInfoData;
d) return type. composite type;
e) parameters should refer to the requirements of Table 18;
Table 18 Obtaining warehouse basic information data method parameter table
Serial number parameter short name data type data format 1 library point code kddm character type a.3
f) The return value should refer to the requirements of Table 19.
Table 19 Get the library point basic information data method return value table
No. Parameter Short Name Data Type Data Format Remarks 1 affiliate company organization code ssqyzzjgdm character type a.9
2 Corporate social credit code ssqytyshxydm character type a.18
3 Company name ssqymc Character type a.50 4 library point code kddm character type a.3 5 library point name kdmc character type a.50
6 Library points referred to as kdjc character type a.20
7 Library point enterprise nature kdqyxz character type a.1
8 Library point category kdlb character type a.20
9 Built-in date jcrq date type YYYYMMDD
10 Library design warehouse kdsjcr numerical type n.8
11 library point area kdmj numerical type n.10, 2
12 Library point phone kddh character type a.50
13 Library point fax kdcz character type a.50
14 Library point address kddz character type a.200
15 Library point zip code kdyzbm character type a.6
16 Library point administrative division name kdxzqhmc character type a.50
17 Library administrative division code kdxzqhdm character type a.6
Meaning and type
LS/T 1802-2016
Medium 6.1.3
5.2.1.2 Interface definition for obtaining warehouse basic information data method.
a) Service requester. grain situation measurement and control system;
b) Service responder. Grain and Oil Warehouse Management Information System;
c) Method name. Get_BarnBaseInfoData;
d) return type. composite type;
e) parameters should refer to the requirements of Table 20;
Table 20 Method table for obtaining warehouse basic information data
No. Parameter Short Name Data Type Data Format Remarks 1 library point code kddm character type a.3
2 Warehouse number cfbh Character type a.3 returns all warehouse information when empty
f) The return value should refer to the requirements of Table 21.
Table 21 Get warehouse basic information data method return value table
No. Parameter Short Name Data Type Data Format Remarks 1 library point sskd character type a.20 2 warehouse number cfbh character type a.3 3 warehouse name cfmc character type a.20 4 warehouse type cflx character type a.7 5 warehouse structure cfjg character type a.20 6 building type jzlx character type a.20
7 Warehouse length (diameter) cfcdzj Numerical type n.5,1 8 warehouse width cfkd numerical type n.5,1 9 warehouse height cfgd numerical type n.5,1 10 warehouse design storage capacity cfsjcr numerical type n.8 11 warehouse actual storage capacity cfsjcr01 numerical type n.8 12 enable date qyrq date type YYYYMMDD 13 warehouse status cfzt character type a.1 14 warehouse use status cfsyzt character type a.1 15 shed zp numerical type a.15, 2 16 simple 囤jyd numerical type a.15, 2 17 simple warehouse jyc numerical type a.15, 2 Meaning and type LS/T 1802-2016 Medium 6.1.4
5.2.1.3 Interface definition for obtaining the basic information data method.
a) Service requester. grain situation measurement and control system;
b) Service responder. Grain and Oil Warehouse Management Information System;
c) Method name. Get_SeparateSpaceBaseInfoData;
d) return type. composite type;
e) parameters should refer to the requirements of Table 22;
Table 22 Obtaining the basic information data method parameter table
No. Parameter Short Name Data Type Data Format Remarks 1 library point code kddm character type a.3
2 When the time is ajbh character type a.3 is empty, return all the information
f) The return value should refer to the requirements of Table 23.
Table 23 Get the basic information data method return value table
No. Parameter Short Name Data Type Data Format Remarks 1 belonging warehouse sscf character type a.20 2 belonging warehouse number sscfbh character type a.3 3 day number ajbh character type a.3 4 day name ajmc character type a.20 5 inter-turn length ajcd numerical type n.5,1 6 inter-turn width ajkd numerical type n.5,1 7 inter-turn height ajgd numerical type n.5,1 8 day design storage ajsjcr numerical type n.8 9 actual storage capacity ajsjcr01 numerical type n.8 10 daytime enable date ajqyrq date type YYYYMMDD 11 day state ajzt character type a.1 12 daytime use state ajsyzt character type a.1 Meaning and type
......
This preview omits tables, figures, formulas and parts of the technical clauses. The complete document — 21 pages — is available in the English PDF.
How to Download LS/T 1812-2017
- 1
Add to cart
Click "Download PDF" on this page and choose "Buy this standard". You can add more standards before checkout.
- 2
Checkout
Enter your email and billing details. Payment is processed securely by Stripe (cards or bank transfer). Prefer bank details? Request a quotation (min. order $300).
- 3
Instant delivery (0–9 sec)
Delivery is automatic: within seconds of payment you'll receive an email with a secure download link. The link stays valid for 72 hours.
- 4
Invoice included
A tax invoice is attached to the confirmation email. Need a custom invoice? Contact us.
Related Standards
LS/T 1205-2025 — Code of practice for grain dryer operation
LS/T 1237-2025 — Technical code of practice for temperature control of stored grain by air conditioner
LS/T 1821-2025 — Technical requirements for information service cloud platform on grain industry
Secure payment via Stripe
Payments accepted
LS/T 1812-2017
$475.00