ICS65.020.99

CCSB07

DB50

重慶市地方標準

DB50/T1719—2025

農(nóng)業(yè)物聯(lián)網(wǎng)平臺數(shù)據(jù)接入規(guī)范

2025-03-24發(fā)布2025-06-24實施

重慶市市場監(jiān)督管理局?發(fā)布

DB50/T1719—2025

前言

本文件按照GB/T1.1—2020《標準化工作導(dǎo)則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。

本文件由重慶市農(nóng)業(yè)信息中心提出。

本文件由重慶市農(nóng)業(yè)農(nóng)村委員會歸口并組織實施。

本文件起草單位：重慶市農(nóng)業(yè)信息中心、重慶市畜牧技術(shù)推廣總站、浙江托普云農(nóng)科技股份有限

公司。

本文件主要起草人：柯楠、凌婧、朱燕、李雪燕、宋琦、劉美伶、吳濤、李林、陳曦、官萬紅、

潘寧、謝朝明。

I

DB50/T1719—2025

農(nóng)業(yè)物聯(lián)網(wǎng)平臺數(shù)據(jù)接入規(guī)范

1范圍

本文件規(guī)定了農(nóng)業(yè)物聯(lián)網(wǎng)平臺數(shù)據(jù)的接入流程與方式、采集指標、數(shù)據(jù)傳輸和數(shù)據(jù)安全等要求。

本文件適用于農(nóng)業(yè)物聯(lián)網(wǎng)平臺的數(shù)據(jù)接入。

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

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

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

文件。

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

GB/T36478.2物聯(lián)網(wǎng)信息交換和共享第2部分：通用技術(shù)要求

GB/T37024信息安全技術(shù)物聯(lián)網(wǎng)感知層網(wǎng)關(guān)安全技術(shù)要求

GB/T37025信息安全技術(shù)物聯(lián)網(wǎng)數(shù)據(jù)傳輸安全技術(shù)要求

GB/T41187農(nóng)業(yè)物聯(lián)網(wǎng)應(yīng)用服務(wù)

3術(shù)語和定義

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

3.1

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

利用智能傳感、無線傳輸、數(shù)據(jù)處理與遠程控制等物聯(lián)網(wǎng)技術(shù)，實現(xiàn)對種植業(yè)和養(yǎng)殖業(yè)的環(huán)境數(shù)據(jù)

進行采集、監(jiān)控和預(yù)警，為生產(chǎn)提供智能化服務(wù)的應(yīng)用平臺。

4縮略語

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

HMACSHA256基于256位安全哈希算法的哈希消息認證碼（Hash-basedMessageAuthentication

CodewithSHA-256）

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

HTTPS安全超文本傳輸協(xié)議（SecureHypertextTransferProtocol）

JsonJavaScript對象簡譜（JavaScriptObjectNotation）

MQTT消息隊列遙測傳輸協(xié)議（MessageQueuingTelemetryTransport）

MQTTS安全消息隊列遙測傳輸協(xié)議（SecureMessageQueuingTelemetryTransport）

5接入流程與方式

5.1流程

1

DB50/T1719—2025

5.1.1數(shù)據(jù)提供方（農(nóng)業(yè)生產(chǎn)經(jīng)營主體、農(nóng)業(yè)管理部門等）應(yīng)經(jīng)過申請，完成傳感設(shè)備的注冊認證。

5.1.2農(nóng)業(yè)物聯(lián)網(wǎng)平臺應(yīng)審核授權(quán)，確認接入方式。

5.1.3數(shù)據(jù)提供方完成接入調(diào)試，開始設(shè)備運行和維護。

5.1.4農(nóng)業(yè)物聯(lián)網(wǎng)平臺接收數(shù)據(jù)，開展數(shù)據(jù)監(jiān)測。

5.2方式

5.2.1農(nóng)業(yè)物聯(lián)網(wǎng)平臺接口應(yīng)符合GB/T35319要求。

5.2.2信息交換和共享應(yīng)符合GB/T36478.2要求。

5.2.3接入方式應(yīng)由農(nóng)業(yè)物聯(lián)網(wǎng)平臺規(guī)定，設(shè)備接入要求見附錄A。

