单片机与物联网 / 系统课时

接通遥测上报和状态同步

接通遥测上报和状态同步

把设备 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。

python
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 秒打印新的序号,例如:

text
设备上报 seq=1
设备上报 seq=2

验证迟到消费者与离线标记

  1. 保持设备运行,在第二个终端执行 python telemetry_demo.py observe,确认能收到后续实时 telemetry,并读到 presence 和 latest。
  2. 等设备至少发布两次,在第三个终端再次执行 python telemetry_demo.py observe。观察端使用不同客户端 ID,会立即收到两条保留状态,然后继续接收实时遥测。
  3. 在设备终端按 Ctrl+C,再次启动观察端,应看到保留的 offline,但 latest 仍是最后一条温度快照;重新启动设备后,presence 变回 online。

迟到消费者可能看到以下输出(序号与消息顺序取决于加入时刻):

text
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,但不会补回离线期间全部遥测。若需要历史曲线,须另配持久会话、离线队列或后端存储;生产数据还应携带采样时间,避免把离线设备的最后一个读数误当作当前测量值。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接通遥测上报和状态同步

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通