1. 项目概述：从寄存器视角理解STM32串口通信

搞嵌入式开发，尤其是玩STM32的，USART（通用同步异步收发器）绝对是绕不开的一个外设。无论是调试打印、设备间通信，还是连接GPS、蓝牙模块，串口都是最常用、最直接的接口。很多教程和库函数（比如HAL库、标准库）把底层细节封装得很好，几行代码就能让串口跑起来，这固然方便，但一旦通信出问题，比如数据收不到、波特率不对、偶尔丢帧，新手往往就懵了，只能对着代码干瞪眼。

我当年也踩过不少坑，后来发现，问题的根子大多出在对寄存器理解不透彻上。库函数是工具，但寄存器才是硬件的“语言”。直接操作寄存器听起来有点“硬核”，但它能让你真正掌控硬件，理解数据是如何一位一位被发送和接收的，中断是如何被触发的，各种标志位又代表了什么状态。这份笔记，就是把我自己学习STM32 USART寄存器时梳理的核心内容、配置步骤和踩过的坑记录下来。目标不是替代库函数，而是为你提供一份“底层地图”。当库函数搞不定，或者你想追求极致的效率和可控性时，这份地图能帮你快速定位问题，甚至自己动手写出更精悍的驱动。

我们将聚焦于STM32最经典的USART1（通常挂在APB2总线上，速度更快），以查询和中断这两种最基础、也最重要的模式为例，拆解每一个关键寄存器的作用，并手把手完成配置。你会发现，抛开库函数的神秘面纱，底层配置的逻辑其实非常清晰和直接。

2. 核心需求解析：为什么必须懂寄存器？

在开始翻数据手册之前，我们先明确两个核心需求，这决定了我们学习寄存器的方向和深度。

2.1 需求一：实现精准可控的通信过程

库函数提供了HAL_UART_Transmit()和HAL_UART_Receive()这样的接口，它们内部处理了缓冲区管理、超时和错误处理，属于“任务级”接口。但在某些场景下，我们需要更精细的控制：

• 极低功耗应用：在等待接收数据时，希望MCU进入休眠模式，仅由串口接收中断唤醒。你需要精确知道哪个标志位能触发中断，以及如何配置。
• 自定义协议解析：例如，需要判断每一个字节的奇偶校验位是否正确，并在出错时立即重发。这就需要直接访问状态寄存器中的奇偶错误标志位。
• 高实时性要求：使用DMA传输时，需要精确控制何时传输完成、缓冲区是否半满，这些状态都体现在特定的寄存器标志位上。

如果只懂调用库函数，面对这些需求就会束手无策。理解寄存器，就是获得了直接与硬件对话的能力，能够按照你设想的精确时序和逻辑来控制通信流程。

2.2 需求二：具备高效的调试与故障排查能力

串口不通，是嵌入式新手最常见的“噩梦”之一。可能的原因非常多：时钟源不对、波特率计算错误、引脚复用没开启、中断未使能或优先级设置冲突、甚至硬件流控制引脚接错。库函数往往用一个HAL_UART_Init()函数掩盖了所有这些步骤。

当问题发生时，如果你理解寄存器，排查思路会非常清晰：

1. 查时钟：USART的时钟是否使能？波特率寄存器BRR的值计算对了吗？
2. 查配置：数据位、停止位、校验位配置寄存器CR1/CR2写对了吗？引脚复用寄存器AFR配置了吗？
3. 查状态：发送数据寄存器空标志TXE和发送完成标志TC是什么状态？接收寄存器非空标志RXNE置位了吗？
4. 查中断：中断使能寄存器CR1中的TXEIE或RXNEIE打开了吗？NVIC中的中断通道使能了吗？

你可以像侦探一样，通过读取这些寄存器的值，一步步缩小问题范围。这份笔记的目的，就是让你成为能解决这些问题的“侦探”，而不是只会重启开发板或重刷代码的“用户”。

3. USART核心寄存器家族详解

STM32的USART寄存器数量不少，但核心的、需要我们手动配置和关注的，可以归纳为以下几类。我们以STM32F1系列（内核为Cortex-M3）的USART1为例进行说明，其他系列或USART外设原理相通，寄存器名称和位定义可能略有差异，需查阅对应数据手册。