6采集指標

6.1種植業(yè)指標

6.1.1氣象類指標應(yīng)包括但不限于表1的要求。

表1種植業(yè)氣象類指標

指標名稱計量單位范圍精度數(shù)據(jù)類型

空氣溫度℃-40～700.1Float

空氣濕度%RH0～100（無凝露）1Int

光照強度Lux0～200,0001Int

風(fēng)速m/s0～600.1Float

風(fēng)向°0～3601Int

降雨量(小時累計)mm0～1400.1Float

二氧化碳ppm0～2,0000.1Float

大氣壓力hPa300～1,1000.1Float

總輻射W/m20～2,0001Int

6.1.2土壤類指標應(yīng)包括但不限于表2的要求。

表2種植業(yè)土壤類指標

指標名稱計量單位范圍精度數(shù)據(jù)類型

土壤溫度℃-40～700.1Float

土壤含水量%0～1000.1Float

土壤鹽分mS/cm0～230.01Float

土壤pH值-0～140.1Float

土壤水勢kPa-100～00.01Float

6.2水產(chǎn)養(yǎng)殖業(yè)指標

應(yīng)包括但不限于表3的要求。

2

DB50/T1719—2025

表3水產(chǎn)養(yǎng)殖業(yè)指標

指標名稱計量單位范圍精度數(shù)據(jù)類型

水溫℃-40～700.1Float

水位m0～1000.01Float

溶解氧mg/L0～200.01Float

水體pH值-0～140.01Float

氨氮mg/L0～1500.1Float

總磷mg/L0～1000.01Float

總氮mg/L0～1000.01Float

CODmg/L0～2,0000.1Float

懸浮物mg/L0～5000.1Float

6.3畜牧養(yǎng)殖業(yè)指標

應(yīng)包括但不限于表4的要求。

表4畜牧養(yǎng)殖業(yè)指標

指標名稱計量單位范圍精度數(shù)據(jù)類型

空氣溫度℃-40～700.1Float

空氣濕度%RH0～1001Int

光照強度Lux0～200,0001Int

氨氣濃度mg/L0～1000.1Float

硫化氫濃度mg/L0～1000.1Float

一氧化碳濃度mg/L0～1,0000.1Float

二氧化碳濃度mg/L0～2,0000.1Float

6.4采集頻率

不低于1次/h。根據(jù)實際生產(chǎn)場景可自行配置采集頻率。

7數(shù)據(jù)傳輸

7.1數(shù)據(jù)交互格式

數(shù)據(jù)傳輸統(tǒng)一使用Json格式。

7.2通信協(xié)議

設(shè)備接入應(yīng)根據(jù)設(shè)備廠家實際情況自主選擇HTTP/HTTPS或MQTT/MQTTS協(xié)議，見附錄A。

7.3傳輸要求

應(yīng)符合GB/T37025要求。

3

DB50/T1719—2025

7.4設(shè)備鑒權(quán)認證

采用MQTT/MQTTS或HTTP/HTTPS協(xié)議接入數(shù)據(jù)，進行設(shè)備鑒權(quán)認證，見附錄A。

8數(shù)據(jù)安全

8.1農(nóng)業(yè)物聯(lián)網(wǎng)平臺應(yīng)統(tǒng)一存儲與處理采集設(shè)備數(shù)據(jù)。

8.2應(yīng)符合GB/T37024、GB/T41187要求。

4

DB50/T1719—2025

A

A

附錄A

（規(guī)范性）

農(nóng)業(yè)物聯(lián)網(wǎng)平臺設(shè)備接入要求

A.1概述

數(shù)據(jù)提供方應(yīng)提供設(shè)備序列號、設(shè)備類型、采集指標、安裝點位等信息，申請接入審核通過后在農(nóng)

業(yè)物聯(lián)網(wǎng)平臺完成設(shè)備注冊與配置，平臺的登錄名默認為設(shè)備序列號。

數(shù)據(jù)提供方與農(nóng)業(yè)物聯(lián)網(wǎng)平臺使用MQTT/MQTTS或HTTP/HTTPS協(xié)議通信。

