STM32U575/585 这个系列的 GPDMA 我用了快两年了从第一版驱动踩坑到现在算是摸透了。最近不少同行在社区里问这套外设怎么上手正好这个应用笔记主题提到 GPDMA我把自己实际调通的流程、踩过的坑、以及和传统 DMA 的对比整理成一篇完整的实践记录。先说结论STM32U5 上的 GPDMA 和 F4/H7 系列上的 DMA 完全不是一个思路它更像一个可编程的数据搬运引擎支持链表式任务队列、硬件握手信号、以及丰富的事件标志。如果你是从 F1/F4 迁移过来第一反应大概是“卧槽怎么这么复杂”但一旦理解它的设计逻辑你会发现它在多数据流、复杂触发场景下真的省心太多。这篇内容适合正在用 STM32U575/585、想用 GPDMA 做外设数据搬运、或者被参考手册绕晕的朋友。我会从硬件原理讲到寄存器和 LL 库实操再到调试踩坑尽量把每个“为什么”都说清楚。1. GPDMA 的整体设计思路拆解1.1 为什么 U5 不再用传统 DMA传统 STM32 的 DMA 控制器比如 F4 的 DMA1/DMA2本质上是“独立的外设搬运工”你把源地址、目标地址、数据长度配好触发一次搬一次。它的问题在于每个 DMA 通道的功能相对固定重映射配置繁琐多段数据传输需要 CPU 频繁干预每个 buffer 传输完都要重新配置很难实现“当定时器触发时从 SPI 接收数据并放入内存然后自动启动下一次传输”这种复杂的流水线场景STM32U575/585 的 GPDMAGeneral Purpose DMA是全新设计它把“搬运任务”抽象成了一个一个的描述符每个描述符可以定义源、目标、触发条件、传输长度、甚至下一个描述符的地址。这样多个描述符串成一个链表交给 GPDMA 自己去执行CPU 只需要在整条链表结束后处理一次中断。打个比方传统 DMA 是“你告诉工人搬一箱货他搬完你再告诉他搬下一箱”GPDMA 是“你给工人一张任务清单他按顺序把五箱货搬完最后给你回个电话”。1.2 GPDMA 在 U5 系列中的硬件资源STM32U575/585 的 GPDMA 一共有 16 个通道Channel 0 到 Channel 15。每个通道是独立的可以配置成不同的优先级。它支持以下主要特性内存到内存、内存到外设、外设到内存、外设到外设的传输8/16/32 位数据宽度支持打包/解包pack/unpack支持 16 字节 FIFO可配置阈值支持 1D/2D 数据传输2D 适合图像块搬运支持链表模式即 Linked-List这是老 DMA 完全没有的支持硬件请求信号触发也支持软件触发每个通道有独立中断可配置多种事件标志我实际在产品里主要用到的是“SPI 接收 链表拼接”“ADC 多通道采样 定时器触发搬运”“以及串口不定长接收”。这三个场景都能用 GPDMA 实现“零 CPU 干预”的搬运。1.3 DMA、DMA 映射与 GPDMA 对象模型里的几个新概念用 GPDMA 之前必须先弄明白几个新概念否则看寄存器就像看天书请求RequestGPDMA 通道可以由外设的硬件请求触发也可以由软件写触发寄存器来启动。硬件请求本质上是一个握手信号外设准备好发送/接收数据时会把请求信号拉高。描述符Descriptor描述一次数据搬运的所有参数包括源端、目标端、传输长度、传输模式、以及下一个描述符的指针。描述符存储在普通 RAM 里。链表Linked-List多个描述符通过 next 指针串起来GPDMA 完成一个描述符后自动加载下一个直到链尾。通道ChannelGPDMA 核心执行单元一次只能执行一条链但可以把不同的描述符分配给不同通道并发执行。看 STM32U5 参考手册时你还会看到GPDMA_C0BR1、GPDMA_C0BR2、GPDMA_C0BR3等寄存器其中BR1配置源端BR2配置目标端BR3配置传输长度和触发设置。命名上比老 DMA 的CCR、CNDTR、CPAR、CMAR更难记但逻辑更统一。2. GPDMA 传输模式的深入理解2.1 那两种传输模式Buffer Mode 和 Linked-List ModeGPDMA 的通道有两种基础模式这个在 CubeMX 里就能看到选项Buffer Mode缓冲模式通道只执行一个描述符搬完就停需要重新配置才能再次启动。Linked-List Mode链表模式通道执行一条描述符链表每个描述符执行完自动跳到下一个直到最后一个描述符的 next 指针为 0。Buffer Mode 适合“一次性”的数据搬移比如某个算法跑完后把结果 buffer 拷到显存区域。Linked-List Mode 适合周期性的多段搬运比如连续采集多组 ADC 数据到不同内存区域或者把分散的数据包按顺序拼成完整帧。从寄存器角度看两种模式的差异只在GPDMA_C0BR1的LINKEDLIST位段设为 0 就是 Buffer Mode设为 1 就是链表模式同时需要配置GPDMA_C0LLR寄存器来指向第一个描述符。2.2 为什么说链表模式是 GPDMA 的最大亮点传统 DMA 最让人头疼的场景之一是“不定长串口数据接收”。很多人用空闲中断IDLE配合 DMA 来收不定长数据但 DMA 需要先配置一个“最大接收长度”实际收到多少要靠NDTR算差值。这在数据帧长差距很大时非常浪费而且频繁重装 DMA 配置容易出错。GPDMA 的链表模式可以直接解决这个问题你可以把缓冲区拆成 N 个小块每个块用一个描述符链表的最后一个描述符的传输长度设置成最大剩余空间。串口每产生一次空闲事件就更新链表。不过说实话串口不定长接收用链表来做还是有点杀鸡用牛刀真正能发挥链表优势的是下面这种场景。比如一个音频采集系统里需要依次执行从 PDM 麦克风采集 256 字节到 buffer A把 buffer A 的数据通过 SPI 发送给编解码器从 SPI 接收 512 字节的解码结果到 buffer B这三个动作如果用传统 DMA需要三套独立配置而且步骤 2 必须等步骤 1 完成。而 GPDMA 只需要一串 3 个描述符描述符 0外设到内存源是 PDM 数据寄存器目标是 buffer A长度 256next - 描述符 1描述符 1内存到外设源是 buffer A目标是 SPI 发送寄存器长度 256next - 描述符 2描述符 2外设到内存源是 SPI 接收寄存器目标是 buffer B长度 512next - NULLCPU 只需要把链头地址写给 GPDMA 并启动剩下全部自动完成。这就是 GPDMA 真正的价值。2.3 数据宽度、地址指针更新方式与 FIFO 的作用无论哪种模式单个描述符里都要配置以下关键参数源/目标数据宽度8 位、16 位、32 位。比如数据宽度是 8 位源地址每次传输后 1如果是 32 位则 4。地址更新模式固定还是递增。比如访问外设数据寄存器时地址固定访问内存 buffer 时地址递增。突发传输Burst可以配置为 INCR4/INCR8/INCR16表示一次总线事务搬运多少个数据单元。配置突发能提高总线利用率但是要注意 FIFO 阈值必须匹配否则会出错。FIFO 阈值GPDMA 内部有 16 字节 FIFO阈值可以设为 1/4、1/2、3/4 或满。我一般设成 1/2这样突发传输时不容易上溢/下溢。这里要特别提醒一下源和目标的数据宽度如果不同GPDMA 是可以处理对齐的。比如源是 8 位、目标是 32 位GPDMA 会自动把 4 个 8 位数据打包成一个 32 位字。但条件是源端传输总字节数必须是最大数据宽度的整数倍否则最后一次搬运会凑不满结果不确定。这个我在调试时踩过后面问题排查部分会再展开。3. STM32CubeMX 中 GPDMA 的配置流程3.1 在 CubeMX 里选择 GPDMA 通道的技巧打开 STM32CubeMX选好芯片型号 STM32U575RIT6 或者 STM32U585AII6配置一个外设比如 SPI1后在 DMA Settings 标签页里点 Add会看到两个选项DMA Request和GPDMA。很多新手拿到这里就晕了其实这两种的区别就是 STM32 的两种 DMA 实现。老一代内核比如 Cortex-M4用标准 DMA而 U5 系列是 Cortex-M33 内核官方主推 GPDMA。在 CubeMX 里添加 GPDMA 时需要配置几个关键选项Channel选择 0-15 任意一个没有被占用的通道。同一时刻一个通道只能服务一个外设。ModeBuffer Mode 或 Linked-List Mode。Request选择外设请求源比如SPI1_RX、USART1_TX、TIM1_TRIG等。如果选None则需要软件触发。DirectionPeripheral to Memory / Memory to Peripheral / Memory to Memory。CubeMX 生成代码时MX_GPIO_Init、MX_SPI1_Init这些函数里会自动加入 GPDMA 的初始化代码一般不需要手写通道初始化。3.2 CubeMX 生成代码与实际 GPDMA 初始化代码解读比如我配置了 SPI1 的 RX 走 GPDMA Channel 0CubeMX 生成的核心代码大致长这样基于 LL 库void MX_SPI1_Init(void) { LL_SPI_InitTypeDef SPI_InitStruct {0}; LL_GPIO_InitTypeDef GPIO_InitStruct {0}; /* Peripheral clock enable */ LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_SPI1); LL_AHB2_GRP1_EnableClock(LL_AHB2_GRP1_PERIPH_GPIOA); LL_AHB1_GRP1_EnableClock(LL_AHB1_GRP1_PERIPH_GPDMA); SPI_InitStruct.TransferDirection LL_SPI_FULL_DUPLEX; SPI_InitStruct.Mode LL_SPI_MASTER; SPI_InitStruct.DataWidth LL_SPI_DATAWIDTH_8BIT; SPI_InitStruct.ClockPolarity LL_SPI_POLARITY_LOW; SPI_InitStruct.ClockPhase LL_SPI_PHASE_1EDGE; SPI_InitStruct.BaudRate 8; LL_SPI_Init(SPI1, SPI_InitStruct); /* GPDMA channel configuration */ LL_DMA_SetMode(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_MODE_BUFFER); LL_DMA_SetPeriphRequest(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_REQUEST_SPI1_RX); LL_DMA_SetDataTransferDirection(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_DIRECTION_PERIPH_TO_MEMORY); LL_DMA_SetSourceAddress(GPDMA, LL_DMA_CHANNEL_0, LL_SPI_DMA_GetRegAddr(SPI1)); LL_DMA_SetSourceDataSize(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDestAddress(GPDMA, LL_DMA_CHANNEL_0, (uint32_t)rxBuffer); LL_DMA_SetDestDataSize(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDataLength(GPDMA, LL_DMA_CHANNEL_0, 256); }这里注意LL_DMA_SetMode其实是 GPDMA 的 Buffer Mode后面如果要切换到链表模式要用LL_DMA_SetMode(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_MODE_LINKEDLIST)。另外LL_SPI_DMA_GetRegAddr(SPI1)这个函数返回的是 SPI1 的 RX 数据寄存器地址用它作为 DMA 源地址就对了。3.3 关键GPDMA 的链路描述符Linked-List Descriptor配置如果要用链表模式CubeMX 生成的基础代码就不够用了需要自己构造描述符。GPDMA 描述符在 STM32U5 的 LL 库里对应一个结构体叫LL_DMA_NodeTypeDef。LL_DMA_NodeTypeDef node1, node2; void GPDMA_LinkedList_Init(void) { /* 节点1从 SPI1 RX 搬 128 字节到 buffer1 */ LL_DMA_InitTypeDef dmaInit {0}; dmaInit.Mode LL_DMA_MODE_LINKEDLIST; dmaInit.Priority LL_DMA_PRIORITY_HIGH; dmaInit.PeriphRequest LL_DMA_REQUEST_SPI1_RX; dmaInit.Direction LL_DMA_DIRECTION_PERIPH_TO_MEMORY; dmaInit.SourceIncMode LL_DMA_SOURCE_FIXED; dmaInit.DestIncMode LL_DMA_DEST_INCREMENT; dmaInit.SourceDataSize LL_DMA_PDATAALIGN_BYTE; dmaInit.DestDataSize LL_DMA_PDATAALIGN_BYTE; dmaInit.DataLength 128; dmaInit.SourceAddress LL_SPI_DMA_GetRegAddr(SPI1); dmaInit.DestAddress (uint32_t)buffer1; LL_DMA_InitNode(GPDMA, LL_DMA_CHANNEL_0, dmaInit, node1); /* 节点2从 SPI1 RX 搬 64 字节到 buffer2 */ dmaInit.DataLength 64; dmaInit.DestAddress (uint32_t)buffer2; LL_DMA_InitNode(GPDMA, LL_DMA_CHANNEL_0, dmaInit, node2); /* 链接节点 */ LL_DMA_LinkNodes(node1, node2); /* 将链表头节点配置给通道 */ LL_DMA_SetLinkedListNode(GPDMA, LL_DMA_CHANNEL_0, node1); }node1和node2必须定义成全局变量不能是局部变量因为 GPDMA 是硬件直接访问内存函数退出后栈变量就失效了。这个坑几乎每个第一次用链表的人都会踩。3.4 描述符的内存对齐要求还有一个容易忽略的细节GPDMA 描述符在内存中的地址必须按 32 字节对齐。这主要是为了 Cortex-M33 内部的 Cache/缓存的效率。如果用 CubeIDE 的默认链接脚本普通全局变量通常是 4 字节对齐所以需要手动处理。最简单的方法是用__ALIGNED(32)来定义节点__ALIGNED(32) LL_DMA_NodeTypeDef node1; __ALIGNED(32) LL_DMA_NodeTypeDef node2;如果你用的是 SDRAM 或者外部 PSRAM更要注意描述符所在内存区域是否能被 GPDMA 访问。我一般把描述符放在主 SRAM 里这样最稳。4. LL 库还是 HAL 库GPDMA 两种驱动方式实测对比4.1 HAL 库的 GPDMA 封装特点STM32U5 的 HAL 库对 GPDMA 也做了封装函数名是HAL_DMA_Start_IT、HAL_DMA_Abort等。它的好处是 API 简单状态管理由库内部处理适合快速出原型。比如用 HAL 启动一次 SPI 接收HAL_StatusTypeDef status; status HAL_DMA_Start_IT(hdma_spi1_rx, (uint32_t)hspi1-Instance-RXDR, (uint32_t)rxBuffer, 256);然后通过HAL_DMA_IRQHandler回调到HAL_SPI_RxCpltCallback里做后续处理。但 HAL 也有问题它对链表的支持封装得比较重你需要理解HAL_DMA_LinkedList_Start之类的扩展 API而且调试时状态机不透明出错后很难定位是哪个描述符的问题。4.2 LL 库的 GPDMA 封装特点LL 库则更接近寄存器层所有配置都是直接操作寄存器没有状态机隐藏。它的代码量大一点但每个操作的行为都是确定的出了问题直接看寄存器就能定位。我的实际感受是如果只是做简单的“外设到内存”搬运HAL 足够一旦涉及链表、多通道并发、或者要做低功耗模式切换必须用 LL。LL 的LL_DMA_StartTransfer或LL_DMA_EnableChannel触发方式非常直白不会有 HAL 那层“包装”带来的坑。4.3 我的建议以 LL 为主HAL 为辅我现在的做法是项目里统一用 LL 库。理由有三个第一U5 的 GPDMA 本身定位就是“可编程数据搬运”如果用 HAL相当于把高级功能藏起来了发挥不出它的优势。第二LL 库生成的代码可读性更好Review 的时候别人能直接看懂每个寄存器的作用。第三LL 库在中断处理上更灵活可以自定义中断服务函数不用被 HAL 的回调机制绑死。如果确实要兼容 HAL 的外设驱动比如 HAL 的 SPI 驱动可以只把 DMA 部分用 LL 接管中断里手动清标志。这种做法我实测是可行的。4.4 完整 LL 库例程SPI 接收 内存间搬运下面给一个完整的 LL 库例程演示“SPI 接收 128 字节然后数据搬运到另一个 buffer用软件触发再搬一次”。这是 GPDMA 最典型的“搬运”演示。#include stm32u5xx_ll_bus.h #include stm32u5xx_ll_dma.h #include stm32u5xx_ll_spi.h #define RX_BUF_SIZE 128 uint8_t spiRxBuffer[RX_BUF_SIZE]; uint8_t dmaCopyBuffer[RX_BUF_SIZE]; void GPDMA_SoftwareTransfer_Demo(void) { /* 1. 配置 GPDMA 时钟 */ LL_AHB1_GRP1_EnableClock(LL_AHB1_GRP1_PERIPH_GPDMA); /* 2. 通道 1SPI1 接收 */ LL_DMA_SetMode(GPDMA, LL_DMA_CHANNEL_1, LL_DMA_MODE_BUFFER); LL_DMA_SetPeriphRequest(GPDMA, LL_DMA_CHANNEL_1, LL_DMA_REQUEST_SPI1_RX); LL_DMA_SetDataTransferDirection(GPDMA, LL_DMA_CHANNEL_1, LL_DMA_DIRECTION_PERIPH_TO_MEMORY); LL_DMA_SetSourceAddress(GPDMA, LL_DMA_CHANNEL_1, LL_SPI_DMA_GetRegAddr(SPI1)); LL_DMA_SetSourceDataSize(GPDMA, LL_DMA_CHANNEL_1, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDestAddress(GPDMA, LL_DMA_CHANNEL_1, (uint32_t)spiRxBuffer); LL_DMA_SetDestDataSize(GPDMA, LL_DMA_CHANNEL_1, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDataLength(GPDMA, LL_DMA_CHANNEL_1, RX_BUF_SIZE); /* 3. 启动 SPI1 RX */ LL_SPI_EnableDMAReq_RX(SPI1); LL_DMA_EnableChannel(GPDMA, LL_DMA_CHANNEL_1); /* 4. 等待传输完成 */ while (!LL_DMA_IsActiveFlag_TC(GPDMA, LL_DMA_CHANNEL_1)) {} LL_DMA_ClearFlag_TC(GPDMA, LL_DMA_CHANNEL_1); /* 5. 通道 2内存到内存搬运 */ LL_DMA_SetMode(GPDMA, LL_DMA_CHANNEL_2, LL_DMA_MODE_BUFFER); LL_DMA_SetPeriphRequest(GPDMA, LL_DMA_CHANNEL_2, LL_DMA_REQUEST_NONE); LL_DMA_SetDataTransferDirection(GPDMA, LL_DMA_CHANNEL_2, LL_DMA_DIRECTION_MEMORY_TO_MEMORY); LL_DMA_SetSourceAddress(GPDMA, LL_DMA_CHANNEL_2, (uint32_t)spiRxBuffer); LL_DMA_SetSourceDataSize(GPDMA, LL_DMA_CHANNEL_2, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDestAddress(GPDMA, LL_DMA_CHANNEL_2, (uint32_t)dmaCopyBuffer); LL_DMA_SetDestDataSize(GPDMA, LL_DMA_CHANNEL_2, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDataLength(GPDMA, LL_DMA_CHANNEL_2, RX_BUF_SIZE); /* 6. 软件触发启动 */ LL_DMA_EnableChannel(GPDMA, LL_DMA_CHANNEL_2); }代码里第 4 步的轮询等待仅用于演示实际项目中应该用中断。内存到内存的搬运LL_DMA_REQUEST_NONE表示不需要外设硬件请求通过软件触发通道就启动了非常方便。5. 我在实际项目中遇到的 6 个 GPDMA 典型问题5.1 一旦启用 DMA 传输CPU 直接死机HardFault这是我第一次用链表模式时遇到的症状是 GPDMA 启动后立即进 HardFault折腾了一天。后来查了 ARM Cortex-M33 的规格和 STM32U5 的参考手册才发现问题出在描述符的地址没有按 32 字节对齐。Cortex-M33 的总线接口对 DMA 描述符的访问有严格的对齐要求不对齐会产生总线错误。解决办法就是给描述符加__ALIGNED(32)。另外如果你把描述符放在外部 RAM比如 FMC 挂的 SDRAM里还要确保 GPDMA 的时钟域和 SDRAM 的访问时序匹配否则也会出错。5.2 外设到内存的数据宽度不一致导致的数据错位从 8 位外设比如 SPI往 32 位的内存 buffer 搬数据时如果 buffer 长度不是 4 的倍数GPDMA 会提前结束或者在最后一次搬运时产生不确定数据。我的经验是要么把内存 buffer 的数据宽度也设成 8 位要么保证总字节数对齐到 4。如果一定要做 8 位到 32 位的打包建议先用一个 8 位的临时 bufferGPDMA 搬完后再由 CPU 做类型转换这样最可靠。5.3 数据搬过去了但似乎少搬了几个字节这种现象大概率是 FIFO 阈值和突发传输设置不匹配导致的。比如突发设置为 INCR16但 FIFO 阈值是 1/44 字节那 GPDMA 可能在一个突发传输还没凑满时就提前停止了。我把突发传输只用在连续大块内存搬运上而且使用INCR8或INCR4而不是INCR16预留一些余量。外设到内存的小批量搬运尽量不配突发。5.4 GPDMA 中断标志不更新导致代码卡死在等待循环GPDMA 有两类标志通道级标志和传输级标志。TCTransfer Complete是通道级的HTHalf Transfer和TETransfer Error也是。问题是在链表模式下TC标志可能在每个节点执行完都会置位也可能只在整条链结束后置位具体取决于GPDMA_C0BR1里的TCEM位段。如果你只关心整条链结束请在启动链之前把TCEM配置为LL_DMA_TCEM_LAST_LL_ITEM。假如用 HAL 库的话默认行为我遇到过不一致的情况所以现在都用 LL 手动设置。5.5 低功耗模式下 GPDMA 数据丢失STM32U575/585 支持多种低功耗模式如果某个外设的时钟在低功耗模式下被关闭GPDMA 在唤醒后可能处于错误状态。我的做法是进入低功耗之前等所有 GPDMA 通道传输完成并禁用通道唤醒后重新初始化链表节点。绝对不能带着未完成的链进入 STOP 模式否则唤醒后 GPDMA 的当前描述符指针会乱套。5.6 中断里操作 GPDMA 通道偶发卡死中断优先级和通道使能顺序不对时可能在LL_DMA_EnableChannel执行一半的时候被更高优先级中断打断导致寄存器配置不一致。解决办法在操作 GPDMA 通道的临界区用__disable_irq()和__enable_irq()包起来。或者在中断里只做标志位置位把真正的 DMA 启动操作放到主循环里执行。6. GPDMA 与 CPU Cache 的一致性处理6.1 Cortex-M33 的 Cache 与 GPDMA 的冲突STM32U575/585 的 Cortex-M33 内核带可选 CacheICache 和 DCache如果启用了 DCacheGPDMA 直接访问内存时CPU 看到的 buffer 可能和 DMA 写入内存的数据不一致。因为你用 GPDMA 读取一个 buffer 时如果该 buffer 的脏数据还在 DCache 里没有回写DMA 读到的将是旧数据。反过来GPDMA 往一个 buffer 写入数据后如果 CPU 后来读取这个 bufferCache 命中的话拿到的是旧数据。这个问题的本质是DMA 是直接访问物理内存的而 CPU 通过 Cache 访问内存两边看到的“内存状态”不一致。6.2 什么时候需要 Clean 和 Invalidate具体什么时候需要做 Cache 维护看下面的场景表就够了传输方向需要操作说明CPU - 内存 - GPDMA 读取CleanCPU 写数据到 buffer 后先 Clean DCache保证数据回写到物理内存GPDMA 写入内存 - CPU 读取InvalidateGPDMA 写完后CPU 要读之前先 Invalidate DCache让 CPU 从物理内存重新读取外设 - GPDMA - 内存Invalidate因为 CPU 可能之后要读该内存内存 - GPDMA - 外设CleanGPDMA 读取的是物理内存所以 CPU 的 dirty cache 必须回写STM32 的 HAL 库里有对应的函数SCB_CleanDCache_by_Addr((uint32_t *)buffer, length); SCB_InvalidateDCache_by_Addr((uint32_t *)buffer, length);LL 库没有现成封装直接调用 CMSIS 的这两个函数就行。6.3 最简单粗暴的避免方案如果你的系统对性能要求不是极致最简单的方案是直接关闭 DCache。U5 的 DCache 默认是关闭的很多人的 CubeMX 配置里根本没用它。这种情况下 DMA 和 CPU 看到的是一致的没有任何一致性隐患。但如果你用了 DCache比如跑复杂的 DSP 算法那就务必在每个 DMA 缓冲区的开始和结束都做 Clean/Invalidate。我自己的习惯是定义一块专用的 DMA 缓冲区区域不与普通变量混用这样 Cache 维护的范围很清楚。7. GPDMA 的性能优化与高级用法7.1 合理配置优先级和通道占用GPDMA 的 16 个通道是有优先级仲裁的。高优先级通道会优先获得总线访问权但是要注意同优先级通道之间是轮询的。如果有一个通道配置了很长的突发传输同优先级的其他通道会被饿死。我的策略是把实时性要求高的外设如音频 I2S、SPI 屏幕刷新放到高优先级通道把后台的内存拷贝放到低优先级通道。7.2 2D 搬运在图像处理中的实际用法GPDMA 支持 2D 数据传输就是把源端看成二维数组每次搬运一行搬完一行后跳到下一行行与行之间可以有偏移。这在图像裁剪、图像旋转、块拷贝中非常有用。比如要搬运一个 320x240 RGB565 图像的右上角 100x100 区域传统 DMA 需要 CPU 循环 100 行每次都重新配置。GPDMA 2D 模式只需要一个描述符dmaInit.Direction LL_DMA_DIRECTION_MEMORY_TO_MEMORY; dmaInit.SourceAddress (uint32_t)image[0][100]; dmaInit.DestAddress (uint32_t)outputBuffer; dmaInit.SourceIncMode LL_DMA_SOURCE_INCREMENT; dmaInit.DestIncMode LL_DMA_DEST_INCREMENT; dmaInit.DataLength 100; // 每行 100 个像素 dmaInit.ImageWidth 100; // 行数 dmaInit.SourceImageOffset 320 - 100; // 每行结束后跳过的像素数注意2D 模式下DataLength表示的是每行的数据单元数而不是总数据长度。这个和 1D 模式有本质区别不要搞混。7.3 用 GPDMA 做低功耗模式下的数据采集STM32U5 系列支持 LPBAMLow-Power Background Autonomous Mode它可以在低功耗模式下让 GPDMA 继续搬运数据不过 LPBAM 有自己的专用 DMA 通道和普通 GPDMA 是两个体系。如果只是想在 STOP 模式下保留几个外设的 DMA 搬运可以通过配置 EXTI 唤醒 定时器触发的 GPDMA 通道来延长采集时间但要注意时钟源。实际项目中我通常的做法是用低功耗定时器LPTIM触发 ADC 采样采样完成后让 GPDMA 搬到内存等搬运完成后产生中断唤醒 CPU。这样 CPU 在等待期间不需要醒来功耗很低。8. 调试 GPDMA 的实用技巧8.1 用寄存器窗口快速定位问题在调试器里打开 Watch 窗口观察几个关键寄存器GPDMA_CxBR1源地址配置、链表使能、传输完成事件模式GPDMA_CxBR2目标地址配置GPDMA_CxBR3数据长度、FIFO 阈值、突发大小GPDMA_CxSR状态寄存器里面有TCF、HTF、DTF、USRF、TE等标志位GPDMA_CxLLR链表模式下指向当前描述符的指针我一般先看GPDMA_CxSR里的TE标志如果有传输错误再看GPDMA_CxISR里对应的错误类型。这样比盲改代码快得多。8.2 不要迷信 DMA 中断用 GPIO 翻转实测更可靠早期调 GPDMA 的时候我习惯在中断回调里设一个断点但断点一命中调试器会暂停整个 CPUDMA 还在跑如果它不依赖 CPU很容易掩盖真正的问题。后来我在 DMA 传输完成中断服务函数开头加一个 GPIO 翻转用示波器看翻转的时机。这样可以在完全不打断 DMA 的情况下判断中断是否及时触发、触发频率如何。8.3 排查 GPDMA 链路状态的小工具思路如果你在调试链表模式可以在启动链之后定一个时间点去读当前寄存器uint32_t current_node_addr; current_node_addr LL_DMA_GetLinkedListNode(GPDMA, LL_DMA_CHANNEL_0);如果链表正常执行这个地址会随着时间变化。如果一直停在第一个节点说明第一个描述符执行完就停了大概率是next指针没有配对。8.4 常见问题速查表症状可能原因解决建议HardFault描述符未 32 字节对齐加__ALIGNED(32)数据错位源/目标数据宽度不一致统一数据宽度或用临时 buffer数据少几个字节FIFO 阈值和突发不匹配减小突发长度或降低阈值中断不触发中断使能未打开 / 标志位未清除检查 NVIC 配置清标志启动后没有传输外设请求未使能 / 软件触发未写检查外设 DMA 请求开关移入低功耗后丢失未等待传输完成进低功耗前禁用通道Cache 数据不一致未做 Clean/Invalidate按表添加维护9. 从 F1/F4/H7 迁移到 GPDMA 的心得如果你以前用过 H7 的 MDMA可能会觉得 GPDMA 有点像 MDMA 的低配版。确实它们在“描述符 链表”的思路上是相通的。但从 F1/F4 的普通 DMA 直接跳到 GPDMA有几件事必须提前转变思维第一GPDMA 的配置项远比传统 DMA 多。传统 DMA 配 4 个寄存器就完事GPDMA 一个描述符就要涉及源、目标、传输长度、触发模式、事件模式、地址更新模式、FIFO、突发等十几个参数。不要烦躁正是因为配置细它才能适应各种复杂的搬移场景。第二中断标志的位置和管理方式不同。传统 DMA 的中断标志在同一个寄存器里GPDMA 每个通道有独立的状态寄存器事件标志也更细。用 LL 库时清标志的函数名和参数要注意区分。第三GPDMA 在低功耗和性能上的优势是传统 DMA 完全无法比的。如果你用 U5 就是为了低功耗那么不要舍不得花时间学 GPDMA值得。我实际迁移一个项目时F4 上用 DMA1 的“SPI 接收 发送”花了大概两三个小时迁移到 U5 的 GPDMA 加链表模式因为对概念不熟用了差不多两个整天。但迁移完之后的维护和扩展性确实好太多了后期加新功能基本不用改底层驱动。10. 最后的实操建议10.1 先从小例子开始别一上来就配置链表模式。我每次换新芯片都喜欢先写一个“内存到内存”的搬运 demo用软件触发搬完翻转 GPIO。这个例子能确认 GPDMA 外设本身没问题也能熟悉 LL 库的 API 风格。跑通之后再加外设请求比如 SPI 接收。最后再加链表模式。分步走每步都能明确排错范围不会一团乱麻。10.2 建立自己的 GPDMA 调试模板我自己的工程里有一个gpdma_debug.h把常见的诊断操作封装成几个宏#define GPDMA_DUMP_CHANNEL_STATUS(dma, ch) \ do { \ uint32_t sr LL_DMA_GetStatus((dma), (ch)); \ if (sr LL_DMA_STATUS_TE) { \ /* 打印传输错误 */ \ } \ if (sr LL_DMA_STATUS_TC) { \ /* 传输完成 */ \ } \ } while(0)这样在调试时只需一行就能看到关键状态不用每次写一堆代码。10.3 这个内容后续还可以这样扩展如果你想把这个 GPDMA 能力用到极致建议再研究一下 STM32U575/585 的 GPADC 与 GPDMA 的联动以及怎么用链表做多通道 ADC 的循环采样。这样形成的“ADC 采样 GPDMA 搬运 定时器触发”一条龙方案几乎可以直接用在一个中等规模的数据采集产品里。我在好几个项目里就是这么用的实测 CPU 占用率极低效果非常理想。 STM32U5 GPDMA实战指南：从传统DMA到链表模式
STM32U575/585 这个系列的 GPDMA 我用了快两年了从第一版驱动踩坑到现在算是摸透了。最近不少同行在社区里问这套外设怎么上手正好这个应用笔记主题提到 GPDMA我把自己实际调通的流程、踩过的坑、以及和传统 DMA 的对比整理成一篇完整的实践记录。先说结论STM32U5 上的 GPDMA 和 F4/H7 系列上的 DMA 完全不是一个思路它更像一个可编程的数据搬运引擎支持链表式任务队列、硬件握手信号、以及丰富的事件标志。如果你是从 F1/F4 迁移过来第一反应大概是“卧槽怎么这么复杂”但一旦理解它的设计逻辑你会发现它在多数据流、复杂触发场景下真的省心太多。这篇内容适合正在用 STM32U575/585、想用 GPDMA 做外设数据搬运、或者被参考手册绕晕的朋友。我会从硬件原理讲到寄存器和 LL 库实操再到调试踩坑尽量把每个“为什么”都说清楚。1. GPDMA 的整体设计思路拆解1.1 为什么 U5 不再用传统 DMA传统 STM32 的 DMA 控制器比如 F4 的 DMA1/DMA2本质上是“独立的外设搬运工”你把源地址、目标地址、数据长度配好触发一次搬一次。它的问题在于每个 DMA 通道的功能相对固定重映射配置繁琐多段数据传输需要 CPU 频繁干预每个 buffer 传输完都要重新配置很难实现“当定时器触发时从 SPI 接收数据并放入内存然后自动启动下一次传输”这种复杂的流水线场景STM32U575/585 的 GPDMAGeneral Purpose DMA是全新设计它把“搬运任务”抽象成了一个一个的描述符每个描述符可以定义源、目标、触发条件、传输长度、甚至下一个描述符的地址。这样多个描述符串成一个链表交给 GPDMA 自己去执行CPU 只需要在整条链表结束后处理一次中断。打个比方传统 DMA 是“你告诉工人搬一箱货他搬完你再告诉他搬下一箱”GPDMA 是“你给工人一张任务清单他按顺序把五箱货搬完最后给你回个电话”。1.2 GPDMA 在 U5 系列中的硬件资源STM32U575/585 的 GPDMA 一共有 16 个通道Channel 0 到 Channel 15。每个通道是独立的可以配置成不同的优先级。它支持以下主要特性内存到内存、内存到外设、外设到内存、外设到外设的传输8/16/32 位数据宽度支持打包/解包pack/unpack支持 16 字节 FIFO可配置阈值支持 1D/2D 数据传输2D 适合图像块搬运支持链表模式即 Linked-List这是老 DMA 完全没有的支持硬件请求信号触发也支持软件触发每个通道有独立中断可配置多种事件标志我实际在产品里主要用到的是“SPI 接收 链表拼接”“ADC 多通道采样 定时器触发搬运”“以及串口不定长接收”。这三个场景都能用 GPDMA 实现“零 CPU 干预”的搬运。1.3 DMA、DMA 映射与 GPDMA 对象模型里的几个新概念用 GPDMA 之前必须先弄明白几个新概念否则看寄存器就像看天书请求RequestGPDMA 通道可以由外设的硬件请求触发也可以由软件写触发寄存器来启动。硬件请求本质上是一个握手信号外设准备好发送/接收数据时会把请求信号拉高。描述符Descriptor描述一次数据搬运的所有参数包括源端、目标端、传输长度、传输模式、以及下一个描述符的指针。描述符存储在普通 RAM 里。链表Linked-List多个描述符通过 next 指针串起来GPDMA 完成一个描述符后自动加载下一个直到链尾。通道ChannelGPDMA 核心执行单元一次只能执行一条链但可以把不同的描述符分配给不同通道并发执行。看 STM32U5 参考手册时你还会看到GPDMA_C0BR1、GPDMA_C0BR2、GPDMA_C0BR3等寄存器其中BR1配置源端BR2配置目标端BR3配置传输长度和触发设置。命名上比老 DMA 的CCR、CNDTR、CPAR、CMAR更难记但逻辑更统一。2. GPDMA 传输模式的深入理解2.1 那两种传输模式Buffer Mode 和 Linked-List ModeGPDMA 的通道有两种基础模式这个在 CubeMX 里就能看到选项Buffer Mode缓冲模式通道只执行一个描述符搬完就停需要重新配置才能再次启动。Linked-List Mode链表模式通道执行一条描述符链表每个描述符执行完自动跳到下一个直到最后一个描述符的 next 指针为 0。Buffer Mode 适合“一次性”的数据搬移比如某个算法跑完后把结果 buffer 拷到显存区域。Linked-List Mode 适合周期性的多段搬运比如连续采集多组 ADC 数据到不同内存区域或者把分散的数据包按顺序拼成完整帧。从寄存器角度看两种模式的差异只在GPDMA_C0BR1的LINKEDLIST位段设为 0 就是 Buffer Mode设为 1 就是链表模式同时需要配置GPDMA_C0LLR寄存器来指向第一个描述符。2.2 为什么说链表模式是 GPDMA 的最大亮点传统 DMA 最让人头疼的场景之一是“不定长串口数据接收”。很多人用空闲中断IDLE配合 DMA 来收不定长数据但 DMA 需要先配置一个“最大接收长度”实际收到多少要靠NDTR算差值。这在数据帧长差距很大时非常浪费而且频繁重装 DMA 配置容易出错。GPDMA 的链表模式可以直接解决这个问题你可以把缓冲区拆成 N 个小块每个块用一个描述符链表的最后一个描述符的传输长度设置成最大剩余空间。串口每产生一次空闲事件就更新链表。不过说实话串口不定长接收用链表来做还是有点杀鸡用牛刀真正能发挥链表优势的是下面这种场景。比如一个音频采集系统里需要依次执行从 PDM 麦克风采集 256 字节到 buffer A把 buffer A 的数据通过 SPI 发送给编解码器从 SPI 接收 512 字节的解码结果到 buffer B这三个动作如果用传统 DMA需要三套独立配置而且步骤 2 必须等步骤 1 完成。而 GPDMA 只需要一串 3 个描述符描述符 0外设到内存源是 PDM 数据寄存器目标是 buffer A长度 256next - 描述符 1描述符 1内存到外设源是 buffer A目标是 SPI 发送寄存器长度 256next - 描述符 2描述符 2外设到内存源是 SPI 接收寄存器目标是 buffer B长度 512next - NULLCPU 只需要把链头地址写给 GPDMA 并启动剩下全部自动完成。这就是 GPDMA 真正的价值。2.3 数据宽度、地址指针更新方式与 FIFO 的作用无论哪种模式单个描述符里都要配置以下关键参数源/目标数据宽度8 位、16 位、32 位。比如数据宽度是 8 位源地址每次传输后 1如果是 32 位则 4。地址更新模式固定还是递增。比如访问外设数据寄存器时地址固定访问内存 buffer 时地址递增。突发传输Burst可以配置为 INCR4/INCR8/INCR16表示一次总线事务搬运多少个数据单元。配置突发能提高总线利用率但是要注意 FIFO 阈值必须匹配否则会出错。FIFO 阈值GPDMA 内部有 16 字节 FIFO阈值可以设为 1/4、1/2、3/4 或满。我一般设成 1/2这样突发传输时不容易上溢/下溢。这里要特别提醒一下源和目标的数据宽度如果不同GPDMA 是可以处理对齐的。比如源是 8 位、目标是 32 位GPDMA 会自动把 4 个 8 位数据打包成一个 32 位字。但条件是源端传输总字节数必须是最大数据宽度的整数倍否则最后一次搬运会凑不满结果不确定。这个我在调试时踩过后面问题排查部分会再展开。3. STM32CubeMX 中 GPDMA 的配置流程3.1 在 CubeMX 里选择 GPDMA 通道的技巧打开 STM32CubeMX选好芯片型号 STM32U575RIT6 或者 STM32U585AII6配置一个外设比如 SPI1后在 DMA Settings 标签页里点 Add会看到两个选项DMA Request和GPDMA。很多新手拿到这里就晕了其实这两种的区别就是 STM32 的两种 DMA 实现。老一代内核比如 Cortex-M4用标准 DMA而 U5 系列是 Cortex-M33 内核官方主推 GPDMA。在 CubeMX 里添加 GPDMA 时需要配置几个关键选项Channel选择 0-15 任意一个没有被占用的通道。同一时刻一个通道只能服务一个外设。ModeBuffer Mode 或 Linked-List Mode。Request选择外设请求源比如SPI1_RX、USART1_TX、TIM1_TRIG等。如果选None则需要软件触发。DirectionPeripheral to Memory / Memory to Peripheral / Memory to Memory。CubeMX 生成代码时MX_GPIO_Init、MX_SPI1_Init这些函数里会自动加入 GPDMA 的初始化代码一般不需要手写通道初始化。3.2 CubeMX 生成代码与实际 GPDMA 初始化代码解读比如我配置了 SPI1 的 RX 走 GPDMA Channel 0CubeMX 生成的核心代码大致长这样基于 LL 库void MX_SPI1_Init(void) { LL_SPI_InitTypeDef SPI_InitStruct {0}; LL_GPIO_InitTypeDef GPIO_InitStruct {0}; /* Peripheral clock enable */ LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_SPI1); LL_AHB2_GRP1_EnableClock(LL_AHB2_GRP1_PERIPH_GPIOA); LL_AHB1_GRP1_EnableClock(LL_AHB1_GRP1_PERIPH_GPDMA); SPI_InitStruct.TransferDirection LL_SPI_FULL_DUPLEX; SPI_InitStruct.Mode LL_SPI_MASTER; SPI_InitStruct.DataWidth LL_SPI_DATAWIDTH_8BIT; SPI_InitStruct.ClockPolarity LL_SPI_POLARITY_LOW; SPI_InitStruct.ClockPhase LL_SPI_PHASE_1EDGE; SPI_InitStruct.BaudRate 8; LL_SPI_Init(SPI1, SPI_InitStruct); /* GPDMA channel configuration */ LL_DMA_SetMode(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_MODE_BUFFER); LL_DMA_SetPeriphRequest(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_REQUEST_SPI1_RX); LL_DMA_SetDataTransferDirection(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_DIRECTION_PERIPH_TO_MEMORY); LL_DMA_SetSourceAddress(GPDMA, LL_DMA_CHANNEL_0, LL_SPI_DMA_GetRegAddr(SPI1)); LL_DMA_SetSourceDataSize(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDestAddress(GPDMA, LL_DMA_CHANNEL_0, (uint32_t)rxBuffer); LL_DMA_SetDestDataSize(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDataLength(GPDMA, LL_DMA_CHANNEL_0, 256); }这里注意LL_DMA_SetMode其实是 GPDMA 的 Buffer Mode后面如果要切换到链表模式要用LL_DMA_SetMode(GPDMA, LL_DMA_CHANNEL_0, LL_DMA_MODE_LINKEDLIST)。另外LL_SPI_DMA_GetRegAddr(SPI1)这个函数返回的是 SPI1 的 RX 数据寄存器地址用它作为 DMA 源地址就对了。3.3 关键GPDMA 的链路描述符Linked-List Descriptor配置如果要用链表模式CubeMX 生成的基础代码就不够用了需要自己构造描述符。GPDMA 描述符在 STM32U5 的 LL 库里对应一个结构体叫LL_DMA_NodeTypeDef。LL_DMA_NodeTypeDef node1, node2; void GPDMA_LinkedList_Init(void) { /* 节点1从 SPI1 RX 搬 128 字节到 buffer1 */ LL_DMA_InitTypeDef dmaInit {0}; dmaInit.Mode LL_DMA_MODE_LINKEDLIST; dmaInit.Priority LL_DMA_PRIORITY_HIGH; dmaInit.PeriphRequest LL_DMA_REQUEST_SPI1_RX; dmaInit.Direction LL_DMA_DIRECTION_PERIPH_TO_MEMORY; dmaInit.SourceIncMode LL_DMA_SOURCE_FIXED; dmaInit.DestIncMode LL_DMA_DEST_INCREMENT; dmaInit.SourceDataSize LL_DMA_PDATAALIGN_BYTE; dmaInit.DestDataSize LL_DMA_PDATAALIGN_BYTE; dmaInit.DataLength 128; dmaInit.SourceAddress LL_SPI_DMA_GetRegAddr(SPI1); dmaInit.DestAddress (uint32_t)buffer1; LL_DMA_InitNode(GPDMA, LL_DMA_CHANNEL_0, dmaInit, node1); /* 节点2从 SPI1 RX 搬 64 字节到 buffer2 */ dmaInit.DataLength 64; dmaInit.DestAddress (uint32_t)buffer2; LL_DMA_InitNode(GPDMA, LL_DMA_CHANNEL_0, dmaInit, node2); /* 链接节点 */ LL_DMA_LinkNodes(node1, node2); /* 将链表头节点配置给通道 */ LL_DMA_SetLinkedListNode(GPDMA, LL_DMA_CHANNEL_0, node1); }node1和node2必须定义成全局变量不能是局部变量因为 GPDMA 是硬件直接访问内存函数退出后栈变量就失效了。这个坑几乎每个第一次用链表的人都会踩。3.4 描述符的内存对齐要求还有一个容易忽略的细节GPDMA 描述符在内存中的地址必须按 32 字节对齐。这主要是为了 Cortex-M33 内部的 Cache/缓存的效率。如果用 CubeIDE 的默认链接脚本普通全局变量通常是 4 字节对齐所以需要手动处理。最简单的方法是用__ALIGNED(32)来定义节点__ALIGNED(32) LL_DMA_NodeTypeDef node1; __ALIGNED(32) LL_DMA_NodeTypeDef node2;如果你用的是 SDRAM 或者外部 PSRAM更要注意描述符所在内存区域是否能被 GPDMA 访问。我一般把描述符放在主 SRAM 里这样最稳。4. LL 库还是 HAL 库GPDMA 两种驱动方式实测对比4.1 HAL 库的 GPDMA 封装特点STM32U5 的 HAL 库对 GPDMA 也做了封装函数名是HAL_DMA_Start_IT、HAL_DMA_Abort等。它的好处是 API 简单状态管理由库内部处理适合快速出原型。比如用 HAL 启动一次 SPI 接收HAL_StatusTypeDef status; status HAL_DMA_Start_IT(hdma_spi1_rx, (uint32_t)hspi1-Instance-RXDR, (uint32_t)rxBuffer, 256);然后通过HAL_DMA_IRQHandler回调到HAL_SPI_RxCpltCallback里做后续处理。但 HAL 也有问题它对链表的支持封装得比较重你需要理解HAL_DMA_LinkedList_Start之类的扩展 API而且调试时状态机不透明出错后很难定位是哪个描述符的问题。4.2 LL 库的 GPDMA 封装特点LL 库则更接近寄存器层所有配置都是直接操作寄存器没有状态机隐藏。它的代码量大一点但每个操作的行为都是确定的出了问题直接看寄存器就能定位。我的实际感受是如果只是做简单的“外设到内存”搬运HAL 足够一旦涉及链表、多通道并发、或者要做低功耗模式切换必须用 LL。LL 的LL_DMA_StartTransfer或LL_DMA_EnableChannel触发方式非常直白不会有 HAL 那层“包装”带来的坑。4.3 我的建议以 LL 为主HAL 为辅我现在的做法是项目里统一用 LL 库。理由有三个第一U5 的 GPDMA 本身定位就是“可编程数据搬运”如果用 HAL相当于把高级功能藏起来了发挥不出它的优势。第二LL 库生成的代码可读性更好Review 的时候别人能直接看懂每个寄存器的作用。第三LL 库在中断处理上更灵活可以自定义中断服务函数不用被 HAL 的回调机制绑死。如果确实要兼容 HAL 的外设驱动比如 HAL 的 SPI 驱动可以只把 DMA 部分用 LL 接管中断里手动清标志。这种做法我实测是可行的。4.4 完整 LL 库例程SPI 接收 内存间搬运下面给一个完整的 LL 库例程演示“SPI 接收 128 字节然后数据搬运到另一个 buffer用软件触发再搬一次”。这是 GPDMA 最典型的“搬运”演示。#include stm32u5xx_ll_bus.h #include stm32u5xx_ll_dma.h #include stm32u5xx_ll_spi.h #define RX_BUF_SIZE 128 uint8_t spiRxBuffer[RX_BUF_SIZE]; uint8_t dmaCopyBuffer[RX_BUF_SIZE]; void GPDMA_SoftwareTransfer_Demo(void) { /* 1. 配置 GPDMA 时钟 */ LL_AHB1_GRP1_EnableClock(LL_AHB1_GRP1_PERIPH_GPDMA); /* 2. 通道 1SPI1 接收 */ LL_DMA_SetMode(GPDMA, LL_DMA_CHANNEL_1, LL_DMA_MODE_BUFFER); LL_DMA_SetPeriphRequest(GPDMA, LL_DMA_CHANNEL_1, LL_DMA_REQUEST_SPI1_RX); LL_DMA_SetDataTransferDirection(GPDMA, LL_DMA_CHANNEL_1, LL_DMA_DIRECTION_PERIPH_TO_MEMORY); LL_DMA_SetSourceAddress(GPDMA, LL_DMA_CHANNEL_1, LL_SPI_DMA_GetRegAddr(SPI1)); LL_DMA_SetSourceDataSize(GPDMA, LL_DMA_CHANNEL_1, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDestAddress(GPDMA, LL_DMA_CHANNEL_1, (uint32_t)spiRxBuffer); LL_DMA_SetDestDataSize(GPDMA, LL_DMA_CHANNEL_1, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDataLength(GPDMA, LL_DMA_CHANNEL_1, RX_BUF_SIZE); /* 3. 启动 SPI1 RX */ LL_SPI_EnableDMAReq_RX(SPI1); LL_DMA_EnableChannel(GPDMA, LL_DMA_CHANNEL_1); /* 4. 等待传输完成 */ while (!LL_DMA_IsActiveFlag_TC(GPDMA, LL_DMA_CHANNEL_1)) {} LL_DMA_ClearFlag_TC(GPDMA, LL_DMA_CHANNEL_1); /* 5. 通道 2内存到内存搬运 */ LL_DMA_SetMode(GPDMA, LL_DMA_CHANNEL_2, LL_DMA_MODE_BUFFER); LL_DMA_SetPeriphRequest(GPDMA, LL_DMA_CHANNEL_2, LL_DMA_REQUEST_NONE); LL_DMA_SetDataTransferDirection(GPDMA, LL_DMA_CHANNEL_2, LL_DMA_DIRECTION_MEMORY_TO_MEMORY); LL_DMA_SetSourceAddress(GPDMA, LL_DMA_CHANNEL_2, (uint32_t)spiRxBuffer); LL_DMA_SetSourceDataSize(GPDMA, LL_DMA_CHANNEL_2, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDestAddress(GPDMA, LL_DMA_CHANNEL_2, (uint32_t)dmaCopyBuffer); LL_DMA_SetDestDataSize(GPDMA, LL_DMA_CHANNEL_2, LL_DMA_PDATAALIGN_BYTE); LL_DMA_SetDataLength(GPDMA, LL_DMA_CHANNEL_2, RX_BUF_SIZE); /* 6. 软件触发启动 */ LL_DMA_EnableChannel(GPDMA, LL_DMA_CHANNEL_2); }代码里第 4 步的轮询等待仅用于演示实际项目中应该用中断。内存到内存的搬运LL_DMA_REQUEST_NONE表示不需要外设硬件请求通过软件触发通道就启动了非常方便。5. 我在实际项目中遇到的 6 个 GPDMA 典型问题5.1 一旦启用 DMA 传输CPU 直接死机HardFault这是我第一次用链表模式时遇到的症状是 GPDMA 启动后立即进 HardFault折腾了一天。后来查了 ARM Cortex-M33 的规格和 STM32U5 的参考手册才发现问题出在描述符的地址没有按 32 字节对齐。Cortex-M33 的总线接口对 DMA 描述符的访问有严格的对齐要求不对齐会产生总线错误。解决办法就是给描述符加__ALIGNED(32)。另外如果你把描述符放在外部 RAM比如 FMC 挂的 SDRAM里还要确保 GPDMA 的时钟域和 SDRAM 的访问时序匹配否则也会出错。5.2 外设到内存的数据宽度不一致导致的数据错位从 8 位外设比如 SPI往 32 位的内存 buffer 搬数据时如果 buffer 长度不是 4 的倍数GPDMA 会提前结束或者在最后一次搬运时产生不确定数据。我的经验是要么把内存 buffer 的数据宽度也设成 8 位要么保证总字节数对齐到 4。如果一定要做 8 位到 32 位的打包建议先用一个 8 位的临时 bufferGPDMA 搬完后再由 CPU 做类型转换这样最可靠。5.3 数据搬过去了但似乎少搬了几个字节这种现象大概率是 FIFO 阈值和突发传输设置不匹配导致的。比如突发设置为 INCR16但 FIFO 阈值是 1/44 字节那 GPDMA 可能在一个突发传输还没凑满时就提前停止了。我把突发传输只用在连续大块内存搬运上而且使用INCR8或INCR4而不是INCR16预留一些余量。外设到内存的小批量搬运尽量不配突发。5.4 GPDMA 中断标志不更新导致代码卡死在等待循环GPDMA 有两类标志通道级标志和传输级标志。TCTransfer Complete是通道级的HTHalf Transfer和TETransfer Error也是。问题是在链表模式下TC标志可能在每个节点执行完都会置位也可能只在整条链结束后置位具体取决于GPDMA_C0BR1里的TCEM位段。如果你只关心整条链结束请在启动链之前把TCEM配置为LL_DMA_TCEM_LAST_LL_ITEM。假如用 HAL 库的话默认行为我遇到过不一致的情况所以现在都用 LL 手动设置。5.5 低功耗模式下 GPDMA 数据丢失STM32U575/585 支持多种低功耗模式如果某个外设的时钟在低功耗模式下被关闭GPDMA 在唤醒后可能处于错误状态。我的做法是进入低功耗之前等所有 GPDMA 通道传输完成并禁用通道唤醒后重新初始化链表节点。绝对不能带着未完成的链进入 STOP 模式否则唤醒后 GPDMA 的当前描述符指针会乱套。5.6 中断里操作 GPDMA 通道偶发卡死中断优先级和通道使能顺序不对时可能在LL_DMA_EnableChannel执行一半的时候被更高优先级中断打断导致寄存器配置不一致。解决办法在操作 GPDMA 通道的临界区用__disable_irq()和__enable_irq()包起来。或者在中断里只做标志位置位把真正的 DMA 启动操作放到主循环里执行。6. GPDMA 与 CPU Cache 的一致性处理6.1 Cortex-M33 的 Cache 与 GPDMA 的冲突STM32U575/585 的 Cortex-M33 内核带可选 CacheICache 和 DCache如果启用了 DCacheGPDMA 直接访问内存时CPU 看到的 buffer 可能和 DMA 写入内存的数据不一致。因为你用 GPDMA 读取一个 buffer 时如果该 buffer 的脏数据还在 DCache 里没有回写DMA 读到的将是旧数据。反过来GPDMA 往一个 buffer 写入数据后如果 CPU 后来读取这个 bufferCache 命中的话拿到的是旧数据。这个问题的本质是DMA 是直接访问物理内存的而 CPU 通过 Cache 访问内存两边看到的“内存状态”不一致。6.2 什么时候需要 Clean 和 Invalidate具体什么时候需要做 Cache 维护看下面的场景表就够了传输方向需要操作说明CPU - 内存 - GPDMA 读取CleanCPU 写数据到 buffer 后先 Clean DCache保证数据回写到物理内存GPDMA 写入内存 - CPU 读取InvalidateGPDMA 写完后CPU 要读之前先 Invalidate DCache让 CPU 从物理内存重新读取外设 - GPDMA - 内存Invalidate因为 CPU 可能之后要读该内存内存 - GPDMA - 外设CleanGPDMA 读取的是物理内存所以 CPU 的 dirty cache 必须回写STM32 的 HAL 库里有对应的函数SCB_CleanDCache_by_Addr((uint32_t *)buffer, length); SCB_InvalidateDCache_by_Addr((uint32_t *)buffer, length);LL 库没有现成封装直接调用 CMSIS 的这两个函数就行。6.3 最简单粗暴的避免方案如果你的系统对性能要求不是极致最简单的方案是直接关闭 DCache。U5 的 DCache 默认是关闭的很多人的 CubeMX 配置里根本没用它。这种情况下 DMA 和 CPU 看到的是一致的没有任何一致性隐患。但如果你用了 DCache比如跑复杂的 DSP 算法那就务必在每个 DMA 缓冲区的开始和结束都做 Clean/Invalidate。我自己的习惯是定义一块专用的 DMA 缓冲区区域不与普通变量混用这样 Cache 维护的范围很清楚。7. GPDMA 的性能优化与高级用法7.1 合理配置优先级和通道占用GPDMA 的 16 个通道是有优先级仲裁的。高优先级通道会优先获得总线访问权但是要注意同优先级通道之间是轮询的。如果有一个通道配置了很长的突发传输同优先级的其他通道会被饿死。我的策略是把实时性要求高的外设如音频 I2S、SPI 屏幕刷新放到高优先级通道把后台的内存拷贝放到低优先级通道。7.2 2D 搬运在图像处理中的实际用法GPDMA 支持 2D 数据传输就是把源端看成二维数组每次搬运一行搬完一行后跳到下一行行与行之间可以有偏移。这在图像裁剪、图像旋转、块拷贝中非常有用。比如要搬运一个 320x240 RGB565 图像的右上角 100x100 区域传统 DMA 需要 CPU 循环 100 行每次都重新配置。GPDMA 2D 模式只需要一个描述符dmaInit.Direction LL_DMA_DIRECTION_MEMORY_TO_MEMORY; dmaInit.SourceAddress (uint32_t)image[0][100]; dmaInit.DestAddress (uint32_t)outputBuffer; dmaInit.SourceIncMode LL_DMA_SOURCE_INCREMENT; dmaInit.DestIncMode LL_DMA_DEST_INCREMENT; dmaInit.DataLength 100; // 每行 100 个像素 dmaInit.ImageWidth 100; // 行数 dmaInit.SourceImageOffset 320 - 100; // 每行结束后跳过的像素数注意2D 模式下DataLength表示的是每行的数据单元数而不是总数据长度。这个和 1D 模式有本质区别不要搞混。7.3 用 GPDMA 做低功耗模式下的数据采集STM32U5 系列支持 LPBAMLow-Power Background Autonomous Mode它可以在低功耗模式下让 GPDMA 继续搬运数据不过 LPBAM 有自己的专用 DMA 通道和普通 GPDMA 是两个体系。如果只是想在 STOP 模式下保留几个外设的 DMA 搬运可以通过配置 EXTI 唤醒 定时器触发的 GPDMA 通道来延长采集时间但要注意时钟源。实际项目中我通常的做法是用低功耗定时器LPTIM触发 ADC 采样采样完成后让 GPDMA 搬到内存等搬运完成后产生中断唤醒 CPU。这样 CPU 在等待期间不需要醒来功耗很低。8. 调试 GPDMA 的实用技巧8.1 用寄存器窗口快速定位问题在调试器里打开 Watch 窗口观察几个关键寄存器GPDMA_CxBR1源地址配置、链表使能、传输完成事件模式GPDMA_CxBR2目标地址配置GPDMA_CxBR3数据长度、FIFO 阈值、突发大小GPDMA_CxSR状态寄存器里面有TCF、HTF、DTF、USRF、TE等标志位GPDMA_CxLLR链表模式下指向当前描述符的指针我一般先看GPDMA_CxSR里的TE标志如果有传输错误再看GPDMA_CxISR里对应的错误类型。这样比盲改代码快得多。8.2 不要迷信 DMA 中断用 GPIO 翻转实测更可靠早期调 GPDMA 的时候我习惯在中断回调里设一个断点但断点一命中调试器会暂停整个 CPUDMA 还在跑如果它不依赖 CPU很容易掩盖真正的问题。后来我在 DMA 传输完成中断服务函数开头加一个 GPIO 翻转用示波器看翻转的时机。这样可以在完全不打断 DMA 的情况下判断中断是否及时触发、触发频率如何。8.3 排查 GPDMA 链路状态的小工具思路如果你在调试链表模式可以在启动链之后定一个时间点去读当前寄存器uint32_t current_node_addr; current_node_addr LL_DMA_GetLinkedListNode(GPDMA, LL_DMA_CHANNEL_0);如果链表正常执行这个地址会随着时间变化。如果一直停在第一个节点说明第一个描述符执行完就停了大概率是next指针没有配对。8.4 常见问题速查表症状可能原因解决建议HardFault描述符未 32 字节对齐加__ALIGNED(32)数据错位源/目标数据宽度不一致统一数据宽度或用临时 buffer数据少几个字节FIFO 阈值和突发不匹配减小突发长度或降低阈值中断不触发中断使能未打开 / 标志位未清除检查 NVIC 配置清标志启动后没有传输外设请求未使能 / 软件触发未写检查外设 DMA 请求开关移入低功耗后丢失未等待传输完成进低功耗前禁用通道Cache 数据不一致未做 Clean/Invalidate按表添加维护9. 从 F1/F4/H7 迁移到 GPDMA 的心得如果你以前用过 H7 的 MDMA可能会觉得 GPDMA 有点像 MDMA 的低配版。确实它们在“描述符 链表”的思路上是相通的。但从 F1/F4 的普通 DMA 直接跳到 GPDMA有几件事必须提前转变思维第一GPDMA 的配置项远比传统 DMA 多。传统 DMA 配 4 个寄存器就完事GPDMA 一个描述符就要涉及源、目标、传输长度、触发模式、事件模式、地址更新模式、FIFO、突发等十几个参数。不要烦躁正是因为配置细它才能适应各种复杂的搬移场景。第二中断标志的位置和管理方式不同。传统 DMA 的中断标志在同一个寄存器里GPDMA 每个通道有独立的状态寄存器事件标志也更细。用 LL 库时清标志的函数名和参数要注意区分。第三GPDMA 在低功耗和性能上的优势是传统 DMA 完全无法比的。如果你用 U5 就是为了低功耗那么不要舍不得花时间学 GPDMA值得。我实际迁移一个项目时F4 上用 DMA1 的“SPI 接收 发送”花了大概两三个小时迁移到 U5 的 GPDMA 加链表模式因为对概念不熟用了差不多两个整天。但迁移完之后的维护和扩展性确实好太多了后期加新功能基本不用改底层驱动。10. 最后的实操建议10.1 先从小例子开始别一上来就配置链表模式。我每次换新芯片都喜欢先写一个“内存到内存”的搬运 demo用软件触发搬完翻转 GPIO。这个例子能确认 GPDMA 外设本身没问题也能熟悉 LL 库的 API 风格。跑通之后再加外设请求比如 SPI 接收。最后再加链表模式。分步走每步都能明确排错范围不会一团乱麻。10.2 建立自己的 GPDMA 调试模板我自己的工程里有一个gpdma_debug.h把常见的诊断操作封装成几个宏#define GPDMA_DUMP_CHANNEL_STATUS(dma, ch) \ do { \ uint32_t sr LL_DMA_GetStatus((dma), (ch)); \ if (sr LL_DMA_STATUS_TE) { \ /* 打印传输错误 */ \ } \ if (sr LL_DMA_STATUS_TC) { \ /* 传输完成 */ \ } \ } while(0)这样在调试时只需一行就能看到关键状态不用每次写一堆代码。10.3 这个内容后续还可以这样扩展如果你想把这个 GPDMA 能力用到极致建议再研究一下 STM32U575/585 的 GPADC 与 GPDMA 的联动以及怎么用链表做多通道 ADC 的循环采样。这样形成的“ADC 采样 GPDMA 搬运 定时器触发”一条龙方案几乎可以直接用在一个中等规模的数据采集产品里。我在好几个项目里就是这么用的实测 CPU 占用率极低效果非常理想。