STM32多串口通信实战：从USART1到USART2/3的配置与架构设计

1. 项目概述：从USART1到多串口协同的实战配置

在嵌入式开发，尤其是基于STM32的项目中，串口通信（USART/UART）几乎是开发者第一个要打交道的硬件外设。无论是打印调试信息、与上位机通信，还是连接GPS、蓝牙、LoRa等模块，串口都扮演着“信息高速公路”的角色。很多新手在配置完USART1，实现简单的“Hello World”打印后，一旦项目需要同时使用USART2、USART3甚至更多串口时，就会遇到各种问题：中断冲突、数据错乱、资源占用不当导致系统卡顿。

这个主题的核心，就是解决从单一串口到多串口系统配置的平滑过渡。它不仅仅是复制粘贴几行初始化代码，而是涉及到时钟树管理、中断优先级设计、DMA资源分配以及软件架构层面的数据流隔离。我见过不少项目，前期只用了USART1，代码写得随意，等到需要添加USART2连接传感器、USART3连接无线模块时，不得不对底层驱动进行伤筋动骨的重构，浪费大量时间。

本文将基于STM32的标准外设库（Standard Peripheral Library）和HAL库两种常见环境，深入拆解USART1、USART2、USART3的配置细节。我会重点分享如何构建一个健壮、可扩展的多串口通信框架，包括轮询、中断和DMA三种模式的实战选择，以及如何避免那些教科书上不会写，但实际开发中一定会踩的坑。无论你是正在做毕业设计的学生，还是需要快速为产品添加通信功能的工程师，这些从实际项目中沉淀下来的经验都能让你少走弯路。

2. 核心思路与架构设计：为什么不能简单复制USART1的代码？

2.1 多串口系统的核心挑战与设计原则

当系统需要多个串口同时工作时，最大的挑战来自于资源的并发访问与冲突管理。许多初学者会犯一个错误：把配置USART1的代码复制三份，分别改成USART2和USART3，然后期望它们能完美工作。这种做法在简单轮询模式下或许能跑起来，但一旦引入中断或DMA，系统就会变得极其不稳定。

这里有几个关键的设计原则需要在一开始就确立：

1. 时钟源独立性核查：STM32不同系列的USART时钟来源可能不同。例如，在STM32F1系列中，USART1挂在APB2总线，而USART2/3挂在APB1总线，两者的时钟频率（PCLK1和PCLK2）可能不同，这直接影响了波特率计算。如果不加区分地使用同一个波特率计算函数，会导致通信速率错误。
2. 中断优先级管理：如果三个串口都使用接收中断，那么必须合理设置它们的NVIC中断优先级。优先级设置不当，可能导致低优先级串口的数据接收被高优先级任务（如USART1）长时间阻塞，造成数据丢失。这不是简单地“都设为同一个优先级”就能解决的。
3. DMA通道冲突规避：USART的发送和接收通常可以搭配DMA以解放CPU。但STM32的DMA通道与特定外设是硬连线关联的。例如，USART1_TX可能固定使用DMA1_Channel4，而USART3_RX可能固定使用DMA1_Channel3。如果同时使用的其他外设（如ADC、SPI）也请求相同的DMA通道，就会发生冲突，导致DMA传输异常。必须在设计阶段就规划好DMA通道的使用图谱。
4. 软件缓冲区的隔离：每个串口都应该拥有自己独立的发送和接收缓冲区（Ring Buffer/Circular Buffer）。绝对禁止多个串口的中断服务程序操作同一个全局缓冲区，否则会出现数据覆盖和难以调试的随机错误。

基于这些原则，一个稳健的多串口驱动架构应该采用“模块化”和“高内聚低耦合”的思想。每个串口被封装成一个独立的对象或结构体，包含其所有的硬件配置参数（如USARTx基地址、波特率）、软件资源（如收发缓冲区、状态标志）以及操作接口（初始化、发送、接收）。

2.2 开发环境与库函数选型：标准库 vs HAL库

STM32的开发主要有两种库函数选择：标准外设库（SPL）和硬件抽象层库（HAL）。两者在多串口配置上思路相通，但具体操作有差异。

