上周帮人看一块 F103 最小系统板。串口助手一打开,满屏 锟斤拷,偶尔蹦两个问号。他已经改了两天代码,MX_USART1_UART_Init 重新生成过三遍,换过两根 USB 转 TTL,最后怀疑芯片坏了。
我看了一眼时钟配置:HSE Frequency 那个框里填的是 25 MHz。板上焊的晶振是 8 MHz。
那天最后改的就是这一个数字,25 改成 8。代码一行没动。
一、先说一个反着的结论
主频 72 MHz、外部晶振 8 MHz 这个最常见的搭配,115200 和 9600 这两档波特率算下来是整除的:USARTDIV 落在整数或者 1/16 的格子上,误差是 0。这种配置下,乱码几乎不可能是「波特率分频算错」。
我以前也信过「乱码就是波特率不对」,然后花半天去改 BRR,改完还是乱。真正会错的是更前面一层:你告诉代码的时钟,和芯片实际跑的时钟,不是一个数。
下面按「30 秒能验的」到「要拿示波器的」排序。先给判别表,照着对号入座比读文字快。
| 现象 | 最可能的原因 | 一步验证 |
|---|---|---|
| 全部字节都乱,一个能认的都没有 | 波特率整体偏了(时钟源错 / 挂错总线) | 用下面的脚本算一遍实际速率 |
| 每个字节的最高位丢了,可打印字符变成怪符号 | 校验位不一致(代码 8N1,对端 8E1) | 两边参数并排看一眼 |
| 前半句正常,往后开始飘,隔几个字节错一个 | 溢出标志 ORE 没清,收不过来在丢字节 | 读 USART_SR 的 ORE 位 |
| 特定字符错,其他全对 | 编码问题,不是串口问题 | 换成纯 ASCII 数字再发一遍 |
| 一个字符都收不到 | 引脚复用 / 时钟没使能 / 收发线接反 | 先量 TX 脚有没有波形 |
这张表能挡掉大部分。剩下三条要展开说,因为它们的表现都像「代码没问题」。
二、时钟源:最像「代码没问题」的那一类
HSE Frequency 这一项,很多人是从别的工程抄配置抄过来的。F4 系列常见 25 MHz,F103 最小系统板常见 8 MHz。填错之后会发生什么:
代码以为主频是 225 MHz(25 × 9),于是按 225 MHz 去算 USART 的分频。而芯片实际跑在 72 MHz(8 × 9)。实际波特率只有设定值的约 32%,全乱码,但程序其他部分完全正常------灯照闪、定时器照跑、ADC 照采,只有串口是坏的。这就是它骗人的地方:你会觉得「时钟肯定没问题,不然整个板子都起不来」。
所以「程序能跑」不能拿来证明时钟配置对。要单独验:
- 看
SystemCoreClock的值,和你以为的是不是同一个数; - 或者反过来,用定时器做一个已知长度的延时,拿示波器/逻辑分析仪量一下实际时间。
三、挂错总线:USART1 和 USART2 不是一个时钟
STM32F103 上,USART1 挂在 APB2(72 MHz),USART2/USART3 挂在 APB1(36 MHz)。从 USART1 的代码复制到 USART2 用,初始化函数里那个「PCLK」如果还写着 72 MHz,算出来的分频只有该有的一半,实际速率是设定值的两倍,一样全乱。
CubeMX 生成的代码一般不会错,因为它是按你选的引脚推的。会错的是手写初始化、或者从别的工程整段搬过来的那些。
四、ORE:前半句正常,后面开始飘
这一条最容易被当成「波特率还是不准」,因为它不是全乱,是时好时坏。
USART 的接收寄存器只有一个字节的缓冲。上一字节没被读走、下一字节又来了,硬件就置 ORE 溢出标志,新来的字节丢掉。表现就是:发一串数字,前几位对,中间开始错位,错的还不是固定位置。
处理上有个坑:ORE 是「读 SR 再读 DR」这个序列来清的,只读 DR 不清、只读 SR 也不清。清得不干净,它会立刻再置一次,看起来像根本没清掉。我在这一条上绕过一次远路------当时以为是中断优先级问题,把 NVIC 调了半天。实际是清除序列写反了。
五、一段能直接用的脚本:先算数,再改代码
乱码第一件事不是改代码,是算一遍你这套时钟下每档波特率的实际误差。下面这段跑完会把 USARTDIV 的整数部分、小数部分和实际速率都打出来,误差超过 2% 的那一行就是嫌疑。
python
def calc(fck, baud, over8=False):
div = fck / (8 * baud) if over8 else fck / (16 * baud)
mant = int(div)
frac = round((div - mant) * (8 if over8 else 16))
# 小数部分进位
if frac == (8 if over8 else 16):
mant, frac = mant + 1, 0
real = fck / ((8 if over8 else 16) * (mant + frac / (8 if over8 else 16)))
return mant, frac, real, (real - baud) / baud * 100
for fck, name in [(72_000_000, "APB2 USART1"), (36_000_000, "APB1 USART2/3")]:
for baud in (9600, 115200):
m, f, real, err = calc(fck, baud)
print(f"{name:14} {baud:6} BRR=0x{(m << 4) | f:03X} 实际 {real:9.1f} 误差 {err:+.3f}%")
三档输出(我自己跑过的):
ini
APB2 USART1 9600 BRR=0x1D4C 实际 9600.0 误差 +0.000%
APB2 USART1 115200 BRR=0x271 实际 115200.0 误差 +0.000%
APB1 USART2/3 115200 BRR=0x138 实际 115384.6 误差 +0.160%
看到没有:72 MHz 下 115200 是精确整除的,BRR 就是 0x271。所以「72 MHz + 115200 乱码,是分频算错」这个判断,从数学上就不成立。真乱,问题一定在别处。
再算一个反例,就是开头那块板子:代码按 225 MHz 算,实际 72 MHz。
python
m, f, real, err = calc(225_000_000, 115200)
print(f"按 225MHz 算:实际速率只有 {72000000 / (16 * (m + f/16)):.0f}")
算出来的实际速率在 36,000 出头,只有 115200 的三成。三成的速率,对端按 115200 采样,每个字节都采在半路上------全乱,而且乱得没有任何规律。
六、手册这一环,我是让 AI 帮我翻的
上面这些位段名(DIV_Mantissa、DIV_Fraction、OVER8)我一年翻不到两次手册,记不住。RM0008 一千多页,为了查三个位段去翻目录不值。
我的做法是把手册切块、每块开头标页码,然后只用三种问法:
| 问法 | 什么时候用 | 写法 | 怎么核 |
|---|---|---|---|
| 定位式 | 不知道在哪一章 | 「这份手册里所有关于 USART 波特率设置的描述在第几页?逐条列页码和原文」 | 抽两处回原文对 |
| 抽取式 | 要位段定义 | 「把 USART_BRR 的所有位段抽成表:位名 / 位置 / 复位值 / 页码」 | 数行数、对复位值 |
| 对照式 | 拿代码对规则 | 「下面这段初始化和手册第 X 章逐条对照,输出符合 / 不符合 / 手册未提及」 | 只验「不符合」项 |
顺序不能反:先抽取,再对照。先让它把位段拉成表,人工过一遍确认没漏,再拿这张表去对代码。反过来做,对照的输入本身就是没验证过的,错了都不知道错在哪一环。
我也踩过:拿抽取式要一张位段表,它把两个相邻位段并成了一行,输出流畅、格式漂亮,我照着配了一次,配置直接不生效。回头对原文表格才发现是拼接错。从那以后位段表我必抽查 20%,数行数、对复位值------这个动作花两分钟,比调试两小时便宜。
AI 在这里只干定位,不干判断。 它十几秒能把「BRR 在哪一页、位段怎么分」给你,但「你这个场景下哪个配置是致命的」它不知道。手册里那种「通信中不要改 BR,先关 UE」的约束,它不一定主动提,你得问到。
七、这套方法什么时候不灵
得说清楚,上面全是配置层的排查。物理层它一点管不了:
- 地线没共。 两块板子各自供电,只接了 TX/RX,没接 GND,共模电压飘,收到的就是乱码。所有寄存器都对也没用。
- 线太长、速率太高。 杜邦线超过半米跑 115200 就开始丢字节,降到 9600 立刻好------这种情况你会误判成「波特率配置有问题」,其实是线的问题。
- 两边电平不匹配。 3.3V 的 TX 直接怼 5V 的 RX,能用,但边界上开始出错。
- ORE 清了又置。 如果中断里读得比来得慢,清完立刻又溢出,看着像没清。这是吞吐问题,不是清除序列问题。
还有一条关于 AI 的:它读手册快在定位,慢在理解。手册里「顺便看到」的东西------比如某个引脚在复用后原来的功能就没了------问答式阅读会直接漏掉,而这往往是后面调试最救命的信息。
八、一句实话
那块板子两天没白折腾,虽然最后改的是一个输入框。他排查出来的那些「确定不是这里」,正好把范围缩到一个格子上------只是没人想到那个格子叫 HSE Frequency。
下次再遇到全乱码,顺序建议是:先跑脚本算误差,再对一眼校验位,最后才动代码。算出来误差是 0,就掉头去查物理层,别在 BRR 上耗时间。