8. 串口通信：基于STM32F103C8T6的HAL库USART配置与实战

串口通信是嵌入式系统最基础、最广泛使用的外设接口之一。它不依赖复杂协议栈，硬件资源占用低，调试信息输出、传感器数据回传、上位机指令交互等场景均离不开它。在STM32F103C8T6这类资源受限的主流MCU上，正确配置并稳定使用USART，是工程落地的第一道门槛。本章不讨论UART/USART的电气层差异或RS-232电平转换芯片选型，而是聚焦于 从寄存器映射到HAL库API调用的完整工程链路 ——包括时钟使能逻辑、GPIO复用配置、波特率计算依据、中断服务函数的职责边界，以及实际项目中必须面对的接收缓冲区管理与数据粘包问题。

8.1 硬件连接与引脚规划：为什么必须从原理图出发

STM32F103C8T6采用LQFP48封装，共48个引脚。其USART外设并非固定绑定某组GPIO，而是通过 复用功能（AF）映射机制 实现灵活分配。以最常用的USART1为例，其TX和RX引脚可映射至多个端口组合：

USART	TX 引脚选项	RX 引脚选项	备注
USART1	GPIOA_Pin9 (AF7)	GPIOA_Pin10 (AF7)	默认推荐 ，PA9/PA10为USART1主映射，无需重映射
	GPIOB_Pin6 (AF7)	GPIOB_Pin7 (AF7)	需启用AFIO时钟并配置重映射寄存器
USART2	GPIOA_Pin2 (AF7)	GPIOA_Pin3 (AF7)	PA2/PA3为USART2主映射，常用于调试打印
	GPIOA_Pin14 (AF7)	GPIOA_Pin15 (AF7)	需部分重映射

在实际开发板（如常见的“蓝 pill” STM32F103C8T6最小系统）上，PA2/PA3通常已焊接为CH340G USB转串口芯片的TXD/RXD通道，物理连接已固化。这意味着： 软件配置必须与硬件走线严格一致 。若强行将USART1配置到PA9/PA10，而硬件上该引脚未引出或未连接至USB转接芯片，则无法进行任何通信。

因此，在启动代码编写前，第一步永远是查阅开发板原理图。确认目标串口（如用于printf调试的USART2）对应的物理引脚，并在CubeMX或手动初始化代码中，将该引脚配置为 复用推挽输出（TX） 和 浮空输入（RX） 。此处的“浮空输入”并非随意选择——它允许外部设备（如USB转串口芯片）直接驱动RX引脚电平，避免内部上拉/下拉电阻干扰信号完整性。若需增强抗干扰能力，可在硬件层面添加10kΩ上拉电阻，软件端则配置为“上拉输入”，但需确保与外部电路不冲突。

8.2 时钟树配置：USART波特率精度的根本保障

USART的波特率由以下公式决定：

USARTDIV = (f_PCLKx / (16 * BaudRate))

其中 f_PCLKx 是USART外设所挂载总线的时钟频率。对于USART1，它挂载在APB2总线上；而USART2/USART3挂载在APB1总线上。STM32F103C8T6的默认系统时钟（SYSCLK）为72MHz，经AHB预分频器（HCLK = SYSCLK / 1 = 72MHz），再经APB2预分频器（PCLK2 = HCLK / 1 = 72MHz），APB1预分频器（PCLK1 = HCLK / 2 = 36MHz）。

这意味着：
- USART1 的 f_PCLKx = 72MHz
- USART2 的 f_PCLKx = 36MHz

波特率误差直接取决于 f_PCLKx 的精度。若系统时钟未正确配置，或APB分频系数设置错误，即使寄存器值计算无误，实际波特率也会严重偏离。例如，配置115200bps时：
- 使用USART2（PCLK1=36MHz）： USARTDIV = 36000000 / (16 * 115200) ≈ 19.53125
- 整数部分为19，小数部分为0.53125，需写入BRR寄存器的高4位（DIV_Fraction）和低12位（DIV_Mantissa）

