1. 项目概述为什么DMA是STM32开发的效率倍增器如果你在STM32开发中还在用CPU吭哧吭哧地搬运串口、ADC这些外设的数据那就像用一台高性能电脑去手动复制粘贴文件一样浪费了宝贵的计算资源。DMA这个常常被新手开发者忽略或觉得“配置麻烦”的功能恰恰是释放STM32性能、实现高效实时系统的关键。简单来说DMA就像一个独立的、不知疲倦的“数据搬运工”它能在内存和外设之间、内存和内存之间自动传输数据而完全不需要CPU的干预。CPU只需要告诉DMA“从哪里搬、搬到哪里、搬多少”然后就可以去处理其他更重要的任务比如算法运算、逻辑判断或者响应更紧急的中断。在STM32的生态里ST官方力推的STM32CubeMX工具极大地简化了DMA的配置过程。它把那些繁琐的寄存器操作、通道映射、优先级仲裁都封装成了直观的图形化界面。但工具简化了操作并不意味着我们不需要理解背后的原理。很多朋友在CubeMX里勾选了DMA后程序跑起来数据不对或者直接卡死根本原因就在于对DMA的工作机制一知半解。比如DMA传输完成中断和串口发送完成中断有什么区别循环模式和非循环模式该怎么选内存地址和外设地址递增又是什么意思这些问题不搞清楚DMA用起来就总是磕磕绊绊。所以这篇内容我们不只讲“怎么点”更要讲清楚“为什么这么点”。我会结合一个最经典的应用场景——串口UART的DMA不定长数据接收来拆解CubeMX配置DMA的每一个步骤并深入到HAL库的代码层面解释其工作原理和常见的“坑”。目标是让你不仅能照着步骤做出来更能理解每一个配置选项的意义从而举一反三把DMA应用到ADC采样、SPI通信、内存拷贝等任何需要高效数据搬运的场景中。2. CubeMX工程创建与外设基础配置在开始配置DMA之前我们首先需要一个明确的目标。这里我们以STM32F103C8T6俗称“蓝桥杯最小系统板”核心芯片为例实现通过串口1USART1接收不定长数据并使用DMA将接收到的数据自动搬运到我们指定的内存缓冲区中。这是物联网设备、调试终端、传感器数据采集等场景中最基础也最实用的需求。2.1 芯片选型与时钟树配置打开STM32CubeMX首先选择正确的芯片型号。对于F103C8T6你可以在搜索框输入“STM32F103C8”进行筛选。选好芯片后第一步不是急着去配外设而是先搞定整个系统的“心跳”——时钟树。对于F103系列通常使用外部高速时钟HSE。在“Pinout Configuration”标签页的“System Core”里找到“RCC”。将“High Speed Clock (HSE)”设置为“Crystal/Ceramic Resonator”。这样芯片就会使用外部8MHz的晶振作为时钟源。接着点击上方“Clock Configuration”标签页这里就是图形化的时钟树。我们的目标是让系统主频跑到72MHz这是F103系列的常见高性能配置。配置流程如下在“PLL Source Mux”处选择“HSE”。将“PLLMUL”设置为9倍频。因为HSE是8MHz 8MHz * 9 72MHz。将“System Clock Mux”的时钟源选择为“PLLCLK”。此时你会看到“HCLK”显示为72MHz。APB1总线时钟PCLK1最高为36MHzAPB2总线时钟PCLK2最高为72MHzCubeMX会自动进行分频配置通常保持默认即可。注意检查一下USART1的时钟源。USART1挂在APB2总线上其时钟由PCLK2提供确认它是72MHz即可。正确的时钟是串口波特率计算的基础。注意时钟配置错误是很多诡异问题的根源。比如如果主频没配到72MHz你计算出的波特率除数就会错导致串口通信乱码。配置完成后可以点击“Project Manager”标签页在“Project”子项中为工程取个名字选择好保存路径和IDEMDK-ARM V5 / STM32CubeIDE等代码生成模式建议选择“Copy all used libraries into the project folder”这样工程迁移起来更方便。2.2 串口USART1参数化配置回到“Pinout Configuration”标签页在左侧分类中找到“Connectivity” - “USART1”。模式选择将“Mode”设置为“Asynchronous”异步通信这是最常用的串口模式。引脚确认下方会自动分配PA9为USART1_TX PA10为USART1_RX。如果引脚被其他功能占用比如调试用的SWD接口可以在这里手动重映射但F103C8T6的这两个引脚通常是空闲的。参数配置在“Parameter Settings”选项卡中配置通信参数。Baud Rate设置为115200 Bits/s。这是一个在性能和抗干扰性之间平衡的常用速率。Word Length8 Bits包含起始位和停止位实际数据位为8位。ParityNone无奇偶校验。Stop Bits1。其他Over Sampling 保持默认的16倍采样。中断使能关键步骤切换到“NVIC Settings”选项卡找到“USART1 global interrupt”并勾选“Enabled”。这里务必使能虽然我们主要用DMA搬运数据但串口本身的一些事件比如空闲中断IDLE仍然需要串口全局中断来处理。DMA和中断是协同工作的不是互斥的。配置好后你可以在右侧的芯片引脚图上看到PA9和PA10被标记为绿色表示已配置为USART功能。3. DMA通道映射与传输模式深度解析这是整个配置的核心部分也是理解DMA工作原理的关键。3.1 为USART1_RX添加DMA请求在左侧分类中找到“DMA”选项通常在“System Core”或“Connectivity”附近不同系列位置略有不同。点击“Add”按钮为USART1的RX接收添加一个DMA流Stream在F1系列中称为Channel概念类似。在弹出的“DMA Request”选择框中找到“USART1_RX”。选中后右侧会自动生成一个DMA通道例如“DMA1 Channel5”。这是因为在STM32F1的架构中USART1_RX的DMA请求被固定映射到了DMA1的通道5。这种映射关系是芯片设计时固定的可以在芯片参考手册的“DMA控制器”章节找到完整的请求映射表不能随意更改。3.2 DMA参数配置详解添加通道后下方会出现该通道的详细配置选项。每一个选项都直接影响DMA的行为我们来逐一拆解Direction方向选项Peripheral To Memory / Memory To Peripheral / Memory To Memory。选择对于串口接收数据是从外设USART1的数据寄存器搬到内存我们定义的数组所以选择“Peripheral To Memory”。为什么这决定了DMA传输的源地址和目的地址的初始设置。如果选反了数据会往错误的方向搬运。Priority优先级选项Low / Medium / High / Very High。选择根据实际需求。如果这个串口数据非常关键不能丢失可以设为“High”。对于一般应用“Medium”即可。当多个DMA通道同时请求时优先级高的先被服务。为什么DMA控制器可能同时管理多个通道。优先级决定了在资源冲突时谁先“上车”。Mode模式选项Normal普通模式 / Circular循环模式。选择对于不定长数据接收这里我们先选择“Normal”。这是一个关键选择后面会结合中断详细解释。为什么Normal模式DMA在传输完指定的数据量比如我们设置的缓冲区大小后会自动停止并产生传输完成中断。需要软件重新配置才能启动下一次传输。适合已知长度或需要精确控制每次传输的场景。Circular模式DMA在传输完缓冲区数据后会自动将地址指针重置到起始位置然后开始新一轮传输周而复始。适合连续不断的数据流比如ADC持续采样。如果不加处理新数据会覆盖旧数据。Increment Address地址递增这里有两个选项“Peripheral”和“Memory”。Peripheral对于串口接收源地址是USART1-DR数据寄存器这是一个固定的寄存器地址。每次DMA读完这个寄存器下一个数据还是会出现在同一个地址。因此源地址不应该递增这里应该选择“Disable”。Memory目的地址是我们定义的数组rx_buffer[]。我们希望第一个字节放在rx_buffer[0]第二个放在rx_buffer[1]以此类推。因此内存地址必须递增这里选择“Enable”。为什么这是DMA使用中最常见的错误之一。如果内存地址不递增所有接收到的字节都会被塞进rx_buffer[0]只有最后一个字节能被保存。如果外设地址错误地递增了DMA会试图从一个不存在的寄存器地址读取数据导致硬件错误。Data Width数据宽度同样分“Peripheral”和“Memory”。选择我们的串口配置是8位数据所以两边都选择“Byte”。这表示DMA每次搬运一个字节。为什么必须与外设的数据宽度匹配。如果串口是8位这里选了Half Word16位DMA会一次读两次USART1-DR逻辑就全乱了。配置完成后你的DMA设置应该类似于下图以CubeMX界面为准参数配置值说明DMA RequestUSART1_RXDMA请求源DirectionPeripheral To Memory从串口到内存PriorityMedium中等优先级ModeNormal普通模式Peripheral IncrementDisable外设地址固定Memory IncrementEnable内存地址递增Peripheral Data WidthByte外设数据宽度为字节Memory Data WidthByte内存数据宽度为字节3.3 使能DMA传输完成中断仅仅配置好DMA通道还不够我们需要知道DMA什么时候搬完了数据。这就需要中断。在DMA配置界面找到“NVIC Settings”选项卡或者可能在DMA通道的详细配置里有一个“Interrupt”子项。勾选“DMA1 Channel5 global interrupt”的“Enabled”复选框。这样当这个DMA通道传输完成或发生错误时就会触发中断我们可以在中断服务函数里处理数据。实操心得很多初学者会忘记使能这里的DMA中断然后程序里傻等DMA完成或者用查询标志位的方式这都浪费了中断响应的实时性优势。使能中断让DMA在“后台”默默工作完成后“通知”CPU这才是正确的异步编程思维。4. 生成代码与关键函数剖析完成所有图形化配置后点击右上角的“GENERATE CODE”生成工程代码。CubeMX会生成完整的初始化代码包括main.c,stm32f1xx_hal_msp.c等。我们重点关注以下几个自动生成和需要手动添加的部分。4.1 自动生成的DMA与串口初始化代码在main.c的main()函数中你会看到HAL_Init()SystemClock_Config()之后调用了MX_DMA_Init()和MX_USART1_UART_Init()。这两个函数是由CubeMX在对应的.c文件中生成的。MX_DMA_Init()通常只包含一句__HAL_RCC_DMA1_CLK_ENABLE()用于使能DMA1的时钟。DMA的通道具体配置是在串口初始化函数里关联的。MX_USART1_UART_Init()这个函数内容很丰富。除了配置USART1的波特率、字长等参数最关键的是下面这两行huart1.Instance USART1; // ... 其他USART参数配置 if (HAL_UART_Init(huart1) ! HAL_OK) { Error_Handler(); }跟踪HAL_UART_Init函数它会进一步调用一个弱函数HAL_UART_MspInit。这个函数在stm32f1xx_hal_msp.c文件中被重写里面包含了引脚配置、时钟使能以及**将我们前面图形化配置的DMA参数关联到串口句柄huart1**的代码// 关联DMA到串口的接收句柄 hdma_usart1_rx.Instance DMA1_Channel5; hdma_usart1_rx.Init.Direction DMA_PERIPH_TO_MEMORY; hdma_usart1_rx.Init.PeriphInc DMA_PINC_DISABLE; hdma_usart1_rx.Init.MemInc DMA_MINC_ENABLE; hdma_usart1_rx.Init.PeriphDataAlignment DMA_PDATAALIGN_BYTE; hdma_usart1_rx.Init.MemDataAlignment DMA_MDATAALIGN_BYTE; hdma_usart1_rx.Init.Mode DMA_NORMAL; // 注意这里是NORMAL模式 hdma_usart1_rx.Init.Priority DMA_PRIORITY_MEDIUM; HAL_DMA_Init(hdma_usart1_rx); __HAL_LINKDMA(huart, hdmarx, hdma_usart1_rx); // 关键链接最后一句__HAL_LINKDMA宏至关重要它把初始化好的DMA句柄hdma_usart1_rx“链接”到了串口句柄huart1的hdmarx成员上。这样后续调用HAL库的UART接收DMA函数时库才知道使用哪个DMA通道。4.2 启动DMA接收与空闲中断的使能生成代码后系统初始化完成但DMA接收还没有开始。我们需要在main()函数的while(1)循环之前手动启动一次DMA接收。在main.c的/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间添加以下代码/* USER CODE BEGIN 2 */ #define RX_BUFFER_SIZE 256 // 定义接收缓冲区大小 uint8_t rx_buffer[RX_BUFFER_SIZE]; // 接收缓冲区 // 启动串口DMA接收 // 参数串口句柄 目标内存地址 接收数据长度 if (HAL_UART_Receive_DMA(huart1, rx_buffer, RX_BUFFER_SIZE) ! HAL_OK) { // 启动失败处理 Error_Handler(); } // 使能串口空闲中断IDLE Interrupt // 这是实现不定长接收的灵魂 __HAL_UART_ENABLE_IT(huart1, UART_IT_IDLE); /* USER CODE END 2 */代码剖析HAL_UART_Receive_DMA(huart1, rx_buffer, RX_BUFFER_SIZE)这个HAL库函数做了几件事检查DMA状态和参数。将我们提供的rx_buffer首地址设置为DMA传输的目标内存地址M0AR寄存器。将串口数据寄存器USART1-DR的地址设置为DMA传输的源外设地址PAR寄存器。将RX_BUFFER_SIZE设置为DMA传输的数据量CNDTR寄存器。使能DMA通道和串口的DMA接收请求。从此每当串口收到一个字节硬件会自动触发DMA将数据从USART1-DR搬到rx_buffer中并且rx_buffer的地址会自动递增因为我们配置了MemInc EnableCNDTR计数器自动减1。__HAL_UART_ENABLE_IT(huart1, UART_IT_IDLE)这是实现不定长接收的关键。串口空闲中断IDLE在检测到接收数据线RX上超过一个字节时间具体是10/11/12位时间取决于帧结构没有新数据时触发。这意味着当一帧数据发送完毕RX线空闲下来就会产生这个中断。我们在这个中断里就能知道“数据包可能已经接收完了”。4.3 中断服务函数与数据处理逻辑DMA和串口空闲中断的响应最终会调用到我们在stm32f1xx_it.c中定义的弱函数。CubeMX已经为我们生成了函数框架我们需要在其中添加业务逻辑。首先在main.c的顶部/* USER CODE BEGIN Includes */部分附近定义几个全局变量用于在中断和主循环间传递信息/* USER CODE BEGIN PV */ volatile uint8_t rx_len 0; // 实际接收到的数据长度 volatile uint8_t recv_flag 0; // 接收完成标志 /* USER CODE END PV */然后找到stm32f1xx_it.c文件中的串口中断服务函数USART1_IRQHandler并在其调用的HAL_UART_IRQHandler(huart1)函数之后添加空闲中断的处理逻辑void USART1_IRQHandler(void) { /* USER CODE BEGIN USART1_IRQn 0 */ // 检查是否是空闲中断 if (__HAL_UART_GET_FLAG(huart1, UART_FLAG_IDLE) ! RESET) { __HAL_UART_CLEAR_IDLEFLAG(huart1); // 必须清除空闲中断标志 // 计算本次接收到的数据长度 // DMA_CNDTR寄存器存储的是剩余待传输的数据量 rx_len RX_BUFFER_SIZE - __HAL_DMA_GET_COUNTER(huart1.hdmarx); if (rx_len 0) { recv_flag 1; // 设置接收完成标志 // 注意此时数据已经在rx_buffer中了 // 可选在这里直接处理数据但建议尽快退出中断 // process_data(rx_buffer, rx_len); } // 重要重新启动DMA接收准备接收下一包数据 // 因为DMA工作在Normal模式传输完指定长度或我们手动停止后需要重启 __HAL_DMA_DISABLE(huart1.hdmarx); // 先关闭DMA huart1.hdmarx-Instance-CNDTR RX_BUFFER_SIZE; // 重新设置传输数据量 huart1.hdmarx-Instance-CMAR (uint32_t)rx_buffer; // 重新设置内存地址 __HAL_DMA_ENABLE(huart1.hdmarx); // 重新使能DMA } /* USER CODE END USART1_IRQn 0 */ HAL_UART_IRQHandler(huart1); // CubeMX生成的默认处理函数 /* USER CODE BEGIN USART1_IRQn 1 */ /* USER CODE END USART1_IRQn 1 */ }中断处理逻辑深度解析判断空闲中断使用__HAL_UART_GET_FLAG宏查询IDLE标志位。这是标准做法。清除标志必须使用__HAL_UART_CLEAR_IDLEFLAG来清除空闲中断标志。这是一个常见的坑有些型号的芯片IDLE标志清除方式比较特殊这个宏是跨型号安全的。计算接收长度这是核心技巧。DMA通道的CNDTR寄存器在HAL库中通过__HAL_DMA_GET_COUNTER宏访问会随着数据传输而递减。初始值是RX_BUFFER_SIZE每传输一个字节减1。因此RX_BUFFER_SIZE - 当前CNDTR值就等于已经传输了多少个字节也就是我们实际接收到的数据长度rx_len。设置标志位将recv_flag置1通知主循环有新的数据包待处理。中断服务函数里应尽量只做标志设置、长度计算等轻量级操作把耗时的数据处理如解析、存储、转发放到主循环中避免长时间占用中断影响系统实时性。重启DMA接收关键因为我们配置DMA为Normal模式。在空闲中断触发时DMA可能还没有传输完我们设定的RX_BUFFER_SIZE比如只收到了10个字节。此时DMA通道并未停止还在等待后续数据。如果我们不重启下一包数据到来时DMA会从上次停止的地址继续存放导致数据覆盖或错乱。因此我们需要手动重启DMA先__HAL_DMA_DISABLE关闭DMA通道。重新配置传输数据量CNDTR和内存地址CMAR虽然地址没变但重新设置是一个好习惯。最后__HAL_DMA_ENABLE重新使能。这样DMA就“复位”到了初始状态准备接收下一个数据包。踩坑实录忘记在空闲中断中重启DMA是导致只能接收第一包数据后续数据全部丢失的最常见原因。另一种方案是使用DMA的Circular循环模式这样DMA在缓冲区满后会自动从头开始覆盖配合双缓冲区或定期读取的策略也可以实现不定长接收但逻辑上不如Normal模式空闲中断清晰直观。4.4 主循环中的数据消费最后我们在main.c的while(1)主循环中检查并处理接收完成的数据/* USER CODE BEGIN WHILE */ while (1) { /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ if (recv_flag) { recv_flag 0; // 清除标志 // 在这里处理接收到的数据 rx_buffer[0...rx_len-1] // 例如回显数据 HAL_UART_Transmit(huart1, rx_buffer, rx_len, 1000); // 或者进行协议解析 // parse_protocol(rx_buffer, rx_len); // 处理完成后rx_len可以清零等待下一次接收 // rx_len 0; } // 其他任务... } /* USER CODE END 3 */主循环不断轮询recv_flag标志。一旦发现被置1就说明有新数据包到达。此时可以安全地读取rx_buffer和rx_len进行处理。处理完毕后清除标志等待下一次中断通知。这种“中断触发主循环处理”的模式是嵌入式系统中典型的生产者-消费者模型能很好地平衡实时性和CPU利用率。5. 进阶话题DMA发送、双缓冲区与错误处理掌握了基本的DMA接收我们再来探讨几个进阶且实用的主题。5.1 配置与使用DMA发送DMA发送的配置流程与接收类似但方向相反。在CubeMX中为USART1_TX添加一个DMA通道例如DMA1 Channel4方向选择“Memory To Peripheral”内存地址递增Enable外设地址不递增Disable模式根据需求选择Normal发送固定长度数据或Circular连续发送如音频流。在代码中使用HAL_UART_Transmit_DMA(huart1, tx_buffer, length)即可启动DMA发送。发送完成后会触发DMA发送完成中断如果使能了的话。这里有一个非常重要的细节DMA发送完成中断HAL_UART_TxHalfCpltCallback/HAL_UART_TxCpltCallback只意味着DMA已经把数据从内存搬到了串口的发送数据寄存器TDR。并不代表数据已经通过TX线全部发送出去了串口外设内部还有一个发送移位寄存器DMA填满TDR后串口控制器会自己把数据一位一位地发出去。所以如果你需要严格知道“最后一个字节已经离开芯片引脚”需要查询串口的“传输完成”TC Transmission Complete标志位或者使用串口自己的TC中断。5.2 双缓冲区Ping-Pong Buffer技术在高速数据流如音频采集、摄像头数据场景下使用单缓冲区会有“数据覆盖”的风险DMA还在往缓冲区A写新数据但CPU还没来得及读完缓冲区A里的旧数据。双缓冲区技术可以完美解决这个问题。原理准备两个大小相同的缓冲区BufferA和BufferB。DMA配置为Circular模式但目标内存地址设置为BufferA。在DMA的半传输完成中断Half Transfer Complete HT和传输完成中断Transfer Complete TC中切换CPU操作的缓冲区。初始DMA目标地址指向BufferA长度为BUFFER_SIZE。当DMA传输了BUFFER_SIZE/2个数据半传输时触发HT中断。此时DMA的前半部分BufferA前半已满后半部分BufferA后半正在写入。在HT中断中CPU可以安全地读取BufferA的前半部分数据因为DMA正在操作后半部分。当DMA传输完BUFFER_SIZE个数据全传输时触发TC中断。此时BufferA已满DMA会自动回到起始地址因为是Circular模式开始下一轮。在TC中断中CPU可以安全地读取BufferA的后半部分数据。更高级的用法是在TC中断里将DMA的目标地址切换到BufferB实现真正的“乒乓”操作。CPU处理BufferA时DMA向BufferB写入下一次TC中断两者角色互换。在CubeMX中配置双缓冲区需要在DMA配置里使能“Circular”模式并在NVIC中使能“DMAx Streamx half transfer interrupt”和“DMAx Streamx transfer complete interrupt”。在代码中你需要重写HAL_UART_RxHalfCpltCallback和HAL_UART_RxCpltCallback这两个回调函数来处理数据。5.3 DMA传输错误处理与调试技巧DMA传输并非总是顺利的可能会发生错误。常见的DMA错误包括传输错误Transfer Error通常是由于访问了非法的内存地址或外设地址比如地址未对齐到数据宽度。FIFO错误与DMA内部的FIFO配置有关。直接模式错误在直接模式下FIFO禁用违反了某些传输规则。在CubeMX中使能DMA全局中断后这些错误都会触发DMA的中断。你可以在stm32f1xx_it.c的DMA1_Channel5_IRQHandler中断服务函数中或者更好的做法是重写错误回调函数HAL_UART_ErrorCallback来捕获和处理错误。调试DMA的实用技巧使用断点和变量观察在DMA启动后、中断回调函数里设置断点观察rx_buffer的内容、rx_len的值、DMA通道的CNDTR寄存器值是否按预期变化。检查地址对齐确保内存缓冲区数组的地址符合数据宽度的对齐要求。例如如果你配置数据宽度为Half Word16位那么内存地址最好是2字节对齐的。使用__align(2)关键字定义数组可以保证这一点。验证时钟再次确认DMA所在总线AHB的时钟是否已经使能并运行在正确频率。DMA时钟在MX_DMA_Init中使能。排查中断优先级如果DMA中断或串口中断一直不触发检查NVIC中的中断优先级配置确保它们没有被其他更高优先级的中断屏蔽或长时间占用。逻辑分析仪/示波器这是最直接的硬件调试手段。用逻辑分析仪抓取串口的TX、RX引脚波形可以直观地看到数据是否被正确发送和接收结合代码断点能快速定位是软件配置问题还是硬件连接问题。通过以上从基础配置到进阶原理再到调试技巧的完整拆解你应该对如何在STM32CubeMX中配置和使用DMA有了一个立体而深入的理解。DMA是一个“用起来简单用好了难”的模块其核心思想是“解放CPU让硬件做它擅长的事”。理解数据流的方向、中断的协同、缓冲区的管理你就能在复杂的嵌入式项目中游刃有余地运用DMA打造出真正高效可靠的系统。
1. 项目概述为什么DMA是STM32开发的效率倍增器如果你在STM32开发中还在用CPU吭哧吭哧地搬运串口、ADC这些外设的数据那就像用一台高性能电脑去手动复制粘贴文件一样浪费了宝贵的计算资源。DMA这个常常被新手开发者忽略或觉得“配置麻烦”的功能恰恰是释放STM32性能、实现高效实时系统的关键。简单来说DMA就像一个独立的、不知疲倦的“数据搬运工”它能在内存和外设之间、内存和内存之间自动传输数据而完全不需要CPU的干预。CPU只需要告诉DMA“从哪里搬、搬到哪里、搬多少”然后就可以去处理其他更重要的任务比如算法运算、逻辑判断或者响应更紧急的中断。在STM32的生态里ST官方力推的STM32CubeMX工具极大地简化了DMA的配置过程。它把那些繁琐的寄存器操作、通道映射、优先级仲裁都封装成了直观的图形化界面。但工具简化了操作并不意味着我们不需要理解背后的原理。很多朋友在CubeMX里勾选了DMA后程序跑起来数据不对或者直接卡死根本原因就在于对DMA的工作机制一知半解。比如DMA传输完成中断和串口发送完成中断有什么区别循环模式和非循环模式该怎么选内存地址和外设地址递增又是什么意思这些问题不搞清楚DMA用起来就总是磕磕绊绊。所以这篇内容我们不只讲“怎么点”更要讲清楚“为什么这么点”。我会结合一个最经典的应用场景——串口UART的DMA不定长数据接收来拆解CubeMX配置DMA的每一个步骤并深入到HAL库的代码层面解释其工作原理和常见的“坑”。目标是让你不仅能照着步骤做出来更能理解每一个配置选项的意义从而举一反三把DMA应用到ADC采样、SPI通信、内存拷贝等任何需要高效数据搬运的场景中。2. CubeMX工程创建与外设基础配置在开始配置DMA之前我们首先需要一个明确的目标。这里我们以STM32F103C8T6俗称“蓝桥杯最小系统板”核心芯片为例实现通过串口1USART1接收不定长数据并使用DMA将接收到的数据自动搬运到我们指定的内存缓冲区中。这是物联网设备、调试终端、传感器数据采集等场景中最基础也最实用的需求。2.1 芯片选型与时钟树配置打开STM32CubeMX首先选择正确的芯片型号。对于F103C8T6你可以在搜索框输入“STM32F103C8”进行筛选。选好芯片后第一步不是急着去配外设而是先搞定整个系统的“心跳”——时钟树。对于F103系列通常使用外部高速时钟HSE。在“Pinout Configuration”标签页的“System Core”里找到“RCC”。将“High Speed Clock (HSE)”设置为“Crystal/Ceramic Resonator”。这样芯片就会使用外部8MHz的晶振作为时钟源。接着点击上方“Clock Configuration”标签页这里就是图形化的时钟树。我们的目标是让系统主频跑到72MHz这是F103系列的常见高性能配置。配置流程如下在“PLL Source Mux”处选择“HSE”。将“PLLMUL”设置为9倍频。因为HSE是8MHz 8MHz * 9 72MHz。将“System Clock Mux”的时钟源选择为“PLLCLK”。此时你会看到“HCLK”显示为72MHz。APB1总线时钟PCLK1最高为36MHzAPB2总线时钟PCLK2最高为72MHzCubeMX会自动进行分频配置通常保持默认即可。注意检查一下USART1的时钟源。USART1挂在APB2总线上其时钟由PCLK2提供确认它是72MHz即可。正确的时钟是串口波特率计算的基础。注意时钟配置错误是很多诡异问题的根源。比如如果主频没配到72MHz你计算出的波特率除数就会错导致串口通信乱码。配置完成后可以点击“Project Manager”标签页在“Project”子项中为工程取个名字选择好保存路径和IDEMDK-ARM V5 / STM32CubeIDE等代码生成模式建议选择“Copy all used libraries into the project folder”这样工程迁移起来更方便。2.2 串口USART1参数化配置回到“Pinout Configuration”标签页在左侧分类中找到“Connectivity” - “USART1”。模式选择将“Mode”设置为“Asynchronous”异步通信这是最常用的串口模式。引脚确认下方会自动分配PA9为USART1_TX PA10为USART1_RX。如果引脚被其他功能占用比如调试用的SWD接口可以在这里手动重映射但F103C8T6的这两个引脚通常是空闲的。参数配置在“Parameter Settings”选项卡中配置通信参数。Baud Rate设置为115200 Bits/s。这是一个在性能和抗干扰性之间平衡的常用速率。Word Length8 Bits包含起始位和停止位实际数据位为8位。ParityNone无奇偶校验。Stop Bits1。其他Over Sampling 保持默认的16倍采样。中断使能关键步骤切换到“NVIC Settings”选项卡找到“USART1 global interrupt”并勾选“Enabled”。这里务必使能虽然我们主要用DMA搬运数据但串口本身的一些事件比如空闲中断IDLE仍然需要串口全局中断来处理。DMA和中断是协同工作的不是互斥的。配置好后你可以在右侧的芯片引脚图上看到PA9和PA10被标记为绿色表示已配置为USART功能。3. DMA通道映射与传输模式深度解析这是整个配置的核心部分也是理解DMA工作原理的关键。3.1 为USART1_RX添加DMA请求在左侧分类中找到“DMA”选项通常在“System Core”或“Connectivity”附近不同系列位置略有不同。点击“Add”按钮为USART1的RX接收添加一个DMA流Stream在F1系列中称为Channel概念类似。在弹出的“DMA Request”选择框中找到“USART1_RX”。选中后右侧会自动生成一个DMA通道例如“DMA1 Channel5”。这是因为在STM32F1的架构中USART1_RX的DMA请求被固定映射到了DMA1的通道5。这种映射关系是芯片设计时固定的可以在芯片参考手册的“DMA控制器”章节找到完整的请求映射表不能随意更改。3.2 DMA参数配置详解添加通道后下方会出现该通道的详细配置选项。每一个选项都直接影响DMA的行为我们来逐一拆解Direction方向选项Peripheral To Memory / Memory To Peripheral / Memory To Memory。选择对于串口接收数据是从外设USART1的数据寄存器搬到内存我们定义的数组所以选择“Peripheral To Memory”。为什么这决定了DMA传输的源地址和目的地址的初始设置。如果选反了数据会往错误的方向搬运。Priority优先级选项Low / Medium / High / Very High。选择根据实际需求。如果这个串口数据非常关键不能丢失可以设为“High”。对于一般应用“Medium”即可。当多个DMA通道同时请求时优先级高的先被服务。为什么DMA控制器可能同时管理多个通道。优先级决定了在资源冲突时谁先“上车”。Mode模式选项Normal普通模式 / Circular循环模式。选择对于不定长数据接收这里我们先选择“Normal”。这是一个关键选择后面会结合中断详细解释。为什么Normal模式DMA在传输完指定的数据量比如我们设置的缓冲区大小后会自动停止并产生传输完成中断。需要软件重新配置才能启动下一次传输。适合已知长度或需要精确控制每次传输的场景。Circular模式DMA在传输完缓冲区数据后会自动将地址指针重置到起始位置然后开始新一轮传输周而复始。适合连续不断的数据流比如ADC持续采样。如果不加处理新数据会覆盖旧数据。Increment Address地址递增这里有两个选项“Peripheral”和“Memory”。Peripheral对于串口接收源地址是USART1-DR数据寄存器这是一个固定的寄存器地址。每次DMA读完这个寄存器下一个数据还是会出现在同一个地址。因此源地址不应该递增这里应该选择“Disable”。Memory目的地址是我们定义的数组rx_buffer[]。我们希望第一个字节放在rx_buffer[0]第二个放在rx_buffer[1]以此类推。因此内存地址必须递增这里选择“Enable”。为什么这是DMA使用中最常见的错误之一。如果内存地址不递增所有接收到的字节都会被塞进rx_buffer[0]只有最后一个字节能被保存。如果外设地址错误地递增了DMA会试图从一个不存在的寄存器地址读取数据导致硬件错误。Data Width数据宽度同样分“Peripheral”和“Memory”。选择我们的串口配置是8位数据所以两边都选择“Byte”。这表示DMA每次搬运一个字节。为什么必须与外设的数据宽度匹配。如果串口是8位这里选了Half Word16位DMA会一次读两次USART1-DR逻辑就全乱了。配置完成后你的DMA设置应该类似于下图以CubeMX界面为准参数配置值说明DMA RequestUSART1_RXDMA请求源DirectionPeripheral To Memory从串口到内存PriorityMedium中等优先级ModeNormal普通模式Peripheral IncrementDisable外设地址固定Memory IncrementEnable内存地址递增Peripheral Data WidthByte外设数据宽度为字节Memory Data WidthByte内存数据宽度为字节3.3 使能DMA传输完成中断仅仅配置好DMA通道还不够我们需要知道DMA什么时候搬完了数据。这就需要中断。在DMA配置界面找到“NVIC Settings”选项卡或者可能在DMA通道的详细配置里有一个“Interrupt”子项。勾选“DMA1 Channel5 global interrupt”的“Enabled”复选框。这样当这个DMA通道传输完成或发生错误时就会触发中断我们可以在中断服务函数里处理数据。实操心得很多初学者会忘记使能这里的DMA中断然后程序里傻等DMA完成或者用查询标志位的方式这都浪费了中断响应的实时性优势。使能中断让DMA在“后台”默默工作完成后“通知”CPU这才是正确的异步编程思维。4. 生成代码与关键函数剖析完成所有图形化配置后点击右上角的“GENERATE CODE”生成工程代码。CubeMX会生成完整的初始化代码包括main.c,stm32f1xx_hal_msp.c等。我们重点关注以下几个自动生成和需要手动添加的部分。4.1 自动生成的DMA与串口初始化代码在main.c的main()函数中你会看到HAL_Init()SystemClock_Config()之后调用了MX_DMA_Init()和MX_USART1_UART_Init()。这两个函数是由CubeMX在对应的.c文件中生成的。MX_DMA_Init()通常只包含一句__HAL_RCC_DMA1_CLK_ENABLE()用于使能DMA1的时钟。DMA的通道具体配置是在串口初始化函数里关联的。MX_USART1_UART_Init()这个函数内容很丰富。除了配置USART1的波特率、字长等参数最关键的是下面这两行huart1.Instance USART1; // ... 其他USART参数配置 if (HAL_UART_Init(huart1) ! HAL_OK) { Error_Handler(); }跟踪HAL_UART_Init函数它会进一步调用一个弱函数HAL_UART_MspInit。这个函数在stm32f1xx_hal_msp.c文件中被重写里面包含了引脚配置、时钟使能以及**将我们前面图形化配置的DMA参数关联到串口句柄huart1**的代码// 关联DMA到串口的接收句柄 hdma_usart1_rx.Instance DMA1_Channel5; hdma_usart1_rx.Init.Direction DMA_PERIPH_TO_MEMORY; hdma_usart1_rx.Init.PeriphInc DMA_PINC_DISABLE; hdma_usart1_rx.Init.MemInc DMA_MINC_ENABLE; hdma_usart1_rx.Init.PeriphDataAlignment DMA_PDATAALIGN_BYTE; hdma_usart1_rx.Init.MemDataAlignment DMA_MDATAALIGN_BYTE; hdma_usart1_rx.Init.Mode DMA_NORMAL; // 注意这里是NORMAL模式 hdma_usart1_rx.Init.Priority DMA_PRIORITY_MEDIUM; HAL_DMA_Init(hdma_usart1_rx); __HAL_LINKDMA(huart, hdmarx, hdma_usart1_rx); // 关键链接最后一句__HAL_LINKDMA宏至关重要它把初始化好的DMA句柄hdma_usart1_rx“链接”到了串口句柄huart1的hdmarx成员上。这样后续调用HAL库的UART接收DMA函数时库才知道使用哪个DMA通道。4.2 启动DMA接收与空闲中断的使能生成代码后系统初始化完成但DMA接收还没有开始。我们需要在main()函数的while(1)循环之前手动启动一次DMA接收。在main.c的/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间添加以下代码/* USER CODE BEGIN 2 */ #define RX_BUFFER_SIZE 256 // 定义接收缓冲区大小 uint8_t rx_buffer[RX_BUFFER_SIZE]; // 接收缓冲区 // 启动串口DMA接收 // 参数串口句柄 目标内存地址 接收数据长度 if (HAL_UART_Receive_DMA(huart1, rx_buffer, RX_BUFFER_SIZE) ! HAL_OK) { // 启动失败处理 Error_Handler(); } // 使能串口空闲中断IDLE Interrupt // 这是实现不定长接收的灵魂 __HAL_UART_ENABLE_IT(huart1, UART_IT_IDLE); /* USER CODE END 2 */代码剖析HAL_UART_Receive_DMA(huart1, rx_buffer, RX_BUFFER_SIZE)这个HAL库函数做了几件事检查DMA状态和参数。将我们提供的rx_buffer首地址设置为DMA传输的目标内存地址M0AR寄存器。将串口数据寄存器USART1-DR的地址设置为DMA传输的源外设地址PAR寄存器。将RX_BUFFER_SIZE设置为DMA传输的数据量CNDTR寄存器。使能DMA通道和串口的DMA接收请求。从此每当串口收到一个字节硬件会自动触发DMA将数据从USART1-DR搬到rx_buffer中并且rx_buffer的地址会自动递增因为我们配置了MemInc EnableCNDTR计数器自动减1。__HAL_UART_ENABLE_IT(huart1, UART_IT_IDLE)这是实现不定长接收的关键。串口空闲中断IDLE在检测到接收数据线RX上超过一个字节时间具体是10/11/12位时间取决于帧结构没有新数据时触发。这意味着当一帧数据发送完毕RX线空闲下来就会产生这个中断。我们在这个中断里就能知道“数据包可能已经接收完了”。4.3 中断服务函数与数据处理逻辑DMA和串口空闲中断的响应最终会调用到我们在stm32f1xx_it.c中定义的弱函数。CubeMX已经为我们生成了函数框架我们需要在其中添加业务逻辑。首先在main.c的顶部/* USER CODE BEGIN Includes */部分附近定义几个全局变量用于在中断和主循环间传递信息/* USER CODE BEGIN PV */ volatile uint8_t rx_len 0; // 实际接收到的数据长度 volatile uint8_t recv_flag 0; // 接收完成标志 /* USER CODE END PV */然后找到stm32f1xx_it.c文件中的串口中断服务函数USART1_IRQHandler并在其调用的HAL_UART_IRQHandler(huart1)函数之后添加空闲中断的处理逻辑void USART1_IRQHandler(void) { /* USER CODE BEGIN USART1_IRQn 0 */ // 检查是否是空闲中断 if (__HAL_UART_GET_FLAG(huart1, UART_FLAG_IDLE) ! RESET) { __HAL_UART_CLEAR_IDLEFLAG(huart1); // 必须清除空闲中断标志 // 计算本次接收到的数据长度 // DMA_CNDTR寄存器存储的是剩余待传输的数据量 rx_len RX_BUFFER_SIZE - __HAL_DMA_GET_COUNTER(huart1.hdmarx); if (rx_len 0) { recv_flag 1; // 设置接收完成标志 // 注意此时数据已经在rx_buffer中了 // 可选在这里直接处理数据但建议尽快退出中断 // process_data(rx_buffer, rx_len); } // 重要重新启动DMA接收准备接收下一包数据 // 因为DMA工作在Normal模式传输完指定长度或我们手动停止后需要重启 __HAL_DMA_DISABLE(huart1.hdmarx); // 先关闭DMA huart1.hdmarx-Instance-CNDTR RX_BUFFER_SIZE; // 重新设置传输数据量 huart1.hdmarx-Instance-CMAR (uint32_t)rx_buffer; // 重新设置内存地址 __HAL_DMA_ENABLE(huart1.hdmarx); // 重新使能DMA } /* USER CODE END USART1_IRQn 0 */ HAL_UART_IRQHandler(huart1); // CubeMX生成的默认处理函数 /* USER CODE BEGIN USART1_IRQn 1 */ /* USER CODE END USART1_IRQn 1 */ }中断处理逻辑深度解析判断空闲中断使用__HAL_UART_GET_FLAG宏查询IDLE标志位。这是标准做法。清除标志必须使用__HAL_UART_CLEAR_IDLEFLAG来清除空闲中断标志。这是一个常见的坑有些型号的芯片IDLE标志清除方式比较特殊这个宏是跨型号安全的。计算接收长度这是核心技巧。DMA通道的CNDTR寄存器在HAL库中通过__HAL_DMA_GET_COUNTER宏访问会随着数据传输而递减。初始值是RX_BUFFER_SIZE每传输一个字节减1。因此RX_BUFFER_SIZE - 当前CNDTR值就等于已经传输了多少个字节也就是我们实际接收到的数据长度rx_len。设置标志位将recv_flag置1通知主循环有新的数据包待处理。中断服务函数里应尽量只做标志设置、长度计算等轻量级操作把耗时的数据处理如解析、存储、转发放到主循环中避免长时间占用中断影响系统实时性。重启DMA接收关键因为我们配置DMA为Normal模式。在空闲中断触发时DMA可能还没有传输完我们设定的RX_BUFFER_SIZE比如只收到了10个字节。此时DMA通道并未停止还在等待后续数据。如果我们不重启下一包数据到来时DMA会从上次停止的地址继续存放导致数据覆盖或错乱。因此我们需要手动重启DMA先__HAL_DMA_DISABLE关闭DMA通道。重新配置传输数据量CNDTR和内存地址CMAR虽然地址没变但重新设置是一个好习惯。最后__HAL_DMA_ENABLE重新使能。这样DMA就“复位”到了初始状态准备接收下一个数据包。踩坑实录忘记在空闲中断中重启DMA是导致只能接收第一包数据后续数据全部丢失的最常见原因。另一种方案是使用DMA的Circular循环模式这样DMA在缓冲区满后会自动从头开始覆盖配合双缓冲区或定期读取的策略也可以实现不定长接收但逻辑上不如Normal模式空闲中断清晰直观。4.4 主循环中的数据消费最后我们在main.c的while(1)主循环中检查并处理接收完成的数据/* USER CODE BEGIN WHILE */ while (1) { /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ if (recv_flag) { recv_flag 0; // 清除标志 // 在这里处理接收到的数据 rx_buffer[0...rx_len-1] // 例如回显数据 HAL_UART_Transmit(huart1, rx_buffer, rx_len, 1000); // 或者进行协议解析 // parse_protocol(rx_buffer, rx_len); // 处理完成后rx_len可以清零等待下一次接收 // rx_len 0; } // 其他任务... } /* USER CODE END 3 */主循环不断轮询recv_flag标志。一旦发现被置1就说明有新数据包到达。此时可以安全地读取rx_buffer和rx_len进行处理。处理完毕后清除标志等待下一次中断通知。这种“中断触发主循环处理”的模式是嵌入式系统中典型的生产者-消费者模型能很好地平衡实时性和CPU利用率。5. 进阶话题DMA发送、双缓冲区与错误处理掌握了基本的DMA接收我们再来探讨几个进阶且实用的主题。5.1 配置与使用DMA发送DMA发送的配置流程与接收类似但方向相反。在CubeMX中为USART1_TX添加一个DMA通道例如DMA1 Channel4方向选择“Memory To Peripheral”内存地址递增Enable外设地址不递增Disable模式根据需求选择Normal发送固定长度数据或Circular连续发送如音频流。在代码中使用HAL_UART_Transmit_DMA(huart1, tx_buffer, length)即可启动DMA发送。发送完成后会触发DMA发送完成中断如果使能了的话。这里有一个非常重要的细节DMA发送完成中断HAL_UART_TxHalfCpltCallback/HAL_UART_TxCpltCallback只意味着DMA已经把数据从内存搬到了串口的发送数据寄存器TDR。并不代表数据已经通过TX线全部发送出去了串口外设内部还有一个发送移位寄存器DMA填满TDR后串口控制器会自己把数据一位一位地发出去。所以如果你需要严格知道“最后一个字节已经离开芯片引脚”需要查询串口的“传输完成”TC Transmission Complete标志位或者使用串口自己的TC中断。5.2 双缓冲区Ping-Pong Buffer技术在高速数据流如音频采集、摄像头数据场景下使用单缓冲区会有“数据覆盖”的风险DMA还在往缓冲区A写新数据但CPU还没来得及读完缓冲区A里的旧数据。双缓冲区技术可以完美解决这个问题。原理准备两个大小相同的缓冲区BufferA和BufferB。DMA配置为Circular模式但目标内存地址设置为BufferA。在DMA的半传输完成中断Half Transfer Complete HT和传输完成中断Transfer Complete TC中切换CPU操作的缓冲区。初始DMA目标地址指向BufferA长度为BUFFER_SIZE。当DMA传输了BUFFER_SIZE/2个数据半传输时触发HT中断。此时DMA的前半部分BufferA前半已满后半部分BufferA后半正在写入。在HT中断中CPU可以安全地读取BufferA的前半部分数据因为DMA正在操作后半部分。当DMA传输完BUFFER_SIZE个数据全传输时触发TC中断。此时BufferA已满DMA会自动回到起始地址因为是Circular模式开始下一轮。在TC中断中CPU可以安全地读取BufferA的后半部分数据。更高级的用法是在TC中断里将DMA的目标地址切换到BufferB实现真正的“乒乓”操作。CPU处理BufferA时DMA向BufferB写入下一次TC中断两者角色互换。在CubeMX中配置双缓冲区需要在DMA配置里使能“Circular”模式并在NVIC中使能“DMAx Streamx half transfer interrupt”和“DMAx Streamx transfer complete interrupt”。在代码中你需要重写HAL_UART_RxHalfCpltCallback和HAL_UART_RxCpltCallback这两个回调函数来处理数据。5.3 DMA传输错误处理与调试技巧DMA传输并非总是顺利的可能会发生错误。常见的DMA错误包括传输错误Transfer Error通常是由于访问了非法的内存地址或外设地址比如地址未对齐到数据宽度。FIFO错误与DMA内部的FIFO配置有关。直接模式错误在直接模式下FIFO禁用违反了某些传输规则。在CubeMX中使能DMA全局中断后这些错误都会触发DMA的中断。你可以在stm32f1xx_it.c的DMA1_Channel5_IRQHandler中断服务函数中或者更好的做法是重写错误回调函数HAL_UART_ErrorCallback来捕获和处理错误。调试DMA的实用技巧使用断点和变量观察在DMA启动后、中断回调函数里设置断点观察rx_buffer的内容、rx_len的值、DMA通道的CNDTR寄存器值是否按预期变化。检查地址对齐确保内存缓冲区数组的地址符合数据宽度的对齐要求。例如如果你配置数据宽度为Half Word16位那么内存地址最好是2字节对齐的。使用__align(2)关键字定义数组可以保证这一点。验证时钟再次确认DMA所在总线AHB的时钟是否已经使能并运行在正确频率。DMA时钟在MX_DMA_Init中使能。排查中断优先级如果DMA中断或串口中断一直不触发检查NVIC中的中断优先级配置确保它们没有被其他更高优先级的中断屏蔽或长时间占用。逻辑分析仪/示波器这是最直接的硬件调试手段。用逻辑分析仪抓取串口的TX、RX引脚波形可以直观地看到数据是否被正确发送和接收结合代码断点能快速定位是软件配置问题还是硬件连接问题。通过以上从基础配置到进阶原理再到调试技巧的完整拆解你应该对如何在STM32CubeMX中配置和使用DMA有了一个立体而深入的理解。DMA是一个“用起来简单用好了难”的模块其核心思想是“解放CPU让硬件做它擅长的事”。理解数据流的方向、中断的协同、缓冲区的管理你就能在复杂的嵌入式项目中游刃有余地运用DMA打造出真正高效可靠的系统。
)
