Skip to content

MQTT 主题概览

JieIOT MQTT 标准协议提供了很多开箱即用的内置访问协议规范,涵盖了绝大多数开发者需要用到的业务场景,例如设备模型、上报下发、拓扑关系、OTA 升级、定时、远程配置下发、文件传输、NTP 等。更多的功能陆续扩展中。

通过这些标准功能,可以大大地降低开发难度,从而帮助您快速地开发物联网项目,缩短项目上线周期,进而提升快速拓展市场的效率。

以下是能力及主题概览介绍,分为发布主题和订阅主题。

发布主题

设备主动发起的业务

下面的主题主要用于设备向云平台发布消息或发起业务请求。

功能消息类型Topic 主题
属性上报设备上报属性things/up/${tenantId}/${productKey}/${deviceKey}/property/post
事件上报设备上报事件things/up/${tenantId}/${productKey}/${deviceKey}/event/post
批量上报设备批量上报things/up/${tenantId}/${productKey}/${deviceKey}/batch/post
固件 OTA设备上报固件版本信息things/up/${tenantId}/${productKey}/${deviceKey}/ota/firmware/post
固件 OTA设备上报升级状态和进度things/up/${tenantId}/${productKey}/${deviceKey}/ota/progress/post

设备回复云端的业务

功能消息类型Topic 主题
属性下发云端下发属性回复things/up/${tenantId}/${productKey}/${deviceKey}/property/set_reply
动作执行云端下发动作指令回复things/up/${tenantId}/${productKey}/${deviceKey}/function/set_reply

网关设备发布拓扑关系消息

功能消息类型Topic 主题
设备上下线网关代理子设备上线things/up/${tenantId}/${productKey}/${deviceKey}/sub/login
设备上下线网关代理子设备下线things/up/${tenantId}/${productKey}/${deviceKey}/sub/logout
绑定子设备网关发现子设备,请求激活子设备并建立拓扑关系things/up/${tenantId}/${productKey}/${deviceKey}/sub/bind
删除子设备网关请求删除子设备及拓扑关系things/up/${tenantId}/${productKey}/${deviceKey}/sub/delete
建立拓扑关系网关添加设备拓扑关系things/up/${tenantId}/${productKey}/${deviceKey}/topo/add
删除拓扑关系网关删除设备拓扑关系things/up/${tenantId}/${productKey}/${deviceKey}/topo/delete
查询拓扑关系网关请求云端查询拓扑关系things/up/${tenantId}/${productKey}/${deviceKey}/topo/get

订阅主题

云端主动发起的业务

功能消息类型Topic 主题
属性下发云端下发属性things/down/${tenantId}/${productKey}/${deviceKey}/property/set
动作执行云端下发动作指令things/down/${tenantId}/${productKey}/${deviceKey}/function/set
固件 OTA云端下发固件升级任务things/down/${tenantId}/${productKey}/${deviceKey}/ota/firmware/upgrade

云端回复设备的业务

功能消息类型Topic 主题
属性上报设备上报属性回复things/down/${tenantId}/${productKey}/${deviceKey}/property/post_reply
事件上报设备上报事件回复things/down/${tenantId}/${productKey}/${deviceKey}/event/post_reply
批量上报设备批量上报回复things/down/${tenantId}/${productKey}/${deviceKey}/batch/post_reply

云端通知网关拓扑关系变更

功能消息类型Topic 主题
拓扑关系变更云端通知网关拓扑关系变更things/down/${tenantId}/${productKey}/${deviceKey}/topo/notify

云端回复网关子设备拓扑关系消息

功能消息类型Topic 主题
绑定子设备云端回复网关发出的激活子设备并建立拓扑关系things/down/${tenantId}/${productKey}/${deviceKey}/sub/bind_reply
删除子设备网关请求删除子设备及拓扑关系things/down/${tenantId}/${productKey}/${deviceKey}/sub/delete_reply
建立拓扑关系云端回复网关添加设备拓扑关系things/down/${tenantId}/${productKey}/${deviceKey}/topo/add_reply
删除拓扑关系云端回复网关删除设备拓扑关系things/down/${tenantId}/${productKey}/${deviceKey}/topo/delete_reply
查询拓扑关系云端回复网关查询拓扑关系请求things/down/${tenantId}/${productKey}/${deviceKey}/topo/get_reply