STM32串口重定向printf原理与工程实现

1. 串口重定向 printf 的工程原理与实现机制

在嵌入式开发中， printf 函数的重定向并非简单的“让串口代替屏幕”，而是一套涉及 C 标准库底层 I/O 抽象、编译器运行时支持、硬件外设驱动协同工作的系统级工程实践。其核心在于 GNU ARM 工具链（如 arm-none-eabi-gcc）对 newlib-nano 或完整 newlib 的裁剪与配置，以及对 _write 和 _read 等底层系统调用（syscalls）的重新实现。

C 语言标准库中的 printf 是一个高度抽象的函数。它不直接操作硬件，而是将格式化后的字符流交由底层的 __wrap_write （或 _write ）函数处理。该函数默认由 newlib 提供一个空桩（stub），在裸机环境下会返回 -1 并触发 abort() ，导致程序崩溃。因此，“重定向”本质上是 用我们自己编写的、基于 HAL_UART_Transmit 的串口发送逻辑，覆盖掉这个默认的空桩实现 。

这一过程的关键在于链接器脚本与符号弱定义（weak definition）机制。newlib 将 _write 定义为一个弱符号（ __attribute__((weak)) ），这意味着只要我们在自己的代码中提供一个同名的强定义函数，链接器就会自动选择我们