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 |