聊USART这个话题，对玩STM32的人来说，几乎是绕不开的第一道关卡。不管是串口打印调试信息、跟传感器模块通信，还是跟PC上位机对接，USART都是生态最成熟、也最容易上手的外设。很多人第一个外设是点亮LED，第二个就是它。这篇东西我不想写成Datasheet翻译，而是想以实际跑通为主，把“为什么这么配”“为什么这个值要这样算”讲清楚，再给出一套可以直接抄的收发程序，顺便把串口调试中最容易踩的坑都列出来。无论你是刚建好工程、准备点灯的新手，还是已经会点灯、想进一步搞懂通信原理的进阶玩家，这篇都适合你先收藏再看。
USART这块内容看似简单，实际上坑一点都不少。比如波特率误差、GPIO复用配置、中断标志位、半主机模式、DMA和中断的搭配，任何一个环节没处理好，现象都是同一个——串口没反应或者乱码。但反过来说，USART也是投入产出比最高的外设，你只要把底层逻辑吃透一次，后面学I2C、SPI、CAN这类通信协议都会轻松很多。下面我按自己的理解，从原理、配置、代码到排障，一步步拆给你看。
1. USART整体设计与思路拆解：先搞清楚它在系统里的位置
1.1 从UART到USART：搞懂底层逻辑比抄代码重要
USART的全称是Universal Synchronous/Asynchronous Receiver/Transmitter，通用同步/异步收发器。STM32家族里绝大多数芯片集成的叫USART，少部分叫UART。两者的差别就一个字母：同步能力。USART支持同步模式，多一根时钟线SCLK，可以在发送数据的同时输出时钟信号，用来驱动从设备；UART没有这根时钟线，纯异步通信。实际项目里90%的场景走的都是异步模式，所以我们平时嘴里的“串口”，默认识别成UART就行。
异步串行通信的核心，是通信双方约定同一个波特率，然后一根TX发、一根RX收，再共用同一个地。数据是按位（bit）一个个排队送的，不是一次传一个字节。就好比两个人面对面聊天，一句话里的字要按顺序说出来，对方按同样的语速听，才能完整接住。这里“语速”就是波特率，一句话的起止就是起始位和停止位。
从STM32系统架构的角度看，USART外设挂在APB总线上。F1系列里USART1挂APB2（最高72MHz），USART2和USART3挂APB1（最高36MHz），这一点在评估波特率误差的时候特别重要，后面我会专门算给你看。外设内部有三个核心寄存器：数据寄存器DR、控制寄存器CR1/CR2/CR3、状态寄存器SR。所谓“用USART收发数据”，本质就是往DR写数据、从DR读数据，再通过SR判断数据是否发完、是否收到。理解了这一层，你再看后面的代码就会觉得所有操作都顺理成章。
1.2 USART数据包结构：串口传的每一帧到底长什么样
很多教程上来就让你调库函数，从不讲通信协议本身，导致一遇到数据对不上就懵。我建议把帧结构先吃透。USART异步传输的最小单位是“帧”，一帧由这些部分组成：
| 帧字段 | 电平状态 | 作用 |
|---|---|---|
| 空闲态 | 高电平 | 线路空闲时保持高，相当于“没有说话” |
| 起始位 | 低电平，宽度1位 | 告诉接收方“我开始发了”，从高拉低这个跳变很关键 |
| 数据位 | 8位或9位，低位在前 | 真正的数据内容，一个字节按最低位先发 |
| 校验位（可选） | 奇校验或偶校验 | 用来粗略检错，不是必须的 |
| 停止位 | 高电平，宽度1位或2位 | 告诉接收方“这帧结束了” |
这里有几个新手容易绕晕的点：第一，线路空闲是高电平，起始位是拉低，接收方正是靠这个“高到低”的跳变来对齐数据位的；第二，数据位是低位先发，也就是说0x01实际在线上是10000000的顺序发出去的（从bit0到bit7）；第三，校验位只做校验，不算在数据里，如果开启了校验，实际有效数据位会少一位。这些细节决定了你解析数据包的逻辑，尤其是做Modbus这类协议的时候，帧边界判断全靠起止位和空闲电平。
1.3 为什么串口能和I2C、SPI“平起平坐”
这里把热词里老问的“USART、UART、I2C、SPI区别”一起讲掉。很多人以为它们是同一种东西，其实只是都属于串行通信大类而已。简单对比一下：
| 协议 | 时钟线 | 数据线 | 速率 | 典型场景 |
|---|---|---|---|---|
| UART/USART | 异步无时钟，USART同步可带SCLK | TX/RX两根 | 一般115200bps以内常用，高可到几Mbps | 调试打印、GPS、蓝牙、RS485 |
| I2C | SCL时钟 | SDA数据，半双工 | 100k/400k/1M | 传感器、EEPROM |
| SPI | SCK时钟 | MOSI/MISO，全双工 | 可达几十Mbps | Flash、屏幕、高速ADC |
一句话总结：USART胜在简单、成熟、线少、不需要时钟线，缺点是速率和实时性一般；I2C胜在连线最少但协议繁琐；SPI胜在快但占用引脚多。项目里选哪个，看的不是谁高级，而是场景匹配。早期学习阶段，USART是理解串行通信最好的切入点。
2. USART核心参数与配置细节：引脚、时钟、波特率三板斧
2.1 引脚复用与时钟使能：新手第一道坎
USART要工作，第一步不是写通信代码，而是把引脚和时钟配好。很多新手在这里就翻车了，因为串口没有任何反应，检查半天代码，结果是GPIO复用没配。以最常见的STM32F103C8T6为例，USART1的TX在PA9，RX在PA10。你要做的有三件事：
- 打开GPIOA的时钟，同时打开USART1的时钟；
- 把PA9配置为复用推挽输出GPIO_Mode_AF_PP，这是TX，由外设控制引脚输出；
- 把PA10配置为浮空输入或上拉输入GPIO_Mode_IN_FLOATING，这是RX，接收外部电平。
这里有个细节：TX模式为什么是复用推挽，而不是普通推挽输出？因为普通推挽是让GPIO模块控制引脚，而复用推挽是把这个引脚的输出控制权交给USART外设。如果你配置错了，代码写再多也没用。RX为什么可以是浮空输入？因为USART接收时会自己采样引脚电平，外部设备空闲时是高电平，浮空输入能直接读到状态。有些板子外部加了上拉电阻，那用浮空输入没问题；如果外部没有上拉，建议用上拉输入更稳。
另外不同STM32系列，GPIO配置方式差异很大。F1用标准库GPIO_Mode_AF_PP，F4/H7就要用GPIO_Mode_AF并调用GPIO_PinAFConfig指定复用功能。所以网上搜代码的时候，一定要先看清楚芯片型号和库版本，F1的代码直接拷到F4上跑，编译能过但实际工作不正常，因为引脚复用机制变了。
2.2 波特率计算：说人话就是“聊天语速”
波特率就是每秒传多少个符号（位）。通信双方必须用同一个波特率，否则你在这边说“你吃饭了吗”，对方那边听起来就是“你吃@#￥%”。USART的波特率不是随便设置的，它由外设时钟经过分频得到。F1的公式是：
波特率 = 外设时钟 / (16 × USARTDIV)
这里的USARTDIV是一个16位寄存器值，整数部分12位、小数部分4位。反过来算就是：
USARTDIV = 外设时钟 / (16 × 目标波特率)
举个例子：USART1挂在APB2上，F103默认系统时钟72MHz，那USART1外设时钟就是72MHz。如果要配置115200波特率，算一下：
72000000 / (16 × 115200) = 39.0625
所以USARTDIV的整数部分是39，小数部分是0.0625 × 16 = 1。换算成BRR寄存器的值就是0x0271，其中高12位是39，低4位是1。
如果配置9600波特率：
72000000 / (16 × 9600) = 468.75
整数部分是468（0x1D4），小数部分是0.75 × 16 = 12（0xC），BRR = 0x1D4C。如果你用标准库或HAL库，这些计算库函数内部都帮你做了，你只要传入波特率数值就行。但你必须理解这个机制，因为后面遇到“115200乱码但9600正常”这种诡异问题，就是波特率误差在作怪。用72MHz主频跑USART1，9600和115200实际误差都很小，几乎可以忽略；但如果换到USART2/3挂在36MHz的APB1上，某些波特率的误差就会变大，极端情况下就会乱码。碰到乱码时，第一反应应该是拿计算器算一遍误差，而不是急着换芯片。
2.3 三种收发方式怎么选：轮询、中断、DMA
USART收发数据有三种模式，很多教程会一股脑教，但初学者很容易搞混。我用最直白的话区分一下：
- 轮询发送：CPU死等发送寄存器空闲。代码简单，逻辑清晰，适合打印日志这种不频繁、不紧迫的场景。
- 轮询接收：同样死等接收标志，但缺点很致命——在等待的过程中CPU什么都干不了，一旦没有数据到，程序就卡在循环里。所以除了极简单的Demo，我基本不推荐主循环里死等接收。
- 中断收发：收到一个字节或发送寄存器空了，触发中断，CPU在中断里处理完马上回去干别的事。这是实际项目中最常用的方式，尤其是接收。
- DMA收发：数据搬运不经过CPU，由DMA控制器直接在外设和内存之间搬。适合大数据量、高速率场景，比如用串口刷固件、传输音频等。
我个人建议的学习路径是：先老老实实用轮询把收发跑通，理解了标志位和流程；然后改成中断接收，因为这是实际项目使用频率最高的；最后有余力再上DMA。上来就抄DMA代码，遇到问题你根本不知道是DMA配置错了还是USART配置错了，排查难度翻倍。
3. 从零跑通USART发送与接收：一份带注释的实测代码
3.1 工程准备：标准库、HAL库和CubeMX到底怎么选
现在STM32开发环境比较多，有人用标准库，有人用HAL库加CubeMX图形化配置，还有人直接操作寄存器。我的看法是：F1系列、学习阶段，标准库非常合适，因为它的函数名直接对应硬件寄存器，代码里能看清楚“现在操作的是哪个寄存器、触发的是什么逻辑”；HAL库封装层次更高，CubeMX点点点就能生成初始化代码，但隐藏了很多细节，一旦出问题不好排查。
如果你用CubeMX，生成代码的时候要注意选择正确的芯片型号，热词里也有人问“cube程序更改单片机型号”。CubeMX实际上支持在工程后期通过Device Selector切换同系列的不同型号芯片，但切换后要重新生成代码并检查引脚配置，因为不同型号的引脚数和外设数量不一样，直接替换往往会报错。标准库的话，F1系列需要手动新建工程模板，把启动文件、内核文件、标准外设库加进去。Keil里安装对应的芯片包是前提，这里就不展开讲了，网上教程很多。
为了让你看清数据通路，下面代码我用标准库手写，以STM32F103的USART1为例，亲测可跑。
3.2 发送实现：查询发送和printf重定向
发送的核心流程是：往数据寄存器DR写一个字节，然后等待发送完成标志。标准库代码如下：直接跑通的USART1初始化函数：
void USART1_Init(uint32_t baud) { GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; // 1. 打开时钟：GPIOA和USART1都在APB2上 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_USART1, ENABLE); // 2. 配置PA9为TX复用推挽输出 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // 3. 配置PA10为RX浮空输入 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &GPIO_InitStructure); // 4. 配置USART参数，8数据位、1停止位、无校验、无硬件流控 USART_InitStructure.USART_BaudRate = baud; USART_InitStructure.USART_WordLength = USART_WordLength_8b; USART_InitStructure.USART_StopBits = USART_StopBits_1; USART_InitStructure.USART_Parity = USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, &USART_InitStructure); // 5. 使能USART USART_Cmd(USART1, ENABLE); }然后写一个发送单字节的函数。发送最关键的是等待TXE标志，即发送数据寄存器为空。注意，TXE标志不是“发送完成”，而是“数据寄存器已空，可以写入下一个字节”，如果写太快，前一个字节可能还没移出到移位寄存器，数据会覆盖。
void USART1_SendChar(uint8_t ch) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET); USART_SendData(USART1, ch); }再把printf重定向到串口，这是串口调试最常用的手段。在Keil中，你需要包含stdio.h，然后重写fputc函数：
int fputc(int ch, FILE *f) { USART1_SendChar((uint8_t)ch); return ch; }这里有个大坑：如果你在Keil里使用标准库的printf，而没有勾选微库（Use MicroLIB），fputc里的底层实现会启动半主机模式，运行时会卡死或者程序进HardFault。解决办法有两个：要么在Options for Target的C/C++页面勾选Use MicroLIB，要么在代码里屏蔽半主机模式（实现_sys_exit之类的函数）。新手用微库最省事。
3.3 接收实现：查询、中断、空闲中断
接收比发送复杂，因为“对方什么时候发数据”是不可预测的。查询接收的代码长这样：
uint8_t USART1_ReceiveChar(void) { while (USART_GetFlagStatus(USART1, USART_FLAG_RXNE) == RESET); return (uint8_t)USART_ReceiveData(USART1); }读USART_ReceiveData会自动清除RXNE标志。但这个函数放在主循环里，一旦没有数据，CPU就死死卡在这个等待里，什么活都干不了。所以我强烈建议用中断接收。初始化里加上这行：
USART_ITConfig(USART1, USART_IT_RXNE, ENABLE); NVIC_InitTypeDef NVIC_InitStructure; NVIC_InitStructure.NVIC_IRQChannel = USART1_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0; NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStructure);然后在中断服务函数里收数据：
uint8_t rx_buffer[64]; volatile uint8_t rx_index = 0; void USART1_IRQHandler(void) { if (USART_GetITStatus(USART1, USART_IT_RXNE) != RESET) { uint8_t ch = USART_ReceiveData(USART1); if (rx_index < 64) { rx_buffer[rx_index++] = ch; } } }注意，中断服务函数里不要做复杂的事情，比如解析协议、调用printf、操作大型数组。中断里应该只做“把数据快速存下来”这一步，解析和处理放到主循环里。为什么？因为中断服务函数执行时间过长，会导致串口新到的数据来不及处理，触发ORE溢出错误。我见过有人直接在中断里调用printf打印收到的数据，结果数据一多就死机，折腾了一整天。
更进一步，如果你想接收一包不定长的数据，比如一个完整的AT指令或Modbus帧，那就要用到空闲中断IDLE。所谓空闲中断，是指接收完一帧数据后、线路空闲下来时触发的中断。利用它，你可以判断“这一包数据已经收完了”。配置方式是在刚才的基础上多开一个中断：
USART_ITConfig(USART1, USART_IT_IDLE, ENABLE);中断函数里这样处理：
void USART1_IRQHandler(void) { if (USART_GetITStatus(USART1, USART_IT_RXNE) != RESET) { // 取出数据存到缓冲区 } if (USART_GetITStatus(USART1, USART_IT_IDLE) != RESET) { // 这里表示一帧数据收完了，可以置一个标志位 frame_ready = 1; // 注意：IDLE标志的清除方式是先读SR，再读DR USART_ReceiveData(USART1); } }这里有个最隐蔽的坑：IDLE中断标志不能像RXNE那样通过读DR自动清除，你需要先读SR寄存器再读DR寄存器，才能把IDLE位清掉。很多人在中断里死循环、反复进入IDLE中断，就是因为没清标志。搞定这一块，你就能优雅地实现“不定长一包数据接收”，这也是很多实际项目的雏形。
3.4 实测记录：USB转TTL、回环测试、逻辑分析仪看波形
程序写完后，最蠢的验证方法也要讲一下。你需要一个USB转TTL模块，常见的CH340或者CP2102都可以。接线方式是：STM32的PA9接到模块的RX，PA10接到模块的TX，然后把两个设备的GND接到一起。别小看共地这一点，很多人串口收不到数据，就是忘了共地，两边参考地不一样，电平判断全是乱的。注意，STM32的引脚是3.3V电平，USB转TTL模块的跳线帽如果选择5V供电输出，那你给模块供电没问题，但通信引脚的逻辑电平取决于模块设计，大部分模块的串口逻辑电平是3.3V，但一些老式模块是5V电平，接到STM32的RX上会有风险。保险起见，用支持3.3V逻辑电平的模块。
接好线后，打开串口调试助手，波特率选115200，数据位8、停止位1、无校验，先发送一个字节，看STM32能否收到；再用STM32主动发送“Hello STM32”，看PC能否收到。我建议额外做一步回环测试：如果软件里把收到的数据原样发回去，PC发送什么串口助手就收到什么，基本可以确定USART硬件链路是通的。这里有个小技巧：用十六进制显示模式来观察，不要只盯ASCII，因为很多数据包不是可打印字符，十六进制显示才能看出真实内容。
如果你手头没有真实硬件，用Proteus仿真也可以完整仿真STM32的串口收发，对初学者来说是低成本验证的好方法。但仿真终究是仿真，时序和真实硬件有差异，我建议有条件还是上板子实测。逻辑分析仪是排查串口问题的利器，采样率至少选1MHz以上，把TX或RX引脚夹住，发送一段数据，你就能在波形上清楚看到起始位、数据位、停止位，还能算实际波特率是否符合预期。没有逻辑分析仪的话，用示波器也够用，只是触发抓取稍麻烦。
4. 常见问题与排障经验合集：从坑里总结的干货
4.1 高频翻车现场：乱码、收不到、一收就死机
这里把我在各个技术社区、群里看到的以及自己踩过的问题整理成一张速查表，建议直接存下来，遇到问题照着排查，效率至少快一倍：
| 现象 | 最常见原因 | 排查顺序 |
|---|---|---|
| 串口完全没输出 | 引脚复用没配、时钟没开、TX/RX接反、没共地 | 先查硬件接线，再查GPIO配置，最后查时钟是否使能 |
| 输出乱码 | 波特率不一致、主频和Boot引脚配置不匹配、外部晶振频率不对 | 核对统一波特率，检查SystemInit时钟配置，用逻辑分析仪量实际波形 |
| 发送死循环卡住 | TXE标志没正确清，或GPIO配置错误导致外设不工作 | 单步调试看是否卡在while循环，检查GPIO模式是否为AF_PP |
| 中断收不到数据 | NVIC优先级没配置、RXNE中断没使能、引脚配置成普通输入 | 检查中断优先级分组，检查USART_ITConfig是否调用 |
| 一收数据就HardFault | 数组越界、缓冲区溢出、栈溢出 | 检查中断里写入数组的下标是否越界，降低缓冲区写速度 |
| 收几帧后不再进中断 | ORE溢出错误没处理的话，在某些库版本会产生连锁问题 | 在中断里检查ORE标志，不要积压未读数据 |
网上有个高频问题“stm32 cfsr 为0x00008200是什么错误”，这个值是SCB->CFSR寄存器的一部分，0x00008200通常指向总线错误或用法错误，常见诱因就是中断里数组越界写了非法地址、栈溢出，或者DMA配置的地址不合法。串口中断接收时最容易触发这类问题，因为你在中断里操作缓冲区，一旦下标处理不严谨，越界写坏栈顶，程序就跑飞了。解决办法就是检查所有中断里对数组的操作，给下标加边界保护。
另外一个高频问题“stm32延时函数delay卡死”。这个和串口关系也很大，如果delay用的是SysTick中断方式，而你的串口中断优先级比SysTick低，串口数据持续进入时，SysTick中断得不到响应，delay就永远等不到中断标志，表现为“程序卡死”。有些新手误以为是串口冲突，其实只是中断优先级没配好。合理的做法是：把SysTick或者其他时间基准的优先级设得比串口中断低，或者不要在串口中断服务函数里调用任何延时函数。
4.2 串口调试三件套：printf逐点打印、环形缓冲区、逻辑分析仪
排障效率高的人不是运气好，而是工具用得好。我强烈建议新手掌握这三招：
第一招，printf逐点打印。在代码关键路径上打日志，程序跑到哪里、变量值是多少，一目了然。要特别注意，打印语句本身也会消耗时间，如果放在高频中断里可能干扰时序，尽量把日志放到主循环或低频代码路径。
第二招，简单的环形缓冲区。中断收数据、主循环解析数据，两个模块之间靠环形缓冲区解耦。这个结构非常简单，核心是一个数组加两个下标（写指针和读指针），写入时只有中断修改写指针，读取时只有主循环修改读指针，天然避免并发冲突。环形缓冲区能有效解决我上面提到的“中断里处理太复杂导致数据丢失”的问题，建议每个做串口项目的人都封装一个。
第三招，逻辑分析仪抓波形。遇到莫名其妙的乱码、丢字节，与其盲猜，不如直接看波形。逻辑分析仪能直观显示时序，你一眼就能看出波特率是否偏了、停止位是否正常。有条件的话，我还喜欢用两个串口做交叉验证，一个专门发测试数据，一个打印内部状态，缩小问题范围。
4.3 延伸方向：Bootloader升级、Modbus总线、低功耗唤醒
USART学会了别停在这里，它往深处走有很多实用方向。比如在线升级（IAP），就是利用USART作为下载通道，通过Bootloader程序接收升级固件，然后写入Flash并跳转。热词里有人提到“stm32 flash loader demonstrator”和“bootloader驱动下载”，这都是USART IAP的典型应用。实现思路是：芯片上电先跑Bootloader，串口收数据，收完校验、写Flash，完成后跳转到App。注意Flash访问要处理中断向量表偏移、跳转前关闭外设中断这些细节。
再比如RS485总线。USART本身是TTL电平，距离短、抗干扰差，但通过外接MAX485等芯片，就能转成差分信号，传输距离可达上千米。热词里“stm32和变频器通讯”“stm32控制伺服电机485”这些场景，底层基本都是USART加RS485的用法。Modbus RTU是这类应用里最常见的协议，帧结构就是基于USART这个“一帧收发”模型定出来的。理解了USART的数据包结构，再去看Modbus RTU的报文格式，你会觉得前面那套原理没有白学。
还有低功耗场景。MCU进入休眠模式后，USART仍可以作为唤醒源，利用RXNE或WAKE中断把芯片从睡眠中唤醒。但要注意，唤醒后需要重新检查接收数据是否有效，因为在低功耗模式下，接收时钟可能被关闭，前几个字节可能已经丢失。这些都是实打实的项目细节。
4.4 从“跑通”到“稳定”：代码健壮性的一些个人建议
最后这段算是个人心得。很多新手写串口程序，跑通一次就完事了，但实际项目里你会发现，串口程序“好写”但“写稳”很难。我后来总结出几条经验：
第一，所有缓冲区操作都必须有边界检查。不管是用数组、指针还是DMA，越界写是最隐蔽的杀手。第二，串口中断里只做“保存现场”级别的最小操作，复杂处理一律丢给主循环。第三，对外部数据的校验不能省，帧头、帧尾、长度、累加和，至少做一种，因为串口在工业现场被干扰时，什么离谱数据都可能出现。第四，初始化顺序也有讲究：先配置GPIO，再配置USART参数，最后开中断。顺序反了，可能在初始化过程中就触发一次中断，处理到半初始化的状态，程序直接跑飞。
我记得自己第一次调USART和传感器通信时，数据总是隔几秒就错一个字节，排查了一整天都没头绪，后来用逻辑分析仪才发现是波特率有微小误差，长时间累计就丢位了。从那之后，我再也不敢忽略波特率误差的问题。USART这个东西，入门简单，精通难，但只要你肯把原理吃透、把工具用好，它能陪你走很远的路。希望这篇实战内容能帮你少踩几个我踩过的坑，后面的路就顺了。
