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。一级消息质量可能重复投递,设备仍需按请求编号处理重复消息。