農業物聯網平臺數據接入規范2025-03-24發布2025-06-24實施I本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規則》的規定請注意本文件的某些內容可能涉及專利。本文件的發布機構不承擔識別專利的責任。本文件由重慶市農業信息中心提出。本文件由重慶市農業農村委員會歸口并組織實施。本文件起草單位：重慶市農業信息中心、重慶市畜牧技術推廣總站、浙江托普云農科技股份有限本文件主要起草人：柯楠、凌婧、朱燕、李雪燕、宋琦、劉美伶、吳濤、李林、陳曦、官萬紅、潘寧、謝朝明。11范圍本文件規定了農業物聯網平臺數據的接入流程與方式、采集指標、數據傳輸和數據安全等要求。本文件適用于農業物聯網平臺的數據接入。2規范性引用文件下列文件中的內容通過文中的規范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本GB/T35319物聯網系統接口要求GB/T36478.2物聯網信息交換和共享第2部分：通用技術要求GB/T37024信息安全技術物聯網感知層網關安全技術要求GB/T37025信息安全技術物聯網數據傳輸安全技術要求GB/T41187農業物聯網應用服務3術語和定義下列術語和定義適用于本文件。利用智能傳感、無線傳輸、數據處理與遠程控制等物聯網技術，實現對種植業和養殖業的環境數據進行采集、監控和預警，為生產提供智能化服務的應用平臺。下列縮略語適用于本文件。HMACSHA256基于256位安全哈希算法的哈希消息認證碼(Hash-basedMessageAuthenticationHTTP超文本傳輸協議(HyperTextTransferProtocol)HTTPS安全超文本傳輸協議(SecureHypertextTransferProtocol)JsonJavaScript對象簡譜(JavaScriptObjectNotation)MQTT消息隊列遙測傳輸協議(MessageQueuingTelemetryTransport)MQTTS安全消息隊列遙測傳輸協議(SecureMessageQueuingTelemetryTransport)5接入流程與方式25.1.1數據提供方(農業生產經營主體、農業管理部門等)應經過申請，完成傳感設備的注冊認證。5.2.2信息交換和共享應符合GB/T36478.2要求。5.2.3接入方式應由農業物聯網平臺規定，設備接入要求見附錄A。6.1.1氣象類指標應包括但不限于表1的要求。表1種植業氣象類指標范圍數據類型空氣溫度℃空氣濕度0～100(無凝露)1光照強度1風向1降雨量(小時累計)大氣壓力16.1.2土壤類指標應包括但不限于表2的要求。范圍數據類型℃%一土壤水勢3表3水產養殖業指標范圍數據類型℃m一總磷總氮范圍數據類型空氣溫度℃空氣濕度1光照強度1一氧化碳濃度二氧化碳濃度不低于1次/h。根據實際生產場景可自行配置采集頻率。4采用MQTT/MQTTS或HTTP/HTTPS協議接入數據，進行設備鑒5(規范性)宜設置為60s,自動重連。password使用MQTT/MQTTS協議時，鑒權參數clientId、userName、password見表A.1,認證通過后建立設備與平臺間的MQTT連接。6表A.1鑒權參數類型(長度)參數說明示例(各部分通過下劃線“_”分隔)設備序列號如：1530001935087445設備身份標識類型固定值為0。0HMACSHA256不校驗時間戳；"1"代表HMACSHA256校驗時時間戳17:56:20則應表示為設備序列號如：1530001935087445用“HMACSHA256”算法以時間戳進行加密，生成密鑰A.4設備對接A.4.1.1消息訂閱設備通過MQTT/MQTTS與農業物聯網平臺建立連接后，設備按需訂閱消息主題，監聽農業物聯網平臺下行的配置消息。A.4.1.2消息發布設備狀態、屬性改變，或者采集數據發布相關消息到農業物聯網平臺端，農業物聯網平臺端對相關消息處理、存儲。A.4.1.3消息主題消息主題定義見表A.2。表A.2消息主題定義/cq/v1/devices/${devi/cq/v1/devices/${devic注：${deviceId}為設備序列號。A.4.2HTTP/HTTPS方式對接請求路徑定義(HTTP):/cq/vl/devices/${deviceId}/up/Json。A.4.3數據格式定義A.4.3.1請求數據7請求數據格式為Json,字段(HTTP/MQTT)描述見表A.3。請求數據格式數據類型說明設備序列號消息類型config:表示設備配置類消息