单片机与物联网 / 系统课时
编写设备端遥测上报程序
编写设备端遥测上报程序
设备端需要持续连接 Broker、周期上报数据,还要在短暂断网后恢复。这里使用 Python 与 Paho MQTT 2.x 实现约每 5 秒一次的遥测发布,并通过 QoS 1 确认判断数据是否完成 MQTT 交付。
学习目标
- 使用 Paho MQTT 2.x 连接 Broker 并发送 JSON 遥测。
- 通过网络循环、连接回调和退避参数处理自动重连。
- 验证断线、恢复及 QoS 1 确认的实际表现。
准备本地 Broker 与依赖
准备 Python 3 和 Mosquitto 2.x。为独立验证,可在终端 A 启动只接受本机连接的测试 Broker;此模式允许本机匿名客户端,不能用于对外部署。若已有启用认证的 Broker,可跳过这条命令,改用实际主机、端口和设备账号。
mosquitto -p 1883 -v预期结果:Broker 在回环地址的 1883 端口监听,并持续输出连接日志;具体时间和日志格式以实际安装版本为准。
在另一终端安装 Paho MQTT 2.x 并检查回调 API 版本:
python -m pip install 'paho-mqtt>=2,<3'
python -c "import paho.mqtt.client as mqtt; print(mqtt.CallbackAPIVersion.VERSION2.name)"预期输出:
VERSION2正式 Broker 若要求账号,应为 device-001 授予 devices/device-001/telemetry 的写权限,并设置 MQTT_USER 与 MQTT_PASSWORD。MQTT_HOST、MQTT_PORT 可切换目标 Broker;用户名是经过认证的授权主体,不能只信任消息体中的 deviceId。不要把真实密码写在源码中。
实现周期发布与自动重连
创建 telemetry.py。这里用固定温度值模拟传感器;接入硬件后,把 23.6 替换为真实采样函数的返回值。loop_start() 维持收发和重连所需的网络循环,连接事件用于阻止离线期间继续生成本示例的遥测消息。
import json
import os
import threading
import time
import paho.mqtt.client as mqtt
DEVICE_ID = os.getenv("MQTT_DEVICE_ID", "device-001")
HOST = os.getenv("MQTT_HOST", "127.0.0.1")
PORT = int(os.getenv("MQTT_PORT", "1883"))
TOPIC = f"devices/{DEVICE_ID}/telemetry"
connected = threading.Event()
def on_connect(client, userdata, flags, reason_code, properties):
if reason_code == 0:
connected.set()
print("Broker 已连接")
else:
connected.clear()
print(f"连接被拒绝: {reason_code}")
def on_disconnect(client, userdata, disconnect_flags, reason_code, properties):
connected.clear()
print("连接已断开")
def on_connect_fail(client, userdata):
print("无法建立 TCP 连接,稍后重试")
def main():
client = mqtt.Client(
callback_api_version=mqtt.CallbackAPIVersion.VERSION2,
client_id=DEVICE_ID,
protocol=mqtt.MQTTv311,
)
username = os.getenv("MQTT_USER")
if username:
client.username_pw_set(username, os.environ["MQTT_PASSWORD"])
client.on_connect = on_connect
client.on_disconnect = on_disconnect
client.on_connect_fail = on_connect_fail
# 重连等待从 1 秒增长,最大为 30 秒
client.reconnect_delay_set(min_delay=1, max_delay=30)
client.connect_async(HOST, PORT, keepalive=30)
client.loop_start()
seq = 0
try:
while True:
if not connected.wait(timeout=2):
continue # 离线期间暂停本示例的采样和发布
payload = json.dumps({
"deviceId": DEVICE_ID,
"seq": seq,
"temperatureC": 23.6,
}, separators=(",", ":"))
info = client.publish(TOPIC, payload, qos=1, retain=False)
if info.rc == mqtt.MQTT_ERR_SUCCESS:
try:
info.wait_for_publish(timeout=3)
if info.is_published():
print(f"PUBACK 已收到, seq={seq}")
else:
print(f"seq={seq} 确认超时,状态未知")
except (RuntimeError, ValueError) as exc:
print(f"seq={seq} 发布失败: {exc}")
else:
print(f"发布未入队: {mqtt.error_string(info.rc)}")
seq += 1
time.sleep(5)
except KeyboardInterrupt:
pass
finally:
client.disconnect()
client.loop_stop()
if __name__ == "__main__":
main()保存为 telemetry.py 后执行 python telemetry.py,预期输出(节选):
Broker 已连接
PUBACK 已收到, seq=0
PUBACK 已收到, seq=1若 Broker 不可达,会提示连接失败并等待重试,不会假装消息已送达。
publish() 返回成功仅表示本地客户端接受了发送请求;wait_for_publish() 配合 is_published() 用来等待 QoS 1 发布交互完成。PUBACK 也不代表业务系统已处理数据。连接在发送中途断开时,确认可能超时,不能简单把“未知”记作“必然失败”。
验证收发与断线恢复
在启动 Python 程序前,先用终端 B 订阅并等待两条消息:
mosquitto_sub -h 127.0.0.1 -p 1883 -t 'devices/device-001/telemetry' -C 2 -W 20 -v预期结果:订阅准备好后,在另一终端运行 python telemetry.py,订阅端依次显示两条 JSON 消息:
devices/device-001/telemetry {"deviceId":"device-001","seq":0,"temperatureC":23.6}
devices/device-001/telemetry {"deviceId":"device-001","seq":1,"temperatureC":23.6}接着停止终端 A 的 Broker,观察客户端出现连接断开或建连失败提示;重新执行 mosquitto -p 1883 -v 后,应自动重新连接并继续上报。需要持续观察收发时,可重新打开订阅终端。
如需接入已经配置认证的本机 1884 端口 Broker,可在运行程序前设置环境变量(密码在终端内交互输入):
export MQTT_HOST=127.0.0.1 MQTT_PORT=1884 MQTT_USER=device-001
read -rsp '设备密码: ' MQTT_PASSWORD; echo
export MQTT_PASSWORD
python telemetry.py预期结果:当该 Broker 已授予 device-001 对对应遥测 Topic 的写权限时,连接成功并持续看到 PUBACK 确认;凭据错误则不能进入正常发布状态。若订阅端也需要验证消息,必须使用拥有对应读取权限的独立账号。

确定哪些数据需要补偿
这个最小程序在离线期间暂停生成新样本,也没有磁盘队列;断线前尚未确认的 QoS 1 消息可能在重连后重发,接收端应按设备编号和业务序号去重。这里的 seq 只在进程内递增,程序重启会归零;正式设备要使用持久化序号或唯一事件 ID。
如果业务允许丢失少量周期采样,可以保持这种做法;如果遥测必须完整留存,应加入有容量上限的本地持久队列,并在收到确认后删除对应记录。生产环境还需使用 TLS 和设备独立凭据,避免明文传输。