3.1 控制寄存器（CR1/CR2/CR3）：设定通信规则

控制寄存器是配置串口工作模式的核心。

• USART_CR1 (Control Register 1)：这是最重要的控制寄存器。

  • UE (USART Enable)：位13，总开关。必须置1，USART外设才会上电工作。注意：通常在其他参数配置完成后，最后才打开此位。
  • M (Word Length)：位12，字长。0代表8数据位（最常见），1代表9数据位。9位模式常用于带奇偶校验或自定义多机通信。
  • PCE (Parity Control Enable)：位10，奇偶校验控制使能。置1后，会根据PS位选择奇校验或偶校验。
  • PS (Parity Selection)：位9，奇偶校验选择。0为偶校验，1为奇校验。
  • TXEIE (TXE Interrupt Enable)：位7，发送数据寄存器空中断使能。当发送数据寄存器（TDR）为空时，若此位置1，会产生中断。适用于查询或中断发送模式。
  • TCIE (Transmission Complete Interrupt Enable)：位6，发送完成中断使能。当一帧数据（包括停止位）完全从移位寄存器发出后，若此位置1，会产生中断。常用于判断一包数据是否完全发送完毕，比如在DMA发送完成后关闭发送器。
  • RXNEIE (RXNE Interrupt Enable)：位5，接收数据寄存器非空中断使能。当接收数据寄存器（RDR）收到新数据时，若此位置1，会产生中断。这是最常用的接收中断使能位。
  • TE (Transmitter Enable)：位3，发送器使能。置1后，TX引脚被配置为输出，并开始发送空闲帧（高电平）。重要提示：在TE从0变为1后的第一个时钟周期，会发送一个空闲帧，这可能会干扰通信。稳妥的做法是先配置好所有参数，最后再使能TE和RE。
  • RE (Receiver Enable)：位2，接收器使能。置1后，RX引脚开始采样输入信号。

• USART_CR2 (Control Register 2)：主要用于配置停止位和智能卡模式等。

  • STOP[1:0]：位13:12，停止位选择。00代表1个停止位，01代表0.5个，10代表2个，11代表1.5个。绝大多数应用场景下，设置为00（1个停止位）即可。

• USART_CR3 (Control Register 3)：用于使能高级功能如DMA、硬件流控制等。

  • DMAT (DMA Enable for Transmitter)：位7，发送DMA使能。置1后，当TXE标志为1时，会触发DMA请求。
  • DMAR (DMA Enable for Receiver)：位6，接收DMA使能。置1后，当RXNE标志为1时，会触发DMA请求。
  • RTSE (RTS Enable)：位8，RTS硬件流控制使能。
  • CTSE (CTS Enable)：位9，CTS硬件流控制使能。注意：使用硬件流控制时，必须正确连接对应的硬件引脚（RTS为输出，CTS为输入），并配置好上下拉电阻。

3.2 状态寄存器（SR）：读取通信状态

USART_SR (Status Register)：这是一个只读寄存器（某些位可由软件清零），反映了USART的实时状态。调试时，频繁读取此寄存器是定位问题的关键。

• TXE (Transmit Data Register Empty)：位7，发送数据寄存器空。当TDR寄存器中的数据被转移到发送移位寄存器后，该位置1。此时可以向TDR写入下一个要发送的数据。在查询发送模式下，我们就是轮询此位，为1时则写入数据。
• TC (Transmission Complete)：位6，发送完成。当一帧数据（包括停止位）完全从TX引脚发出，且TDR寄存器为空时，该位置1。此标志位需要软件清零（读SR寄存器，然后写DR寄存器）。常用于判断一串数据是否发送完毕，以便关闭发送器或进行后续操作。
• RXNE (Read Data Register Not Empty)：位5，接收数据寄存器非空。当接收移位寄存器的数据被转移到RDR寄存器后，该位置1。此时可以从RDR读取数据。读取数据后，该位会自动清零。在查询或中断接收模式下，都依赖此位。
• ORE (Overrun Error)：位3，溢出错误。当RXNE标志还未被清除（即数据未被读取），又收到新的数据时，该位置1。发生溢出时，旧数据会丢失。此标志位需要软件清零（读SR寄存器，然后读DR寄存器）。在高速或不稳定通信中需注意此错误。
• FE (Framing Error)：位2，帧错误。当检测到停止位不是预期的电平（通常为高电平）时，该位置1。可能由波特率不匹配或噪声引起。
• PE (Parity Error)：位0，奇偶校验错误。当使能了奇偶校验，且接收数据的奇偶校验位与计算值不符时，该位置1。

