单片机与物联网 / 系统课时
完成设备命令闭环验证
完成设备命令闭环验证
控制端成功调用 publish(),不代表电机已经执行命令。本课用本地 MQTT Broker、模拟设备和控制端跑通下发、处理、回执与关联校验,并用设备返回的状态判断一次控制是否真正完成。
学习目标
- 设计可关联的命令主题、响应主题及消息字段。
- 运行一次 QoS 1 设备命令闭环,检查执行结果。
- 区分 MQTT 确认、业务拒绝、重复投递和超时。
明确命令完成的判断条件
以设备 motor-07 为例,控制端向 demo/devices/motor-07/cmd 发布命令,设备向 demo/devices/motor-07/reply 回传结果。命令带 requestId、action=set_power 和 value=1;响应复用相同的 requestId,并带上 status 与回读状态 appliedPower。
控制端必须先订阅响应主题并收到 SUBACK,再发布命令。Broker 负责转发,设备负责执行和报告结果,控制端负责将响应关联到仍在等待的请求;否则,响应可能在订阅建立前丢失,或被误认为另一条命令的结果。

只有 requestId 匹配,且 status=applied、appliedPower=1 同时满足,才把本次控制标记为成功。QoS 1 的 PUBACK 只确认对应 MQTT 传输段上的接收,不证明执行器动作成功。
准备并运行最小闭环
先在本机启动可由 127.0.0.1:1883 访问的测试 Broker(如 Mosquitto),准备 Python 3,并执行 python -m pip install "paho-mqtt>=2,<3"。将下方代码保存为 mqtt_command_demo.py,通过 python mqtt_command_demo.py 运行。示例使用 MQTT 3.1.1 和 Paho 2.x;测试监听不应直接暴露到公网。
import json
import threading
import uuid
import paho.mqtt.client as mqtt
HOST = "127.0.0.1"
CMD = "demo/devices/motor-07/cmd"
REPLY = "demo/devices/motor-07/reply"
request_id = uuid.uuid4().hex
device_ready = threading.Event()
app_ready = threading.Event()
reply_ready = threading.Event()
device_state = {"power": 0}
handled = {}
response = {}
def subscribe_on_connect(topic):
def callback(client, userdata, flags, reason_code, properties):
if not reason_code.is_failure:
client.subscribe(topic, qos=1)
return callback
def device_subscribed(client, userdata, mid, reasons, properties):
if reasons and all(not r.is_failure for r in reasons):
device_ready.set()
def app_subscribed(client, userdata, mid, reasons, properties):
if reasons and all(not r.is_failure for r in reasons):
app_ready.set()
def on_command(client, userdata, msg):
command = json.loads(msg.payload.decode("utf-8"))
key = command["requestId"]
if key not in handled:
if command.get("action") == "set_power" and command.get("value") in (0, 1):
# 模拟执行和状态回读;真机应先操作驱动再读取状态
device_state["power"] = command["value"]
handled[key] = {
"requestId": key, "status": "applied",
"appliedPower": device_state["power"]
}
else:
handled[key] = {"requestId": key, "status": "rejected"}
print(f"设备处理 requestId={key} status={handled[key]['status']}")
# QoS 1 可能重复投递;同一请求只执行一次,重复时复用结果
client.publish(REPLY, json.dumps(handled[key]), qos=1, retain=False)
def on_reply(client, userdata, msg):
data = json.loads(msg.payload.decode("utf-8"))
if data.get("requestId") == request_id:
response.update(data)
reply_ready.set()
device = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="motor-07-sim")
app = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="control-app-demo")
device.on_connect = subscribe_on_connect(CMD)
device.on_subscribe = device_subscribed
device.on_message = on_command
app.on_connect = subscribe_on_connect(REPLY)
app.on_subscribe = app_subscribed
app.on_message = on_reply
try:
device.connect(HOST, 1883, 60)
app.connect(HOST, 1883, 60)
device.loop_start()
app.loop_start()
if not (device_ready.wait(5) and app_ready.wait(5)):
raise TimeoutError("订阅未就绪")
result = app.publish(CMD, json.dumps({
"requestId": request_id, "action": "set_power", "value": 1
}), qos=1, retain=False)
if result.rc != mqtt.MQTT_ERR_SUCCESS:
raise RuntimeError(f"发布失败: {result.rc}")
if not reply_ready.wait(5):
raise TimeoutError("5 秒内未收到匹配的设备回执")
if response.get("status") != "applied" or response.get("appliedPower") != 1:
raise RuntimeError(f"设备未执行成功: {response}")
print(f"控制端确认 requestId={request_id} appliedPower={response['appliedPower']}")
finally:
device.disconnect()
app.disconnect()
device.loop_stop()
app.loop_stop()预期输出(<ID> 是每次运行生成的不同请求标识):
设备处理 requestId=<ID> status=applied
控制端确认 requestId=<ID> appliedPower=1用失败场景验证判定逻辑
把下发值 value 改为 2,设备应返回 status=rejected,控制端抛出“设备未执行成功”;临时取消 device.on_message = on_command 的绑定,应在约 5 秒后得到超时,而不是成功。若设备响应使用了其他 requestId,控制端同样应忽略该响应。
再次发送同一个 requestId 时,示例中的 handled 会复用旧结果,不再重复改变设备状态。但它只是进程内去重,重启就会丢失。实际控制系统应持久化命令处理记录,约束命令有效期,避免离线积压指令在重连后误执行;命令通常不设置 Retain。
生产排障时同时记录 requestId、命令发布时间、设备接收时间、执行结果与响应到达时间。只有执行回读与请求标识都验证成功,闭环才算通过。