单片机与物联网 / 系统课时
设计遥测和指令主题结构
设计遥测和指令主题结构
一台设备既要上报温度、同步运行状态,也要接收应用下发的设置指令。如果这些消息共用一个 Topic,订阅者就难以按职责分流,权限也不好限制。这里以工厂电机为例,规划四类消息路径,并用本地 Broker 检查订阅是否准确匹配。
学习目标
- 为遥测、状态、命令和响应分别确定 Topic 与消息方向。
- 使用 MQTT 通配符设计批量订阅,同时避免跨设备和跨租户串线。
- 通过实际发布与订阅验证命名方案,并确定保留和权限边界。
以消息方向定义四类 Topic
先选定公共前缀 tenants/{tenantId}/devices/{deviceId}。花括号表示设计时要替换的业务标识,并非 MQTT 的动态路由语法。实际发布的 Topic 必须填入具体值,例如租户 acme、设备 motor-07。
| 消息类别 | 示例 Topic | 发布方 → 订阅方 | 约定 |
|---|---|---|---|
| 遥测 | tenants/acme/devices/motor-07/telemetry |
设备 → 应用 | 温度、电流等采样;通常不保留 |
| 状态 | tenants/acme/devices/motor-07/state |
设备 → 应用 | 最新运行快照;可使用 Retain |
| 命令 | tenants/acme/devices/motor-07/commands/set-rate |
应用 → 设备 | 修改上报间隔;禁止 Retain |
| 响应 | tenants/acme/devices/motor-07/responses/set-rate |
设备 → 应用 | 回报执行结果;通过 requestId 对应命令 |

Topic 表示消息所处的路由位置,不负责解析 JSON 内容,也不会自动限制谁能发布。生产环境应在 Broker ACL 中实施方向约束:设备仅能向自己的遥测、状态和响应路径写入,并读取自己的命令;应用按租户权限读取设备消息、发布命令。
用过滤器订阅设备集合
订阅过滤器里的 + 匹配恰好一层,# 匹配其所在位置之后的零层或多层,且必须位于过滤器末尾。发布方使用的 Topic Name 不能含这两个通配符,完整规则见 MQTT 5.0 规范。
tenants/acme/devices/+/telemetry:接收租户acme下所有设备的遥测。tenants/acme/devices/motor-07/commands/+:只接收该设备的一层命令名称。tenants/acme/devices/motor-07/#:覆盖该设备的所有业务分支,适合有权限的诊断端,不宜给普通业务端默认开放。
Topic 区分大小写;Motor-07 与 motor-07 是不同设备路径。设备标识不得包含 /、+、# 等会改变路由结构的字符。不要把温度数值、时间戳或 requestId 放入 Topic,否则每次发布都会产生新路径,也难以复用固定订阅和 ACL。
通过本地 Broker 验证匹配
准备一个监听 127.0.0.1:1883 的本地 Mosquitto Broker,并安装 mosquitto_sub、mosquitto_pub。下面的 Bash 示例面向允许本机测试连接的 Broker;1883 是示例监听端口,实际环境可能不同,需替换为配置的地址和端口。
set -e
# 先订阅所有设备的遥测,收到一条后自动退出
mosquitto_sub -h 127.0.0.1 -p 1883 -t 'tenants/acme/devices/+/telemetry' -q 1 -C 1 -W 5 -v &
sub_pid=$!
sleep 1
# 发布端必须指定真实设备的完整 Topic
mosquitto_pub -h 127.0.0.1 -p 1883 -t 'tenants/acme/devices/motor-07/telemetry' -q 1 -m '{"temperatureC":27.4}'
wait "$sub_pid"预期输出:
tenants/acme/devices/motor-07/telemetry {"temperatureC":27.4}-v 让订阅端同时打印 Topic 和载荷,-C 1 表示收到一条就退出,-W 5 限制等待时间。若超时,先检查 Broker 是否运行、是否允许当前客户端连接,再确认订阅过滤器与发布 Topic 的大小写和层级是否一致。这个试验只验证路由,不代表命令已经被设备执行。选项细节见 Mosquitto 订阅命令手册。
给状态和命令设置不同交付规则
周期遥测常用 QoS 0;重要遥测可按可靠性要求选 QoS 1。state 是最新快照时,可用 Retain 让新订阅者立即获得最近状态,但必须在载荷中注明状态生成时间,避免将旧快照当作实时数据。异常离线状态若依赖遗嘱消息,还需由设备在建连时另行配置 Will。
commands/set-rate 不应保留:设备重连后误收到旧命令,可能将上报间隔改回过期值。业务命令可用 QoS 1 并携带 requestId 与有效期;由于 QoS 1 允许重复交付,设备需按 requestId 去重,执行后向对应的 responses/set-rate 回传同一编号及结果。
验收时检查四项:设备无法发布其他设备的路径;普通应用无法订阅其他租户;重连订阅状态路径能获得最新有效快照;重连订阅命令路径不会触发历史命令。命名约定与 ACL、Retain、业务幂等一起实施,才能避免路由正确但动作错误。