第4章：UART串口通信与打印调试

UART串口，说白了就是嵌入式开发者的“眼睛”。没有它，你连芯片在干什么都不知道。我刚开始做裸机时，第一件事就是把串口调通，否则后面所有调试都像在摸黑走路。

这一章我们聚焦四个核心问题：波特率怎么算、中断和轮询怎么选、printf怎么重定向到串口、以及串口丢数据怎么排查。嗯，都是实战中绕不开的坑。

4.1 UART硬件基础与波特率计算

UART是异步串行通信，没有时钟线。收发双方得约定好一个“节奏”——这就是波特率。波特率错了，收到的全是乱码，我当年第一次调串口就栽在这上面。

波特率计算公式很简单，但不同芯片的时钟源和分频器略有差异。以常见的STM32F103为例，其USART波特率计算公式为：

波特率 = fCK / (16 × USARTDIV)

其中：
- fCK：外设时钟（通常是PCLK1或PCLK2）
- USARTDIV：一个16位整数+4位小数的分频值

举个例子，如果fCK=72MHz，目标波特率115200：

USARTDIV = 72000000 / (16 × 115200) = 39.0625
整数部分 = 39 (0x27)
小数部分 = 0.0625 × 16 = 1 (0x1)
USART_BRR = (39 << 4) | 1 = 0x271

实际配置时，我建议直接查芯片手册的波特率表格，或者用官方库的宏定义。手动算容易算错，尤其是小数部分。

4.2 轮询模式 vs 中断模式

两种模式各有适用场景。轮询模式简单直接，但会阻塞CPU；中断模式效率高，但代码复杂度上升。我个人的选择标准是：调试阶段用轮询，产品阶段用中断。

轮询模式： 不断检查状态寄存器，有数据就读，有空间就写。

// 轮询发送一个字节
void uart_send_byte(char c) {
    while (!(USART1->SR & USART_SR_TXE));  // 等待发送缓冲区空
    USART1->DR = c;
}

// 轮询接收一个字节
char uart_recv_byte(void) {
    while (!(USART1->SR & USART_SR_RXNE));  // 等待接收数据
    return USART1->DR;
}

中断模式： 使能接收中断，数据到了自动进中断处理函数。

// 初始化时使能接收中断
USART1->CR1 |= USART_CR1_RXNEIE;
NVIC_EnableIRQ(USART1_IRQn);

// 中断服务函数
void USART1_IRQHandler(void) {
    if (USART1->SR & USART_SR_RXNE) {
        char data = USART1->DR;
        // 将data放入环形缓冲区
        ringbuf_put(&uart_rx_buf, data);
    }
}

4.3 实现printf重定向

printf是C标准库函数，默认输出到控制台。在裸机环境下，我们需要把它重定向到串口。这样就能用printf("%d", var)直接打印变量，调试效率翻倍。

重定向的核心是重新实现_write函数（ARMCC编译器）或__io_putchar（GCC编译器）。

ARMCC (Keil) 环境：

// 重定向fputc到串口
int fputc(int ch, FILE *f) {
    while (!(USART1->SR & USART_SR_TXE));
    USART1->DR = (ch & 0xFF);
    return ch;
}

// 重定向fgetc从串口
int fgetc(FILE *f) {
    while (!(USART1->SR & USART_SR_RXNE));
    return (int)USART1->DR;
}

GCC (ARM GCC) 环境：

// 重定向_write系统调用
int _write(int file, char *ptr, int len) {
    int i;
    for (i = 0; i < len; i++) {
        while (!(USART1->SR & USART_SR_TXE));
        USART1->DR = ptr[i];
    }
    return len;
}

// 重定向_read系统调用
int _read(int file, char *ptr, int len) {
    int i;
    for (i = 0; i < len; i++) {
        while (!(USART1->SR & USART_SR_RXNE));
        ptr[i] = USART1->DR;
    }
    return i;
}

4.4 串口丢数据问题排查

串口丢数据，是嵌入式开发中最常见也最头疼的问题之一。我排查过不下20次，总结下来就几个原因：

1. 波特率误差过大 — 用示波器量一下TX引脚的波形，看位宽对不对
2. 接收缓冲区溢出 — 中断服务函数处理太慢，数据被覆盖
3. 中断优先级冲突 — 高优先级中断长时间占用CPU，串口中断被饿死
4. 硬件流控未使能 — 高速传输时，接收方来不及处理，数据丢失
5. DMA配置错误 — 使用DMA时，传输完成中断未正确处理

我曾经遇到一个案例：系统有多个外设中断，串口接收中断优先级设得比较低。结果某个高优先级中断处理函数执行时间过长，串口数据连续丢失。解决办法很简单——把串口接收中断优先级提到最高，或者在高优先级中断里尽量减少处理时间。

另一个常见问题是环形缓冲区太小。假设你的MCU主频72MHz，串口波特率115200，每秒约11.5KB数据。如果主循环处理速度跟不上，缓冲区很快就满了。我一般把环形缓冲区设为1KB以上，并监控缓冲区使用率，超过80%就报警。

4.5 本章知识体系

下面这张图总结了UART串口调试的核心流程和关键节点：

这张图把UART调试的三大块——配置、模式、故障排查——串起来了。你可以把它当作一个检查清单：调串口时，从上到下过一遍，基本不会漏掉关键点。