使用MQTT/MQTTS協(xié)議完成設(shè)備采集數(shù)據(jù)上行、下行傳輸，設(shè)備端應(yīng)配置MQTT心跳，Keep-Alive

宜設(shè)置為60s，自動重連。

使用HTTP/HTTPS協(xié)議完成設(shè)備與農(nóng)業(yè)物聯(lián)網(wǎng)平臺間的數(shù)據(jù)傳輸。

A.2設(shè)備接入流程

見圖A.1。

圖A.1設(shè)備接入流程

A.3鑒權(quán)認證

使用MQTT/MQTTS協(xié)議時，鑒權(quán)參數(shù)clientId、userName、password見表A.1,認證通過后建立設(shè)

備與平臺間的MQTT連接。

使用HTTP/HTTPS協(xié)議時，首次請求字段clientId、userName、password見表A.1,通過認證后返

回token，后續(xù)數(shù)據(jù)傳輸，在請求頭中攜帶token信息用于鑒權(quán)認證。

5

DB50/T1719—2025

表A.1鑒權(quán)參數(shù)

參數(shù)類型（長度）參數(shù)說明示例

設(shè)備序列號，在申請接入后通過

設(shè)備序列號如：1530001935087445

后，由平臺注冊生成和提供。

設(shè)備身份標識類型固定值為0。0

clientId長度1字節(jié)，“0”代表

(各部分通HMACSHA256不校驗時間戳；

String(256)密碼簽名類型-

過下劃線“1”代表HMACSHA256校驗時

“_”分隔)間戳。

UTC時間2018/7/24

設(shè)備連接平臺的UTC時間，格式

時間戳17:56:20則應(yīng)表示為

為YYYYMMDDHH

2018072417。

userNameString(32)設(shè)備序列號如：1530001935087445

passwordString(256)用“HMACSHA256”算法以時間戳進行加密，生成密鑰HMACSHA256(2018072417)

A.4設(shè)備對接

A.4.1MQTT/MQTTS方式對接

A.4.1.1消息訂閱

設(shè)備通過MQTT/MQTTS與農(nóng)業(yè)物聯(lián)網(wǎng)平臺建立連接后，設(shè)備按需訂閱消息主題，監(jiān)聽農(nóng)業(yè)物聯(lián)網(wǎng)平

臺下行的配置消息。

A.4.1.2消息發(fā)布

設(shè)備狀態(tài)、屬性改變，或者采集數(shù)據(jù)發(fā)布相關(guān)消息到農(nóng)業(yè)物聯(lián)網(wǎng)平臺端，農(nóng)業(yè)物聯(lián)網(wǎng)平臺端對相關(guān)

消息處理、存儲。

A.4.1.3消息主題

消息主題定義見表A.2。

表A.2消息主題定義

消息主題備注

/cq/v1/devices/${deviceId}/up設(shè)備數(shù)據(jù)上行

/cq/v1/devices/${deviceId}/set平臺數(shù)據(jù)下行

注：${deviceId}為設(shè)備序列號。

A.4.2HTTP/HTTPS方式對接

請求路徑定義（HTTP）：/cq/v1/devices/${deviceId}/up/Json。

A.4.3數(shù)據(jù)格式定義

A.4.3.1請求數(shù)據(jù)

6

DB50/T1719—2025

請求數(shù)據(jù)格式為Json，字段（HTTP/MQTT）描述見表A.3。

表A.3請求數(shù)據(jù)格式

名稱字段數(shù)據(jù)類型說明

設(shè)備序列號equiptSerialString平臺提供的設(shè)備序列號

消息類型msgTypeStringconfig：表示設(shè)備配置類消息，status：表示設(shè)備狀態(tài)類消息，

data：表示數(shù)據(jù)采集類消息

消息IDmsgIdInt設(shè)備端自增消息編號

是否需要應(yīng)答needRespInt枚舉1：需要，0：不需要

消息體bodyJson-

A.4.3.2回復(fù)數(shù)據(jù)

回復(fù)數(shù)據(jù)格式見表A.4。

表A.4回復(fù)數(shù)據(jù)格式

協(xié)議類型名稱