在GD32F303上做串口通信最头疼的就是接收不定长数据。如果你还在用逐字节中断加状态机的方式波特率一提高数据量一上来CPU就被频繁的中断打满系统里其他任务基本没法跑。用USART硬件空闲中断配合DMA把数据搬运全部交给DMA一帧数据结束后由空闲中断通知CPU去处理既能拿到完整的一帧又几乎不占CPU。今天就把我在项目里实际验证过的这一套USARTDMA空闲中断完整方案分享出来代码可以直接抄坑我替你踩过了。文章适合正在做串口协议解析、Modbus RTU帧接收、上位机指令交互的朋友用的是GD32F30x标准外设库你只要改一下宏定义和引脚配置就能跑起来。1. 方案选型与整体思路拆解1.1 先说说为什么不用逐字节中断很多朋友拿到串口接收需求第一反应是开一个接收中断进一次中断读一个字节放进数组。这种方式本身没毛病但它有两个绕不开的问题一是中断次数和接收字节数成正比二是每次中断都要做压栈、出栈、读寄存器、判断状态这些开销累加起来非常可观。我算过一笔账115200波特率8位数据位、1位停止位没有校验位一个字节实际占用10个bit换算下来每秒最多接收11520个字节。如果每个字节触发一次接收中断那就意味着每秒钟有超过1万次中断在打断主流程CPU需要频繁保存现场、跳转、恢复现场。嵌入式系统里除了串口可能还有定时器、外部中断、任务调度这些开销一叠加CPU负载很容易就上去了。DMA的作用就是把“从USART接收寄存器把数据搬到内存缓冲区”这件事接管过来CPU只需要在数据搬完之后得到一个通知。但DMA本身有个问题它只管搬不管“这一帧什么时候结束”。如果你用DMA传输完成中断那就只能处理定长帧因为DMA只有搬满你预设的长度时才会触发完成事件。如果数据帧长度不固定或者一帧比缓冲区短DMA根本不会理你。这时候就需要USART的空闲中断。空闲中断是串口控制器检测到总线上数据停止超过一个字节时间后触发的硬件事件它天然就是“一帧数据结束”的信号。把DMA和空闲中断结合起来逻辑就非常顺了DMA负责不间断地接收数据CPU不用管总线空闲了说明一帧数据收完了空闲中断通知CPU来取数据。这就是这个方案能省CPU的核心原因。1.2 三种串口接收方案对比与选型我把常用的三种串口接收方案放在一起做过对比各有各的适用场景先看表格方案CPU开销帧长支持实现复杂度适用场景逐字节接收中断高任意长度低低频小数据量、流式数据、帧间隔极短DMA 传输完成中断低仅定长低协议帧长度固定、批量数据搬运DMA 空闲中断低任意长度中不定长帧、逐帧交互、中高波特率逐字节中断适合那种一两个字节的简单命令交互比如读个按键状态、回个应答数据量很小用DMA反而显得杀鸡用牛刀。DMA加传输完成中断适合协议里已经明确规定了帧长度的场景比如每帧固定8字节或者32字节配置好DMA传输数量之后搬完就触发中断非常简单可靠。但工业通信里最常见的往往是Modbus RTU、自定义协议、AT指令这种不定长帧帧长度根据内容不同而变化。用定长DMA接收只能把缓冲区开得很大再用空闲中断来界定帧边界。这也是我在项目中最终选择DMA加空闲中断的原因。它的实现其实并不复杂核心就是初始化USART时使能空闲中断和DMA接收请求初始化一个DMA通道负责把数据搬进缓冲区然后在空闲中断里读出DMA剩余计数算出这一帧的实际长度。2. 硬件特性与开发环境准备2.1 GD32F303的USART与DMA资源盘点GD32F303是兆易创新基于Cortex-M4内核的32位MCU主频最高能跑到120MHz。片上串口资源很丰富有USART0、USART1、USART2以及UART3、UART4这几个串口外设对于一般产品来讲完全够用。DMA控制器则有DMA0和DMA1两个每个控制器下面有6个通道可以灵活映射到不同的外设请求。这里要特别提醒一句GD32F303虽然和STM32F103有很多相似之处但DMA请求映射并不是完全相同的。很多从STM32F1迁移过来的朋友直接照搬STM32F103里USART1对应DMA1_Channel5的做法结果GD32F303上根本收不到数据。我在GD32F30x上用的USART0接收通道和STM32F103就不一样具体到你的芯片一定要去翻GD32F30x参考手册里的DMA请求映射表确认当前USART对应哪个DMA控制器、哪个通道再动手写代码。还需要注意APB1和APB2的时钟频率。GD32F303的APB1最高60MHzAPB2最高120MHzUSART0通常是挂在APB2上的USART1和USART2挂在APB1上。串口波特率是通过外设时钟分频算出来的如果APB1和APB2时钟没配对波特率就会出现偏差表现就是能发能收但偶尔出错。做高波特率通信时优先用USART0分频步进更细误差更小。2.2 开发工程与引脚接线开发环境我用的是Keil MDK5配合GD32F30x标准外设库。在Keil里新建工程后把GD32F30x固件库里的核心文件和启动文件加进去然后在Options for Target里选好芯片型号比如GD32F303VET6。编译链接没有问题之后就可以开始写业务代码了。如果你用IAR或者STM32CubeIDE原理相同移植成本也不大。硬件接线非常简单。我用的是GD32F303VET6的USART0发送引脚PA9接收引脚PA10外接一个USB转TTL串口模块。接线方式是模块的TXD接板子的PA10模块的RXD接板子的PA9GND必须共地。这里最容易犯的错就是把TXD和RXD接反导致什么数据都收不到调试半天还以为是代码问题。main函数的基本骨架是这样int main(void) { systick_config(); usart0_dma_rx_init(); while (1) { if (rx_complete_flag) { rx_complete_flag 0; process_rx_frame(rx_app_buffer, rx_len); rx_len 0; } } }初始化完串口和DMA之后主循环只需要不停地查询接收完成标志。收到一帧数据就丢给业务处理函数没有数据就继续跑其他逻辑。整个接收流程里CPU只在空闲中断里做了很少的工作剩下的时间都在主循环里自由支配。3. 核心代码实现与关键细节解析3.1 USART0与DMA初始化配置初始化是整个方案的基石。我先把完整的初始化函数贴出来再逐段解释每一部分为什么这么写。#include gd32f30x.h #include string.h #define RX_BUFFER_SIZE 256 uint8_t rx_buffer[RX_BUFFER_SIZE]; uint8_t rx_app_buffer[RX_BUFFER_SIZE]; volatile uint16_t rx_len 0; volatile uint8_t rx_complete_flag 0; /* USART0_RX在GD32F30x系列上通常对应DMA0通道3实际通道以参考手册DMA请求映射表为准 */ #define USART0_RX_DMA_CH DMA_CH3 #define USART0_RX_DMA DMA0 void usart0_dma_rx_init(void) { /* 1. 使能时钟GPIO、USART、DMA三部分都要开 */ rcu_periph_clock_enable(RCU_GPIOA); rcu_periph_clock_enable(RCU_USART0); rcu_periph_clock_enable(RCU_DMA0); /* 2. 引脚复用配置PA9 USART0_TXPA10 USART0_RX */ gpio_af_set(GPIOA, GPIO_AF_7, GPIO_PIN_9 | GPIO_PIN_10); gpio_mode_set(GPIOA, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_PIN_9 | GPIO_PIN_10); gpio_output_options_set(GPIOA, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_9); /* 3. USART0基本参数配置 */ usart_deinit(USART0); usart_baudrate_set(USART0, 115200U); usart_word_length_set(USART0, USART_WL_8BIT); usart_stop_bit_set(USART0, USART_STB_1BIT); usart_parity_config(USART0, USART_PM_NONE); usart_hardware_flow_rts_config(USART0, USART_RTS_DISABLE); usart_hardware_flow_cts_config(USART0, USART_CTS_DISABLE); usart_receive_config(USART0, USART_RECEIVE_ENABLE); usart_transmit_config(USART0, USART_TRANSMIT_ENABLE); /* 4. 关键使能空闲中断和DMA接收请求 */ usart_interrupt_enable(USART0, USART_INT_IDLE); usart_dma_receive_config(USART0, USART_DENR_ENABLE); /* 5. DMA参数配置外设到内存、8位宽度、非循环模式 */ dma_parameter_struct dma_init_struct; dma_deinit(USART0_RX_DMA, USART0_RX_DMA_CH); dma_init_struct.periph_addr (uint32_t)(USART0-DATA); dma_init_struct.memory_addr (uint32_t)rx_buffer; dma_init_struct.direction DMA_PERIPHERAL_TO_MEMORY; dma_init_struct.number RX_BUFFER_SIZE; dma_init_struct.periph_inc DMA_PERIPH_INCREASE_DISABLE; dma_init_struct.memory_inc DMA_MEMORY_INCREASE_ENABLE; dma_init_struct.periph_width DMA_PERIPHERAL_WIDTH_8BIT; dma_init_struct.memory_width DMA_MEMORY_WIDTH_8BIT; dma_init_struct.priority DMA_PRIORITY_HIGH; dma_init(USART0_RX_DMA, USART0_RX_DMA_CH, dma_init_struct); dma_circulation_disable(USART0_RX_DMA, USART0_RX_DMA_CH); dma_channel_enable(USART0_RX_DMA, USART0_RX_DMA_CH); /* 6. 配置USART0中断优先级 */ nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2); nvic_irq_enable(USART0_IRQn, 0, 0); }这里有一个很容易忽略的细节DMA的外设地址必须写成USART0-DATA也就是USART数据寄存器的地址而不是USART0外设基地址。USART的DATA寄存器是专门用来收发数据的写错成其他寄存器地址DMA搬过来的数据就是乱的。我在调试时见过有人把外设地址写成了USART_DATA(USART0)结果数据全不对最后逐字节对比才发现是寄存器地址搞错。另外一个关键点是第4步的顺序。先使能USART的空闲中断再使能USART的DMA接收请求最后再使能DMA通道。如果你想先使能DMA通道再开USART接收也不是不行但建议按这个顺序来逻辑上更清晰USART准备好接收DMA也准备好搬运最后DMA通道打开数据一到就自动开始搬运。如果你用的是不同版本的标准外设库GPIO初始化部分的API可能略有不同。老版本库用gpio_init(GPIOA, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_9 | GPIO_PIN_10)这种写法新版本引入了gpio_mode_set和gpio_af_set。编译报错时优先检查是不是API版本不匹配不要上来就怀疑硬件。3.2 空闲中断处理函数如何算出实际接收长度并重新装载DMA初始化做好之后真正干活的是USART0中断处理函数。这一部分我把完整代码贴出来然后详细讲解里面的每一步。void USART0_IRQHandler(void) { if (usart_interrupt_flag_get(USART0, USART_INT_FLAG_IDLE) ! RESET) { /* 清除空闲中断标志库函数内部会按手册要求依次读STAT和DATA */ usart_interrupt_flag_clear(USART0, USART_INT_FLAG_IDLE); /* 读取DMA当前剩余传输次数算出这一帧实际接收长度 */ uint16_t remain dma_transfer_number_get(USART0_RX_DMA, USART0_RX_DMA_CH); rx_len RX_BUFFER_SIZE - remain; if (rx_len 0 rx_len RX_BUFFER_SIZE) { /* 拷贝到应用缓冲区避免主循环处理旧帧时被DMA新数据覆盖 */ memcpy(rx_app_buffer, rx_buffer, rx_len); rx_complete_flag 1; } /* 重新装载DMA准备接收下一帧 */ dma_channel_disable(USART0_RX_DMA, USART0_RX_DMA_CH); dma_transfer_number_config(USART0_RX_DMA, USART0_RX_DMA_CH, RX_BUFFER_SIZE); dma_channel_enable(USART0_RX_DMA, USART0_RX_DMA_CH); } }这里最核心的代码就一行rx_len RX_BUFFER_SIZE - remain。DMA通道内部维护着一个计数器记录当前还剩余多少个数据传输单元没有搬完。初始化DMA时我设置了传输数量为RX_BUFFER_SIZEDMA每搬运一个字节这个计数器就减1。当一帧数据收完总线空闲DMA停在当前计数值上直接用缓冲区大小减去剩余计数得到的就是已经搬进缓冲区的字节数。我举个例子假设缓冲区是256字节DMA初始化时计数器是256。外部设备发来3字节数据DMA依次把这3个字节搬进rx_buffer此时计数器变成了253。总线空闲触发空闲中断后执行256 - 253得到3正好就是这一帧的长度。这个计算方法很直观也是整个方案的精髓。读取DMA计数器的函数名在各个库版本里略有不同。GD32F30x标准外设库里叫dma_transfer_number_getSTM32标准库里对应的是DMA_GetCurrDataCounter。如果你在移植过程中发现这个函数名不存在去库里搜一下当前计数相关的函数基本就能对上。关于清除空闲中断标志也说明一下。USART的空闲标志不是写一下就能直接清零的按GD32F30x参考手册的要求需要依次读取USART_STAT状态寄存器和USART_DATA数据寄存器。库函数usart_interrupt_flag_clear在内部已经做了这个操作所以我直接用。有些朋友在自己清标志时只读了STAT结果空闲中断只触发一次之后就再也不进来了就是这个原因。中断函数里我用了一次memcpy把数据从rx_buffer拷贝到rx_app_buffer这是有意的设计。假设主循环正在处理上一帧数据处理到一半时新一帧来了DMA会把新数据写进rx_buffer如果主循环还在读rx_buffer数据就会被覆盖导致解析出错。拷贝到应用缓冲区之后主循环只处理rx_app_bufferDMA在rx_buffer里继续搬运两边互不干扰。对于几十字节的小帧来说memcpy耗时才几微秒完全在可接受范围内。3.3 缓冲区保护与DMA重装载时序的思考DMA重装载这一步看着简单但时序上有个很有意思的窗口期。参考115200波特率下的时间预算8位数据、1位停止位无校验一个字节实际占10个bit每个字节的传输时间约86.8微秒。空闲中断是在总线空闲超过一个字节时间之后才触发的也就是说当代码在空闲中断里执行DMA重装载时总线上理论上还有至少一个字节时间才会出现下一帧的起始位这个窗口大约是86.8微秒。正常的中断服务程序从进入中断到完成DMA重装载一般只需要几微秒远小于这个窗口期。所以这套方案在常规波特率下非常稳不用担心来不及重新装载DMA导致丢字节。但有一种情况需要警惕如果你在空闲中断里写了大量耗时处理比如调用printf打印日志、做浮点运算、或者处理复杂的协议解析中断时间就会暴涨一旦超过缓冲区重装载的时间窗口下一帧数据来了DMA还没准备好就会丢字节。我的建议是空闲中断里只做拷贝和标志置位所有业务解析放到主循环里做。缓冲区大小也是需要考虑的。我习惯把缓冲区设置为协议单帧最大长度的2倍或者直接用256字节这种整数值。如果你的协议规定单帧最大64字节缓冲区开64或者128都行但要记住DMA传输完成事件和空闲中断是独立的如果一帧长度超过缓冲区大小DMA会先搬满缓冲区然后自动停止后面继续来的数据就进不去了此时空闲中断即使触发你也只能拿到缓冲区满的那256字节后面的数据全丢了。所以缓冲区大小必须大于协议允许的最大帧长。关于循环模式我再多说一句。DMA循环模式下DMA搬完缓冲区后会从头开始继续搬可以避免数据满后自动停止的问题。但循环模式下的剩余计数是不断循环变化的空闲中断触发时读到的计数无法准确判断当前是第几轮的数据所以对不定长接收来说反而更难处理。我在这个方案里用非循环模式逻辑最直观。还有一点需要提醒如果你在初始化时就开了DMA通道而外部设备已经提前发来了数据这些数据会在DMA使能之后立刻开始搬入缓冲区但此时空闲中断可能尚未触发数据会一直积压在rx_buffer里直到总线空闲。启动时序上如果发现第一帧数据异常可以在初始化后增加几毫秒延时再开始业务交互或者由主设备发送握手命令后再开始接收。4. 常见问题与排查技巧实录4.1 典型故障速查表这套方案我前前后后调试过很多次也帮同事排查过不少问题把最常见的现象、原因和排查思路整理成了表格遇到问题可以直接对照着查问题现象常见原因排查思路串口完全不进中断USART中断使能没开、NVIC优先级配置遗漏、GPIO复用错误检查usart_interrupt_enable和nvic_irq_enable是否生效DMA没有搬运数据DMA通道映射错、外设地址用错、USART_DENR没使能对照参考手册确认DMA通道断点查看DMA计数器是否变化空闲中断只触发一次清除标志方式不对没有按STATDATA顺序清除改用库函数usart_interrupt_flag_clear清标志数据前几个字节丢失初始化后DMA启动太晚外部设备已经开发初始化后延时或握手后再开始业务一帧数据被拆成几次收到对端发送间隔过长或波特率有偏差导致空闲误判检查对端串口参数用逻辑分析仪确认帧间隔接收缓冲区被覆盖主循环处理不及时、缓冲区过小、误用循环模式加大缓冲区中断里加拷贝或采用双缓冲高波特率下偶发乱码APB时钟配置错误、波特率分频误差过大按芯片时钟树检查APB1/APB2配置优先用USART04.2 定位问题的手段GPIO翻转与逻辑分析仪串口调试最忌讳在中断里用printf一旦中断服务时间长直接影响接收时序问题反而更复杂。我更推荐用GPIO翻转来观察中断触发的频率和时机。具体做法是在空闲中断入口处把某个GPIO拉高中断处理完再拉低然后用示波器或逻辑分析仪监测这个引脚的波形。正常情况下每次收到一帧数据这个引脚就应该出现一个高电平脉冲脉冲宽度就是中断处理耗时。这个信息非常有用如果脉冲频率远超预期说明空闲中断被错误地频繁触发如果脉冲宽度非常大说明中断里做了太多事情。确认中断触发正常之后再用串口助手往MCU发一组已知数据比如连续发0xAA 0x55 0x01 0x02 0x03然后在主循环或者回调函数里检查rx_app_buffer的内容是否与发送一致。如果数据内容对但长度不对重点检查DMA计数器的读取方式如果数据完全不对优先检查DMA通道映射和外设地址。还有一种比较实用的调试方法是回环验证。在handle函数里临时把接收到的数据原样通过USART发送回去用串口助手看回显。如果回显内容和发送内容一致说明接收链路没有问题问题很可能出在后面业务处理上。这个技巧在处理复杂协议时非常省时间。4.3 优化方向与我有印象的几个坑这套方案跑通之后可以按项目需求继续扩展。比如处理Modbus RTU这类协议时空闲中断天然就满足RTU模式对帧间隔的要求你只需要在回调函数里加上CRC校验就能组成一个完整的Modbus从站接收链路。如果数据量特别大还可以考虑双缓冲结构两块缓冲区交替使用减少拷贝的开销。我印象比较深的坑有两个。第一个是关于GD32F303的DMA请求映射前面也反复提过它和STM32F103不是完全一致的网上很多教程在讲STM32你照着抄过来发现在GD32上就是不通问题不出在代码逻辑而是通道映射根本不对。遇到这种情况别急着改代码先把参考手册打开找到DMA请求映射表一个一个确认过来。第二个坑是库版本的API差异。GD32F30x标准外设库有老版本和新版本之分有的用gpio_init有的用gpio_mode_set有的中断标志清除函数叫usart_flag_clear有的叫usart_interrupt_flag_clear。很多朋友从网上下载了工程模板编译报错之后直接懵了其实只要去库文件里翻一下函数声明很快就能找到对应的函数名。关于DMA连续请求和循环模式还有一个容易混淆的地方。在普通模式下DMA传输完设定的数量后会停止需要软件重新使能在循环模式下DMA会持续工作自动重载计数。有些外设手册里提到的DMA连续请求指的是外设持续向DMA发出请求让DMA在循环模式下不停传输。如果你看到类似“DMA continuous requests”的配置项基本就是循环模式相关对于不定长接收场景我更建议用非循环模式加空闲中断的组合。我在实际项目中最后使用的就是这里分享的代码结构稍微改了一下波特率和缓冲区大小就上线了。整套方案跑下来CPU占用率比原来逐字节中断的方式低了非常多而且代码逻辑非常清晰DMA负责搬运空闲中断负责通知主循环负责业务处理。接收链路的可靠性说到底就要靠这些细节堆出来。
)
