CubeMx——串口与 printf 打印

### 配置 STM32CubeMX 中的 `printf` 函数 为了使 `printf` 函数能够在基于 HAL 库的 STM32 项目中正常工作并通过串口输出，需完成几个必要的设置。 #### 设置 USART 初始化结构体 在 STM32CubeMX 软件界面内配置 USART 外设参数，确保选择了合适的波特率、字长和其他属性。这一步骤会自动生成初始化代码，在生成的项目中的 `.c` 文件里找到类似如下定义： ```c UART_HandleTypeDef huart1; ``` 此句声明了一个用于 UART/USART 的处理对象实例[^1]。 #### 修改 `fputc` 和 `fgetc` 函数 为了让标准 C 库里的输入输出函数能够通过指定的串行端口传输数据，需要重写这两个函数。具体做法是在项目的源码目录下的 `usart.c` 或其他适当位置添加下面两段代码片段： 对于字符输出（即 `printf`），应有如下形式的 `fputc` 实现： ```c int fputc(int ch, FILE *f) { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, 0xFFFF); return ch; } ``` 而对于字符输入，则可以提供相应的 `fgetc` 定义来支持像 `getchar()` 这样的调用： ```c int fgetc(FILE *f) { uint8_t ch = 0; HAL_UART_Receive(&huart1, &ch, 1, 0xFFFF); return ch; } ``` 上述两个函数分别实现了将单个字符发送给以及从硬件 UART 接收单个字符的功能[^4]。 #### 添加 `<stdio.h>` 头文件 最后但同样重要的是，在任何打算使用这些 I/O 功能的地方——无论是主应用程序还是驱动程序模块——都应当包含标准 IO 库头文件： ```c #include <stdio.h> ``` 这样做的目的是让编译器知道如何解析 `printf`, `scanf` 及其变种版本等高级别的I/O操作符[^2]。 完成了以上步骤之后，就可以利用 `printf` 来向连接至选定 USART 线路的终端设备发送调试信息或其他任何形式的数据流了。