解决Python连接STM32串口失败或数据乱码问题
针对Python使用pyserial连接STM32微控制器时常见的端口打开失败、权限拒绝、无响应以及数据乱码等问题,提供从硬件接线、电平共地、时钟树波特率配置到编码格式与缓冲区的完整排查步骤与解决方案。
在使用 Python 脚本(基于 pyserial 库)与 STM32 开发板进行串口交互时,“串口打不开”与“读取内容乱码”是两个最高频出现的故障。解决这两个问题的核心路径非常明确:连接失败通常源于端口号混淆、进程占用或操作系统权限配置;而数据乱码则主要集中在电气共地缺失、双方波特率与时钟树配置漂移,以及字符编码解析不匹配。只要按照物理接线、通信参数、底层时钟和软件协议的次序逐层排查,就能快速恢复稳定通信。
一、Python 无法连接串口或打开报错的排查
在运行 Python 代码调用 serial.Serial() 时,最常见的异常有两种:SerialException: could not open port 和 PermissionError: Access is denied。
1. 端口名称错误或设备未被系统识别
在 Windows 环境下,串口名称通常为 COM3、COM4 等;在 Linux 或 macOS 下,通常为 /dev/ttyUSB0 或 /dev/tty.usbserial-xxx。如果直接硬编码端口名,由于重新插拔 USB-TTL 模块可能导致端口号变更,代码就会抛出无法打开端口的错误。
推荐先使用 serial.tools.list_ports 动态枚举当前系统可见的串口设备,确认芯片型号(如 CH340、CP2102、FT232)对应的具体设备路径:
import serial.tools.list_ports
ports = serial.tools.list_ports.comports()
for p in ports:
print(f"端口: {p.device}, 描述: {p.description}, 硬件ID: {p.hwid}")
2. 端口被其他软件独占
串口具有排他性,同一时刻只能被一个进程打开。如果打开了 Keil 调试监视器、SSCOM、VOFA+ 等串口助手,或者上一次运行的 Python 脚本异常终止未释放句柄,当前脚本就会直接报权限拒绝错误。
- 彻底关闭所有正在占用该串口的上位机软件。
- 在任务管理器中检查是否存在残留的后台
python.exe进程,若有则强制结束。 - 在 Linux 系统下,非 root 用户访问
/dev/ttyUSB0默认可能报权限不足,可通过命令sudo usermod -aG dialout $USER添加用户组后注销重新登录。
二、物理连接与电气特性排查
很多连接无响应或收到全零/全0xFF的情况,并非软件代码问题,而是底层接线错误或缺少共地参考点。
1. TX 与 RX 必须交叉连接
串口通信为全双工异步传输。发送端(TXD)必须连接接收端(RXD):
- USB-TTL 的
TXD接 STM32 的RXD(例如 PA10)。 - USB-TTL 的
RXD接 STM32 的TXD(例如 PA9)。 - 如果直连(TX-TX、RX-RX),两端均为输入/输出冲突,Python 永远无法收到任何数据。
2. 必须保证共地(GND 连通)
TTL 电平是以地电平(0V)作为基准参考的。如果 STM32 采用独立锂电池或外部稳压电源供电,而 USB-TTL 插在电脑 USB 口,两者的地电位可能存在数伏特甚至更高的浮动电压差。没有连接 GND 时,逻辑 “0” 和 “1” 无法被正确定界,接收端将出现连续的高低电平抖动,导致 Python 收到一长串 0x00、0xFF 或完全无法解析的乱码字符。
三、波特率不匹配与 STM32 时钟树漂移
波特率决定了双方每个数据位持续的时间长度(例如 115200bps 下每位约 8.68 微秒)。若双方采样时钟不一致,采样点就会偏离比特窗口中心,造成采样错误并生成乱码。
1. 双方通信参数必须一致
串口通信包含四个基础参数:波特率(Baudrate)、数据位(Data bits)、校验位(Parity)和停止位(Stop bits)。工业和嵌入式开发最通用标准是 8-N-1(8位数据位,无校验,1位停止位)。
如果在 STM32 的 HAL 库初始化中设置为 115200,而 Python 端设置为 9600,或者奇偶校验设置不一致,数据帧结构将被彻底打乱,表现为连续的非法字节。
2. STM32 时钟树与外部晶振(HSE)实际频率核对
在 STM32CubeMX 中生成代码时,RCC 配置中的外部高速时钟(HSE)频率默认可能设为 8MHz 或 25MHz。如果读者使用的核心板焊接的是 12MHz 晶振,但 CubeMX 中依然保留默认的 8MHz,虽然代码依然可以编译下载,但系统的倍频计算(PLL)完全错误,导致实际给串口外设 APB1/APB2 提供的时钟与预设产生严重偏差。即便在代码中写 huart1.Init.BaudRate = 115200,硬件生成的实际波特率可能是 172800,直接导致上位机收到不可读乱码。
解决办法:查看板载晶振表面丝印频率(如 8.000 或 12.000),确保 stm32xxxx_hal_conf.h 中的 HSE_VALUE 与实际晶振频率严格一致。
四、字符编码与换行定界符处理
当 Python 能够正常接收英文字符和数字,但一旦传输中文就报 UnicodeDecodeError 或显示乱码字符时,问题出在编码格式上。
1. GBK 与 UTF-8 编码不一致
国内很多 Keil MDK 默认的文件编码是 GB2312 或 GBK,STM32 中的字符串常量(如 printf("温度: %d\r\n", temp);)在编译后直接以 GBK 编码保存在固件中。如果 Python 代码中使用 line.decode('utf-8') 解码,由于 GBK 双字节编码不符合 UTF-8 规范,会直接抛出解码异常。
推荐处理方式:在 Python 端指定使用 gbk 解码,或者将 Keil 编辑器与源文件保存格式切换为带签名或无签名的 UTF-8。在生产脚本中,建议加入容错参数 errors='replace':
# 优先尝试 utf-8,失败则回退到 gbk,避免异常退出
try:
text = raw_bytes.decode('utf-8')
except UnicodeDecodeError:
text = raw_bytes.decode('gbk', errors='replace')
2. 缓冲区与换行符阻塞(readline 假死)
调用 ser.readline() 时,该方法会持续读取直到接收到 \n(0x0A)换行符,或者达到超时时间 timeout。若 STM32 端发送数据使用的是 HAL_UART_Transmit() 且没有在末尾追加 \n,Python 将会一直阻塞直到超时,导致接收响应极其迟缓甚至看似“断连”。
五、常见问题与解决对策速查
六、标准稳定的 Python 串口通信实现范例
下面给出一段具有完整异常捕获、自动寻找有效编码及安全关闭资源的 Python 串口通信代码,适用于与 STM32 进行双向文本数据收发:
import serial
import time
import sys
def run_serial_client(port='COM3', baudrate=115200, timeout=1.0):
try:
# 打开串口,指定 8-N-1 格式与超时时间
ser = serial.Serial(
port=port,
baudrate=baudrate,
bytesize=serial.EIGHTBITS,
parity=serial.PARITY_NONE,
stopbits=serial.STOPBITS_ONE,
timeout=timeout
)
except serial.SerialException as e:
print(f"[错误] 无法打开串口 {port}: {e}", file=sys.stderr)
return
print(f"[成功] 成功连接 {port},波特率 {baudrate}")
# 丢弃初始化时可能存在的残余乱码数据
ser.reset_input_buffer()
ser.reset_output_buffer()
try:
# 向 STM32 发送一条握手指令(包含换行符)
ser.write(b"PING\r\n")
while True:
# 读取一行数据,遇到 \n 结束或触发超时
raw_line = ser.readline()
if not raw_line:
continue
# 兼容处理 UTF-8 与 GBK 编码
try:
line_str = raw_line.decode('utf-8').strip()
except UnicodeDecodeError:
line_str = raw_line.decode('gbk', errors='replace').strip()
print(f"收到 STM32 数据: {line_str}")
time.sleep(0.01)
except KeyboardInterrupt:
print("\n用户手动终止连接")
finally:
ser.close()
print("串口已安全释放")
if __name__ == "__main__":
run_serial_client(port="COM3", baudrate=115200)
TXD 和 RXD 引脚短接。运行上述 Python 脚本发送数据,若能原样收回,则说明 PC、驱动及 Python 环境完全正常,故障范围即可锁定在外部接线、共地或 STM32 的固件配置上。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









