单片机与物联网 / 系统课时
命令码与响应怎样配对
命令码与响应怎样配对
本课解决串口设备“收到一帧,却不知道它对应哪个请求”的问题。通过统一命令码、响应类型和错误码规则,让主站能把请求、成功响应和失败响应准确对应起来。
学习目标
- 能设计请求命令与响应消息的配对规则
- 能区分成功响应、业务错误和协议错误
- 能在程序中根据命令码稳定解析响应
为什么不能只看命令码
最简单的协议可以让请求和响应共用一个命令码,例如主站发送 0x10,设备返回 0x10。但当一个命令既可能成功又可能失败时,仅靠命令码无法判断执行结果。
更稳妥的做法是固定三件事:命令码表示请求的业务动作,响应类型表示处理结果,错误码只在失败响应中解释具体原因。这样主站无需猜测载荷内容,就能先判断“这是什么响应”。
一套可落地的编码规则
可以将命令码和响应类型分开定义。例如:请求使用 0x10 表示读取设备状态;响应类型 0x00 表示成功,0x01 表示业务错误,0x02 表示协议错误。成功响应携带状态数据,错误响应携带错误码。
| 字段 | 示例 | 含义 |
|---|---|---|
| 命令码 | 0x10 |
读取设备状态 |
| 响应类型 | 0x00 |
成功 |
| 错误码 | 0x00 |
无错误;成功时可固定为 0x00 |
| 错误码 | 0x02 |
参数非法等具体失败原因,实际值按协议定义 |
一个请求可以定义为 CMD + 参数,响应定义为 CMD + TYPE + ERROR + DATA。关键点不是具体字节值,而是规则必须稳定、唯一,并在整个协议中保持一致。
主站怎样完成配对
主站收到响应后,先校验帧是否合法,再读取命令码和响应类型,随后按命令码找到对应请求。若响应类型为成功,就解析业务数据;若为错误,则读取错误码并结束本次请求。
片段示例:下面程序展示一个最小的响应匹配器,实际项目应把校验和、超时及串口读取逻辑接在它之前。
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()预期输出
成功: 0102设计时容易踩的坑
不要让不同命令复用含义不同的响应类型,也不要让错误码同时承担“成功/失败”这一层职责。状态层级越混乱,主站越容易出现“响应到了但解析错了”的问题。
还要明确是否允许异步上报。如果设备会主动发送事件帧,就不能简单地把“收到相同命令码”当成请求响应;应通过消息类型、序号或独立的事件命令空间区分主动上报。
最终应形成一条明确规则:命令码确定对应哪项操作,响应类型确定处理结果,错误码解释失败原因,必要时再增加请求序号处理并发请求或异步场景。