嵌入式DMA避坑指南：访问模式与缓冲区大小详解

一、从两个参数说起：为什么它们总是一起出问题

做嵌入式开发的读者多半遇到过类似场景：代码编译、下载、运行一气呵成，外设初始化打印一切正常，可ADC采回来的数据要么恒为零，要么每隔几个点才跳动一次，甚至缓冲区后面的全局变量莫名其妙被改写。排查采样时序、检查引脚配置都找不到明显问题，最后疑点往往收敛到DMA配置的两个参数上——一个控制访问模式，一个控制缓冲区大小（即传输数据项总数）。

这两个参数看似各管一摊：访问模式回答“搬运完成之后DMA下一步做什么”，缓冲区大小回答“这一轮总共搬多少个数据”。但它们实际上共同划定了DMA控制器的行为边界，彼此深度耦合：

• 模式选错，大小再精确也无法挽救：单次模式下，无论缓冲区多大，搬完一轮就停，连续采集必然“断流”；
• 大小算错，模式再正确也会出错：循环模式下，如果配置的传输项数大于实际分配的内存，DMA会把数据写到缓冲区之外，破坏相邻变量，而且这种越界往往不触发任何报错，极难定位。

因此，把这两个参数当成一个整体来理解和校验，是避开绝大多数DMA数据异常的关键。下文先分别拆解各自的语义，再分析耦合关系，最后给出可直接照做的配置流程与症状速查表。

二、DMA访问模式：决定“搬完之后干什么”

2.1 三种模式的本质区别

不同平台的库对访问模式的命名略有差异，但主流设计基本都提供以下三类。它们回答的其实是同一个问题：当传输计数器走到零之后，DMA通道接下来如何表现。

（1）单次模式

• 行为：搬运完设定数量的数据项后，通道自动关闭，传输完成标志置位，之后不再响应外设请求；
• 恢复方式：必须由软件重新装载计数并再次使能通道；
• 适用场景：一次性采集固定长度数据，例如采满1024个点做一次频谱分析、触发一次成批的数据记录。

（2）循环模式

• 行为：计数器走到零后，硬件自动把内存地址重新装载回缓冲区起始位置、计数器恢复初值，继续响应请求，永不停止，直到软件主动关闭通道；
• 适用场景：连续采样、实时波形刷新、需要长期无人值守运行的采集任务；
• 关键含义：缓冲区被视为一个“环形空间”，旧数据会被新数据按地址顺序覆盖，因此软件消费数据的速度必须跟上外设生产的速度，否则尚未处理完的旧数据会被冲掉。

（3）外设流控模式（部分平台特有）

• 行为：传输节奏与终点不由DMA预设的计数决定，而由外设侧的流控信号（请求、就绪、停止等）主导；
• 适用场景：音频流、高速串行接口等数据长度不确定、需要外设实时节制的流式传输；
• 注意：并非所有MCU的DMA都支持该模式，使用前需确认所用平台的能力。

2.2 容易被忽视的耦合项：地址递增与数据宽度

访问模式配置项周围往往还夹着地址与宽度相关的选项，它们与“模式”共同决定数据的实际落点：

• 外设侧地址：对ADC这类外设，数据永远从同一个数据寄存器读出，因此外设侧地址必须配置为“固定不递增”。如果误配为递增，DMA会去读数据寄存器旁边的保留区域或其它寄存器，采到的自然是无意义数据——这是“数据全零或乱码”的高频原因。
• 内存侧地址：多数场景下需要“按传输宽度递增”，让数据依序填满缓冲区。若误配为固定，所有数据都会写到缓冲区第一个位置，表现为“只有第一个点在更新”。
• 数据宽度：外设侧与内存侧宽度（字节/半字/字）应与外设数据寄存器的有效宽度对齐。12位ADC通常按半字（16位）传输；两侧宽度不一致时会发生拆分或拼接，导致数据错位。

三、缓冲区大小：决定“这一轮搬多少”

