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

搞嵌入式的人应该都遇到过这么个需求：DMA传输不能每次都老老实实从缓冲区第0个字节开始，而是要从基地址加上某个偏移量的位置启动。标题里这句“DMA: Start transfer from address + offset”，说白了就是描述这个场景。不管是ADC多通道扫描循环采样、串口DMA环形缓冲，还是SPI批量发送、定时器触发的脉冲输出，都会碰到“从中间某个位置开始搬数据”这种需求，而这个“中间位置”就是地址偏移。

这篇文章我打算从原理到实战，把“地址+偏移”这件事讲透。为什么DMA要支持偏移而不是靠CPU重新配置基地址？偏移的量到底按字节算还是按元素算？环形缓冲回绕的时候怎么用偏移分两段传？多通道ADC怎么用偏移快速定位各通道数据？这些我都会结合GD32、STM32的实战经验展开。适合正在调ADC+DMA、串口DMA，或者想深入了解DMA地址管理的朋友，能帮你少走不少弯路。

1. DMA地址+偏移的本质原理

1.1 地址+偏移到底是个什么机制

先明确一个核心概念：DMA控制器本身只认识物理地址。它的任务就是“从源地址读数据，写到目标地址”，源地址和目标地址分别配置在外设端和内存端。在STM32/GD32这类MCU上，这个地址通常由DMA的CPAR（外设地址寄存器）和CMAR（内存地址寄存器）来保存，一个32位地址值，指向的是绝对内存地址。

那么“地址+偏移”是如何实现的？实际工程中，无非三种方式：

1. 软件合成地址。最直接的做法，在调用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))。这类接口内部不做任何特殊处理，就是把你传进去的“地址+偏移”当成最终地址写入寄存器。

2. 硬件提供独立偏移字段。部分DMA控制器在传输描述符里内置了偏移量寄存器，比如NXP的eDMA的TCD里就有last source address adjustment字段，DMA2D的Line Offset、Pitch参数也是同一类逻辑。这类控制器在执行传输时，地址是按“基地址+内部偏移”动态计算的，可以在不重写整个地址的前提下切换传输区间。

3. 靠地址增量+循环模式实现伪偏移。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多通道扫描循环采样DMA

ADC多通道扫描+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轴插补能达到500k，3轴可达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寄存器，因此你传addr，DMA就从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偏移问题的八成，尤其是“对齐”和“元素/字节混淆”，非常典型。写代码的时候多用&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相关的问题其实并没有想象中那么难缠。