STM32 UART 串口通信:printf 重定向与中断接收(示例帖)

[admin]

串口是 STM32 调试的生命线:打印日志、看传感器数据、跟上位机联调都靠它。这篇把最常用的两招讲透:printf 重定向输出,中断方式接收。

1. CubeMX 配置要点

• Connectivity → USART1,Mode 选 Asynchronous
• 波特率 115200,8 数据位、无校验、1 停止位(8N1)
• NVIC Settings 里勾选 USART1 global interrupt(中断接收才需要)
• PA9(TX)、PA10(RX)接到 USB 转串口模块,注意 TX 接 RX、RX 接 TX,交叉接

2. printf 重定向

C 库的 printf 最终调 fputc,重写它把字符送进串口:

#include <stdio.h>

int fputc(int ch, FILE *f) {
    HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY);
    return ch;
}

// main 里直接用
printf("system clock: %lu Hz\r\n", HAL_RCC_GetSysClockFreq());

注意两点:

• printf 发 \n 不会自动回车,串口助手里看到满屏阶梯状就改成 \r\n
• HAL_MAX_DELAY 是阻塞等待,放在中断里调 printf 会卡死,中断里只做标记

3. 中断接收(推荐做法)

轮询接收会堵住主循环,用中断 + 一字节缓冲:

uint8_t rx_byte;
uint8_t rx_buf[128];
uint8_t rx_len = 0;

void start_uart_rx(void) {
    HAL_UART_Receive_IT(&huart1, &rx_byte, 1); // 启动一次
}

// 每收到 1 字节进一次回调,记得重新挂起下一次接收
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
    if (huart->Instance == USART1) {
        if (rx_byte == '\n' || rx_len >= sizeof(rx_buf) - 1) {
            rx_buf[rx_len] = '\0';
            // 在这里处理一行命令,不要做耗时操作
            rx_len = 0;
        } else if (rx_byte != '\r') {
            rx_buf[rx_len++] = rx_byte;
        }
        HAL_UART_Receive_IT(&huart1, &rx_byte, 1); // 关键:重新挂起
    }
}

4. 排障清单

现象	先查
串口无输出	波特率两边是否一致;TX/RX 是否交叉接;GND 有没有共地
输出乱码	波特率/时钟配置,检查 HSE 是否起振
只能收一次	回调里有没有重新调 HAL_UART_Receive_IT
printf 卡死	是否在中断上下文里调用;串口外设时钟开了没

下一篇计划写定时器 PWM 驱动舵机/电机,连载目录见 /series。