HAL库的 HAL_UART_Init() 函数内部会自动完成此计算，并检查误差是否在容忍范围内（通常<3%）。但开发者必须明确： 时钟源的选择与分频系数的设定，是串口通信可靠的前置条件 。在CubeMX中，务必确认RCC配置页的HSE/HSI状态、PLL倍频系数，以及APB1/APB2的预分频值。若使用HSI（8MHz）作为PLL输入，需确保PLL配置后SYSCLK稳定输出72MHz；若使用外部晶振（如8MHz），则需在System Clock Configuration中勾选“HSE Bypass”并正确设置。

8.3 GPIO复用配置：从模式选择到速度设定

以USART2为例，其TX（PA2）和RX（PA3）需配置为复用功能。这涉及三个关键寄存器：
- GPIOA_MODER ：将PA2/PA3的模式位（MODER2[1:0], MODER3[1:0]）设置为 10b （Alternate Function mode）
- GPIOA_OTYPER ：保持默认（推挽输出），TX引脚需驱动能力
- GPIOA_OSPEEDR ：设置输出速度。对于115200bps通信，50MHz速度等级已足够；若需更高波特率（如921600bps），应设为 11b （50MHz）

最关键的配置在 GPIOA_AFRL 寄存器（低8位控制PA0–PA7）：
- PA2对应AFRL寄存器的 AFSEL2[3:0] 位，需写入 0x7 （AF7，对应USART2）
- PA3对应 AFSEL3[3:0] 位，同样写入 0x7

HAL库中，此过程被封装为 __HAL_RCC_GPIOA_CLK_ENABLE() + GPIO_InitStruct 结构体初始化：

GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();
GPIO_InitStruct.Pin = GPIO_PIN_2 | GPIO_PIN_3;
GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;      // 复用推挽
GPIO_InitStruct.Pull = GPIO_NOPULL;          // 浮空，匹配硬件
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; // 50MHz
GPIO_InitStruct.Alternate = GPIO_AF7_USART2; // AF7 = USART2
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

此处 GPIO_SPEED_FREQ_HIGH 不可省略。若设为 LOW ，在高速通信时可能出现边沿畸变，导致接收误码。而 Pull 配置为 NOPULL ，是因为外部USB转串口芯片（如CH340G）自身已提供上拉，软件再配置上拉会形成竞争。

8.4 USART初始化：HAL_UART_Init()背后的寄存器操作

HAL_UART_Init() 并非黑盒，其核心是配置USART控制寄存器（CR1/CR2/CR3）与波特率寄存器（BRR）。以USART2初始化为例，关键步骤如下：

1. 使能USART2时钟 ： __HAL_RCC_USART2_CLK_ENABLE() ，对应 RCC->APB1ENR 寄存器的 USART2EN 位置1。
2. 复位USART2 ： __HAL_RCC_USART2_FORCE_RESET() + __HAL_RCC_USART2_RELEASE_RESET() ，确保寄存器处于已知初始状态。
3. 配置BRR寄存器 ：根据前述公式计算 USARTDIV ，分离整数与小数部分，写入 USART2->BRR 。
4. 配置CR1寄存器 ：
   - UE （USART Enable）= 1：使能USART
   - TE （Transmitter Enable）= 1：使能发送器
   - RE （Receiver Enable）= 1：使能接收器
   - RXNEIE （RX Not Empty Interrupt Enable）= 1（若启用中断接收）
   - M （Word Length）= 0：8位数据位
   - PCE （Parity Control Enable）= 0：无校验
5. 配置CR2寄存器 ： STOP （Stop Bits）= 00b（1位停止位）
6. 配置CR3寄存器 ： RTSE / CTSE （硬件流控）= 0，除非外接RTS/CTS信号线

HAL库的 huart2.Init 结构体即是对上述寄存器位的抽象：

