DB50∕T 1719-2025 农业物联网平台数据接入技术规范

ICS65.020.99

CCSB07

DB50

重庆市地方标准

DB50/T1719—2025

农业物联网平台数据接入规范

2025-03-24发布2025-06-24实施

重庆市市场监督管理局 发布

DB50/T1719—2025

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由重庆市农业信息中心提出。

本文件由重庆市农业农村委员会归口并组织实施。

本文件起草单位：重庆市农业信息中心、重庆市畜牧技术推广总站、浙江托普云农科技股份有限

公司。

本文件主要起草人：柯楠、凌婧、朱燕、李雪燕、宋琦、刘美伶、吴涛、李林、陈曦、官万红、

潘宁、谢朝明。

I

DB50/T1719—2025

农业物联网平台数据接入规范

1范围

本文件规定了农业物联网平台数据的接入流程与方式、采集指标、数据传输和数据安全等要求。

本文件适用于农业物联网平台的数据接入。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T35319物联网系统接口要求

GB/T36478.2物联网信息交换和共享第2部分：通用技术要求

GB/T37024信息安全技术物联网感知层网关安全技术要求

GB/T37025信息安全技术物联网数据传输安全技术要求

GB/T41187农业物联网应用服务

3术语和定义

下列术语和定义适用于本文件。

3.1

农业物联网平台agriculturalinternetofthingsplatform

利用智能传感、无线传输、数据处理与远程控制等物联网技术，实现对种植业和养殖业的环境数据

进行采集、监控和预警，为生产提供智能化服务的应用平台。

4缩略语

下列缩略语适用于本文件。

HMACSHA256基于256位安全哈希算法的哈希消息认证码（Hash-basedMessageAuthentication

CodewithSHA-256）

HTTP超文本传输协议（HyperTextTransferProtocol）

HTTPS安全超文本传输协议（SecureHypertextTransferProtocol）

JsonJavaScript对象简谱（JavaScriptObjectNotation）

MQTT消息队列遥测传输协议（MessageQueuingTelemetryTransport）

MQTTS安全消息队列遥测传输协议（SecureMessageQueuingTelemetryTransport）

5接入流程与方式

5.1流程

1

DB50/T1719—2025

5.1.1数据提供方（农业生产经营主体、农业管理部门等）应经过申请，完成传感设备的注册认证。

5.1.2农业物联网平台应审核授权，确认接入方式。

5.1.3数据提供方完成接入调试，开始设备运行和维护。

5.1.4农业物联网平台接收数据，开展数据监测。

5.2方式

5.2.1农业物联网平台接口应符合GB/T35319要求。

5.2.2信息交换和共享应符合GB/T36478.2要求。

5.2.3接入方式应由农业物联网平台规定，设备接入要求见附录A。

6采集指标

6.1种植业指标

6.1.1气象类指标应包括但不限于表1的要求。

表1种植业气象类指标

指标名称计量单位范围精度数据类型

空气温度℃-40～700.1Float

空气湿度%RH0～100（无凝露）1Int

光照强度Lux0～200,0001Int

风速m/s0～600.1Float

风向°0～3601Int

降雨量(小时累计)mm0～1400.1Float

二氧化碳ppm0～2,0000.1Float

大气压力hPa300～1,1000.1Float

总辐射W/m20～2,0001Int

6.1.2土壤类指标应包括但不限于表2的要求。

表2种植业土壤类指标

指标名称计量单位范围精度数据类型

土壤温度℃-40～700.1Float

土壤含水量%0～1000.1Float

土壤盐分mS/cm0～230.01Float

土壤pH值-0～140.1Float

土壤水势kPa-100～00.01Float

6.2水产养殖业指标

应包括但不限于表3的要求。

2

DB50/T1719—2025

表3水产养殖业指标

指标名称计量单位范围精度数据类型

水温℃-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畜牧养殖业指标

应包括但不限于表4的要求。

表4畜牧养殖业指标

指标名称计量单位范围精度数据类型