• 标准外设库（SPL）：更贴近寄存器，代码效率高，对硬件资源控制精细。在资源紧张的F1系列或对实时性要求极高的场景中仍有优势。配置过程需要手动开启外设时钟、设置GPIO、配置USART参数、使能中断等，步骤清晰但繁琐。
• 硬件抽象层库（HAL）：ST主推的库，提供了更高层次的抽象，函数通用性强，配合STM32CubeMX工具可以快速生成初始化代码。在管理多个串口时，HAL库的huart1,huart2,huart3等句柄结构体使得代码结构更统一。但其代码体积相对庞大，中断处理流程有时不够直观。

我的建议是：对于新手或需要快速原型验证的项目，优先使用HAL库+STM32CubeMX。这能让你避开大量底层细节，专注于通信逻辑。而对于追求极致性能、代码体积或正在维护老项目的开发者，需要深入理解标准库的配置流程。

注意：无论用哪个库，都不要过度依赖CubeMX生成代码后就不管了。自动生成的代码往往只提供了最基础的轮询模式，你需要根据实际需求手动添加中断或DMA配置，并编写对应的回调函数。

3. 硬件连接与时钟配置：为多串口打下坚实基础

3.1 USART1/2/3的引脚映射与硬件连接

在画原理图或连接硬件前，必须查阅你所使用的STM32具体型号的数据手册（Datasheet）和参考手册（Reference Manual），以确定USART引脚的位置，因为很多引脚具有复用功能。

以常见的STM32F103C8T6（蓝色药丸板）为例：

• USART1: TX - PA9, RX - PA10。这是默认的下载和调试串口。
• USART2: TX - PA2, RX - PA3。
• USART3: TX - PB10, RX - PB11。（注意：USART3的引脚可能有重映射，需要查表确认）

硬件连接的一个大坑：USB转TTL模块的电平是3.3V还是5V？STM32的GPIO引脚是3.3V电平，耐受5V电压的能力因型号而异（F1系列很多引脚是5V容忍的，但F4系列可能不是）。为安全起见，一律使用3.3V电平的USB转TTL模块，或者至少在RX线上加一个电平转换电路（如分压电阻），否则有烧毁芯片的风险。

3.2 系统时钟树配置与波特率计算

稳定的通信离不开精确的时钟。多串口配置时，必须清楚每个USART挂载在哪个总线，以及该总线的时钟频率。

以STM32F1系列为例（使用标准库思想说明）：

1. 系统启动后，首先配置系统时钟（SYSCLK），例如使用外部8MHz晶振，通过PLL倍频到72MHz。
2. 高速外设总线APB2（PCLK2）的时钟可以配置为与SYSCLK同频（72MHz），USART1挂在此总线上。
3. 低速外设总线APB1（PCLK1）的时钟最大为36MHz，USART2和USART3挂在此总线上。

波特率计算是关键：USART的波特率发生器使用USART_BRR寄存器。计算公式为：波特率 = f_PCLKx / (16 * USARTDIV)其中，USARTDIV是一个存储在USART_BRR寄存器中的浮点数（整数部分+小数部分）。库函数USART_Init()内部会帮你完成这个计算并写入寄存器。但你需要确保传入的USART_InitStructure.USART_BaudRate参数，与当前f_PCLKx（该USART所在总线的时钟）是匹配的。

实操心得：我遇到过最诡异的问题就是USART2通信乱码，查了半天发现是系统时钟配置函数被意外修改，导致APB1总线时钟不是预期的36MHz，而是8MHz，从而使得实际波特率与设定值严重不符。务必在初始化后，通过调试器或打印方式，确认一下系统核心时钟和各总线时钟的频率是否与设计一致。

4. 三种通信模式详解与代码实现

4.1 轮询模式：最简单，但也最“笨”

轮询模式就是CPU不断查询USART的状态寄存器（如USART_FLAG_RXNE接收非空，USART_FLAG_TXE发送为空），来执行收发操作。

标准库示例（USART1发送一个字符）：

void USART1_SendByte(uint8_t data) { USART_SendData(USART1, data); while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET); // 等待发送完成 }

HAL库示例：

HAL_UART_Transmit(&huart1, &data, 1, 1000); // 阻塞等待1000ms

轮询模式的致命缺点：while循环等待会独占CPU。如果一个串口在等待发送完成，另一个串口的数据来了也无法及时响应，必然导致数据丢失。因此，轮询模式仅适用于单任务、对实时性要求极低的场景，或者仅用于最初的调试。在多串口系统中，应尽量避免使用纯轮询模式。

