单片机与物联网 / 系统课时
写一个最小串口收发程序
写一个最小串口收发程序
本篇用 Python 和 pyserial 完成一条最小可验证链路:打开串口、设置通信参数、写入字节、读取响应,并在无论成功还是失败时安全关闭端口。实际串口名称、波特率和响应内容应按设备协议替换。
学习目标
- 能用
pyserial打开并配置一个串口。 - 能区分发送成功、读取超时和串口异常。
- 能用十六进制报文验证程序与终端工具的结果一致。
最小收发链路
最小程序只保留通信闭环,不加入线程、队列和协议解析器。示例假设设备使用串口 <PATH>,参数为 115200、8 数据位、无校验、1 停止位,并在收到一帧请求后返回响应。
import serial
PORT = "<PATH>"
REQUEST = bytes.fromhex("AA 55 01 01 00 00")
try:
with serial.Serial(
port=PORT,
baudrate=115200,
bytesize=serial.EIGHTBITS,
parity=serial.PARITY_NONE,
stopbits=serial.STOPBITS_ONE,
timeout=1.0,
write_timeout=1.0,
) as ser:
# 先发出完整字节串,再按超时读取响应,避免无限等待。
written = ser.write(REQUEST)
response = ser.read(32)
print(f"sent={written} bytes")
print(f"response={response.hex(' ')}")
except serial.SerialException as exc:
print(f"serial error: {exc}")预期结果
sent=6 bytes
response=<DEVICE_RESPONSE_HEX>其中 <PATH> 是实际串口设备名,例如 Linux 下可能是 /dev/ttyUSB0,Windows 下可能是 COM3;<DEVICE_RESPONSE_HEX> 表示设备实际返回的十六进制字节,因此这里不假造具体响应。
为什么先用固定长度读取
read(32) 的目的只是建立最小闭环:程序最多等待 32 字节,并在 timeout=1.0 秒后返回已经收到的数据。它适合验证“端口真的打开了、请求真的发出去了、设备真的有响应”。
正式协议通常需要根据帧头和长度字段持续接收,再校验完整报文。此时不能把一次 read() 当成“一帧”,因为串口读取可能出现分段、合并或只收到部分数据的情况。
与终端工具逐字节对照
联调时,先用串口终端发送同一组十六进制字节,再运行程序发送完全相同的 REQUEST。如果终端工具能得到响应,而程序得不到,应优先比较端口名称、波特率、数据位、校验位、停止位以及实际发送字节,而不是立即修改业务代码。
还要注意某些终端工具会自动追加换行、回车或其他字节。程序中的 bytes.fromhex() 不会自动增加这些内容,因此必须确认抓包或设备日志中的实际字节流一致。
常见失败定位
端口无法打开时,先检查 <PATH> 是否正确,以及设备是否被其他程序占用。打开成功但一直读到空字节,则重点检查通信参数和设备是否真的会对当前请求应答;如果响应偶尔只有半帧,再进入协议层接收缓冲与边界解析,而不是简单提高 read() 长度。
当这段最小程序与终端工具能够得到一致的原始字节流后,再增加帧解析、校验、重试和业务状态处理。这样每增加一层功能,都有一个已经验证过的串口基础链路作为参照。