MQTT接入

主题总览

按功能查看 MQTT 主题、交互方向、必需与按需标签,并悬浮查看用途详情。

主题列表

主题按“设备注册 → 数据上报 → 属性下发 → 属性查询 → 配置读取 → 控制指令 → 设备联动 → 固件升级”的功能顺序排列,同一功能的请求与响应相邻展示。其中,“属性查询”是设备查询平台保存的属性,“配置读取”是平台读取设备本机当前配置,“控制指令”通过远程调用执行设备物模型服务。

“方向”列区分设备注册、设备发布、平台发布和设备订阅。“设备注册”表示临时注册连接的交互;“设备发布”表示设备上行;“平台发布”表示平台主动下发,设备需要订阅对应主题;“设备订阅”表示设备接收平台确认、响应或升级任务。具体发布与订阅操作见悬浮说明和对应流程。

设备只能访问包含自身访问令牌的设备主题;自动注册使用独立的临时连接和 provision 主题。通配符 + 只能用于订阅,发布时必须使用实际请求编号。

无需为每台设备配置全部主题。 主题前的“必需”标签表示数据上报的基础要求;“按需”标签表示仅在设备实现对应能力时启用,请求与响应主题应配套实现。鼠标悬停或键盘聚焦用途文字,可查看详细用途和配置条件。

功能方向主题用途
设备注册设备注册按需 provision/request/{requestId}注册或查询接入状态
设备注册按需 provision/response/{requestId}接收接入处理结果
数据上报设备发布必需 v1/devices/{token}/data综合数据上报
设备订阅必需 v1/devices/{token}/ack/+接收数据确认
属性下发平台发布按需 v1/devices/{token}/attributes下发共享属性
属性查询设备发布按需 v1/devices/{token}/attributes/request/{requestId}主动读取平台属性
设备订阅按需 v1/devices/{token}/attributes/response/+接收平台属性结果
配置读取平台发布按需 v1/devices/{token}/attributes/read/request/{requestId}读取设备当前配置
设备发布按需 v1/devices/{token}/attributes/read/response/{requestId}返回本机配置读取结果
控制指令平台发布按需 v1/devices/{token}/rpc/request/{requestId}下发控制指令
设备发布按需 v1/devices/{token}/rpc/response/{requestId}返回执行结果
设备联动设备发布按需 v1/devices/{token}/platform/request/{requestId}发起设备联动请求
设备订阅按需 v1/devices/{token}/platform/response/+接收设备联动结果
固件升级设备发布按需 v1/devices/{token}/ota/request/{requestId}检查升级或上报进度
设备订阅按需 v1/devices/{token}/ota/response/+接收升级结果和任务

例如,仅上报数据的设备配置 data 和 ack/+ 即可;作为联动来源的喂食器另加 platform 请求与响应主题,作为联动目标的电箱另加 rpc 请求与响应主题。同一设备兼任来源和目标时,两组主题都需要实现。共享配置下发、平台读取设备配置及固件升级分别按业务需要启用。

设备联动请求和设备配置读取响应使用一级消息质量(QoS 1),并设置 retain=false。一级消息质量可能重复投递,设备仍需按请求编号处理重复消息。

功能文档

  • 设备注册:临时注册连接、令牌获取、设备认领及接入恢复查询,恢复查询复用注册主题。
  • 数据上报:综合数据报文、机器码上报、确认及重试。
  • 共享属性:平台下发配置,以及设备查询平台保存的属性。
  • 配置读取:平台读取设备本机当前保存的共享配置。
  • 控制指令:设备接收指令、执行动作并返回结果。
  • 设备联动:来源设备发起联动,查询执行状态并处理重试。
  • 固件升级:检查版本、接收任务并上报升级进度。
© 2026 飞鸟智联