ICS 35.240.01 DB5120
CCS L 70
四 川 省 （ 资 阳 市 ） 地 方 标 准
DB5120/T 29.3—2024
感知信息共享应用规范
第 3 部分：物联感知平台接入管理
2024 - 12 - 12 发布
2024 - 12 - 27 实施
资阳市市场监督管理局 发 布
DB5120/T 29.3—2024
目
次
前言........................................................................................................................................................................II
1
范围...................................................................................................................................................................1
2
规范性引用文件.............................................................................................................................................. 1
3
术语和定义...................................................................................................................................................... 1
4
缩略语...............................................................................................................................................................2
5
总体架构.......................................................................................................................................................... 2
6
接入方式概览.................................................................................................................................................. 3
7
设备通信能力要求.......................................................................................................................................... 4
8
设备接入协议.................................................................................................................................................. 6
9
设备物模型...................................................................................................................................................... 6
10
设备鉴权方式................................................................................................................................................ 8
11
应用侧访问与接入方式................................................................................................................................ 9
附录 A（资料性） Topic 对应的业务参数及开发指南.................................................................................. 10
附录 B（资料性） JSON 格式转换示例...........................................................................................................12
附录 C（资料性） 设备属性应用示例.............................................................................................................14
附录 D（资料性） 请求 URI 示例....................................................................................................................22
附录 E（资料性） 鉴权认证示例.....................................................................................................................25
参考文献...............................................................................................................................................................27
I
DB5120/T 29.3—2024
前
言
本文件对资阳市物联网存量、新建时，物联网设备统一接入资阳市物联感知平台提出技术规范，包
括设备接入方式、通信能力、安全要求、数据规范、应用接入要求等内容。
本文件按照GB/T 1.1-2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定起
草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由资阳市政务服务管理局提出并归口。
本文件起草单位:资阳市政府政务服务和公共资源交易服务中心、资阳市大数据服务中心、资阳乾
耀信创科技有限责任公司、成都工贸职业技术学院、四川省职业技能鉴定指导中心。
本文件主要起草人:刘桄序、刘光乾、李天祥、胡颖梅、李沙、戢培全、邵柏华、张亚琴、杨建康、
袁嘉、邓森林、彭国林、任良华、戢昕蕾、曾毅伟、陈杜宇、刘云峰、卓先德、夏荣、张润泽、郑雪梅、
李强、苏熠。
II
DB5120/T 29.3—2024
感知信息共享应用规范 第 3 部分：物联感知平台接入管理
1
范围
本文件规定了物联感知设备接入物联感知平台的管理规范，包含术语和定义、缩略语、整体架构、
接入方式概览、设备通信能力要求、设备接入协议、设备物模型、设备鉴权方式、应用侧访问与接入方
式内容。
本文件适用于资阳市行政区域内政务组织、非政务组织和个人拥有可能接入的物联感知及视频采集
端的要求管理和使用。
2
规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，
仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本
文件。
GB/T 2260
中华人民共和国行政区划代码
GB/T 22239
信息安全技术网络安全等级保护基本要求
GB/T 28181
公共安全视频监控联网系统信息传输、交换、控制技术要求
GB/T 33474
物联网 参考体系结构
GB/T 33745
物联网 术语
GB/T 34678
智慧城市技术参考模型
GB/T 36620
面向智慧城市的物联网技术应用指南
GB/T 36478.4
物联网 信息交换和共享 第 4 部分：数据接口
GB/T 37024
信息安全技术 物联网感知层网关安全技术要求
GB/T 37093
信息安全技术 物联网感知层接入通信网的安全要求
GB/T 38624.1
物联网 网关 第 1 部分：面向感知设备接入的网关技术要求
GB/T 38637
物联网 感知控制设备接入
GB/T 38606
物联网标识体系 数据内容标识符
GB/T 38656
特种设备物联网系统数据交换技术规范
GB/T 40688
物联网 生命体征感知设备数据接口
GB/T 40687
物联网 生命体征感知设备通用规范
GB/T 41780
物联网 边缘计算
GB/T 41782
物联网 系统互操作性
GB/T 42196
公安物联网视频图像元数据分析技术要求
GB/T 42197
公安物联网视频图像内容元数据描述规范
GB/T 42409
物联网 电子价签系统 总体要求
GB/T 42760
智慧城市 感知终端应用指南
GB/Z 41294
物联网应用协议 受限应用协议（CoAP）技术要求
DB5120/T 18-2023
公共信息资源标识指南
DB5120/T 19-2023
数据资源体系技术指南
3
术语和定义
1
DB5120/T 29.3—2024
以上“规范性引用文件”中所引用标准界定以及下列术语和定义适用于本文件。
3.1
物联感知平台 IoT platform
为设备提供安全可靠的连接通信能力，向下连接海量物联网设备，支撑物联网设备数据采集上云和
远程控制；向上提供云端API，供业务应用调用，快速实现高效、低成本、易扩展的物联网支撑平台。
3.2
物联网设备
IoT device
处于物联网感知控制域，具备与外部系统双向通信能力，用于收集物理世界的信息并能够发送或接
受处理外部命令的装置。
4
缩略语
下列缩略语适用于本文件。
HTTP：超文本传输协议（Hyper Text Transfer Protocol）[参考RFC 7540]
HTTPS：安全的超文本传输协议（Hyper Text
Transfer Protocol over Secure Socket Layer）[参
考 RFC 2818]
MQTT：遥测传输协议（Message Queue Telemetry Transport）[参考 ISO/IEC PRF 20922]
MQTTS：使用了TLS加密的MQTT协议(TLS Support for Message Queue Telemetry Transport)
COAP：受限应用协议（Constrained Application Protocol）[参考 RFC 7252]
OPC UA：OPC统一架构协议（Open Platform Communication Unified Architecture）[参考 IEC 62541]
Modbus TCP：Modbus传输控制协议（Modbus Transmission Control Protocol）[参考 GB/T 19582.3-2008]
TSL：物品描述语言（Thing Specification Language）
SDK：软件开发工具包（Software Development Kit）
API：应用程序接口（Application Programming Interface）
NB-IoT：窄带物联网（Narrow Band Internet of Things）[参考 ITU IMT-2020]
LWM2M：轻量级M2M（Lightweight Machine-To-Machine）[参考 ETSI TS 118114]
OTA：空中编程（Over-the-air）
5
总体架构
物联感知平台（以下也称IoT平台、IoTDA（IoT Device Access）），包括以下3种接入平台的方式:
设备直连、网关接入、平台对接。新建物联网设备应按设备直连平台或通过网关接入两种方式接入。
2
DB5120/T 29.3—2024
图1
物联感知平台接入架构
6
接入方式概览
总物联网设备接入平台，可以通过消息，命令，属性的方式和设备进行通信。设备要提供详细的位
置信息，包括但不限于经纬度、街道等，相关信息可以由设备信息上的资产属性和扩展信息承载。物联
网设备接入平台不接入视频感知源设备。
设备命名要符合业务要求，设备名称只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合，
建议不少于 4 个字符。具体命名要符合项目要求，要尽可能体现该设备的基本能力和该设备的一些必要
特征。例如 xx_streetlight_1, 表示 xx 公司提供的编号为 1 的路灯。
根据设备所处网络情况，以及设备使用的接入协议，需要灵活选择设备接入方式。物联网接入平台
有设备直连接入方式与网关接入方式；使用 Mqtt/Coap/http 协议接入的设备，可以采用直连接入方式，
此方式为物联网平台的标准接入方式，使用对应的设备侧标准 sdk，在云端定义好物模型，在设备侧进
行开发适配，以物联网设备接入平台标准的数据格式接收上报数据，即可完成设备接入。网关接入方式，
由于涉及场景较为复杂，与具体接入场景关系紧密，往往需要专门进行适配和开发，为非标准接入方式，
具体实施需项目组单独评估规划。
推荐接入策略如下：
a）设备使用 CoAP/LWM2M 方式接入，建议采用设备直连方式接入物联感知平台。该方式为物联网
接入平台的标准接入方式，使用标准的 IoT Device SDK Tiny 接入即可；
b） 设备使用 Mqtt 协议，建议采用设备直连方式接入物联感知平台，设备也可以采用网关接入方
式。该方式为物联网接入平台的标准接入方式，使用标准的 IoT Device SDK 接入即可。
c）设备使用 opcua, opcda, Modbus, iec 等协议，推荐其使用网关接入方式接入物联感知平台。具体
实施需项目组单独评估规划并申请经费。
d） 设备数据，需要通过查询第三方系统 api，或者查询第三方数据库才可以获取，推荐采用网关
接入方式。具体实施需项目组单独评估规划并申请经费。
e） 设备本身无法直接连接到物联感知平台，建议在设备周围部署一个可以和平台直连的网关，将
设备与网关对接，然后网关统一上报到物联感知平台。此场景，建议采用网关接入方式接入物联感知平
台。具体实施需项目组单独评估规划并申请经费。
f）如设备无法主动上报数据，需要采用特定方式，采集设备相关数据，推荐使用网关接入方式对
3
DB5120/T 29.3—2024
接物联感知平台。具体实施需项目组单独评估规划并申请经费。
g）设备数据使用 plc 上报，推荐使用网关接入方式对接。具体实施需项目组单独评估规划并申请
经费。
h）设备数据是先汇聚到 scada 系统，则推荐采用网关方式对接。具体实施需项目组单独评估规划
并申请经费。
j）设备是采用其他非标准协议，如 jt808(应用于交通领域), hj212（应用于环境领域）, sl651（应用
于水里领域）等，且希望与平台直连，则可以采用泛协议接入方式对接。具体实施需项目组单独评估规
划并申请经费。
平台提供了两种 SDK，它们之间的主要区别如表 1 所示。
表1
两种SDK区别
SDK种类 SDK集成场景 SDK支持的物联网通信协议
IoT Device SDK 面向运算、存储能力较强的嵌入式设备， 例如网关、采集器等。 MQTT
IoT Device SDK Tiny 面向对功耗、存储、计算资源有苛刻限制 的终端设备，例如单片机、模组。 LWM2M over CoAP、MQTT
7
设备通信能力要求
7.1
通则
物联网设备主流接入方式有固网、2G/3G/4G/5G/NB-IoT、WLAN，用户可以根据物联网应用场景从
覆盖面、时延、部署方式、组网形式等方面来选择通信方式对接物联感知平台，并在项目规划阶段选择
合适的设备厂商进行合作。
7.2
固定网络
固定网络接入（如通过 RJ45 有线网口、光模块等），需要用户将物联网设备的网络接入到整个工
厂、园区或交通设施等应用场景中。
固定网络能够带来稳定可靠的网络连接，网络带宽、时延可以根据项目实际情况按需综合设计与实
施，但固定的网口也限制了设备的种类和用途，适用于部署位置可以相对固定的设备，如充电桩、中央
空调、门禁闸机等等。设备网络接口要求如表 2 所示。
表2
网络接口要求
类型 项目 规格 备注
必选 网卡 10/100/1000M全双工网卡 带宽大小可根据承载的数据类型选择
IP类型 IPv4/IPv6 优先IPv6
可选 PoE 支持 简化现场布线
7.3
运营商传统蜂窝网络（2G/3G/4G/5G）
运营商网络接入（2G/3G/4G/5G）要求设备提供商选择合适的运营商，并购买对应的物联网 SIM 卡。
设备则需要有能支持选定网络制式的基带芯片。运营商网络接入依托现有的基站网络，有着广覆盖、快
速接入的特点。
可根据物联网应用场景选择对应网络制式，2G 到 5G 带宽性能、时延性能依次升高，但相应设备
芯片成本也相应提升。
设备网络制式要求如表 3 所示。
表3
网络制式
4
DB5120/T 29.3—2024
项目 规格 备注
网络制式 2G: GSM CDMA 3G: WCDMA CDMA 4G: TD-LTE/LTE FDD 5G: NR 具体制式可根据场地运营商支持情况、带宽 时延要求、功耗成本要求选择
网络制式 LTE CAT NB1 LTE CAT NB1 具体制式可根据场地运营商支持情况、带宽 时延要求、功耗成本要求选择
对于高带宽、低延迟以及高可靠场景，推荐采用5G网络切片构建虚拟专网，结合物联感知平台下
沉的混合云方案，从而提高可靠性以及保障极致性能。
2G网络正在逐步退网，不推荐使用，建议采用4G网络的Cat.1替代。
7.4
运营商窄带网络（NB-IoT）
在物联网领域，NB-IoT比传统蜂窝网络有更强的竞争力和更加旺盛的生命力。工信部《工业和信
息化部办公厅关于深入推进移动物联网全面发展的通知》则明确要求推动2G/3G物联网业务转网，能够
迁移到NB-IoT等技术生态上来。
NB-IoT相较传统蜂窝网络在同频段下，可以获得20dB更多的增益，因而拥有更强的覆盖能力。NB
网络单扇区可以支持10万个连接，时延敏感度低，同时设备成本及功耗低，适合远程抄表、智慧农业、
资产跟踪等业务。
设备通过NB-IoT网络需实时控制设备时，需组建专线网络：
设备通NB-IoT网络连接，推送CoAP下行消息，需要等待NB设备主动连线后才能下发，因此下行消
息根据CoAP心跳时间会有不同的延时。这是由于运营商公共地址池和NB-IoT设备的映射表会老化，平
台无法找到消息下行时刻的设备地址。
在NB-IoT要求消息下行能够实时送到的场景，需委托电信运营商组建专线网络。在平台和NB设备
所在EPC之间搭建专线或建立基于公网的VPN（GRE/IPSec）等，以保证平台消息下行时能够正常地进
行设备寻址。
7.5
无线局域网（WLAN）
无线局域网（WLAN）在物联网行业使用较为广泛的接入方式，主流物联网设备对WLAN的支持非
常充分，可根据用户需求选择部署在专网或者公网，根据物联网应用场景可自定WLAN覆盖范围。但是
WLAN不适合高密覆盖，高密场景下邻同频干扰将导致时延和带宽性能下降，并影响传输可靠性，需要
用户在网规网设阶段合理设置WLAN覆盖容量。
设备WLAN接入规格要求如表4所示。
表4
WLAN接入规格
类型 项目 规格 备注
必选 频段 2.4GHz
信道 1～13 信道使用需符合当地法规
标准 802.11n 以上
带宽 150MHz 以上
可选 PoE 支持 简化现场布线
频段 5GHz 获得更高的带宽，但牺牲覆盖
7.6
通过网关接入网络要求
5
DB5120/T 29.3—2024
在实际应用场景，基于功耗、成本的考虑，如某些温湿度传感器、烟雾报警器等超低功耗、低带宽
要求的设备，不需要也不具备功耗相对较高泛网络接入能力，而采用串口（RS485标准等）、蓝牙、Zigbee
等进场通信协议接入。此场景需要经终端的网关做数据转换对接到物联感知平台。
8
设备接入协议
8.1
MQTT/MQTTS 协议接入
终端设备通过原生MQTT/MQTTS接入物联感知平台，物联感知平台对设备MQTT/MQTTS协议要求如
表5所示。
表5
MQTT/MQTTS协议
描述 限制
支持的 MQTT 协议版本 3.1.1
与标准 MQTT 协议的区别 支持 Qos 0
MQTTS 支持的安全等级 采用 TCP 通道基础 + TLS 协议（TLSV1.2、 TLS1.3）
单个设备最大 MQTT 连接数 1
单个 MQTT 连接每秒的吞吐量，即带宽，包含直连 设备和网关 3 KB/s
MQTT 单个发布消息最大长度，超过此大小的发布请 求将被直接拒绝 1 MB
MQTT 连接心跳时间建议值 心跳时间限定为 30 至 1200 秒，推荐设置为 120 秒
8.2
LwM2M/CoAP 协议接入
目前LWM2M/CoAP协议主要用在NB-IoT场景上，业务数据交互端口是物联感知平台的5684端口，
5684端口走DTLS+CoAP协议通道接入，NB-IoT设备端接入时提供必要的数据凭证，并支持标准DTLS协
议。
设备在登录平台前，需将设备对接平台的端口设置为5684（即走DTLS加密通道）。
将设备出厂前的PSK秘钥预置到物联感知平台中，PSK秘钥的数据类型为String型，长度范围为8-32
位。
8.3
泛协议设备接入
目前平台支持基于MQTT/LWM2M等标准协议接入，为解决用户自定义处理设备数据以及自定义协
议设备快速接入IOT平台的诉求。华为云IoT提供泛协议适配机制，您可使用泛协议对接SDK，快速构建
桥接服务，搭建设备或平台与IoT的双向数据通道。
8.4
使用场景
设备只支持某种类型协议，而平台目前不支持该协议。
设备与其接入服务器之间已有通信网络，您希望在不修改设备和协议的情况下，将设备接入IOT平
台。
由于设备硬件资源或者网络限制，设备无法直接接入IOT平台。
6
DB5120/T 29.3—2024
9
设备物模型
9.1
物模型概述
设备物模型用于描述设备具备的能力和特性。为统一各设备厂家的设备模型，方便应用与设备解耦，
要求设备都使用物模型的方式接入。设备物模型在物联感知平台构建一款设备的抽象模型，使平台理解
该款设备支持的服务、属性、命令等信息，如颜色、开关等。当定义完一款设备物模型后，在进行注册
设备时，就可以使用该模型详见图2所示。
图2
设备物模型
设备物模型包括产品信息和服务能力：
a）产品信息
描述一款设备的基本信息，包括厂商ID、厂商名称、设备类型、协议类型。
例如：水表的厂商名称为“HZYB”，厂商ID为“TestUtf8ManuId”，设备类型为“WaterMeter”，
协议类型为“CoAP”。
b）服务能力
描述设备具备的业务能力。将设备业务能力拆分成若干个服务后，再定义每个服务具备的属性、命
令以及命令的参数。
9.2
物模型接入的方式
9.2.1
基于具体设备定义好物模型后，就可以基于物模型接入物联感知平台。MQTT 协议设备支持平台
标准接口接入、编解码插件接入，而 NB-IoT 设备只支持编解码插件接入。
9.2.2
平台标准接口接入：物联感知平台预置了数据、消息、事件上报，以及命令、消息、事件下发
等典型场景的 MQTT Topic，设备厂商可根据业务特点按需实现集成。
9.2.3
平台标准接口数据格式。
a）设备命令
平台命令下发：用于平台向设备下发设备控制命令。平台下发命令后，需要设备及时将命令的执行
结果返回给平台，设备没回响应，平台会认为命令执行超时。命令下发和消息下发的区别，请查看消息
通信说明。
b)通过编解码插件接入
平台为实现非标接口和数据格式兼容，以及非MQTT的物联网协议兼容，支持设备厂商开发编解码
插件(JavaScript)，设备厂商应在编解码转换层，将特定设备的接口和数据格式转换为平台标准的格式类
型。
7
DB5120/T 29.3—2024
10
设备鉴权方式
a)通过设备密钥方式鉴权。通过物联感知平台注册设备后，获得的DeviceId和Secret将用于设备南向
鉴权。设备侧应支持MQTT协议的connect消息接口，接口规范参考MQTT标准规范，鉴权通过后建立设
备与平台间的MQTT连接，参考的参数表6所示。
表6
密钥方式鉴权
参数 必选/ 可选 类型 参数描述
ClientId 必选 String(256) 设备 clientId 由 3 个部分组成：设备 ID、设备身份标识类型、用 户标识 ID（ScopeID）。通过下划线“_”分隔，设备身份标识类 型固定值为 0。 例：5f052ac562369102d42b0fb6_0_ff5bbx7a488f 其他场景： 设备 clientId 由 4 个部分组成：设备 ID、设备身份标识类型、密 码签名类型、时间戳。通过下划线“_”分隔，设备身份标识类 型固定值为 0 密码签名类型：长度 1 字节，当前支持 2 种类型： “0”代表 HMACSHA256 不校验时间戳。 “1”代表 HMACSHA256 校验时间戳。 时间戳：为设备连接平台时的 UTC 时间，格式为 YYYYMMDDHH，如 UTC 时间 2018/7/24 17:56:20 则应表示为 2018072417。 例：5f052ac562369102d42b0fb6_0_0_2019122614
Username 必选 String(256) 设备 ID。
Password 必选 String(256) Password 的值为使用“HMACSHA256”算法以时间戳为密钥，对 secret 进行加密后的值。 secret 为注册设备时平台返回的 secret。当设备认证类型使用密钥 认证接入(SECRET)可填写该字段。
b)通过X.509设备证书方式鉴权。设备使用证书认证鉴权，除满足ClientId与Username要求外，还需
要设备能够支持X.509证书方式与平台鉴权。
c）LwM2M/CoAP协议鉴权：通过物联感知平台添加的设备，会获得nodeId，DTLS方式接入有PSK，
设备通过LwM2M接入需实现Register功能进行南向接入鉴权，各参数参考如表7所示。
表7
Registe接入规范
参数名 参数位置 可选/必选 说明
Endpoint Client Name Uri-Query 必选 设备身份标识 nodeId
Lifetime Uri-Query 否，默认为 86400 s 生命周期
Version Uri-Query 可选，默认为 1.0 设备版本
Objects and Object Instances Payload 必选 设备支持的对象和实例
11
应用侧访问与接入方式
8
DB5120/T 29.3—2024
11.1
通则
物联感知平台把自身丰富的管理能力通过API的形式对外开放，包括产品管理、设备管理、设备组
管理、标签管理、设备CA证书管理、设备影子、设备命令、设备消息、设备属性、订阅管理、规则管
理、批量任务等，帮助用户快速构筑基于物联感知平台的行业应用。
11.2
API 约束
物联感知平台提供了RESTful风格API，支持用户通过HTTPS请求调用。为保障物联感知平台与其他
信息系统对接的功能完整性与可靠性，应用侧接入系统需要满足以下要求：
a）API的演进会保持前向兼容性，若接口升级了版本，其旧版本接口可以继续使用，但功能不再做
增强，新增功能仅在新版本接口中提供。
b）应用在接收处理物联感知平台发送的响应消息和推送消息时，需要兼容或忽略消息中的新增参
数，不能因为消息中的新增参数导致应用的处理异常。
c）在应用侧调用API的同步接口时，诸如“下发设备命令”，“查询设备属性”，“修改设备属性”
等，需要在设备在线后订阅对应的平台下行Topic，对平台下行指令进行回复响应。否则应用侧同步接
口会执行超时，报Timeout。
d）在应用侧调用API的异步接口时，诸如“查询设备消息”，“下发设备消息”等，允许设备在
线后订阅对应的平台下行Topic，对平台下行指令回复或不回复响应。也支持设备不在线，应用侧异步
接口执行不会超时。
11.3
API 调用方法
构造请求：本节介绍REST API请求的组成，并以调用物联感知平台的查询产品和创建产品接口说
明如何调用API，该API可用于获取用户的指定产品信息。
11.4
认证鉴权
调用接口有如下两种认证方式，用户可以选择其中一种进行认证鉴权。
Token认证：通过Token认证通用请求。
AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。
9
DB5120/T 29.3—2024
附 录 A
（资料性）
Topic 对应的业务参数及开发指南
A.1 Topic对应的业务参数及开发指南应符合表A.1规则
举例：资阳市雁江区住建局互联网扬尘检测点位：中心编码（资阳市雁江区641300、基层接入单位
暂定00）、行业编码（环境接入11）、类型编码（扬尘检测感知终端600）、网络标识（Internet网7）、
基层分类（00）、序号（第一台0001），因此编码应为64130000116007000001。
表A.1
Topic对应的业务参数
主题（Topic） 分类 主题 Topic 生产者 Publisher 订阅者 Subscriber 用途
设备消息相关 Topic $oc/devices/{device_id}/sys/messag es/up 设备 平台 设备消息上报
$oc/devices/{device_id}/sys/messag es/down 平台 设备 平台下发消息给设 备
设备命令相关 Topic $oc/devices/{device_id}/sys/comma nds/request_id={request_id} 平台 设备 平台下发命令给设 备
$oc/devices/{device_id}/sys/comma nds/response/request_id={request_i d} 设备 平台 设备返回命令响应
设备属性相关 Topic $oc/devices/{device_id}/sys/properti es/report 设备 平台 设备上报属性数据
$oc/devices/{device_id}/sys/gateway /sub_devices/properties/report 设备 平台 网关批量上报属性 数据
$oc/devices/{device_id}/sys/properti es/set/request_id={request_id} 平台 设备 平台设置设备属性
$oc/devices/{device_id}/sys/properti es/set/response/request_id={request _id} 设备 平台 属性设置的响应结 果
$oc/devices/{device_id}/sys/properti es/get/request_id={request_id} 平台 设备 平台查询设备属性
$oc/devices/{device_id}/sys/properti es/get/response/request_id={request _id} 设备 平台 属性查询响应结 果，这个结果不会 对设备属性和影子 产生影响
$oc/devices/{device_id}/sys/shadow/ get/request_id={request_id} 设备 平台 设备侧主动获取平 台的设备影子数据
10
DB5120/T 29.3—2024
（续）表A.1
Topic对应的业务参数
主题（Topic） 分类 主题 Topic 生产者 Publisher 订阅者 Subscriber 用途
设备属性相关 Topic $oc/devices/{device_id}/sys/shadow/ get/response/request_id={request_i d} 平台 设备 设备侧主动获取平 台设备影子数据的 响应
设备事件相关 Topic $oc/devices/{device_id}/sys/events/ up 设备 平台 设备事件上报
$oc/devices/{device_id}/sys/events/ down 平台 设备 平台事件下发
11
DB5120/T 29.3—2024
附 录 B
（资料性）
JSON 格式转换示例
B.1 示例
低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联感知平台通信
时，可将原始二进制数据透传到物联感知平台。通过开发编解码插件实现二进制数据到平台定义JSON
格式的转换。
Topic
下行： $oc/devices/{device_id}/sys/commands/request_id={request_id}
上行：
$oc/devices/{device_id}/sys/commands/response/request_id={request_id}
{request_id}用于唯一标识这次请求。设备侧收到下行请求的topic带该参数时，上行响应的topic需要
将该参数值返回给平台。
设备侧订阅带{request_id}结尾的topic时，可以使用通配#，设备侧订阅平台命令下发的topic为：
$oc/devices/{device_id}/sys/commands/#
下行请求参数说明
字段名 必选/可选 类型 参数描述
object_device_id 可选 String 命令对应的目标设备 ID，命令下发对应的最终目标设备， 没有携带则表示目标设备即 topic 中指定的设备。
service_id 可选 String 设备的服务 ID，在设备关联的产品模型中定义
command_name 可选 String 设备命令名称，在设备关联的产品模型中定义。
paras 可选 Object 设备命令的执行参数，具体字段在设备关联的产品模型 中定义。
上行响应参数说明
命令应答的json格式，具体字段在设备关联的产品模型中定义。
字段名 必选/可选 类型 参数描述
result_code 可选 Integer 标识命令的执行结果，0 表示成功，其他表示失败。不带默 认认为成功。
response_name 可选 String 命令的响应名称，在设备关联的产品模型中定义。
paras 可选 Object 命令的响应参数，具体字段在设备关联的产品模型中定义。
下行请求示例
Topic: $oc/devices/{device_id}/sys/commands/request_id={request_id}
数据格式：
{
"object_device_id": "{object_device_id}",
"command_name": "ON_OFF",
"service_id": "WaterMeter",
"paras": {
"value": "1"
12
DB5120/T 29.3—2024
}
}
上行响应示例
Topic：$oc/devices/{device_id}/sys/commands/response/request_id={request_id}
数据格式：
{
"result_code": 0,
"response_name": "COMMAND_RESPONSE",
"paras": {
"result": "success"
}
}
13
DB5120/T 29.3—2024
附 录 C
（资料性）
设备属性应用示例
C.1 示例
a）设备属性上报：用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上
报的区别，请查看消息通信说明。