注意：TXE和TC的区别是初学者容易混淆的点。TXE=1只表示数据从TDR搬到了移位寄存器，可以准备下一字节了，但引脚上的数据可能还没发完。TC=1才表示引脚上的数据（包括停止位）全部发送完毕，线路恢复空闲（高电平）。在连续发送多字节数据时，通常用TXE来判断是否可以发送下一字节；而在发送完最后一个字节后，如果需要确保所有数据都已物理发出（例如在切换收发模式前），则需要查询TC标志。

3.3 数据寄存器（DR）与波特率寄存器（BRR）

• USART_DR (Data Register)：这是一个兼具读写功能的寄存器。

  • 写入操作：当你向USART_DR写入数据时，实际上是将数据写入了发送数据寄存器(TDR)。如果TXE标志为1，数据会很快被硬件转移到发送移位寄存器，然后逐位发出。
  • 读取操作：当你从USART_DR读取数据时，实际上是从**接收数据寄存器(RDR)**中读取。读取操作会自动清除RXNE标志。
  • 关键特性：由于TDR和RDR在物理上是两个寄存器，但共享同一个地址（USART_DR），所以读写操作互不影响。这简化了编程模型。

• USART_BRR (Baud Rate Register)：波特率寄存器，用于设定通信速率。

  • 这是一个32位寄存器，但只有低16位有效。
  • 波特率的计算公式为：Tx/Rx波特率 = f_PCLKx / (16 * USARTDIV)。其中f_PCLKx是USART挂载的总线时钟（USART1挂APB2，其他USART挂APB1），USARTDIV是一个无符号的定点数，其整数部分存放在BRR[15:4]，小数部分存放在BRR[3:0]。
  • 例如：f_PCLK2 = 72MHz，目标波特率baud = 115200。 计算USARTDIV = 72M / (16 * 115200) = 39.0625。 整数部分DIV_Mantissa = 39 = 0x27。 小数部分DIV_Fraction = 0.0625 * 16 = 1 = 0x1。 因此，USART_BRR应设置为(39 << 4) | 1 = 0x0271。
  • 实操心得：STM32CubeMX等工具会自动帮你计算这个值。但手动计算时，务必确认你使用的f_PCLKx时钟频率是否正确。这是导致波特率不对的最常见原因之一。

4. 寄存器级配置实战：查询与中断模式

理论说得再多，不如动手配置一遍。我们假设系统时钟SYSCLK=72MHz，APB2时钟（PCLK2）也为72MHz，使用USART1，TX引脚PA9，RX引脚PA10，目标波特率115200，8位数据，无校验，1位停止位。

4.1 第一步：基础外设与引脚时钟使能

任何外设使用前，必须先打开其时钟。这是STM32功耗管理的要求，也是新手最容易遗漏的一步。

// 1. 使能GPIOA时钟 (因为PA9, PA10) RCC->APB2ENR |= RCC_APB2ENR_IOPAEN; // 2. 使能USART1时钟 (USART1挂在APB2总线上) RCC->APB2ENR |= RCC_APB2ENR_USART1EN;

4.2 第二步：GPIO引脚复用功能配置

USART的TX、RX是复用功能引脚，需要将GPIO模式配置为复用推挽输出（TX）和浮空输入/上拉输入（RX）。

