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

完成设备命令闭环验证

完成设备命令闭环验证

控制端成功调用 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 负责转发,设备负责执行和报告结果,控制端负责将响应关联到仍在等待的请求;否则,响应可能在订阅建立前丢失,或被误认为另一条命令的结果。

命令下发、设备执行与响应关联的 MQTT 时序图

只有 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;测试监听不应直接暴露到公网。

python
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> 是每次运行生成的不同请求标识):

text
设备处理 requestId=<ID> status=applied
控制端确认 requestId=<ID> appliedPower=1

用失败场景验证判定逻辑

把下发值 value 改为 2,设备应返回 status=rejected,控制端抛出“设备未执行成功”;临时取消 device.on_message = on_command 的绑定,应在约 5 秒后得到超时,而不是成功。若设备响应使用了其他 requestId,控制端同样应忽略该响应。

再次发送同一个 requestId 时,示例中的 handled 会复用旧结果,不再重复改变设备状态。但它只是进程内去重,重启就会丢失。实际控制系统应持久化命令处理记录,约束命令有效期,避免离线积压指令在重连后误执行;命令通常不设置 Retain。

生产排障时同时记录 requestId、命令发布时间、设备接收时间、执行结果与响应到达时间。只有执行回读与请求标识都验证成功,闭环才算通过。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成设备命令闭环验证

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

登录哪都通