4.2 中断模式：平衡效率与复杂性的首选

中断模式是大多数中等复杂度项目的选择。当USART收到数据或发送缓冲区空时，会触发中断，CPU暂停当前任务来处理数据，处理完再返回。

配置关键步骤（以标准库USART2接收中断为例）：

1. 使能USART2全局中断：在NVIC（嵌套向量中断控制器）中配置。

   NVIC_InitTypeDef NVIC_InitStructure; NVIC_InitStructure.NVIC_IRQChannel = USART2_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; // 抢占优先级 NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0; // 子优先级 NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStructure);

2. 使能USART2的特定中断源：通常我们使能接收中断。

   USART_ITConfig(USART2, USART_IT_RXNE, ENABLE);

3. 编写中断服务函数（ISR）：函数名在启动文件startup_stm32f10x_xx.s中已定义。

   void USART2_IRQHandler(void) { if (USART_GetITStatus(USART2, USART_IT_RXNE) != RESET) { uint8_t received_data = USART_ReceiveData(USART2); // 将数据存入USART2专用的环形接收缓冲区 ring_buffer_write(&uart2_rx_buffer, received_data); // 清除中断标志（库函数读取数据后通常会自动清除部分标志，但最好显式操作） USART_ClearITPendingBit(USART2, USART_IT_RXNE); } // 还可以处理发送完成中断（TC）、空闲中断（IDLE）等 }

HAL库的中断模式更为统一。在CubeMX中勾选对应串口的全局中断后，你主要需要重写（或处理）回调函数（Callback）：

• HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart): 当接收到指定长度数据时调用。
• HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart): 当发送完成时调用。
• HAL_UART_ErrorCallback(UART_HandleTypeDef *huart): 当发生错误时调用。

使用HAL库中断接收的常见做法是启动一次接收，在回调函数中处理数据，然后再次启动接收，形成循环。

// 在main初始化后启动中断接收 uint8_t rx_buffer[1]; HAL_UART_Receive_IT(&huart2, rx_buffer, 1); // 回调函数 void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart->Instance == USART2) { // 处理rx_buffer[0]中的数据 // ... // 再次启动接收，等待下一个字节 HAL_UART_Receive_IT(&huart2, rx_buffer, 1); } }

注意事项：中断服务函数（ISR）必须尽可能短小精悍。只做最必要的操作，如读取数据、放入缓冲区、清除标志。绝对不要在ISR中进行复杂计算、调用可能阻塞的函数（如HAL_Delay）或进行浮点运算（除非你清楚上下文保存开销）。繁重的数据处理应放在主循环中，通过检查缓冲区状态来进行。

4.3 DMA模式：高性能、大数据量的终极解决方案

当需要高速、连续、大数据量传输（如GPS数据流、图像传输、与高速上位机通信）时，DMA（直接存储器访问）是必须的。DMA可以在不占用CPU的情况下，在外设（USART的接收/发送数据寄存器）和内存（自定义的缓冲区）之间直接搬运数据。

配置DMA的核心逻辑（以HAL库的USART3接收为例）：

1. 在CubeMX中配置：为USART3_RX选择一个DMA通道（如DMA1_Channel3），模式设为“Circular”（循环模式），这样当DMA填满缓冲区后会自动从头开始，无需手动重启，完美实现环形缓冲区。
2. 启动DMA接收：

   #define UART3_RX_BUFFER_SIZE 256 uint8_t uart3_rx_dma_buffer[UART3_RX_BUFFER_SIZE]; HAL_UART_Receive_DMA(&huart3, uart3_rx_dma_buffer, UART3_RX_BUFFER_SIZE);