// 配置PA9为复用推挽输出，最大速度50MHz // CNF[1:0] = 10 (复用功能输出模式), MODE[1:0] = 11 (输出模式，最大速度50MHz) GPIOA->CRH &= ~(GPIO_CRH_CNF9 | GPIO_CRH_MODE9); // 先清零 GPIOA->CRH |= (GPIO_CRH_CNF9_1 | GPIO_CRH_MODE9_0 | GPIO_CRH_MODE9_1); // 0b1011 // 配置PA10为浮空输入（或上拉输入，根据外部电路决定） // CNF[1:0] = 01 (浮空输入), MODE[1:0] = 00 (输入模式) GPIOA->CRH &= ~(GPIO_CRH_CNF10 | GPIO_CRH_MODE10); GPIOA->CRH |= GPIO_CRH_CNF10_0; // 0b0100 // 如果使用内部上拉，还需设置 ODR 寄存器对应位为1 // GPIOA->ODR |= GPIO_ODR_ODR10;

注意：不同系列的STM32，GPIO配置寄存器的名称和位定义可能不同（如F1是CRL/CRH，F4是MODER/OTYPER/OSPEEDR/PUPDR，H7则更复杂）。务必查阅对应芯片的参考手册。这是移植代码时需要重点修改的地方。

4.3 第三步：USART核心参数配置

现在开始配置USART本身。遵循一个原则：先配置参数，最后使能USART和收发器。

// 1. 配置波特率 115200 (PCLK2=72MHz) // USARTDIV = 72000000 / (16 * 115200) = 39.0625 // DIV_Mantissa = 39 = 0x27, DIV_Fraction = 0.0625*16 = 1 USART1->BRR = (39 << 4) | 1; // 即 0x0271 // 2. 配置数据帧格式：8位数据，无校验，1位停止位 // 清除M位(12)为0，选择8位数据位 USART1->CR1 &= ~USART_CR1_M; // 清除PCE位(10)为0，禁用奇偶校验 USART1->CR1 &= ~USART_CR1_PCE; // 配置CR2的STOP位为00，1位停止位 USART1->CR2 &= ~USART_CR2_STOP; // 通常STOP位默认就是00，但显式清零更安全 // 3. 使能发送器和接收器（TE和RE） USART1->CR1 |= USART_CR1_TE | USART_CR1_RE; // 4. 最后，使能USART模块（UE） USART1->CR1 |= USART_CR1_UE;

配置顺序心得：一定要先写BRR，再写CR1/CR2/CR3的控制位，最后再置位UE。有些更严谨的代码，会在置位TE和RE之前，先确保UE=0，配置完成后再打开UE，以避免产生毛刺信号。

4.4 第四步：实现查询式收发

查询方式是最简单、最直接的，适合在不频繁通信或对实时性要求不高的场景中使用。

查询发送函数：

