STM32 串口通信入门：printf 重定向 + 调试技巧

作为STM32新手串口通信是嵌入式调试的万能钥匙。很多新手调试程序时只能靠LED亮灭判断运行状态出错后无从排查想查看变量、确认函数执行情况也没有有效方法。串口通信可解决这一问题通过printf函数STM32能将程序信息发送到电脑直观呈现运行过程显著提升调试效率。本文从零开始手把手教你实现STM32串口通信与printf重定向步骤清晰代码可直接复制新手看完就能用串口调试程序。你调试STM32时是否也遇到过不知道程序跑没跑通的问题评论区说说你的调试痛点一、前置准备硬件软件串口通信无需复杂设备复用之前LED项目的硬件和软件提前准备好以下物品即可。1. 硬件准备核心硬件STM32F103C8T6 最小系统板适合新手资料丰富下载工具ST-Link V2用于烧录串口程序通信工具USB转TTL模块实现STM32与电脑通信的关键设备辅助工具杜邦线4-5根电源STM32通过ST-Link供电USB转TTL通过电脑USB供电无需额外电源。USB转TTL模块负责转换TTL电平与USB电平实现双向通信。2. 软件准备Keil MDK V5.38a已搭建STM32F103环境含STM32F1xx_DFP芯片包串口调试助手推荐XCOM正点原子体积小、操作简单ST-Link驱动已安装用于烧录USB转TTL驱动电脑可自动安装未识别可自行查找安装。你已准备好USB转TTL模块和串口调试助手了吗找不到软件可以在评论区留言二、先搞懂串口通信是什么串口通信并不复杂无需深究底层原理先掌握用法即可。1. 通俗理解串口通信就是电脑和STM32对话电脑与STM32通信需杜邦线和USB转TTL作为连接媒介约定好波特率、数据位等规则就能双向传递信息。2. 核心专业名词UARTSTM32自带串口外设负责处理数据收发本文使用UART1波特率通信速率新手固定用9600或115200即可稳定性最高数据位/停止位/校验位通信规则新手固定为8位数据位、1位停止位、无校验位printf重定向修改printf输出路径使其通过STM32串口发送到电脑。3. 核心逻辑STM32通过UART1将printf内容转为电信号经USB转TTL转换电平后传递给电脑电脑通过串口调试助手接收显示实现双向通信。三、实操步骤STM32 串口配置 printf 重定向重点关注硬件接线、串口初始化代码、printf重定向代码严格按步骤操作新手不要跳过。Step 1硬件接线使用STM32的UART1USB转TTL核心引脚4个遵循交叉通信原则即TX接RXRX接TX具体接线如下USB转TTL模块STM32F103C8T6 最小系统板注意事项VCC3.3V绝对不要接5V会烧STM32芯片GNDGND必须共地否则无法通信TXD发送PA10UART1_RXTX接RXRXD接收PA9UART1_TXRX接TX常见坑1接线接反会导致接收不到数据接5V会烧芯片新手务必核对接完后再次检查。STM32F103C8T6的UART1引脚固定TX为PA9RX为PA10不可接错。Step 2编写串口初始化代码核心是开启时钟、配置GPIO和串口参数代码带详细注释可直接复制。1. uart.h 代码#ifndef __UART_H__ #define __UART_H__ #include stm32f10x.h #include stdio.h // 用于printf函数 // 串口初始化函数声明波特率96008位数据位1位停止位无校验位 void UART1_Init(void); #endif2. uart.c 代码#include uart.h // 串口1初始化函数PA9-TXPA10-RX波特率9600 void UART1_Init(void) { // 1. 开启GPIOA和USART1时钟外设必开时钟 RCC-APB2ENR | RCC_APB2ENR_IOPAEN; // 开启GPIOA时钟 RCC-APB2ENR | RCC_APB2ENR_USART1EN; // 开启USART1时钟 // 2. 配置PA9TX为复用推挽输出 GPIOA-CRH ~(GPIO_CRH_MODE9 | GPIO_CRH_CNF9); // 清除原有配置 GPIOA-CRH | GPIO_CRH_MODE9_0 | GPIO_CRH_MODE9_1; // 输出速度50MHz GPIOA-CRH | GPIO_CRH_CNF9_1; // 复用推挽输出 // 3. 配置PA10RX为浮空输入 GPIOA-CRH ~(GPIO_CRH_MODE10 | GPIO_CRH_CNF10); // 清除原有配置 GPIOA-CRH | GPIO_CRH_CNF10_0; // 浮空输入 // 4. 配置USART1参数 USART1-BRR 0x2710; // 波特率960072MHz系统时钟对应值 USART1-CR1 | USART_CR1_UE; // 使能USART1 USART1-CR1 | USART_CR1_TE; // 使能发送功能 USART1-gt;CR1 | USART_CR1_RE; // 使能接收功能#xA;}Step 3实现printf重定向重写fputc函数即可让printf输出到串口代码添加到uart.c开头// 重写fputc函数实现printf重定向到串口1 int fputc(int ch, FILE *f) { while(!(USART1-SR USART_SR_TXE)); // 等待发送缓冲区为空 USART1-DR (uint8_t)ch; // 发送字符 return ch; }重写后main函数中直接用printf即可发送数据无需额外调用发送函数。Step 4编写main函数测试串口通信修改main.c调用串口初始化函数发送测试信息代码可直接复制#include stm32f10x.h #include system_stm32f10x.h #include uart.h // 包含串口头文件 // 延时函数控制发送频率 void Delay_ms(uint32_t ms) { for(volatile uint32_t i 0; i ms * 1000; i); } int main(void) { uint32_t count 0; // 测试用计数变量 SystemInit(); // 初始化系统时钟72MHz UART1_Init(); // 初始化串口1波特率9600 while(1) { printf(Hello STM32! 我是串口通信测试\r\n); printf(当前计数%d串口通信正常\r\n, count); printf(-------------------------\r\n); count; // 计数自增 Delay_ms(1000); // 每秒发送一次 } }四、编译 烧录 串口调试代码配置完成后按以下步骤操作即可实现STM32与电脑通信。Step 1编译程序点击Keil Build或按F7开始编译显示0 Errors即为编译成功警告不影响常见坑编译报错fputc函数重定义确保仅在uart.c中添加一次该函数。Step 2烧录程序ST-Link连接STM32并上电Keil中点击Download或按CtrlF5开始烧录显示Download completed successfully说明烧录成功。Step 3串口调试助手配置打开XCOM正点原子按以下步骤配置即可接收信息USB转TTL插入电脑设备管理器中查看其对应的COM口端口选择查到的COM口也可以通过正点原子中串口选择查找。波特率9600数据位8停止位1校验位无。点击打开串口按钮变为关闭串口即成功接收窗口每隔1秒会收到STM32发送的信息说明通信成功。效果演示重启有乱码是正常的现象不影响常见坑接收不到数据解决方案1. 核对接线2. 核对串口参数3. 检查程序烧录和串口初始化4. 重新插拔USB转TTL、重启调试助手。你的串口调试助手成功收到信息了吗成功的朋友扣1未成功的可以留言排查六、新手常见踩坑总结整理6个高频坑及解决方案帮助大家高效排错接线错误 → 交叉接TX和RX确保GND共地、VCC接3.3V串口调试助手参数错误 → 波特率96008N1配置选对COM口printf未定义 → uart.h添加stdio.h配置正确Include Paths串口乱码 → 核对波特率、接线确保调用SystemInit接收不到数据 → 检查程序烧录、串口初始化、USB转TTL驱动fputc重定义 → 仅在uart.c中添加一次该函数。结语恭喜你成功实现STM32串口通信和printf重定向掌握了嵌入式调试的核心技巧。串口通信是嵌入式基础后续学习传感器、中断等内容都需要用到今天掌握的技能会持续助力你的学习。新手觉得串口难多是卡在接线和printf重定向跨过后会发现它简单又实用。后续我会持续更新STM32入门教程跟着学习就能轻松搞定入门。最后恳请大家一键三连点赞、收藏、关注走一波你们的支持就是我更新的最大动力评论区分享你的实操经历和问题我会一一回复和大家一起进步