huart2.Instance = USART2;
huart2.Init.BaudRate = 115200;
huart2.Init.WordLength = UART_WORDLENGTH_8B;
huart2.Init.StopBits = UART_STOPBITS_1;
huart2.Init.Parity = UART_PARITY_NONE;
huart2.Init.Mode = UART_MODE_TX_RX;
huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE;
huart2.Init.OverSampling = UART_OVERSAMPLING_16; // 对应公式中的16
HAL_UART_Init(&huart2);

OverSampling 设为 16 是标准模式，适用于绝大多数场景。若需更高波特率精度且PCLK1足够高，可选 8 ，此时公式中分母变为8，但需确保 f_PCLKx 足够大以避免溢出。

8.5 发送与接收：轮询、中断与DMA的工程权衡

8.5.1 轮询方式：最简但最耗资源

HAL_UART_Transmit() 与 HAL_UART_Receive() 是阻塞式API。以发送为例：

uint8_t tx_data[] = "Hello STM32!\r\n";
HAL_UART_Transmit(&huart2, tx_data, sizeof(tx_data)-1, HAL_MAX_DELAY);

该函数内部循环查询 USART_SR_TC （Transmission Complete）标志位，直至发送完成。优点是代码简洁，无中断开销；缺点是CPU在此期间无法执行其他任务，且 HAL_MAX_DELAY 若设为有限值，可能因总线忙或外设异常导致超时返回错误。

适用场景 ：仅用于启动阶段的简单调试信息输出，或对实时性要求极低的场合。绝不应用于主循环中频繁调用。

8.5.2 中断方式：平衡效率与复杂度

中断方式将发送/接收操作与主程序解耦。以接收为例，需启用 RXNE 中断：

HAL_UART_Receive_IT(&huart2, &rx_byte, 1); // 单字节接收

当RX引脚检测到起始位，数据移入移位寄存器并存入RDR后， RXNE 置位，触发 USART2_IRQHandler 。HAL库的中断处理函数 HAL_UART_RxCpltCallback() 会被调用，开发者在此回调中处理接收到的字节。

但单字节中断存在严重缺陷：每接收1字节就进出一次中断，CPU开销巨大。更合理的做法是 接收缓冲区+帧头帧尾识别 ：
- 定义环形缓冲区（如 uint8_t rx_buffer[256] ）与读写指针
- 在 USART2_IRQHandler 中，只要 RXNE 有效，就持续读取 USART2->DR ，存入缓冲区，直到 RXNE 清零
- 主循环中，扫描缓冲区寻找帧头（如 0xAA ）、帧长、校验和，组装完整数据包

此方案将中断频率降至最低，同时避免了轮询的CPU占用。关键点在于： 中断服务函数（ISR）必须极短，只做数据搬运，所有协议解析逻辑必须放在主循环或独立任务中 。

8.5.3 DMA方式：高吞吐量的终极选择

对于大数据量传输（如固件升级、图像数据回传），DMA是唯一选择。配置USART2_RX使用DMA通道5（DMA1_Channel6）：

hdma_usart2_rx.Instance = DMA1_Channel6;
hdma_usart2_rx.Init.Direction = DMA_PERIPH_TO_MEMORY;
hdma_usart2_rx.Init.PeriphInc = DMA_PINC_DISABLE;
hdma_usart2_rx.Init.MemInc = DMA_MINC_ENABLE;
hdma_usart2_rx.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE;
hdma_usart2_rx.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE;
hdma_usart2_rx.Init.Mode = DMA_CIRCULAR; // 循环模式，防止溢出
hdma_usart2_rx.Init.Priority = DMA_PRIORITY_HIGH;
HAL_DMA_Init(&hdma_usart2_rx);

__HAL_LINKDMA(&huart2, hdmarx, hdma_usart2_rx);
HAL_UART_Receive_DMA(&huart2, rx_dma_buffer, BUFFER_SIZE);

