農(nóng)業(yè)物聯(lián)網(wǎng)平臺數(shù)據(jù)交換技術(shù)指南

ICS65.20.01

CCSB07

23

黑龍江省地方標(biāo)準(zhǔn)

DB23/TXXXX—2023

農(nóng)業(yè)物聯(lián)網(wǎng)平臺數(shù)據(jù)交換技術(shù)指南

（征求意見稿）

2023-XX-XX發(fā)布2023-XX-XX實施

黑龍江省市場監(jiān)督管理局發(fā)布

DB23/TXXXX—2023

農(nóng)業(yè)物聯(lián)網(wǎng)平臺數(shù)據(jù)交換技術(shù)指南

1范圍

本文件規(guī)定了種植業(yè)農(nóng)業(yè)物聯(lián)網(wǎng)平臺與共享云平臺、種植業(yè)農(nóng)業(yè)物聯(lián)網(wǎng)平臺與采集設(shè)備之間的數(shù)據(jù)

交換要求。

本文件適用于黑龍江省種植業(yè)農(nóng)業(yè)物聯(lián)網(wǎng)數(shù)據(jù)交換平臺的數(shù)據(jù)交換。

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

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T17859—1999計算機(jī)信息系統(tǒng)安全保護(hù)等級劃分準(zhǔn)則

GB/T25058—2019信息安全技術(shù)信息系統(tǒng)安全等級保護(hù)實施指南

GB/T28827.1—2012信息技術(shù)服務(wù)運行維護(hù)通用要求

GB/T35319—2017物聯(lián)網(wǎng)系統(tǒng)接口要求

GB/T37973—2019信息安全技術(shù)大數(shù)據(jù)安全管理指南

DB23/T3280—2022農(nóng)業(yè)物聯(lián)網(wǎng)平臺基礎(chǔ)數(shù)據(jù)采集規(guī)范

3術(shù)語和定義

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

農(nóng)業(yè)物聯(lián)網(wǎng)平臺

通過農(nóng)田各類傳感器及監(jiān)測設(shè)備感知環(huán)境數(shù)據(jù)，并將數(shù)據(jù)傳輸?shù)娇蛇M(jìn)行數(shù)據(jù)存儲和交換的軟件平臺。

報文

網(wǎng)絡(luò)中交換與傳輸?shù)臄?shù)據(jù)單元，站點一次性要發(fā)送的數(shù)據(jù)塊。

數(shù)據(jù)交換

在多個數(shù)據(jù)終端設(shè)備之間，為任意兩個終端設(shè)備建立數(shù)據(jù)通信臨時互連通路的過程。

4縮略語

下列縮略語適用于本文件。

HTTP文件傳輸協(xié)議（HyperTextTransferProtocol）

JSON文件傳輸格式（JavaScriptObjectNotation）

CRC循環(huán)冗余校驗（CyclicalRedundancyCheck）

5數(shù)據(jù)交換原則

1

DB23/TXXXX—2023

農(nóng)業(yè)物聯(lián)網(wǎng)平臺數(shù)據(jù)交換工作應(yīng)符合數(shù)據(jù)傳輸?shù)囊话阋蠛蛿?shù)據(jù)交換中數(shù)據(jù)規(guī)范、傳輸安全、效率

合理、便于迭代的基本原則。

6數(shù)據(jù)交換方式

采集設(shè)備采集數(shù)據(jù)通過報文上報到平臺中，平臺與平臺之間數(shù)據(jù)交換通過HTTP協(xié)議進(jìn)行數(shù)據(jù)交換。

7數(shù)據(jù)交換流程

數(shù)據(jù)發(fā)送方和數(shù)據(jù)接收方要制定規(guī)約，保障數(shù)據(jù)的有效傳輸。

數(shù)據(jù)交換依據(jù)不同設(shè)備及定義的協(xié)議進(jìn)行數(shù)據(jù)傳輸，并識別數(shù)據(jù)包采用的感知層協(xié)議，判斷

感知層協(xié)議是否屬于預(yù)設(shè)協(xié)議類型。

判斷源數(shù)據(jù)地址到目的地址的交換路徑接收前端設(shè)備發(fā)送的數(shù)據(jù)包，并按照預(yù)設(shè)路徑，掃描

業(yè)務(wù)數(shù)據(jù)的風(fēng)險系數(shù)，將業(yè)務(wù)數(shù)據(jù)、源地址和目的地址采用報文和HTTP協(xié)議，將數(shù)據(jù)包上傳到共享云

平臺。實現(xiàn)共享云平臺與應(yīng)用平臺的數(shù)據(jù)交換。數(shù)據(jù)傳輸雙方按照設(shè)備類型制定規(guī)約，約定數(shù)據(jù)傳輸?shù)?/p>

協(xié)議和數(shù)據(jù)格式，采用報文和HTTP協(xié)議進(jìn)行數(shù)據(jù)傳輸。

數(shù)據(jù)接收方和數(shù)據(jù)發(fā)送方同層的協(xié)議需要保持一致。