3.1 单位陷阱：数的是数据项，不是字节

最常见的理解偏差是把这个参数当成“字节数”。在主流设计中，它计数的是传输次数，即数据项的个数，每次搬运多宽由数据宽度配置决定：

实际占用内存（字节）= 传输项数 × 内存侧数据宽度（字节）

举例：以半字宽度传输1024项，实际占用 1024 × 2 = 2048 字节。如果按“我分配了1024字节就填1024”来配置，要么少搬一半数据，要么越界写穿内存，两种方向都出错。此外还需保证：

• 缓冲区实际声明的数组大小 ≥ 配置的传输总量；
• 缓冲区起始地址按数据宽度对齐，避免非对齐访问引发的异常或性能损失；
• 传输项数不能配置为零，也不能超出计数器的位宽上限。

3.2 多通道扫描时的换算

ADC工作在扫描模式时，每触发一轮，所有使能的通道会按顺序各产生一个数据，依次进入同一个缓冲区。此时缓冲区大小必须按“通道数 × 每通道采样点数”计算：

传输项数 = 使能通道数 × 每通道所需点数

例如：4个通道、每通道128个点，传输项数应为512。如果仍按128配置，会出现两个症状：一是各通道数据互相“踩位”，顺序错乱；二是DMA很快搬完，后续数据丢失或完成中断提前触发。数据处理时按“每N个连续元素为一轮扫描”的步长切分，即可还原各通道的时间序列。

3.3 循环模式下的容量裕量设计

循环模式下，缓冲区不仅要装得下一轮数据，还要装得下“软件响应中断期间新产生的数据”。一个实用的估算方法：

缓冲区容量 ≥ 外设数据生产速率 × 最大中断响应与处理延迟 × 安全系数（一般取1.5～2）

更稳妥的工程做法是利用半传输与全传输两个中断实现“乒乓处理”：DMA写前半缓冲区时，软件处理后半缓冲区；DMA写后半时，软件处理前半。这样即便中断响应存在抖动，也始终留有半个缓冲区的时间余量。多数平台对任意大小的缓冲区都支持这两个中断，无需依赖硬件双缓冲特性即可搭建该结构。

四、典型症状与定位方法

把前文结论映射成一张“症状—原因”对照表，排查时按图索骥可以省去大量时间。

症状1：数据全为零，或只有第一个元素在变

• 高频原因：内存侧地址未配置递增；外设侧地址被误配为递增；DMA通道未真正使能；传输项数被误配为极小值。

症状2：数据隔几个点才更新一次，或通道数据互相错位

• 高频原因：多通道扫描但缓冲区大小按单通道点数计算；两侧数据宽度不一致导致拆分错位。

症状3：缓冲区之后的变量莫名被改写

• 高频原因：配置的传输项数 × 数据宽度大于实际分配的内存，DMA越界写入相邻内存。这类问题不触发任何报错，是最隐蔽的一类。

症状4：只采到一轮就停

• 高频原因：需要连续采集却误用了单次模式；或单次模式下忘记在完成中断里重新装载计数并再次使能通道。

症状5：新数据覆盖未处理的旧数据，波形出现“撕裂”

• 高频原因：循环模式下软件消费速度不足；缓冲区容量没有预留处理延迟的裕量。

通用定位三步法：

1. 读传输计数器当前值：与预期比对，判断DMA是否在动、动到了哪里；
2. 查中断标志：传输完成、半传输、传输错误三个标志的状态组合，能区分“没启动”“启动了没完成”“完成了但软件没处理”三种情形；
3. 核对三组配置：外设侧与内存侧的地址递增方向、两侧数据宽度、传输项数与实际内存分配的一致性。

五、可直接照做的配置流程与伪代码

推荐按以下顺序配置，每一步都有明确的检查点：

