STM32F103 标准库串口1重定向printf实战与调试技巧

最新推荐文章于 2026-03-29 09:18:35 发布

原创

最新推荐文章于 2026-03-29 09:18:35 发布 · 466 阅读

标签

#STM32F103 #串口通信 #嵌入式调试 #printf重定向

1. 为什么我们需要串口打印？从“盲人摸象”到“打开天眼”

刚接触STM32开发那会儿，我最头疼的就是调试。程序烧录进去，灯不亮，电机不转，屏幕一片漆黑，代码到底跑哪儿去了？是卡在初始化了，还是某个变量溢出了？那时候的感觉，真就像个“盲人摸象”，全凭猜。后来，一位老师傅告诉我：“你得学会让芯片‘说话’。” 他说的“说话”，指的就是通过串口把程序内部的运行状态、变量值、错误信息打印出来。而让最常用的 printf 函数在串口上工作，就是打开这扇“天眼”的第一把钥匙。

对于STM32F103这类资源有限的单片机，标准库（Standard Peripheral Library）依然是很多老项目和维护性开发的首选，它直接、可控，没有HAL库那些复杂的抽象层。把 printf 重定向到串口1（USART1），意味着你可以像在电脑上写C程序一样，轻松地使用 printf("ADC Value: %d\n", adc_value); 来输出调试信息。这不仅仅是输出一个“Hello World”，而是为你搭建了一条与芯片内部世界实时沟通的桥梁。无论是监测传感器数据、跟踪程序流程，还是捕获异常错误，有了它，调试效率会提升好几个数量级。接下来，我就以实战十年的经验，带你一步步打通这个关键环节，并分享那些官方手册里不会写的调试技巧和避坑指南。

2. 动手之前：理清脉络与备好“工具箱”

在开始写代码之前，花几分钟把原理和准备工作理顺，能避免后面很多莫名其妙的错误。首先，你得理解 printf 是怎么“跑”到串口上去的。

2.1 核心原理：重定向 `fputc` 函数

你可以把C语言的标准输入输出库（stdio.h）想象成一个巨大的物流中心。printf 这个函数负责打包好你要发送的信息（格式化字符串），但它自己并不负责运输。它会调用一个叫 fputc 的低级函数，把“包裹”（一个个字符）交给它，并告诉它：“送到标准输出（stdout）去。” 在电脑上，stdout默认就是你的显示器控制台。

而在我们的STM32上，没有显示器。所谓“重定向”，就是我们去修改这个物流中心的“送货地址”。我们亲自实现一个 fputc 函数，在这个函数里，我们不把字符送去屏幕，而是通过STM32的串口1发送出去。这样，当 printf 调用 fputc 时，字符就自然而然地流向了串口。编译器会优先使用我们实现的这个版本，这就是“重定向”的本质。

2.2 硬件与软件准备清单

工欲善其事，必先利其器。确保你手头有这些东西：

硬件：
- 一块STM32F103核心板：最常见的就是STM32F103C8T6（蓝色小板），它完全够用。
- 一个USB转TTL串口模块：这是连接电脑和芯片串口的关键。推荐使用CH340G或CP2102芯片的，比较稳定。
- 杜邦线若干：用于连接。
软件：
- Keil MDK-ARM：我习惯用Keil，当然用IAR或者VSCode+Arm GCC也可以，原理相通。
- 串口调试助手：电脑端用来接收和显示串口数据的工具。XCOM、SSCOM、Putty都行，选一个你顺手的。

硬件连接是这个阶段最容易出错的地方，务必仔细：

USB转TTL模块的TX 接 STM32的PA10（USART1_RX）。
USB转TTL模块的RX 接 STM32的PA9（USART1_TX）。
两者GND相连（共地！这是必须的，否则通信不稳定）。
给STM32开发板供电（通常USB转TTL模块的3.3V/5V输出电流不够，建议开发板单独供电）。

这里有个我踩过的坑：有些USB转TTL模块的电平是5V的，而STM32F103的IO口是3.3V电平。虽然短时间接上可能也能工作，但长期使用有损坏芯片的风险。所以最好使用支持3.3V电平输出的模块，或者在TX、RX线上串联一个1kΩ的电阻做简易降压隔离。

3. 从零开始：一步步实现printf重定向

好了，原理懂了，东西齐了，我们开始撸代码。我会用一个完整的工程示例，把每个细节都讲清楚。

3.1 创建工程与基础外设配置

打开Keil，新建一个工程，选择你的芯片型号（比如 STM32F103C8）。在管理运行时环境（Manage Run-Time Environment）里，选择 Device -> Startup 和 Device -> StdPeriph Drivers -> GPIO、RCC、USART。这样Keil会自动帮你添加必要的启动文件和标准库文件。

首先，我们需要初始化系统时钟。很多新手会忽略这一步，导致串口波特率不准，打印乱码。在主函数开头，最好加上：

int main(void) {
    // 初始化系统时钟（使用外部8MHz晶振，倍频到72MHz）
    SystemInit();
    // 你的其他初始化...
}

如果你的板子用的是外部8MHz晶振（大部分核心板都是），并且你在工程配置中正确设置了，SystemInit() 函数会在启动文件里被调用。但为了保险，显式调用一下是个好习惯。

3.2 精细配置串口1：不止是波特率

串口初始化是重定向的基石。这里我给出一个更健壮、带注释的初始化函数：

#include "stm32f10x.h"

void USART1_Config(void) {
    GPIO_InitTypeDef GPIO_InitStructure;
    USART_InitTypeDef USART_InitStructure;

    // 第1步：打开时钟总线——忘记开时钟是最常见的错误！
    // USART1和GPIOA都挂在APB2高速总线上
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE);

    // 第2步：配置GPIO引脚
    // PA9 作为USART1的TX，需要配置为复用推挽输出
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; // 复用推挽输出
    GPIO_InitStru