農(nóng)業(yè)物聯(lián)網(wǎng)平臺數(shù)據(jù)交換采用采集點與平臺之間數(shù)據(jù)交換（報文）、平臺與平臺數(shù)據(jù)交換（HTTP

協(xié)議JSON數(shù)據(jù)格式）進(jìn)行數(shù)據(jù)傳輸。數(shù)據(jù)傳輸過程中，數(shù)據(jù)發(fā)送方根據(jù)數(shù)據(jù)接收方提出的傳輸請求，

按照預(yù)設(shè)協(xié)議和數(shù)據(jù)格式進(jìn)行數(shù)據(jù)傳輸，數(shù)據(jù)傳輸方式見圖1。

圖1數(shù)據(jù)傳輸方式

注：1、物聯(lián)網(wǎng)設(shè)備信息在應(yīng)用平臺登記后，應(yīng)用平臺才能成功獲取設(shè)備采集數(shù)據(jù)。

2、物聯(lián)網(wǎng)設(shè)備直接將采集的數(shù)據(jù)推送到應(yīng)用平臺。

3、應(yīng)用平臺發(fā)起請求，通過請求設(shè)備信息等內(nèi)容，獲得設(shè)備數(shù)據(jù)。

8數(shù)據(jù)交換格式

采集點與平臺之間數(shù)據(jù)交換

8.1.1數(shù)據(jù)封裝與解封

2

DB23/TXXXX—2023

數(shù)據(jù)在交換過程中以報文的形式進(jìn)行傳輸，數(shù)據(jù)向下進(jìn)行逐層封裝，每一層對數(shù)據(jù)進(jìn)行加工處理，

并且添加報頭的信息。接收到的設(shè)備將刪除添加的信息，根據(jù)報頭中的信息沿著協(xié)議棧向上傳輸。

8.1.2報文信封解析

報文信封解析方式

.1按照報文格式設(shè)定報文信封，平臺接收到報文后，進(jìn)行報文信封的解析。信封解析后，方

能讀取內(nèi)部報文內(nèi)容。

.2從左到右依次進(jìn)行信息解析。地址為：0731260003，定時等間隔上報定時報（間隔為5分

鐘），功能碼0x32，中心接收軟件收到報文后給出回應(yīng)報文。

正常數(shù)據(jù)解析（DATA）

根據(jù)協(xié)議28報文有三個字節(jié)：byte3-00，byte2-01，byte1-01，根據(jù)協(xié)議解析版本。

多數(shù)據(jù)包解析

每行報文為8個字節(jié)。超過8個字節(jié)的，宜形成多包。

8.1.3報文上報

報文上報應(yīng)按照預(yù)設(shè)的格式上報。

報文信封經(jīng)過解析后，將需要上傳的報文格式及內(nèi)容打包，打包后進(jìn)行數(shù)據(jù)上傳。

8.1.4報文校驗

采用CRC循環(huán)冗余校驗。生成二進(jìn)制數(shù)據(jù)，依次按照字節(jié)為單位，取出數(shù)據(jù)進(jìn)行累加，從信封內(nèi)容

起開始校驗，數(shù)據(jù)準(zhǔn)確無誤，則生成四位數(shù)的校驗碼。

8.1.5報文回應(yīng)

在接收到經(jīng)過驗證的報文信息后，進(jìn)行數(shù)據(jù)解析，按照報文的數(shù)據(jù)請求要求，應(yīng)用平臺進(jìn)行定時回

應(yīng)。

報文格式

8.2.1報文格式形式

報文格式采用定時報文和心跳報文兩種形式，可根據(jù)實際需要選擇一種。定時發(fā)送報文的條件下，

宜選擇定時報文；監(jiān)視機(jī)器網(wǎng)絡(luò)存儲器的運行狀態(tài)時，宜采用心跳報文。

8.2.2報文信息格式

定時報報文上報格式

定時報報文上報格式見表1。

表1定時報報文上報格式

報文起始符報文結(jié)束符

幀起始符地址功能碼流水號發(fā)報時間數(shù)據(jù)校驗碼

（ASCII碼STX）（ASCII碼ETX）

0x7E0x7E0x070x310x260x32000223041310550120x0——0x03——

3

DB23/TXXXX—2023

示例：定時報報文上報內(nèi)容。

幀起始符7E7E

地址0731260003

功能碼32

流水號0002

發(fā)報時間230413105501

報文起始符（ASCII碼STX）02

土壤溫度0123

報文結(jié)束符（ASCII碼ETX）03

校驗碼BD45

根據(jù)示例打包生成報文如下：

7E7E073126000332000223041310550102012303BD45

心跳報報文上報格式

心跳報報文上報格式見表2。

表2心跳報報文上報格式

示例：報文

報文結(jié)束符

幀起始符地址功能碼流水號發(fā)報時間起始符（ASCII數(shù)據(jù)校驗碼

（ASCII碼ETX）

碼STX）

0x7E0x7E0x070x310x260x2F000423041310555720x0——0x03——

示例：心跳報報文上報內(nèi)容。

幀起始符7E7E