空气温度℃-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。根据实际生产场景可自行配置采集频率。

7数据传输

7.1数据交互格式

数据传输统一使用Json格式。

7.2通信协议

设备接入应根据设备厂家实际情况自主选择HTTP/HTTPS或MQTT/MQTTS协议，见附录A。

7.3传输要求

应符合GB/T37025要求。

3

DB50/T1719—2025

7.4设备鉴权认证

采用MQTT/MQTTS或HTTP/HTTPS协议接入数据，进行设备鉴权认证，见附录A。

8数据安全

8.1农业物联网平台应统一存储与处理采集设备数据。

8.2应符合GB/T37024、GB/T41187要求。

4

DB50/T1719—2025

A

A

附录A

（规范性）

农业物联网平台设备接入要求

A.1概述

数据提供方应提供设备序列号、设备类型、采集指标、安装点位等信息，申请接入审核通过后在农

业物联网平台完成设备注册与配置，平台的登录名默认为设备序列号。

数据提供方与农业物联网平台使用MQTT/MQTTS或HTTP/HTTPS协议通信。

使用MQTT/MQTTS协议完成设备采集数据上行、下行传输，设备端应配置MQTT心跳，Keep-Alive

宜设置为60s，自动重连。

使用HTTP/HTTPS协议完成设备与农业物联网平台间的数据传输。

A.2设备接入流程

见图A.1。

图A.1设备接入流程

A.3鉴权认证

使用MQTT/MQTTS协议时，鉴权参数clientId、userName、password见表A.1,认证通过后建立设

备与平台间的MQTT连接。

使用HTTP/HTTPS协议时，首次请求字段clientId、userName、password见表A.1,通过认证后返

回token，后续数据传输，在请求头中携带token信息用于鉴权认证。

5

DB50/T1719—2025

表A.1鉴权参数

参数类型（长度）参数说明示例

设备序列号，在申请接入后通过

设备序列号如：1530001935087445

后，由平台注册生成和提供。

设备身份标识类型固定值为0。0

clientId长度1字节，“0”代表

(各部分通HMACSHA256不校验时间戳；

String(256)密码签名类型-

过下划线“1”代表HMACSHA256校验时

“_”分隔)间戳。

UTC时间2018/7/24

设备连接平台的UTC时间，格式

时间戳17:56:20则应表示为

为YYYYMMDDHH

2018072417。

userNameString(32)设备序列号如：1530001935087445

passwordString(256)用“HMACSHA256”算法以时间戳进行加密，生成密钥HMACSHA256(2018072417)

A.4设备对接

A.4.1MQTT/MQTTS方式对接

A.4.1.1消息订阅

设备通过MQTT/MQTTS与农业物联网平台建立连接后，设备按需订阅消息主题，监听农业物联网平

台下行的配置消息。

A.4.1.2消息发布

设备状态、属性改变，或者采集数据发布相关消息到农业物联网平台端，农业物联网平台端对相关

消息处理、存储。

A.4.1.3消息主题

消息主题定义见表A.2。

表A.2消息主题定义

消息主题备注

/cq/v1/devices/${deviceId}/up设备数据上行

/cq/v1/devices/${deviceId}/set平台数据下行

注：${deviceId}为设备序列号。

A.4.2HTTP/HTTPS方式对接

请求路径定义（HTTP）：/cq/v1/devices/${deviceId}/up/Json。

A.4.3数据格式定义

A.4.3.1请求数据

6

DB50/T1719—2025

请求数据格式为Json，字段（HTTP/MQTT）描述见表A.3。

表A.3请求数据格式

名称字段数据类型说明

设备序列号equiptSerialString平台提供的设备序列号

消息类型msgTypeStringconfig：表示设备配置类消息，status：表示设备状态类消息，

data：表示数据采集类消息

消息IDmsgIdInt设备端自增消息编号

是否需要应答needRespInt枚举1：需要，0：不需要

消息体bodyJson-

A.4.3.2回复数据

回复数据格式见表A.4。

表A.4回复数据格式

协议类型名称