DMA从地址+偏移启动传输：原理、实战与避坑指南

搞嵌入式的人应该都遇到过这么个需求DMA传输不能每次都老老实实从缓冲区第0个字节开始而是要从基地址加上某个偏移量的位置启动。标题里这句“DMA: Start transfer from address offset”说白了就是描述这个场景。不管是ADC多通道扫描循环采样、串口DMA环形缓冲还是SPI批量发送、定时器触发的脉冲输出都会碰到“从中间某个位置开始搬数据”这种需求而这个“中间位置”就是地址偏移。这篇文章我打算从原理到实战把“地址偏移”这件事讲透。为什么DMA要支持偏移而不是靠CPU重新配置基地址偏移的量到底按字节算还是按元素算环形缓冲回绕的时候怎么用偏移分两段传多通道ADC怎么用偏移快速定位各通道数据这些我都会结合GD32、STM32的实战经验展开。适合正在调ADCDMA、串口DMA或者想深入了解DMA地址管理的朋友能帮你少走不少弯路。1. DMA地址偏移的本质原理1.1 地址偏移到底是个什么机制先明确一个核心概念DMA控制器本身只认识物理地址。它的任务就是“从源地址读数据写到目标地址”源地址和目标地址分别配置在外设端和内存端。在STM32/GD32这类MCU上这个地址通常由DMA的CPAR外设地址寄存器和CMAR内存地址寄存器来保存一个32位地址值指向的是绝对内存地址。那么“地址偏移”是如何实现的实际工程中无非三种方式软件合成地址。最直接的做法在调用DMA接口时直接把buffer offset作为地址传进去让这个合成后的地址填进DMA寄存器。比如HAL_DMA_Start_IT(hdma, (uint32_t)(src offset), ...)或者GD32库里的dma_memory_address_config(DMA0, DMA_CH0, DMA_MEMORY_0, (uint32_t)(buf offset))。这类接口内部不做任何特殊处理就是把你传进去的“地址偏移”当成最终地址写入寄存器。硬件提供独立偏移字段。部分DMA控制器在传输描述符里内置了偏移量寄存器比如NXP的eDMA的TCD里就有last source address adjustment字段DMA2D的Line Offset、Pitch参数也是同一类逻辑。这类控制器在执行传输时地址是按“基地址内部偏移”动态计算的可以在不重写整个地址的前提下切换传输区间。靠地址增量循环模式实现伪偏移。DMA支持地址递增Increment和循环模式Circular时地址会按传输数据宽度递增到达边界后自动回绕到初始地址。借助这个特性你可以把初始地址故意设成buffer offset让DMA在前半段和后半段之间来回跑从而实现一个“环形缓冲区”。这三种方式里MCU裸机开发最常用的是第一种和第三种组合也就是软件算好偏移地址再把“环形、增量”这些属性交给DMA硬件去处理。理解这一点之后你就会发现标题里的address offset不是一个固定API而是一种设计需求你的代码可以灵活地把它落到任意一种实现上。1.2 偏移量的单位字节还是元素这是最常踩坑、但最容易被忽略的一个点。DMA地址寄存器的单位永远是字节因为内存的最小寻址单位是字节但在配置传输数据宽度时DMA是按半字Half Word、字Word或者字节来递增的。很多人在这里混淆了“偏移了几个元素”和“偏移了几个字节”。举个例子我有一个uint16_t数组adc_values[16]DMA外设宽度设置为半字内存宽度也设置为半字地址增量模式开启。如果我想让DMA从adc_values[4]开始传输那么地址偏移应该是4 * sizeof(uint16_t) 8字节而不是4。如果你在代码里写成(uint32_t)(adc_values 4)没问题C语言智能帮你乘了2但如果你用(uint32_t)adc_values 4那就错了DMA会从adc_values[2]的中间位置开始读数据全错。再一个对齐问题。DMA传输数据宽度为字32位时要求首地址必须4字节对齐否则在Cortex-M系列上会触发总线错误或者数据被悄悄拆分。这在串口DMA接收不定长数据时特别常见因为串口接收缓冲区往往是uint8_t数组偏移量可能是一个奇数一旦从奇数地址启动字宽度DMA就会出问题。我一般都要求串口DMA环形缓冲区的读取指针和写入指针都做对齐处理或者直接把DMA宽度配置成字节模式虽然效率略低但稳定。1.3 为什么需要“偏移”而不是重新改基地址有人会问我每次需要从新位置启动DMA直接把基地址改成新位置不就行了为什么还要煞费苦心搞出个偏移实际上重新配置基地址确实是最普通的做法但它在工程里有两个明显痛点。第一重新配置意味着要停掉DMA、改寄存器、再使能这个过程中如果外设还在持续产生数据比如串口在连续接收、ADC在连续转换要么丢数据要么需要额外的硬件缓冲来过渡而偏移可以在不改变其他控制参数的前提下只更新地址字段配合“循环模式”或者“DMA当前地址寄存器”就能无缝衔接。第二在多通道、多缓冲场景下基地址往往是固定的比如一组连续采样缓冲区可变的只是“从哪个批次开始”这时候本质就是偏移的变化代码上用偏移来表达更清晰不容易出错。还有一个实用场景是DMA双缓冲。两块缓冲区一块给CPU处理一块给DMA搬运交替使用的时机往往是“DMA传输完成中断”或“半传输中断”。这时候如果用偏移去定位到另一块缓冲区只需要在中断里把内存地址寄存器切换到另一块的起始地址而其他配置全部保持不变代码写起来非常清爽。2. DMA地址偏移的高频实战场景2.1 ADC多通道扫描循环采样DMAADC多通道扫描DMA是嵌入式里最典型的DMA使用姿势之一。STM32、GD32的ADC都支持扫描模式硬件会按照配置的通道顺序依次转换每次转换完成后触发DMA请求DMA把转换结果按顺序存到内存缓冲区里。假设我配置了8个ADC通道采样结果用uint16_t存放。那么一次扫描完成DMA会向缓冲区写入8个半字缓冲区里的数据排列就是[ch0, ch1, ch2, ..., ch7]。如果设置DMA为循环模式它会反复采样不断覆盖缓冲区数据排列永远是“一轮一轮”的这个时候你就需要偏移来定位“某一轮的第几个通道”。举个例子我想直接读取第5轮的第3通道的采样值缓冲区定义如下#define ADC_CH_NUM 8 #define ADC_ROUND_NUM 16 uint16_t adc_buffer[ADC_ROUND_NUM][ADC_CH_NUM]; // 启动DMA让数据从adc_buffer[0][0]开始写入 HAL_ADC_Start_DMA(hadc, (uint32_t *)adc_buffer, ADC_ROUND_NUM * ADC_CH_NUM);这里如果想从第5轮开始而不是从头开始偏移就是uint16_t *start_addr adc_buffer[5][0]; // 也就是 uint32_t start_addr_v (uint32_t)adc_buffer 5 * ADC_CH_NUM * sizeof(uint16_t);很多老手直接用索引adc_buffer[5][channel]去读值本质上就是一种“基地址偏移”的寻址方式只是C语言帮我们做了。但如果你想在DMA启动时就直接指定从某个位置开始比如我想反复采集第6到第10轮的数据到另一段缓冲区就得手动算偏移然后传给DMA接口。这里有个经验多通道ADC的DMA缓冲区最好用二维数组让编译器和调试器帮你计算偏移而不是手写一维数组加偏移公式。因为二维数组的存取逻辑和ADC扫描顺序天然对应代码可读性高也不容易把行列搞混。2.2 串口DMA环形缓冲串口接收不定长数据最经典的解法是“空闲中断 DMA环形缓冲”。这种情况下偏移就不仅是启动时的计算而是贯穿整个接收流程。我常用的设计是这样的定义一个uint8_t rx_buffer[512]DMA配置为循环模式外设地址固定为串口的数据寄存器内存地址是rx_buffer传输长度是512。一旦使能串口收到一个字节DMA就把它搬到缓冲区里地址自动加1当传完512字节后DMA循环回绕到缓冲区头部继续接收。这时候CPU怎么知道新数据落在哪方法是读取DMA当前内存地址寄存器DMA_GetCurrentMemoryAddr()拿它减去缓冲区基地址就是当前DMA写指针的偏移量。uint32_t current_addr (uint32_t)rx_buffer HAL_DMA_GetMemoryAddress(hdma_uart_rx); // HAL库返回的是存着当前内存地址寄存器的指针 // 更准确的是直接读寄存器 uint32_t dma_current (uint32_t)rx_buffer (hdma_uart_rx.Instance-CMAR - (uint32_t)rx_buffer); // 所以偏移 当前地址 - 基地址注意这里实际读的是CMAR寄存器表示DMA下一次要写的内存地址它一直在变。这个偏移值就是环形缓冲区里“旧数据”和“新数据”的分界线。当我们解析完一帧数据需要把DMA的写入位置调整到某个偏移处继续接收时就直接重新配置内存地址为rx_buffer target_offset并更新传输长度。因为循环模式下传输长度要和整个缓冲区分区匹配所以工程上更常用的是“正常模式偏移分两段启动”的策略每收到一段数据CPU根据当前偏移计算出下一个空闲区间的起始地址和长度然后用普通模式启动DMA让它只接收这一段接收完成后进入中断再由CPU切到另一段。// 第一段从offset开始接收(512 - offset)字节 HAL_UART_Receive_DMA(huart, rx_buffer offset, 512 - offset); // 数据接收完成解析后 // 若还有剩余空间继续从头部启动第二段 HAL_UART_Receive_DMA(huart, rx_buffer, offset);这样写虽然分两段但每一段都准确利用了“地址偏移”启动DMA而且避免了环形模式难以判断数据边界的问题个人觉得比纯循环模式更可控。2.3 双DMA与脉冲输出热搜风格里有人提到“通过双DMA实现脉冲输出8轴插补能达到500k3轴可达1M”。这个场景我很熟悉本质就是利用DMA从内存中搬运脉冲波形到GPIO数据寄存器上用定时器触发DMA每个脉冲周期的输出都由DMA提前准备好而不是CPU逐个翻转引脚。以STM32为例用DMA把内存中的某个数据表搬到GPIO-BSRRL或GPIO-ODR就能精确控制一组引脚的电平随时间变化。脉冲波形可以预先生成到一个数组中数组里每个元素对应一个时隙的引脚电平状态。如果要做多轴运动控制每个轴实际上对应内存表中不同的偏移位置几轴联动时DMA从不同的base offset取出数据做到“各走各的波形、互不干扰”。// 假设TIM触发DMA将脉冲表转移到GPIO-BSRRL #define PULSE_TABLE_LEN 1024 uint16_t pulse_table_axis0[PULSE_TABLE_LEN]; uint16_t pulse_table_axis1[PULSE_TABLE_LEN]; // 从axis0开始50个数据输出 HAL_DMA_Start_IT(hdma_tim_ch0, (uint32_t)(pulse_table_axis0), (uint32_t)GPIOA-BSRRL, 50); // 下一次从axis0表中间某个位置继续输出偏移了120个元素 HAL_DMA_Start_IT(hdma_tim_ch0, (uint32_t)(pulse_table_axis0 120), (uint32_t)GPIOA-BSRRL, 50);这里的地址偏移帮我们把“当前运动到哪个位置、下一段要输出多少脉冲”抽象成“从波形表哪个位置开始搬数据”逻辑非常顺。更妙的是如果两张波形表在内存中是连续定义的那么连切换表的代码都省了直接改偏移量就可以无缝衔接不同运动阶段的数据。当然这种用法对DMA缓冲区的连续性和对齐要求都很高。我在实际项目中会把波形表单独放到一个4字节对齐的内存段并且用__attribute__((aligned(4)))来强制对齐避免DMA字传输时出问题。还要注意一点如果数据表很大缓存一致性会是个隐患尤其是Cortex-M7内核比如STM32H7上DMA和CPU共享内存时要记得做Cache Clean/Invalidate操作。3. 实操从地址偏移启动DMA的完整配置3.1 用HAL库从“地址偏移”启动ADC DMA传输先演示一个完整的STM32 HAL库实现。ADC配置为扫描模式8个通道循环采样。需求是当某个外部标志置位时DMA立即从缓冲区第2轮第0个通道开始继续写入而不是从头开始。/* 缓冲区定义 */ #define ADC_CHANNEL_COUNT 8 #define ADC_SAMPLE_ROUNDS 32 uint16_t adc_buffer[ADC_SAMPLE_ROUNDS][ADC_CHANNEL_COUNT]; /* 启动ADC DMA从缓冲区头部开始 */ HAL_ADC_Start_DMA(hadc, (uint32_t *)adc_buffer, ADC_SAMPLE_ROUNDS * ADC_CHANNEL_COUNT);当需要从第2轮开始传输时我们只需要把DMA的内存地址改成adc_buffer[2][0]也就是偏移了2 * 8 * sizeof(uint16_t) 32字节。HAL库里面可以直接这样void adc_dma_start_at_round(uint16_t round_index) { uint16_t *addr adc_buffer[round_index][0]; // 停止DMA重新设置内存地址和传输数量 HAL_ADC_Stop_DMA(hadc); __HAL_UNLOCK(hadc); hadc.DMA_Handle-Instance-CMAR (uint32_t)addr; HAL_ADC_Start_DMA(hadc, (uint32_t *)addr, ADC_SAMPLE_ROUNDS * ADC_CHANNEL_COUNT); }注意HAL_ADC_Start_DMA内部会调用HAL_DMA_Start_IT最终把第二个参数写入CMAR寄存器因此你传addrDMA就从addr开始搬。这里并没有额外的“硬件偏移寄存器”本质就是软件合成地址。我实际用的时候发现HAL_ADC_Stop_DMA到Start之间需要清掉ADC的DMA请求和状态标志否则有时会在停止瞬间误触发一次传输导致第一轮数据错位。处理方式是停止后加一个短延时或者把hadc.State强制置为HAL_ADC_STATE_READY再重新配置。3.2 用GD32库寄存器级配置偏移GD32的DMA库和STM32略有差异配置更直接。比如GD32F4系列把DMA通道的内存地址配置为buffer offset直接用一行dma_memory_address_config(DMA0, DMA_CH0, DMA_MEMORY_0, (uint32_t)(buffer offset));启动通道dma_channel_enable(DMA0, DMA_CH0);在环形缓冲回绕时我需要把DMA从尾部切回头部可以这样分两次启动/* 第一段从内存中部到尾部的数据 */ dma_memory_address_config(DMA0, DMA_CH0, DMA_MEMORY_0, (uint32_t)(rx_buf tail)); dma_transfer_number_config(DMA0, DMA_CH0, capacity - tail); dma_channel_enable(DMA0, DMA_CH0); /* 传输完成中断中启动第二段 */ void DMA0_Channel0_IRQHandler(void) { if(dma_interrupt_flag_get(DMA0, DMA_CH0, DMA_INT_FLAG_FTF)) { dma_interrupt_flag_clear(DMA0, DMA_CH0, DMA_INT_FLAG_FTF); dma_memory_address_config(DMA0, DMA_CH0, DMA_MEMORY_0, (uint32_t)(rx_buf)); dma_transfer_number_config(DMA0, DMA_CH0, tail); dma_channel_enable(DMA0, DMA_CH0); } }GD32的库函数参数很直白不会像HAL库那样有多层封装适合阅读和理解底层行为。如果你刚接触GD32建议直接把dma_memory_address_config和dma_transfer_number_config的寄存器操作打开看看代码量不大但能帮你彻底搞明白偏移地址最终写进了哪个寄存器。3.3 影响偏移计算的三个细节第一条DMA传输数量是元素个数不是字节数。这在配置DMA传输长度时特别容易混淆。比如你让DMA把内存中一个uint32_t数组的50个元素搬到外设传输数量应该填50不是200。如果偏移量也按元素算那么传给DMA的地址偏移就应该是元素下标 * 数组元素类型大小而DMA内部的地址增量是每次加“传输宽度”字节数。第二条半传输中断/传输完成中断的指针位置。半传输中断意味着DMA搬运到一半此时当前内存地址寄存器已经走到缓冲区的中间位置和启动地址相差了长度/2个元素。如果你在中断里读取CMAR来计算偏移得到的就是这个中间位置而不是起始位置。很多人在解析串口环形缓冲时容易在这里被绕晕。我的建议是既然半传输中断的本质就是“到了缓冲区中间”那就直接拿这个位置做分界不要再额外加偏移。第三条缓存一致性。Cortex-M7内核带D-Cache时CPU写入缓冲区后直接启动DMA可能会因为Cache没回写DMA实际读到的是DDR/SRAM里的旧数据。解决方法是启动DMA前对偏移区域执行SCB_CleanDCache_by_Addr传输完成后用SCB_InvalidateDCache_by_Addr让CPU读到DMA搬完的数据。/* 启动前clean确保CPU的数据写回内存 */ SCB_CleanDCache_by_Addr((uint32_t *)(src offset), len); /* 启动DMA... */ /* 传输完成后invalidate确保CPU读到的不是Cache中的旧值 */ SCB_InvalidateDCache_by_Addr((uint32_t *)(src offset), len);这三个细节每一个都可能导致偏移后的数据传输结果“看起来对但偶尔错”排查起来非常耗时间提前规避绝对值得。4. 常见问题与排查技巧实录4.1 问题速查表这块内容我整理成了表格都是实际调试中反复出现的问题解决办法也验证过。现象根本原因解决思路DMA启动后数据全是乱的偏移地址未按传输宽度对齐检查首地址是否是传输宽度的整数倍Word模式必须4字节对齐多通道ADC只有第0通道正确其余错位偏移计算把通道号和字节偏移混了使用(uint32_t)adc_buffer[round][ch]而不是(uint32_t)adc_buffer round * ch串口DMA循环接收一段时间后丢字节从偏移处重新启动DMA前没清状态标志Stop后执行__HAL_DMA_CLEAR_FLAG再清State为Ready环形缓冲回绕后数据顺序错乱分两段启动时第二段的长度没算对len2 taillen1 capacity - tail确保两段长度之和等于缓冲区容量从偏移处传输出错但从头传没问题缓存一致性DMA读到了旧数据启动前Clean、完成后Invalidate D-CacheDMA传输字节数正常但数据被截断内存当前地址寄存器的返回值被当成偏移读CMAR后减去基地址才是偏移别直接用读到的值GD32的DMA中断不触发通道优先级没配或者DMA请求源没使能检查DMA_CHX_CTL里的外设请求使能位以及外设的DMA请求开关其中前四个现象占了我遇到DMA偏移问题的八成尤其是“对齐”和“元素/字节混淆”非常典型。写代码的时候多用array[index]而不是手工算地址能避开一大半坑。4.2 两个典型排查案例案例一ADC多通道DMA只有第0通道值正确其他通道值错位。用STM32F407的ADC1扫描模式DMA循环搬运到uint16_t adc_buf[8]代码直接读adc_buf[1]到adc_buf[7]却只有adc_buf[0]是对的。排查后发现我配置ADC转换序列时第一次配置了8个通道但中途又改了序列长度为5导致DMA按ADC_SQR1里的L[3:0]去判断单次扫描的总转换次数DMA传输数量还写的是8 * 采样轮数数据排列自然错位。这种问题不是偏移算错而是“ADC序列长度变化导致DMA实际搬运的数据流和预期不一致”但表象和偏移错误一模一样。排查方法就是先停掉DMA打印一轮数据确认缓冲区内存值和实际通道对应关系。案例二串口DMA环形缓冲在回绕时偶尔出现两帧数据拼在一起。我用的方案是空闲中断DMA正常模式每次接收完一段把DMA内存地址改成下一个空闲区间的偏移位置。排查中发现串口中断处理函数里调用HAL_UART_Receive_DMA重新启动时没有处理DMA的传输完成中断标志导致第二次启动时DMA在当前中断服务函数返回后又被旧中断标志触发了一次相当于重复搬运了相同地址的数据。解决办法是在重新启动前先调用__HAL_DMA_CLEAR_FLAG(hdma_uart_rx, DMA_FLAG_TC)并且把DMA的State变量重置为Ready。从那之后环形缓冲的拼接就再也没有错乱过。4.3 调试地址偏移问题的三个独门技巧第一个技巧DMA启动前在关键位置打印或者在线仿真查看合成后的起始地址。很多人习惯在初始化代码里直接用buffer offset却从不去确认这个值到底是多少。我在GDB或者Keil的Watch窗口里直接看CMAR寄存器再和手动计算的期望地址比对多数偏移问题一眼就能看出来。第二个技巧画一张内存布局图。把基地址写到纸上按字节把缓冲区分成几个区间用箭头标出DMA下一次读写的位置。别嫌土我遇到复杂的多通道、多缓冲交错使用时靠脑算是真的会算错画图之后就再也没出过“偏移算错一位”的问题。第三个技巧利用DMA当前地址寄存器做动态偏移检测。在运行过程中定期读取CMAR看它是否落在预期区间内。比如串口DMA环形缓冲如果读到的当前地址和CPU解析时算出的写指针不一致说明DMA曾经停止过或者地址被改过。这个检查加在串口数据处理任务里能帮你快速定位“数据错乱是不是DMA偏移没跟上”的问题。以上这些都是我在STM32和GD32平台上反复调试DMA功能后的经验总结。地址偏移这个设计看起来只是一个简单的加法运算实际用起来牵扯到地址对齐、元素宽度、缓存一致性、状态标志管理等多个环节。个人体会是不要急着写代码先用内存图和寄存器值把“DMA下一次到底从哪开始、搬多少、搬完做什么”想清楚再动手配置你会发现DMA相关的问题其实并没有想象中那么难缠。