DMA_CIRCULAR 模式使DMA在填满缓冲区后自动回到起始地址，避免因主程序处理不及时导致数据丢失。但循环缓冲区带来新挑战：如何确定当前有效数据长度？HAL库提供 HAL_UARTEx_ReceiveToIdle_DMA() ，它在检测到线路空闲（idle line）时触发回调，此时缓冲区中从上次回调位置到当前DMA地址的数据即为一帧完整数据。这比固定长度DMA更契合实际通信协议。

8.6 接收缓冲区管理：解决粘包与丢包的核心实践

无论采用中断还是DMA，接收端都面临两个经典问题：
- 粘包（Packet Sticking） ：连续发送的多帧数据在缓冲区中无分隔，如发送 [AA 02 01 FF] 和 [AA 02 02 FE] ，缓冲区内容为 AA 02 01 FF AA 02 02 FE
- 丢包（Packet Loss） ：缓冲区溢出或中断响应不及时，导致部分字节被覆盖

解决方案是建立 状态机驱动的帧解析引擎 ，而非简单地按固定长度截取：

typedef enum {
    WAITING_HEADER,
    RECEIVING_LENGTH,
    RECEIVING_PAYLOAD,
    CHECKING_CRC
} ParseState;

ParseState state = WAITING_HEADER;
uint8_t frame_header = 0xAA;
uint8_t frame_length = 0;
uint8_t payload_index = 0;
uint8_t rx_buffer[256];
uint16_t rx_head = 0, rx_tail = 0;

// 主循环中调用
void parse_uart_buffer(void) {
    while (rx_head != rx_tail) { // 缓冲区非空
        uint8_t byte = rx_buffer[rx_tail++];
        if (rx_tail >= sizeof(rx_buffer)) rx_tail = 0;

        switch (state) {
            case WAITING_HEADER:
                if (byte == frame_header) {
                    state = RECEIVING_LENGTH;
                }
                break;
            case RECEIVING_LENGTH:
                frame_length = byte;
                payload_index = 0;
                state = RECEIVING_PAYLOAD;
                break;
            case RECEIVING_PAYLOAD:
                if (payload_index < frame_length) {
                    payload[payload_index++] = byte;
                } else {
                    // 此处应为CRC，进入校验状态
                    state = CHECKING_CRC;
                    crc_received = byte;
                }
                break;
            case CHECKING_CRC:
                // 计算payload CRC并与crc_received比较
                if (crc_ok) {
                    process_frame(payload, frame_length);
                }
                state = WAITING_HEADER; // 重置状态机
                break;
        }
    }
}

此状态机不依赖定时器，完全由接收到的字节驱动，鲁棒性强。关键在于： 帧头必须具有强区分度（如0xAA而非0x00），且协议中必须包含显式长度字段 。若协议无长度字段（如AT指令），则需依赖结束符（ \r\n ）或超时机制，此时需在状态机中加入看门狗计时器，防止单帧数据不完整导致死锁。

8.7 printf重定向：调试效率的倍增器

将 printf 输出重定向至USART2，可极大提升调试效率。需实现 _write 函数（ARM GCC工具链）：

#include <sys/stat.h>
#include <stdio.h>

int _write(int fd, char *ptr, int len) {
    if (fd == STDOUT_FILENO || fd == STDERR_FILENO) {
        HAL_UART_Transmit(&huart2, (uint8_t*)ptr, len, HAL_MAX_DELAY);
        return len;
    }
    errno = EIO;
    return -1;
}

注意：此函数为阻塞式，若在中断中调用 printf 会导致系统死锁。因此， printf 只能在主循环或任务中安全使用 。若需在中断中输出日志，应使用 HAL_UART_Transmit_IT() 发送，并在回调中处理完成事件，或采用轻量级日志队列（如FreeRTOS的 xQueueSendFromISR ）。

此外， printf 格式化消耗大量Flash和RAM。在资源紧张的C8T6上，建议：
- 关闭浮点支持（编译选项 -u _printf_float ）
- 使用 %d 而非 %i ， %x 而非 %X 以减少代码体积
- 避免 %s 格式化长字符串，改用 HAL_UART_Transmit() 直接发送