地址0731260003

功能碼2F

流水號0004

發(fā)報時間230413105557

報文起始符（ASCII碼STX）02

報文結(jié)束符（ASCII碼ETX）03

校驗碼546C

根據(jù)示例打包生成報文如下：

7E7E07312600032F00042304131055570203546C

定時報報文回應(yīng)格式

定時報報文回應(yīng)格式見表3。

表3定時報報文回應(yīng)格式

報文起始符報文結(jié)束符

幀起始符地址功能碼流水號發(fā)報時間數(shù)據(jù)校驗碼

（ASCII碼STX）（ASCII碼ETX）

0x7E0x7E0x070x310x260x32000323041310550120x0——0x1B——

4

DB23/TXXXX—2023

示例：定時報報文回應(yīng)內(nèi)容。

幀起始符7E7E

地址0731260003

功能碼32

流水號0003

發(fā)報時間230413105501

報文起始符（ASCII碼STX）02

報文結(jié)束符（ASCII碼ETX）1B

校驗碼FD2A

根據(jù)示例打包生成報文如下：

7E7E0731260003320003230413105501021BFD2A

心跳報報文回應(yīng)格式

心跳報報文回應(yīng)格式見表4。

表4心跳報報文回應(yīng)格式

報文起始符報文結(jié)束符

幀起始符地址功能碼流水號發(fā)報時間數(shù)據(jù)校驗碼

（ASCII碼STX）（ASCII碼ETX）

0x7E0x7E0x070x310x260x2F000523041310555720x0——0x03——

示例：心跳報報文回應(yīng)內(nèi)容。

幀起始符7E7E

地址0731260003

功能碼2F

流水號0005

發(fā)報時間230413105557

報文起始符（ASCII碼STX）02

報文結(jié)束符（ASCII碼ETX）03

校驗碼59FC

根據(jù)示例打包生成報文如下：

7E7E07312600032F0005230413105557020359FC

8.2.3報文信息

定時報文

.1回送請求報文

回送請求報文將信息發(fā)送到目標(biāo)平臺，平臺收到該報文后，立即發(fā)回一條回送通告報文。回送請求

報文的類型字段值為128,代碼字段值為0。

.2回送應(yīng)答報文

5

DB23/TXXXX—2023

當(dāng)接收方接收到一個回送請求報文時，ICMPv6會用回送應(yīng)答報文進(jìn)行響應(yīng)。回送應(yīng)答報文的類型字

段值為129，代碼字段值為0。標(biāo)識符和序列號值與回送請求報文中相應(yīng)的字段值完全一致。回送應(yīng)答

報文結(jié)構(gòu)與回送請求報文結(jié)構(gòu)一致。

平臺與平臺之間數(shù)據(jù)交換

平臺與平臺之間數(shù)據(jù)交換通過HTTP協(xié)議實現(xiàn)。

8.3.1請求格式

HHTP請求由請求行、請求頭部、請求數(shù)據(jù)三部分組成。請求行包括請求方法、URL、協(xié)議版本；請

求頭部包括頭部字段名、值；請求數(shù)據(jù)為請求信息內(nèi)容。HTTP請求格式見圖2。

注：SP代表空格，CR代表回車，LF代表換行

圖2HTTP請求格式

8.3.2響應(yīng)格式

HTTP響應(yīng)報文由狀態(tài)行、響應(yīng)頭部、響應(yīng)正文三部分組成。狀態(tài)行包括：協(xié)議版本、狀態(tài)行、狀態(tài)

碼描述；響應(yīng)頭部包括：頭部字段名、值；響應(yīng)正文為響應(yīng)信息內(nèi)容。HTTP響應(yīng)格式見圖3

注：SP代表空格，CR代表回車，LF代表換行

圖3HTTP響應(yīng)格式

設(shè)備信息

通過設(shè)備編碼獲取單個設(shè)備信息的數(shù)據(jù)格式見表5。

6

DB23/TXXXX—2023

表5通過設(shè)備編碼獲取單個設(shè)備信息的數(shù)據(jù)格式

接口描述

URL/device/info

請求方式POST

請求類型application/json

返回類型*/*

參數(shù)名數(shù)據(jù)類型參數(shù)類型是否必填說明

dviceCodestringN設(shè)備編號

狀態(tài)碼描述說明

200OK

返回屬性名類型說明

successbool

codeint

data

name

type

lat

lng

address

xzqh

baseCode

傳感器數(shù)據(jù)

獲取傳感器類型列表數(shù)據(jù)格式見表6、獲取指定設(shè)備某日的傳感器采集數(shù)據(jù)格式見表7。

表6獲取傳感器類型列表數(shù)據(jù)格式

接口描述

URL/device/data/page

請求方式POST

請求類型application/json

返回類型*/*

參數(shù)名數(shù)據(jù)類型參數(shù)類型是否必填說明

dviceCodestringY

PageIndxintN不填寫返回第一頁報文數(shù)據(jù)

狀態(tài)碼描述說明

200OK

返回屬性名類型說明

successbool

codeint

listarray報文集合