单片机与物联网 / 系统课时
用主题层级组织设备消息
用主题层级组织设备消息
当产线增加到几十台设备,全部发布到 temperature 会让消费者难以筛选来源。把站点、产线、设备、消息类别和指标写成有规律的 Topic,再通过通配符订阅,就能按设备或消息类型选择数据,而无需修改每条消息的载荷。
学习目标
- 用
/组织设备、消息类别和指标的多级 Topic。 - 正确区分发布主题与包含
+、#的订阅过滤器。 - 用两台模拟设备验证主题匹配范围及未命中的消息。
从业务维度设计主题
本例约定主题格式为 factory/{line}/device/{deviceId}/{kind}/{metric}。其中 line 标识产线、deviceId 标识稳定设备编号、kind 区分消息用途、metric 指明测量项或命令类型。花括号部分是命名模板,发送消息时必须替换成实际名称。
| Topic | 含义 |
|---|---|
factory/line1/device/t01/telemetry/temperature |
一号设备的温度 |
factory/line1/device/t02/telemetry/temperature |
二号设备的温度 |
factory/line1/device/t01/status/online |
一号设备的在线状态 |
factory/line1/device/t01/command/setpoint |
向一号设备发送设定值 |
/ 分隔的是匹配层级,而不是操作系统目录。Broker 不会因为写了 telemetry 就自动校验温度格式;消息含义需要由发布端和消费端约定。温度值 24.6 应放在载荷中,避免将每次变化的读数拼进 Topic,造成主题数量失控。
用通配符限定订阅范围
发布时应指定具体 Topic;+ 与 # 只能出现在订阅过滤器中,不能用在发布主题名里。两种通配符含义不同:
+匹配恰好一个层级,且必须独占该层级。例如factory/line1/device/+/telemetry/temperature同时选中t01和t02的温度数据。#匹配零个或多个后续层级,只能单独作为过滤器最后一级。例如factory/line1/device/t01/#可接收t01的温度、状态和命令主题消息。

像 factory/line1/device/t+/telemetry/temperature 这样把通配符嵌进设备编号,或写 factory/#/temperature 让 # 出现在中间,都不是合法过滤器。主题还区分大小写,T01 与 t01 是不同层级名称。
用客户端检验两台设备的路由
准备已安装 Mosquitto 的本机环境,打开终端 A 启动临时 Broker。若 1883 端口已有可用的本地 Broker,就直接使用它:
mosquitto -p 1883 -v预期结果:Broker 持续运行并监听本地 1883 端口;日志的时间和标识因环境而异。若端口已被占用,不要重复启动实例。
终端 B 订阅所有设备的温度数据,-v 会在输出中保留 Topic,便于看出消息来自哪台设备:
mosquitto_sub -h 127.0.0.1 -p 1883 -t 'factory/line1/device/+/telemetry/temperature' -v预期结果:订阅客户端保持运行,等待命中的温度消息。
终端 C 依次发布两条温度和一条状态消息。第三条用于检查过滤器是否错误接收了其他类别:
mosquitto_pub -h 127.0.0.1 -p 1883 -t 'factory/line1/device/t01/telemetry/temperature' -m '24.6'
mosquitto_pub -h 127.0.0.1 -p 1883 -t 'factory/line1/device/t02/telemetry/temperature' -m '25.1'
# status/online 不属于温度过滤器的匹配范围
mosquitto_pub -h 127.0.0.1 -p 1883 -t 'factory/line1/device/t01/status/online' -m 'true'预期结果:三条发布命令正常执行后,终端 B 仅显示两条温度消息:
factory/line1/device/t01/telemetry/temperature 24.6
factory/line1/device/t02/telemetry/temperature 25.1订阅端不应出现 status/online true。如果想把同一设备的温度和状态一起消费,可将终端 B 的过滤器改成 factory/line1/device/t01/#,重新订阅后再发布消息验证;由于本例未发布保留消息,旧消息不会自动重放。
避免把命名约定当成访问控制
Topic 路由只解决消息分类和匹配,不能代替权限检查。虽然示例把 telemetry、status、command 分开,Broker 仍需要通过 ACL 约束哪些客户端可以向 command 发布,以及哪些客户端能订阅它。
实际项目应统一使用小写、稳定设备编号和固定层级位置,避免 line1/t01/temp 与 factory/line1/device/t01/telemetry/temperature 两套命名并存。若后续增加湿度,只需新增 telemetry/humidity 分支,现有温度订阅过滤器不必修改。