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

命令码与响应怎样配对

命令码与响应怎样配对

本课解决串口设备“收到一帧,却不知道它对应哪个请求”的问题。通过统一命令码、响应类型和错误码规则,让主站能把请求、成功响应和失败响应准确对应起来。

学习目标

  • 能设计请求命令与响应消息的配对规则
  • 能区分成功响应、业务错误和协议错误
  • 能在程序中根据命令码稳定解析响应

为什么不能只看命令码

最简单的协议可以让请求和响应共用一个命令码,例如主站发送 0x10,设备返回 0x10。但当一个命令既可能成功又可能失败时,仅靠命令码无法判断执行结果。

更稳妥的做法是固定三件事:命令码表示请求的业务动作,响应类型表示处理结果,错误码只在失败响应中解释具体原因。这样主站无需猜测载荷内容,就能先判断“这是什么响应”。

一套可落地的编码规则

可以将命令码和响应类型分开定义。例如:请求使用 0x10 表示读取设备状态;响应类型 0x00 表示成功,0x01 表示业务错误,0x02 表示协议错误。成功响应携带状态数据,错误响应携带错误码。

字段 示例 含义
命令码 0x10 读取设备状态
响应类型 0x00 成功
错误码 0x00 无错误;成功时可固定为 0x00
错误码 0x02 参数非法等具体失败原因,实际值按协议定义

一个请求可以定义为 CMD + 参数,响应定义为 CMD + TYPE + ERROR + DATA。关键点不是具体字节值,而是规则必须稳定、唯一,并在整个协议中保持一致。

主站怎样完成配对

主站收到响应后,先校验帧是否合法,再读取命令码和响应类型,随后按命令码找到对应请求。若响应类型为成功,就解析业务数据;若为错误,则读取错误码并结束本次请求。

片段示例:下面程序展示一个最小的响应匹配器,实际项目应把校验和、超时及串口读取逻辑接在它之前。

python
REQUEST_STATUS = 0x10
RESPONSE_OK = 0x00
RESPONSE_ERROR = 0x01

ERROR_MESSAGES = {
    0x01: "参数非法",
    0x02: "设备忙",
}


def parse_response(expected_command, frame):
    # frame 结构:命令码、响应类型、错误码、数据
    command, response_type, error_code, data = frame
    if command != expected_command:
        return "命令码不匹配"
    if response_type == RESPONSE_OK:
        return f"成功: {data.hex()}"
    if response_type == RESPONSE_ERROR:
        return f"失败: {ERROR_MESSAGES.get(error_code, '未知错误')}"
    return "未知响应类型"


def main():
    response = (REQUEST_STATUS, RESPONSE_OK, 0x00, bytes([0x01, 0x02]))
    print(parse_response(REQUEST_STATUS, response))


if __name__ == "__main__":
    main()

预期输出

text
成功: 0102

设计时容易踩的坑

不要让不同命令复用含义不同的响应类型,也不要让错误码同时承担“成功/失败”这一层职责。状态层级越混乱,主站越容易出现“响应到了但解析错了”的问题。

还要明确是否允许异步上报。如果设备会主动发送事件帧,就不能简单地把“收到相同命令码”当成请求响应;应通过消息类型、序号或独立的事件命令空间区分主动上报。

最终应形成一条明确规则:命令码确定对应哪项操作,响应类型确定处理结果,错误码解释失败原因,必要时再增加请求序号处理并发请求或异步场景。

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

目录与阅读设置

阅读设置

17

记录一个想法

命令码与响应怎样配对

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

登录哪都通