简介这是一份面向STM32F429开发者的串口通信工程示例基于标准外设库实现UART/USART收发覆盖GPIO复用配置、USART结构体初始化、阻塞/中断收发、错误回调以及DMA配合等常用环节适合正在学习STM32F4库函数开发或需要快速搭建串口调试框架的初学者与项目开发者。压缩包共295个文件约17.11MB包含完整Keil工程源码.c/.h、编译产物.o/.axf/.map/.lst、依赖与浏览信息文件.d/.crf以及工程配置.uvprojx/.uvoptx/.sct可直接打开运行或参考移植。目前已有1029人浏览学习。其中除了核心串口代码外还附带标准外设库各模块源文件、启动文件与清理脚本便于梳理串口通信的完整调用链同时便于理解库函数封装层次。作者在描述中表示可答疑并提供外包支持对初学者尤为实用。1. 串口通信在F429上的第一道坎标准库配好的外设上电却不是那么回事调试F429开发板串口的人十有八九会撞上这种情况程序烧进去了调试助手界面也打开了按一下发送回显要么是乱码要么是断断续续的半个帧。这不是硬件玄学大部分原因是时钟树、引脚复用和波特率配置在初始化阶段就没对齐。这份工程把USART1的标准库配置整理成一套可以直接编译烧录的代码PA9/PA10做收发轮询发送、查询接收、中断接收三套写法都排好了烧进去就能在调试助手上看到回显。适合刚接触F4平台还沿用标准库的开发者也适合想快速定位串口乱码的熟手当底层模板。2. 时钟树与引脚复用先让外设时钟和AF选项对上串口的初始化顺序理论上没有严格规定但实际调试里先配时钟再配引脚这条线不能乱。F429的时钟树是两级总线结构GPIO挂在AHB1上USART1挂在APB2上USART2/3/4/5挂在APB1上。代码里第一步要打开GPIOA的AHB1时钟第二步打开USART1的APB2时钟顺序反了GPIO寄存器读出来可能全是0xFF甚至直接触发HardFault。2.1 两级总线的差异APB1与APB2不是一回事F429系统主频到180MHz时高速外设总线APB2能到90MHz低速的APB1只有45MHz。USART1和USART6挂在APB2上USART2到USART5挂在APB1上这个分布不是随手写的它决定了你能用的最高波特率档位。外设所在总线最高频率对串口的影响USART1 / USART6APB290MHz高波特率优先选这两路USART2 / USART3 / USART4 / USART5APB145MHz波特率高了BRR量化误差明显GPIOA 至 GPIOKAHB1180MHz复用前必须开对应组时钟有个容易踩的盲区USART2虽然是串口但它在APB1上有人照抄USART1的初始化用RCC_APB2PeriphClockCmd去使能USART2时钟。标准库不会报错因为RCC_APB2Periph_USART2这个位根本不存在你的USART2寄存器完全没被使能读出来的状态全是复位值。要么外设时钟使能失败要么等到天荒地老中断也不来。F429这块芯片的串口资源多但不代表每个串口的待遇一样挂APB1的那几个跑个19200倒是无所谓想上921600就得掂量掂量了。2.2 引脚复用AF7GPIO_Mode_AF之后还有一步很多人写串口初始化时把GPIO配置成GPIO_Mode_OUT就想当然觉得能用结果发现引脚有电平翻转但对端收到的全是乱码。原因在F4的多路复用架构每个引脚可以映射多个外设功能你必须明确告诉引脚控制器我现在需要USART1而不是别的外设挂在这个引脚上。这一步叫AF选择USART1对应的是AF7代码里写作GPIO_AF_USART1。void UART_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; /* 先开两个时钟GPIOA挂在AHB1USART1挂在APB2 */ RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE); /* PA9 USART1_TX, PA10 USART1_RX */ GPIO_InitStructure.GPIO_Pin GPIO_Pin_9 | GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_OType GPIO_OType_PP; GPIO_InitStructure.GPIO_PuPd GPIO_PuPd_UP; GPIO_Init(GPIOA, GPIO_InitStructure); /* 关键的第二行把PA9、PA10切换到USART1的AF7功能 */ GPIO_PinAFConfig(GPIOA, GPIO_PinSource9, GPIO_AF_USART1); GPIO_PinAFConfig(GPIOA, GPIO_PinSource10, GPIO_AF_USART1); }两组GPIO_PinAFConfig才是真正让引脚挂到USART1上的动作。GPIO_AF_USART1是头文件里定义好的枚举值字面是7对应F429参考手册里的AF7复用表。逻辑上分两步理解GPIO_Init把引脚模式改成复用模式告诉引脚控制器“这个引脚不归GPIO模块管了”GPIO_PinAFConfig则把引脚的复用编号写进AFRL/AFRH寄存器告诉引脚控制器“具体转接给哪个外设”。参数上我一般都用GPIO_Speed_50MHz而不是100MHz因为UART是低速串行协议上升沿太陡反而增加振铃50MHz是信号完整性和功耗的平衡点。GPIO_PuPd_UP的理由是UART空闲电平是高电平引脚悬空时上拉能避免RX端误触发起始位让RXNE出现无意义的置位。GPIO_OType保持推挽输出就行别为了省一个上拉电阻去开漏后面你会为电平匹配问题多接一根飞线。3. USART外设初始化波特率、字长与使能顺序时钟和引脚打开之后轮到USART外设本身的配置。这里要用到USART_InitTypeDef结构体描述串口通信协议的一组属性。工程里的默认参数是115200、8位数据、无校验、1位停止位这也是电脑端串口调试助手最常见的默认组合。3.1 协议参数选型8N1不是唯一选择void UART_Config(uint32_t baud) { USART_InitTypeDef USART_InitStructure; USART_InitStructure.USART_BaudRate baud; USART_InitStructure.USART_WordLength USART_WordLength_8b; USART_InitStructure.USART_StopBits USART_StopBits_1; USART_InitStructure.USART_Parity USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, USART_InitStructure); USART_Cmd(USART1, ENABLE); }8N1的意思是8个数据位、无校验None、1个停止位这是异步串口最常见的形式。但不是所有场景都该用8N1比如连接Modbus总线设备经常要求8E1即偶校验加1位停止位。这时把USART_Parity改成USART_Parity_Even即可F4标准库里校验位会占用数据帧的第9位实际有效数据仍然8位。有一点要注意如果你校验位开了偶数校验结构体里的USART_WordLength仍然写USART_WordLength_8b库函数会自动把字长调整成带校验位的9位这个逻辑藏在源码里不理解的人容易在配置好后发现接收到的字节高一位总是异常。USART_Mode_Rx | USART_Mode_Tx同时开了收发两个方向。不少顺手抄的代码只开TX结果回显测试时发现主机永远收不到数据。USART_HardwareFlowControl_None是禁掉硬件流控四线制串口才需要RTS/CTS没有接那两根线就打开流控数据会一直卡在对方发不出来的状态。3.2 波特率误差为什么减半进位在这里是分水岭USART_Init内部会用PCLK2频率和你的目标波特率计算BRR寄存器值。BRR PCLK2 / baud标准库做了余数四舍五入的处理即加上baud/2再整除。理论上所有波特率都能配但误差不是线性的。目标波特率PCLK290MHz时BRR实际波特率误差960093759600.00.00%115200781115239.40.03%1843200481836734.70.35%30000003030000000.00%从表里能看到大部分常用波特率误差都在1%以内UART的容错范围通常在±2%左右问题不大。真正的坑发生在高波特率配合非整数分频系数的时候。以250000为目标时BRR 90M / 250000 360没误差没问题但有些人会用2000000BRR45实际波特率正好2M也没问题。问题是那些除不尽的目标例如1843200这种带有设备厂商烙印的速率误差已经到了0.35%在长线上来回反射后误码率会明显上升。我一般会避免使用非标准波特率直接选时钟能整除的值。如果你对端设备固定死了某个特殊波特率优先考虑用USART_OverSampling_8把16倍过采样降到8倍BRR变成之前的整数误差会摊薄一半。这个参数在USART_InitStructure结构体里没有需要在调用USART_Init之后单独调用USART_OverSamplingCmd(USART1, USART_OverSampling_8)小心别漏。3.3 使能顺序USART_Cmd放最后不是形式主义工程里的初始化顺序是固定的先GPIO后USARTUSART_Init写完结构体后最后才USART_Cmd使能外设。顺序反过来会出什么现象外设一使能移位寄存器就开始工作而此刻BRR可能还是复位值0波特率被当成无穷大引脚上的电平会闪一下异常波形。如果有对端连着这一瞬间就可能被识别成帧起始。另一个容易被忽略的状态上电复位后DR寄存器里可能残留上次调试暂停时的数据。修复的方法是给串口模块做一个复位动作——读一次SR寄存器再读一次DR寄存器。标准库的USART_ClearITPendingBit在F4上并不总能把所有残留清干净最可靠的方式是手动读这两次。这个习惯我后面每次换新板子都保留着。4. 数据收发轮询、查询与中断三种写法一个真正能跑的串口工程除了初始化还得解决“怎么把数据发出去”和“怎么把数据收进来”这两个问题。这份工程里三套代码对应三个使用阶段刚开始验证用轮询简单交互用查询做正式产品就用中断加缓冲。4.1 轮询发送的TXE与TC细节void UART_SendByte(uint8_t byte) { /* TXE置1表示发送数据寄存器已空可以写入下一个字节 */ while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); USART_SendData(USART1, byte); } void UART_SendString(char *str) { while (*str) UART_SendByte((uint8_t)*str); }TXE是发送数据寄存器空标志代表CPU可以把数据写进外设的发送缓冲区但此时数据不一定已经出现在引脚上。还有另一个标志位TC表示整个移位寄存器把数据帧完全送出、引脚回到空闲状态。轮询发送一串数据时用TXE就够了TC反而不是合适的判断条件——如果每发一个字节都等TC串口速率会被拉低因为TC要等整个帧发送完成才置位。但发第一个字节前我建议先等一次TC避免外设刚使能时的链路抖动吞掉首字节。4.2 查询接收的卡死问题uint8_t UART_ReceiveByte(void) { /* 等待RXNE表示接收数据寄存器非空 */ while (USART_GetFlagStatus(USART1, USART_FLAG_RXNE) RESET); return (uint8_t)USART_ReceiveData(USART1); }这段代码逻辑没问题但工程里绝不建议在裸机主循环里直接调用它。原因是没做超时保护如果对端不回应程序会无限卡死在while循环里。调试时你会发现按了暂停键PC指针正好停在USART_GetFlagStatus那一行看起来像死机实际是死等。我通常在工程里给查询接收套一个超时窗口用一个全局变量做标志SysTick每毫秒减一次进入UART_ReceiveByte时先把这个标志设置成200循环等待时每个周期查一次标志减到0就直接返回0xFF表示超时。这样既保留了查询模式的简单性又给主循环留了退路。正式的工程里收数据会用到下一节的中断方案查询模式只适合初始化自测和发送应答类交互。4.3 中断接收NVIC优先级与环形缓冲做产品时串口数据什么时候到是不确定的主循环不可能一直死等。工程里用USART1的接收中断加环形缓冲区解决。#define UART_RX_BUF_SIZE 64 static volatile uint8_t rxBuf[UART_RX_BUF_SIZE]; static volatile uint16_t rxRd 0, rxWr 0; void USART1_IRQHandler(void) { /* 判断RXNE中断标志读取DR会自动清除标志 */ if (USART_GetITStatus(USART1, USART_IT_RXNE) ! RESET) { rxBuf[rxWr] (uint8_t)USART_ReceiveData(USART1); rxWr (rxWr 1) % UART_RX_BUF_SIZE; } }中断初始化代码USART_ITConfig(USART1, USART_IT_RXNE, ENABLE); NVIC_InitStructure.NVIC_IRQChannel USART1_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority 1; NVIC_InitStructure.NVIC_IRQChannelSubPriority 0; NVIC_InitStructure.NVIC_IRQChannelCmd ENABLE; NVIC_Init(NVIC_InitStructure);USART_ReceiveData一次读取会同时把RXNE硬件标志清零千万别画蛇添足在读取后手动清标志标准库的某些清零函数反而会把下一次中断触发条件弄乱。环形缓冲的读写指针是分离的rxWr只由中断服务函数写rxRd只由主循环读两者相等时说明缓冲为空。这个结构足够应对连续几帧数据的接收压力前提是主循环读取频率要高于最坏情况下的填充速度否则缓冲区溢出后新数据会覆盖旧数据。4.4 主循环取数据超时判帧中断负责把字节塞进缓冲主循环负责把缓冲里的字节按帧取出来。最常见的取帧策略是超时判定同一个串口的相邻字节间隔如果超过3到5个字节时间就认为一帧结束。工程里用SysTick实现一个简单的帧超时计数if (rxRd ! rxWr) { while (rxRd ! rxWr) { uint8_t ch rxBuf[rxRd]; rxRd (rxRd 1) % UART_RX_BUF_SIZE; frameBuf[frameLen] ch; } if (frameLen 0) { /* 在这里处理一帧完整数据 */ UART_SendString((char *)frameBuf); frameLen 0; } }这个设计适合变长协议每条指令长度不同用固定长度判帧反而麻烦。注意帧缓冲的数组也要做边界保护如果传输内容超过缓冲长度要么截断要么报错裸数组越界写是很隐蔽的内存踩踏。5. 串口配置避坑合辑现象、原因与处置顺序标准库串口的坑多半不在C语法层面而在芯片配置和外部环境的匹配。整理了五条最常遇到的问题每条都按现象到原因再到解决展开。5.1 换板子后全部乱码现象工程在原来那块F429板上能正常收发换成另一块F429板子后所有波特率下的串口助手都显示乱码示波器看TX引脚有波形跳动但完全没有可辨识的帧结构。原因F429的外部晶振变了。原来板子用25MHz晶振新板子用8MHz但代码里的HSE_VALUE还写着25MHzSystemInit计算PLL参数时把8MHz当25MHz乘整个系统主频跑偏PCLK2不再是90MHzBRR寄存器算出来的波特率自然不对。解决先看新板子晶振丝印确认频率后修改stm32f4xx.h里的HSE_VALUE宏再核对SystemInit里PLL_M、PLL_N、PLL_P这三个参数。修改后建议用示波器量一下MCO引脚输出的时钟信号验证。F429的PA8可以复用成MCO1输出内部时钟实测频率和预期一致再烧程序验证串口。5.2 TX引脚有电平变化但字节内容错乱现象发送时用示波器量PA9能看到高低电平翻转但接上USB转串口工具后助手显示的内容和发送内容完全对不上甚至每个字节都重复出现相同错误。原因GPIO错配成GPIO_Mode_OUT而不是GPIO_Mode_AF。普通输出模式下引脚被GPIO模块接管USART外设的数据根本没路由到引脚上此时看到的电平可能是GPIO初始化时的静态电平或者是代码里附加的翻转操作不是协议波形。解决把GPIO_InitStructure.GPIO_Mode改成GPIO_Mode_AF然后补上GPIO_PinAFConfig那两行。配置完检查一下复用功能切换寄存器AFRL/AFRH如果AF编号写成别的值比如把AF7误写成AF8引脚会被接到另一个外设上去现象和这类似。5.3 上电后第一个字节丢失现象程序启动后第一次调用UART_SendString对端收不到第一个字符从第二个字符开始一切正常。这个现象在低速9600波特率时尤其明显。原因USART_Cmd使能外设后发送路径还没稳定。有些情况是GPIO从复位状态切换到复用状态时引脚电平有一个短暂的过渡期更多情况是代码没有等待发送状态机就绪就直接写DR寄存器第一个字节被状态机的初始化过程吞掉。解决发送第一个字节前强制等待TC标志置位让移位寄存器完全空闲后再连续发送void UART_SendStringSafe(char *str) { /* 首字节前等待TC确保发送状态机完全空闲 */ while (USART_GetFlagStatus(USART1, USART_FLAG_TC) RESET); while (*str) UART_SendByte((uint8_t)*str); }从那以后我把发送函数的入口统一改成先等TC再发虽然损失了TXE轮询的一点实时性但换来了每次上电行为一致。5.4 中断接收丢帧两个字节只收到一个现象主机连续发0x01 0x02两个字节中断里只在缓冲里收到0x01。把波特率调低后又能收到两个看起来跟速率有关。原因两个字节间隔过短时RXNE标志在第二个字节到达时自动被新数据覆盖而中断服务函数如果执行时间太长比如在里面做了打印、延时第二个字节的RXNE标志可能来不及处理就被硬件再次置位覆盖。另一个常见元凶是NVIC优先级配置不合理如果其他外设中断频繁抢占串口中断RXNE在等待期间被连续两次触发最终只保存了最后一次状态。解决中断服务函数里只做一件事读数据放进环形缓冲任何协议解析或打印都移到主循环。NVIC优先级上把串口中断抢占优先级设得比其它外设高例如抢占优先级1其它外设从2开始排同抢占优先级内不再用子优先级区分避免嵌套深度失控。5.5 高波特率死活对不上现象把波特率设成1843200或3M时收发双方配置一致但传输过程频繁误码几个KB数据里总有几个字节是错的。降到115200一切正常。原因BRR寄存器是整数PCLK2除以波特率的结果如果不能整除余数会让实际波特率偏离目标高波特率下位周期缩短同一个百分比的绝对误差对应的时间偏差以纳秒计采样点刚好落在信号边沿附近。解决优先选择PCLK2能整除的波特率例如90MHz下选115200、3000000、4500000这类有明显整除关系的值。如果目标波特率无法整除调用USART_OverSamplingCmd切换到8倍过采样量化步长从1/16位缩短到1/8位误差直接减半。硬件上TX线串一个33Ω电阻抑制振铃USB转串口工具选带独立晶振的少用内部RC振荡器的廉价方案。排查顺序建议先查HSE_VALUE再量MCO然后软件里打印PCLK2频率确认最后才检查USART_Init参数这条链路能处理九成以上串口异常。6. 收尾技巧printf重定向与验证路径工程里最后一层是调试便利性。很多开发者发现裸机工程里调用printf没有输出或者输出一段后进入奇怪的卡死状态这和标准库的半主机模式有关。串口打印调试信息是刚需解决办法是重定向fputc到USART1。int fputc(int ch, FILE *f) { /* 和轮询发送一样等TC保证字节真正发完 */ while (USART_GetFlagStatus(USART1, USART_FLAG_TC) RESET); USART_SendData(USART1, (uint8_t)ch); return ch; }加了这段代码还需要在IDE里启用微库选项。MDK环境下把Use MicroLIB打钩IAR里对应配置是允许C库使用底层I/O重定向。否则标准库的fputc默认打进半主机机制程序会在底层暂停等待调试器接管于是你看到的现象就是第一行输出正常第二行开始卡住。重定向完成后printf就能和普通调试助手顺畅交互格式化输出浮点数之类的工作也都能正常跑。验证路径上我有一套固定的动作先接好USB转串口工具确认接线无误给板子上电串口助手设好波特率115200和8N1发送一个单字节0x55看回显是否一致然后发送一串文本验证连续发送最后把波特率提到460800观察是否出现断帧。如果全程稳定再继续往上压速率。这个工程虽然小但我每次换新板子重写串口底层的习惯是固定的先查外部晶振再量MCO确认PCLK频率然后才是USART参数最后用0x55单字节过一遍链路。从那以后我在串口上翻车的次数少了很多多数问题都能在十分钟内定位。希望帮到你。本文还有配套的精品资源点击获取