1. 明确采集形态：一次性定长采集选单次模式；连续采集选循环模式；
2. 确认数据宽度：与ADC数据寄存器有效宽度对齐，通常为半字；
3. 计算传输项数：单通道为点数；多通道扫描为通道数 × 点数；
4. 校验内存：数组大小 ≥ 项数 × 宽度，且起始地址按宽度对齐；
5. 设置地址方向：外设侧固定，内存侧递增；
6. 注册中断：循环模式建议同时启用半传输与全传输中断；
7. 使能顺序：先使能ADC的DMA请求，再使能DMA通道，最后启动ADC。

伪代码示例（字段名做了抽象，具体名称以所用平台手册为准）：

/* 需求：ADC 双通道扫描，每通道256点，连续采集 */
#define CH_NUM        2
#define POINTS_PER_CH 256
#define BUF_ITEMS     (CH_NUM * POINTS_PER_CH)   /* 512 个数据项 */
static uint16_t adc_buf[BUF_ITEMS];            /* 实际占用 512*2=1024 字节 */
void adc_dma_setup(void)
{
    /* 外设侧：源地址固定，宽度半字 */
    dma_cfg.src_addr  = (uint32_t)&ADC_DATA_REG;
    dma_cfg.src_inc   = ADDR_FIXED;
    dma_cfg.src_width = WIDTH_HALFWORD;
    /* 内存侧：目的地址递增，宽度与外设侧一致 */
    dma_cfg.dst_addr  = (uint32_t)adc_buf;
    dma_cfg.dst_inc   = ADDR_INCREMENT;
    dma_cfg.dst_width = WIDTH_HALFWORD;
    /* 传输总量：以数据项为单位，而非字节数 */
    dma_cfg.items     = BUF_ITEMS;
    /* 连续采集选循环模式；一次性定长采集改回单次模式 */
    dma_cfg.mode      = MODE_CIRCULAR;
    /* 半传输/全传输中断：用于乒乓处理 */
    dma_cfg.irq_half  = 1;
    dma_cfg.irq_full  = 1;
    adc_enable_dma_request();   /* 先开外设请求 */
    dma_channel_enable();       /* 再开通道 */
    adc_start();                /* 最后启动采集 */
}

中断处理函数中只做轻量工作——置标志，或把就绪的那半缓冲拷贝给处理任务；耗时的滤波、频域变换、通信打包放到主循环或任务中完成，避免中断滞留导致数据被覆盖。

六、两个容易被忽略的收尾细节

1. 停止DMA的正确顺序：先关闭外设侧的DMA请求，再关闭DMA通道，最后清除相关标志。顺序颠倒时，可能残留一次未完成的请求，导致下次使能后第一笔数据异常，或触发一次莫名的传输错误中断。

2. 带数据缓存的内核的一致性：如果所用内核带数据缓存，DMA直写内存，而缓存中可能仍是旧值，CPU会读到“过期数据”。通用处理思路有三类：读取前对缓冲区做缓存失效操作；将缓冲区放置到非缓存内存区域；或按缓存行对齐并严格维护一致性。具体接口名称因平台而异，但思路是相通的。

七、小结

最后把全文收敛成几条判断依据：

• 访问模式管“生命周期”：单次搬完即停、循环自动回绕、外设流控由外设主导；先根据“一次性还是连续”定模式，再谈其它；
• 缓冲区大小管“边界”：以数据项为单位计数，实际内存占用 = 项数 × 内存侧宽度；多通道扫描务必乘以通道数；
• 二者耦合的三条红线：单次模式配连续需求等于断流；循环模式配容量不足等于越界或覆盖；宽度错配等于错位；
• 工程习惯：用半传输/全传输中断做乒乓处理、中断里只做轻量工作、停止DMA按“外设请求→通道→标志”的顺序执行、带缓存的内核注意一致性维护。

把这两个参数放在一起理解、一起校验，绝大多数“ADC+DMA”类的数据异常都能在配置阶段被拦下来，而不是等到示波器和逻辑分析仪轮番上阵之后才找到根源。