单片机与物联网 / 系统课时

DMA 常见故障

DMA 常见故障

本课建立一套可重复的 DMA 排查顺序,针对启动失败、回调不触发、数据错位和运行一段时间后被覆盖等现象逐项定位。完成后,你可以先用计数器判断链路停在哪一层,再根据请求映射、长度、宽度和缓存状态修复问题。

学习目标

  • 根据故障现象选择正确的排查入口
  • 识别通道冲突、长度单位和数据宽度错误
  • 使用回调计数与错误码验证修复结果

先按现象分类

现象 优先检查项 常见根因
HAL_*_Start_DMA 返回失败 句柄、DMA 状态、请求映射 通道或 Stream 被占用,外设未正确关联 DMA
数据在变化但回调不触发 NVIC、DMA 中断、传输模式 中断未启用,使用了普通模式且只完成一次
数据值错位或相邻变量被改写 长度、宽度、地址对齐 把字节数当数据项数,半字与字配置不一致
运行一段时间后数据周期性异常 处理时限、缓存、内存区域 缓冲区被覆盖,数据缓存未同步,DMA 无法访问该内存

DMA 故障排查流程

按固定顺序定位

  1. 先检查启动函数返回值,不要在启动失败后继续分析缓冲区内容。
  2. 再观察 DMA 剩余计数或回调计数,确认请求是否真正进入 DMA。
  3. 然后核对源地址、目标地址、长度单位、数据宽度和地址递增方向。
  4. 最后检查循环覆盖、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 重定向到串口。它统计半传输、全传输和错误回调次数,便于判断问题发生在启动、传输还是中断阶段。

c
#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);
}

预期输出

text
half=100 full=100 err=0 code=0x00000000

计数值会随运行时间变化,但正常循环采集时 half 与 full 应持续增长且大致接近。若两者始终为 0,应优先检查 DMA 请求、NVIC 和中断处理函数;若 err 增长,则结合具体系列的 HAL 错误码继续定位。

修复后的验收方法

修复后先清零计数并重新启动 DMA,确认启动函数返回 HAL_OK。随后在低负载和高负载场景下各运行一段时间,检查回调计数持续增长、错误计数不变、缓冲区边界外的哨兵值未被修改。

对于循环采集,还要记录处理超时或未消费事件的次数。只有在长时间运行、提高采样率和增加 CPU 负载后仍无越界、无错误回调、无缓存旧数据,才能认为故障真正消除。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

DMA 常见故障

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通