8.8 常见故障排查：从现象到根源的定位路径

当串口通信失败时，按以下优先级逐项排查：

1. 硬件连通性
   - 用万用表测量PA2/PA3对地电压：空闲时应为3.3V（逻辑高），发送时应有跳变。若恒为0V，检查GPIO是否配置为开漏或未使能时钟。
   - 检查USB转串口芯片供电是否正常（CH340G的VCC需3.3V），TXD/RXD是否交叉连接（开发板TXD接CH340G的RXD）。

2. 时钟配置
   - 用示波器测量PA2引脚在发送”U”字符（0x55）时的波形，计算实际波特率。若偏差>5%，检查RCC配置及 HAL_RCC_GetSysClockFreq() 返回值是否为72000000。

3. GPIO复用
   - 读取 GPIOA->AFR[0] 寄存器，确认 AFSEL2 和 AFSEL3 是否为0x7。若为0x0，则复用功能未生效，检查 GPIO_InitStruct.Alternate 赋值。

4. 中断向量
   - 若使用中断但 HAL_UART_RxCpltCallback() 未被调用，检查 NVIC_EnableIRQ(USART2_IRQn) 是否执行， USART2->CR1 的 RXNEIE 位是否为1， NVIC->ISER[0] 对应位是否置1。

5. 缓冲区溢出
   - 若接收数据随机乱码，大概率是环形缓冲区读写指针错位。在 parse_uart_buffer() 入口添加 if (rx_head == rx_tail) return; ，并在每次读写后加断言 assert(rx_head < sizeof(rx_buffer) && rx_tail < sizeof(rx_buffer)) 。

我在实际项目中曾遇到一个隐蔽问题：PA3（USART2_RX）被误配置为 GPIO_MODE_INPUT 而非 GPIO_MODE_AF_PP 。现象是能发送但无法接收，且 HAL_UART_Receive_IT() 返回 HAL_OK 却无回调。用逻辑分析仪抓取PA3波形，发现引脚电平被外部设备正确驱动，但MCU内部未采样——根源正是GPIO模式配置错误，导致AFIO模块未将RX信号路由至USART2接收器。

8.9 进阶技巧：多串口协同与低功耗设计

STM32F103C8T6最多支持3个USART（USART1/2/3）。在复杂系统中，常需多串口分工：
- USART2：连接PC，用于调试日志（printf）
- USART1：连接GPS模块，接收NMEA语句
- USART3：连接蓝牙模块，透传手机指令

此时需注意：
- 中断优先级分组 ：调用 HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_2) ，为每个USART IRQ设置不同抢占优先级（如USART1最高，USART2次之，USART3最低），避免高优先级串口长时间占用CPU导致低优先级串口丢包。
- 时钟域隔离 ：USART1挂APB2（72MHz），USART2/3挂APB1（36MHz），波特率计算公式不同，初始化时必须分别处理。

在电池供电场景下，串口可成为功耗大户。降低功耗的手段包括：
- 动态时钟门控 ：在不使用串口时，调用 __HAL_RCC_USART2_CLK_DISABLE() 关闭时钟，进入低功耗模式前执行。
- 接收唤醒 ：配置USART的 WUFIE （Wake Up from Stop mode Interrupt Enable）位，使MCU在Stop模式下，当RX引脚检测到起始位时自动唤醒。此功能要求USART时钟源为HSI（1MHz）或LSE（32.768kHz），需在 CR1 中配置 UE 和 WAKE 位，并在 CR3 中使能 WUFIE 。

最后提醒一个易忽略点： 串口引脚在复位后的默认状态是浮空输入，可能拾取噪声触发虚假中断 。在 HAL_UART_MspInit() 中，应在使能时钟后、初始化USART前，先将RX引脚配置为浮空输入并读取一次，清除可能存在的残留电平。