单片机与物联网 / 系统课时
DMA 常见故障
DMA 常见故障
本课建立一套可重复的 DMA 排查顺序,针对启动失败、回调不触发、数据错位和运行一段时间后被覆盖等现象逐项定位。完成后,你可以先用计数器判断链路停在哪一层,再根据请求映射、长度、宽度和缓存状态修复问题。
学习目标
- 根据故障现象选择正确的排查入口
- 识别通道冲突、长度单位和数据宽度错误
- 使用回调计数与错误码验证修复结果
先按现象分类
| 现象 | 优先检查项 | 常见根因 |
|---|---|---|
HAL_*_Start_DMA 返回失败 |
句柄、DMA 状态、请求映射 | 通道或 Stream 被占用,外设未正确关联 DMA |
| 数据在变化但回调不触发 | NVIC、DMA 中断、传输模式 | 中断未启用,使用了普通模式且只完成一次 |
| 数据值错位或相邻变量被改写 | 长度、宽度、地址对齐 | 把字节数当数据项数,半字与字配置不一致 |
| 运行一段时间后数据周期性异常 | 处理时限、缓存、内存区域 | 缓冲区被覆盖,数据缓存未同步,DMA 无法访问该内存 |

按固定顺序定位
- 先检查启动函数返回值,不要在启动失败后继续分析缓冲区内容。
- 再观察 DMA 剩余计数或回调计数,确认请求是否真正进入 DMA。
- 然后核对源地址、目标地址、长度单位、数据宽度和地址递增方向。
- 最后检查循环覆盖、CPU 处理时限、缓存一致性和 DMA 可访问的内存区域。
这个顺序从“是否启动”逐步走到“数据是否可信”,能避免一开始就修改大量配置,反而掩盖原始故障。
四类高频根因
通道或请求冲突
不同 STM32 系列使用 Channel、Stream 或 DMAMUX 请求进行映射。两个外设若占用同一不可共享资源,后初始化的外设可能覆盖前一个配置。应对照芯片参考手册和 CubeMX 冲突提示,确认每个外设都关联到正确的 DMA 句柄。
长度单位错误
HAL 启动函数的长度通常表示“数据项数量”,不是字节数。uint16_t buffer[64] 应传入 64,而不是 sizeof(buffer)。后者等于 128,会导致 DMA 越界访问并破坏相邻内存。
数据宽度不匹配
外设宽度、内存宽度和缓冲区元素类型必须一致。ADC 结果通常使用半字保存;若 DMA 配成字节,数据会被截断,若配成字但目标是 uint16_t,则可能出现错位或越界。还要确认内存地址满足宽度对应的对齐要求。
缓存或缓冲区覆盖
在带数据缓存的 Cortex-M7、部分 M33 或 H7 系列上,DMA 与 CPU 可能看到不同版本的数据。接收完成后应按缓存行对齐要求失效对应区域,发送前则应清理缓存。部分系列的 DTCM 不能被 DMA 访问,缓冲区应放到 DMA 可达的 SRAM。
用计数器确认中断链路
下面是片段示例,依赖 ADC DMA 已启动,并已将 printf 重定向到串口。它统计半传输、全传输和错误回调次数,便于判断问题发生在启动、传输还是中断阶段。
#include "main.h"
#include <stdint.h>
#include <stdio.h>
extern ADC_HandleTypeDef hadc1;
static volatile uint32_t halfCount = 0U;
static volatile uint32_t fullCount = 0U;
static volatile uint32_t errorCount = 0U;
static volatile uint32_t dmaErrorCode = 0U;
void HAL_ADC_ConvHalfCpltCallback(ADC_HandleTypeDef *hadc)
{
if (hadc->Instance == ADC1) {
++halfCount;
}
}
void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef *hadc)
{
if (hadc->Instance == ADC1) {
++fullCount;
}
}
void HAL_ADC_ErrorCallback(ADC_HandleTypeDef *hadc)
{
if (hadc->Instance == ADC1) {
++errorCount;
if (hadc->DMA_Handle != NULL) {
dmaErrorCode = HAL_DMA_GetError(hadc->DMA_Handle);
}
}
}
void DmaDiag_Report(void)
{
printf("half=%lu full=%lu err=%lu code=0x%08lX\n",
(unsigned long)halfCount,
(unsigned long)fullCount,
(unsigned long)errorCount,
(unsigned long)dmaErrorCode);
}预期输出
half=100 full=100 err=0 code=0x00000000计数值会随运行时间变化,但正常循环采集时 half 与 full 应持续增长且大致接近。若两者始终为 0,应优先检查 DMA 请求、NVIC 和中断处理函数;若 err 增长,则结合具体系列的 HAL 错误码继续定位。
修复后的验收方法
修复后先清零计数并重新启动 DMA,确认启动函数返回 HAL_OK。随后在低负载和高负载场景下各运行一段时间,检查回调计数持续增长、错误计数不变、缓冲区边界外的哨兵值未被修改。
对于循环采集,还要记录处理超时或未消费事件的次数。只有在长时间运行、提高采样率和增加 CPU 负载后仍无越界、无错误回调、无缓存旧数据,才能认为故障真正消除。