void USART1_SendByte(uint8_t data) { // 等待发送数据寄存器为空（TXE=1） while ((USART1->SR & USART_SR_TXE) == 0) { // 可以加入超时机制，防止死循环 } // 将数据写入数据寄存器，开始发送 USART1->DR = data; // 注意：这里没有等待TC（发送完成），因为写入下一个字节前会等待TXE。 // 如果需要确保数据完全发出（例如关闭发送器前），需要额外等待TC。 } void USART1_SendString(char *str) { while (*str) { USART1_SendByte(*str++); } // 可选：等待最后一个字节发送完成 // while ((USART1->SR & USART_SR_TC) == 0); }

查询接收函数：

uint8_t USART1_ReceiveByte(void) { // 等待接收数据寄存器非空（RXNE=1） while ((USART1->SR & USART_SR_RXNE) == 0) { // 同样可以加入超时机制 } // 读取数据寄存器，RXNE位会自动清零 return (uint8_t)(USART1->DR & 0xFF); // 只取低8位 }

踩坑记录：查询方式最大的风险是“阻塞”。如果因为硬件故障、线路断开等原因导致TXE或RXNE标志永远达不到预期状态，while循环就会成为死循环，整个程序“卡死”。务必在实际产品中为查询循环添加超时退出机制，例如用一个递减计数器，超时后则返回错误码，并尝试复位外设或进行错误处理。

4.5 第五步：实现中断式收发

中断方式不占用CPU时间等待，效率高，是实际项目中最常用的方式。配置分为两部分：使能USART自身的中断，以及配置内核的NVIC。

1. 使能USART接收中断：

// 在USART初始化函数的最后，使能接收中断 USART1->CR1 |= USART_CR1_RXNEIE; // 使能RXNE中断 // 如果也需要发送完成中断（例如用于DMA发送完成回调），则使能TCIE // USART1->CR1 |= USART_CR1_TCIE;

2. 配置NVIC（嵌套向量中断控制器）：

// 设置USART1中断的优先级（分组和子优先级，这里简单设为0） NVIC_SetPriority(USART1_IRQn, 0); // 使能USART1的中断通道 NVIC_EnableIRQ(USART1_IRQn);

3. 编写中断服务函数（ISR）： 中断服务函数的名字在启动文件（startup_*.s）中已有定义，通常是USART1_IRQHandler。

void USART1_IRQHandler(void) { // 1. 判断中断来源是否为RXNE（接收中断） if ((USART1->SR & USART_SR_RXNE) != 0) { // 读取数据，此操作会清除RXNE标志 uint8_t received_data = (uint8_t)(USART1->DR & 0xFF); // 在这里处理接收到的数据，例如放入环形缓冲区 // ring_buffer_put(&rx_buf, received_data); // 注意：中断服务函数中应尽量快速处理，避免复杂操作。 // 常见的做法是只做数据搬运，在主循环或更低优先级任务中解析。 } // 2. 可以判断其他中断源，例如发送完成中断TC // if ((USART1->SR & USART_SR_TC) != 0) { // // 清除TC标志（读SR，写DR） // volatile uint32_t temp = USART1->SR; // temp = USART1->DR; // 无实际作用的写操作，用于清除TC // // ... 处理发送完成事件，例如关闭发送器或通知任务 // } // 3. 错误处理（非常重要！） if ((USART1->SR & USART_SR_ORE) != 0) { // 溢出错误 // 清除ORE标志：先读SR，再读DR volatile uint32_t temp = USART1->SR; temp = USART1->DR; // 记录错误或进行恢复操作 } // 类似地，可以处理FE（帧错误）、PE（奇偶校验错误）等 }

中断模式心得：

• 中断嵌套与优先级：如果系统中有多个中断，需要合理规划优先级。USART通信中断的优先级通常不宜设得太高，避免阻塞更紧急的系统中断（如SysTick）。
• 缓冲区是必须的：中断服务函数中绝不能进行耗时操作（如printf、浮点运算）。标准做法是使用环形缓冲区（Ring Buffer）。中断中只负责将DR的数据快速存入缓冲区尾部，或从缓冲区头部取出数据写入DR；主程序则从缓冲区中读取数据进行处理。这实现了生产者和消费者的解耦。
• 错误处理不可忽视：在工业或复杂环境中，线路干扰可能导致各种错误。如果不及时在中断中读取SR并清除错误标志（ORE、FE等），可能会导致后续中断被阻塞。一个健壮的中断服务函数必须包含错误状态判断和处理逻辑。

5. 高级应用与深度优化

掌握了基础配置和查询/中断模式后，我们可以探索一些更高级的用法和优化技巧，这些往往需要更深入地操作寄存器。

5.1 精确控制发送完成与TC标志

在很多精细控制场景下，TC标志比TXE更有用。例如，在RS-485半双工通信中，需要在所有数据发送完毕后，才能将控制线从“发送”切换到“接收”模式。如果只用TXE判断，最后一个字节可能还在移位寄存器中未完全发出，此时切换会导致数据帧不完整。

void USART1_SendString_Blocking(char *str) { while (*str) { USART1_SendByte(*str++); // 使用之前的查询发送函数 } // 关键：等待最后一个字节的发送真正完成（包括停止位） while ((USART1->SR & USART_SR_TC) == 0); // 此时，可以安全地切换RS-485方向控制引脚 // GPIO_ResetBits(RS485_DIR_GPIO, RS485_DIR_PIN); // 切换到接收模式 }

注意：TC标志在TXE置位且发送移位寄存器为空时置位。读取TC标志后，需要通过“读SR寄存器，再写DR寄存器”的操作来清除它。上面的代码中，由于我们发送完字符串后没有进行任何清除操作，TC会一直保持为1，直到下一次发送流程开始（写入DR）才会被硬件清除。在某些库函数的实现中，会在初始化时主动清除一次TC标志，以避免误判。

5.2 利用空闲中断实现不定长数据接收

RXNE中断是每收到一个字节触发一次。对于不定长数据包（例如以换行符\n结尾，但长度未知），频繁中断会消耗资源。STM32的USART提供了一个“空闲中断”（Idle Interrupt），当RX线在收到一字节数据后，持续保持高电平（空闲状态）超过一帧的时间，就会触发此中断。这非常适合用于接收一包完整的数据。

配置空闲中断需要操作CR1寄存器：

// 使能空闲中断 USART1->CR1 |= USART_CR1_IDLEIE;

同时，在NVIC中使能USART1全局中断（前面已做）。

在中断服务函数中，需要增加对空闲中断的判断：

void USART1_IRQHandler(void) { // 1. 处理字节接收中断 if ((USART1->SR & USART_SR_RXNE) != 0) { uint8_t data = (uint8_t)USART1->DR; // 将数据存入环形缓冲区 // ... } // 2. 处理空闲中断 if ((USART1->SR & USART_SR_IDLE) != 0) { // 清除空闲中断标志：**读一次SR寄存器，再读一次DR寄存器** volatile uint32_t temp = USART1->SR; temp = USART1->DR; // 这个读DR的操作是清除IDLE标志的关键！ // 空闲中断触发，意味着一包数据接收完毕（例如，收到了换行符后线路空闲） // 可以在这里设置一个标志，通知主程序处理缓冲区中的数据包 // idle_flag = 1; } // ... 错误处理 }

重要提示：清除空闲中断标志IDLE的方法与清除RXNE不同。IDLE标志需要通过先读SR寄存器（判断），再读DR寄存器的方式来清除。仅仅读SR是不够的，这是一个常见的坑点。

5.3 低功耗应用下的串口唤醒

在电池供电设备中，MCU经常需要进入低功耗的停止（Stop）或待机（Standby）模式。此时，可以通过配置串口，使其在收到数据时产生中断，从而唤醒MCU。

1. 配置唤醒事件：在进入低功耗模式前，确保USART接收器使能（RE=1），并且接收中断使能（RXNEIE=1）。同时，根据芯片手册，可能需要配置USART的时钟源在低功耗模式下保持运行（例如使用HSI或LSI）。
2. 进入低功耗模式：调用进入Stop模式的函数（如PWR_EnterSTOPMode）。
3. 唤醒与恢复：当RX引脚上有数据到来时，RXNE标志置1并产生中断。中断服务函数执行，MCU被唤醒。唤醒后，系统时钟可能会复位为HSI（内部高速时钟），需要重新初始化系统时钟（HSE、PLL等）和依赖于系统时钟的外设（包括USART的波特率！）。这是低功耗串口唤醒最需要注意的地方。

6. 调试技巧与常见问题排查实录

理解了寄存器，调试就有了抓手。下面是我在实际项目中遇到的一些典型问题及排查思路，整理成表，方便快速对照。

终极调试工具：逻辑分析仪和调试器

• 逻辑分析仪：几十块钱的简易逻辑分析仪（配合Sigrok/PulseView软件）是调试串口的利器。它可以直观地显示TX/RX引脚上的波形，直接测量波特率、查看数据帧（起始位、数据位、停止位），一眼就能看出是波特率问题还是帧格式问题。
• 调试器（ST-Link等）：配合IDE（如Keil、IAR、VSCode+OpenOCD）可以实时查看和修改所有寄存器的值。当你怀疑某个配置位不对时，直接在外设观察窗口（Peripheral View）里查看，比翻代码快得多。你还可以在中断服务函数里设置断点，看中断是否被触发。

从寄存器层面理解USART，就像拿到了串口通信的“原理图”。最初的学习曲线可能稍陡，但一旦掌握，你对通信过程的掌控力、调试问题的效率都会大幅提升。这份笔记里的内容，几乎都是我在实际项目中踩过坑、排过雷后总结出来的。希望它能帮你绕过那些弯路，更自信地驾驭STM32的串口功能。记住，库函数是快艇，让你快速航行；寄存器是航海图，让你知道方向，甚至在风暴中也能找到回家的路。两者结合，才是嵌入式开发者的完整武器库。