3. 利用空闲中断（Idle Interrupt）：这是DMA串口接收的“黄金搭档”。我们使能USART的空闲中断，当串口总线在一帧数据结束后出现空闲状态（高电平）时，会触发中断。在空闲中断服务函数中，我们可以计算出DMA搬运了多少数据到缓冲区，然后一次性取出处理。

   // 使能USART3空闲中断（在初始化后） __HAL_UART_ENABLE_IT(&huart3, UART_IT_IDLE); // 在USART3的全局中断服务函数中处理空闲中断 void USART3_IRQHandler(void) { HAL_UART_IRQHandler(&huart3); // 调用HAL库中断处理函数 // 用户代码 if(__HAL_UART_GET_FLAG(&huart3, UART_FLAG_IDLE) != RESET) { __HAL_UART_CLEAR_IDLEFLAG(&huart3); // 清除空闲中断标志 // 计算本次接收到的数据长度 uint16_t dma_buffer_len = UART3_RX_BUFFER_SIZE - __HAL_DMA_GET_COUNTER(&hdma_usart3_rx); if(dma_buffer_len > 0) { // 处理 uart3_rx_dma_buffer 中前 dma_buffer_len 个字节的数据 process_uart3_data(uart3_rx_dma_buffer, dma_buffer_len); // 重置DMA指针到缓冲区开头，准备下一次接收（循环模式会自动进行） // 如果是普通模式，则需要重新设置DMA接收长度并启动 } } }

DMA模式的优势与陷阱：

• 优势：CPU占用率极低，可以同时处理多个高速数据流。
• 陷阱1：缓冲区溢出：如果数据处理速度跟不上接收速度，DMA循环缓冲区会被新数据覆盖。必须确保处理逻辑高效，或者缓冲区足够大。
• 陷阱2：数据帧解析：DMA+空闲中断非常适合接收不定长数据包。但你需要设计一个简单的协议（如包头包尾、长度位）在process_uart3_data函数中解析出完整的一帧数据，而不是简单地把所有数据当成一帧。
• 陷阱3：DMA通道冲突：如前所述，必须规划好所有外设的DMA通道使用，避免冲突。

5. 构建一个健壮的多串口管理框架

理解了三种模式后，我们可以设计一个统一的管理框架。这里给出一个基于HAL库和中断/DMA混合模式的简单框架思路。

定义串口实例结构体：

typedef struct { UART_HandleTypeDef *huart; // HAL库串口句柄 uint8_t rx_dma_buffer[RX_DMA_BUF_SIZE]; // DMA接收缓冲区 uint8_t tx_buffer[TX_BUF_SIZE]; // 发送缓冲区（可配合DMA或中断） volatile uint16_t rx_read_index; // 环形缓冲区读指针 volatile uint16_t rx_write_index; // 环形缓冲区写指针（由DMA更新或中断更新） void (*data_ready_callback)(struct uart_instance *inst, uint8_t *data, uint16_t len); // 数据就绪回调 } uart_instance_t; // 声明三个串口的实例 uart_instance_t uart1_instance, uart2_instance, uart3_instance;

初始化函数：为每个实例初始化硬件（调用HAL库初始化），绑定回调函数，并启动DMA接收或中断接收。

中断服务与数据处理：在各自的中断服务函数中，将数据填入实例的软件环形缓冲区。在主循环中，定期检查每个实例的缓冲区是否有新数据，如果有，则调用其data_ready_callback函数进行处理。这种“中断入队，主循环出队处理”的模式，有效隔离了硬件中断与业务逻辑，使系统更稳定。

发送函数封装：提供一个线程安全的发送函数，内部处理发送缓冲区的管理，可以选择阻塞式发送（HAL_UART_Transmit）或非阻塞式发送（HAL_UART_Transmit_IT/DMA）。

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

即使按照最佳实践配置，在实际硬件上仍可能遇到问题。以下是一些常见故障的排查清单：

一个高级调试技巧：利用串口自身进行自环测试。将MCU上某个USART的TX和RX引脚用杜邦线短接，然后让程序发送一段特定数据，并立即接收。比较发送和接收的数据是否一致。这可以快速隔离是软件配置问题，还是外部电路或对方设备的问题。

最后，关于USART2和USART3的配置，其本质流程与USART1完全一致，核心区别就在于外设基地址、时钟使能位、中断向量、GPIO引脚和DMA通道的不同。在代码中，你只需要将操作对象从USART1、&huart1、USART1_IRQn等，替换为对应的USART2、&huart2、USART2_IRQn即可。真正的功夫，花在文章前半部分所讲的架构设计、资源规划和错误处理上。当你为第一个串口（比如USART1）构建了一个稳健的驱动模型后，增加第二个、第三个串口，就只是“依葫芦画瓢”的体力活了。