单片机与物联网 / 系统课时
接通遥测上报和状态同步
接通遥测上报和状态同步
把设备 motor-07 的周期温度上报、在线标记和最新读数接入本地 MQTT Broker。完成后,在线消费者能持续收到新读数,稍后启动的消费者也能取到最近状态,还可以区分设备正常退出和意外断线。
学习目标
- 区分实时遥测、在线状态与最新快照的交付方式。
- 使用 Paho MQTT 5 完成周期发布、保留消息和遗嘱配置。
- 验证新消费者加入、设备下线与重连的实际表现。
为三类数据划分 Topic
以 lab/motor-07 为设备前缀,将不同生命周期的数据分开放置:
| Topic | 示例内容 | QoS / Retain | 消费语义 |
|---|---|---|---|
lab/motor-07/telemetry |
温度与序号 | 1 / false | 在线实时流,不补发旧样本 |
lab/motor-07/presence |
online 或 offline |
1 / true | 保存最近一次在线状态 |
lab/motor-07/latest |
最近一次温度与序号 | 1 / true | 新订阅者立即获得最新读数 |
retain=true 让 Broker 为一个 Topic 保存最后一条消息,而不是保存完整历史。设备连接成功发布保留的 online,正常退出主动写入 offline,异常断开则由预先登记的遗嘱写入 offline。QoS 1 仍可能重复投递,消费端不能假定一条消息只到达一次。

运行设备发布端和观察端
准备 Python 3.10 及以上版本和支持 MQTT 5 的本地 Mosquitto Broker,监听 127.0.0.1:1883。启动 Broker(例如执行 mosquitto -v),再安装依赖 python -m pip install "paho-mqtt>=2,<3"。这里使用本机测试端口;跨主机部署应另行配置监听、认证和 TLS。
将下面程序保存为 telemetry_demo.py。设备模式每 2 秒发布一次,观察模式在每次连接成功后重新订阅三个 Topic。
import json
import os
import sys
import threading
import time
import paho.mqtt.client as mqtt
BASE = "lab/motor-07"
TELEMETRY = f"{BASE}/telemetry"
PRESENCE = f"{BASE}/presence"
LATEST = f"{BASE}/latest"
def create_client(role):
return mqtt.Client(
mqtt.CallbackAPIVersion.VERSION2,
client_id=f"lesson10-{role}", protocol=mqtt.MQTTv5
)
def run_device():
connected = threading.Event()
client = create_client("motor-07")
# 异常掉线时,Broker 使用遗嘱覆盖在线标记。
client.will_set(PRESENCE, "offline", qos=1, retain=True)
def on_connect(c, userdata, flags, reason_code, properties):
if reason_code.is_failure:
print(f"连接失败: {reason_code}")
return
c.publish(PRESENCE, "online", qos=1, retain=True)
connected.set()
def on_disconnect(c, userdata, disconnect_flags, reason_code, properties):
connected.clear()
client.on_connect = on_connect
client.on_disconnect = on_disconnect
client.connect("127.0.0.1", 1883, 60)
client.loop_start()
seq = 0
try:
while True:
connected.wait()
seq += 1
sample = json.dumps(
{"seq": seq, "temperatureC": round(25 + (seq % 5) * 0.2, 1)},
separators=(",", ":")
)
# 遥测走实时流;latest 每次覆盖上一条保留值。
client.publish(TELEMETRY, sample, qos=1).wait_for_publish()
client.publish(LATEST, sample, qos=1, retain=True).wait_for_publish()
print(f"设备上报 seq={seq}")
time.sleep(2)
except KeyboardInterrupt:
pass
finally:
if connected.is_set():
client.publish(PRESENCE, "offline", qos=1, retain=True).wait_for_publish()
client.disconnect()
client.loop_stop()
def run_observer():
client = create_client(f"observer-{os.getpid()}")
def on_connect(c, userdata, flags, reason_code, properties):
if reason_code.is_failure:
print(f"连接失败: {reason_code}")
return
c.subscribe([(TELEMETRY, 1), (PRESENCE, 1), (LATEST, 1)])
def on_message(c, userdata, msg):
print(f"{msg.topic} retain={msg.retain} payload={msg.payload.decode('utf-8')}")
client.on_connect = on_connect
client.on_message = on_message
client.connect("127.0.0.1", 1883, 60)
try:
client.loop_forever()
except KeyboardInterrupt:
client.disconnect()
if __name__ == "__main__":
if len(sys.argv) != 2 or sys.argv[1] not in {"device", "observe"}:
raise SystemExit("用法: python telemetry_demo.py device|observe")
(run_device if sys.argv[1] == "device" else run_observer)()预期结果:在一个终端运行 python telemetry_demo.py device,每隔约 2 秒打印新的序号,例如:
设备上报 seq=1
设备上报 seq=2验证迟到消费者与离线标记
- 保持设备运行,在第二个终端执行
python telemetry_demo.py observe,确认能收到后续实时telemetry,并读到presence和latest。 - 等设备至少发布两次,在第三个终端再次执行
python telemetry_demo.py observe。观察端使用不同客户端 ID,会立即收到两条保留状态,然后继续接收实时遥测。 - 在设备终端按
Ctrl+C,再次启动观察端,应看到保留的offline,但latest仍是最后一条温度快照;重新启动设备后,presence变回online。
迟到消费者可能看到以下输出(序号与消息顺序取决于加入时刻):
lab/motor-07/presence retain=True payload=online
lab/motor-07/latest retain=True payload={"seq":2,"temperatureC":25.4}
lab/motor-07/telemetry retain=False payload={"seq":3,"temperatureC":25.6}这里 retain=True 表示 Broker 因新订阅而补发保留消息;后续实时转发的状态更新可能显示 retain=False,即使发布端用了保留标志。判断某个 Topic 是否承担快照职责,应看主题契约,而不能只看接收端标志。
确认恢复范围与边界
正常退出时程序主动发布 offline,Broker 不会为正常 DISCONNECT 再触发遗嘱。若进程被强制终止或网络中断,Broker 必须先判断连接失效才会发布 Will,耗时受 Keep Alive 和网络条件影响,不会必然立即更新。
这个观察端重连后会重新订阅,能恢复 presence 与 latest,但不会补回离线期间全部遥测。若需要历史曲线,须另配持久会话、离线队列或后端存储;生产数据还应携带采样时间,避免把离线设备的最后一个读数误当作当前测量值。