STM32CubeIDE如何实现STM32开发板printf输出到IDE内置控制台

为什么STM32CubeIDE默认不支持显示开发板printf输出的控制台标签页 #

• STM32CubeIDE的默认控制台仅用于输出主机端的IDE运行日志，包括编译信息、调试器控制指令反馈等，本身没有默认绑定下位机开发板的硬件输出通道
• 开发板的printf输出属于下位机侧的数据流，需要依托特定硬件传输通道（SWO、UART、USB虚拟串口等）和上位机调试协议做透传，不同项目的硬件配置、使用的传输通道差异极大，官方无法做通用的默认适配

实现printf打印到内置控制台的核心要求 #

该功能必须同时完成项目属性/调试配置修改 + C语言底层I/O函数重定向，仅修改项目属性无法实现：C标准库的printf默认没有绑定嵌入式平台的硬件输出逻辑，必须手动重写底层输出函数关联到对应的硬件通道，再在IDE侧打开对应的数据接收窗口，才能完成输出展示。

推荐实现方案（SWO通道，无需额外接线，适配NUCLEO-F401RE） #

NUCLEO-F401RE板载的ST-Link已经默认连接了SWO调试引脚，不需要额外接线就可以实现调试状态下的printf输出，操作步骤如下：

步骤1：重定向printf底层输出逻辑 #

在项目的main.c文件头部或者独立的系统调用重写文件中，添加如下代码：

#include "stm32f4xx_hal.h"
#include <stdio.h>

/* 重写printf底层输出函数，绑定到SWO通道0 */
int __io_putchar(int ch) {
    // 等待SWO发送缓冲区空闲
    while (ITM->PORT[0U].u32 == 0UL);
    // 写入字符到SWO通道
    ITM->PORT[0U].u8 = (uint8_t)ch;
    return ch;
}

/* 适配newlib-nano标准库的write系统调用 */
int _write(int fd, char *ptr, int len) {
    for (int i = 0; i < len; i++) {
        __io_putchar(ptr[i]);
    }
    return len;
}

如果需要支持printf输出浮点数，需要额外修改项目属性：

1. 右键项目名选择Properties > C/C++ Build > Settings > Tool Settings > MCU Settings
2. 勾选Use float with printf from newlib-nano，保存后重新编译

步骤2：修改调试配置启用SWV功能 #

1. 点击顶部菜单栏Run > Debug Configurations，找到当前项目对应的调试配置项
2. 切换到Debugger标签页，找到Serial Wire Viewer (SWV)配置区域
3. 勾选Enable选项，将Core Clock参数设置为你的项目实际配置的系统主频（STM32F401RE最高为84MHz，对应填84000000）
4. 切换到同页面的SWV Console标签，勾选Enable port 0，保存配置

步骤3：打开内置SWV控制台查看输出 #

1. 启动调试后，点击顶部菜单栏Window > Show View > Other
2. 在弹出的窗口中找到SWV > SWV ITM Data Console，打开该视图
3. 点击视图面板上的红色录制按钮启用数据接收，后续printf输出的内容就会显示在该控制台中

替代方案（使用内置串口终端，无需SWO） #

如果你不想修改现有UART发送的逻辑，可以直接使用IDE内置的串口终端替代PuTTY：

1. 保留你现有重定向printf到HAL_UART_Transmit的代码逻辑
2. 点击顶部菜单栏Window > Show View > Other，找到Terminal > Terminal打开内置终端
3. 点击终端面板上的连接按钮，连接类型选择Serial，配置和你UART一致的波特率、数据位、停止位、校验位参数，选择板载ST-Link对应的串口端口号，连接后即可查看输出

内容的提问来源于stack exchange，提问作者overmach