STM32H7 D-Cache与DMA环形缓冲区数据撕裂：从MPU配置到Clean/Invalidate时序的完整排查路径

1. 问题现象与根源

在STM32H7上使用DMA进行高速ADC采样、串口通信或以太网传输时，若启用D-Cache，环形缓冲区（Ring Buffer）常出现“数据撕裂”：

  • DMA写入的新数据被CPU缓存中的旧数据覆盖；
  • CPU读取缓冲区时得到过时内容；
  • 数据包部分正确、部分错乱，且随Cache命中率变化。

根源在于Cache一致性：DMA直接访问物理内存，而CPU通过Cache访问。当两者操作同一块内存时，若未正确维护Cache，就会发生数据不一致。

2. 核心原理：Cache与DMA的交互

  • 写通（Write-Through） vs 写回（Write-Back）：STM32H7的D-Cache默认写回模式。CPU写数据时只更新Cache，不立即写回内存；读数据时若Cache未命中，则从内存加载。
  • DMA视角：DMA绕过Cache直接读写内存。若CPU修改了Cache但未写回，DMA读到旧数据；若DMA更新了内存但CPU Cache中仍有旧副本，CPU读到旧数据。
  • 环形缓冲区：生产者（DMA）和消费者（CPU）异步操作，读写指针分离，加剧了竞争。

3. 排查路径与解决方案

3.1 步骤一：确认内存区域与MPU配置

首先确定DMA缓冲区所在的内存区域（如DTCM、AXI SRAM、SRAM1-4）。不同区域Cache属性不同：

  • DTCM：紧耦合内存，无Cache，DMA可访问，但CPU访问零等待。适合小缓冲区。
  • AXI SRAM：通常有Cache，需MPU配置。

使用MPU将DMA缓冲区配置为Non-Cacheable或Write-Through，可简化一致性维护。示例MPU配置（Non-Cacheable）：

void MPU_Config(void) {
    HAL_MPU_Disable();
    MPU_Region_InitTypeDef MPU_InitStruct = {0};
    MPU_InitStruct.Enable = MPU_REGION_ENABLE;
    MPU_InitStruct.BaseAddress = 0x24000000; // AXI SRAM
    MPU_InitStruct.Size = MPU_REGION_SIZE_512KB;
    MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    MPU_InitStruct.IsBufferable = MPU_ACCESS_NOT_BUFFERABLE;
    MPU_InitStruct.IsCacheable = MPU_ACCESS_NOT_CACHEABLE;
    MPU_InitStruct.IsShareable = MPU_ACCESS_SHAREABLE;
    MPU_InitStruct.Number = MPU_REGION_NUMBER0;
    MPU_InitStruct.TypeExtField = MPU_TEX_LEVEL0;
    MPU_InitStruct.SubRegionDisable = 0x00;
    MPU_InitStruct.DisableExec = MPU_INSTRUCTION_ACCESS_ENABLE;
    HAL_MPU_ConfigRegion(&MPU_InitStruct);
    HAL_MPU_Enable(MPU_PRIVILEGED_DEFAULT);
}

3.2 步骤二：正确使用Clean/Invalidate

若必须使用Cacheable内存，则需在DMA传输前后维护Cache：

  • DMA写内存（外设→内存）：在DMA启动前，对缓冲区执行Invalidate，丢弃CPU Cache中的旧数据，确保DMA写入后CPU能读到新数据。
  • DMA读内存（内存→外设）：在DMA启动前，对缓冲区执行Clean，将CPU Cache中的新数据写回内存，确保DMA读到正确数据。
  • 传输完成后：对于DMA写内存，CPU读取前需再次Invalidate（因为DMA可能已更新内存，而Cache中仍是旧数据）。

关键时序：

// 示例：DMA接收环形缓冲区
#define BUF_SIZE 256
uint8_t dma_buf[BUF_SIZE] __attribute__((aligned(32)));

// 启动DMA接收前
SCB_InvalidateDCache_by_Addr((uint32_t*)dma_buf, BUF_SIZE);
HAL_DMA_Start(&hdma, (uint32_t)&periph, (uint32_t)dma_buf, BUF_SIZE);

// DMA传输完成中断中
void DMA_IRQHandler(void) {
    if (DMA_GetFlagStatus(DMA_FLAG_TC)) {
        SCB_InvalidateDCache_by_Addr((uint32_t*)dma_buf, BUF_SIZE);
        // 处理数据
    }
}

3.3 步骤三：环形缓冲区的特殊处理

环形缓冲区读写指针由CPU维护，DMA通常只操作数据区。若读写指针与数据在同一Cache行，需注意：

  • 将读写指针与数据分离到不同Cache行（32字节对齐）。
  • 使用__attribute__((aligned(32)))确保缓冲区起始地址对齐。
  • 对于DMA循环模式，每次DMA半满/全满中断时，对相应半区执行Invalidate。

3.4 步骤四：使用内存屏障

在Clean/Invalidate后，插入__DSB()确保操作完成：

SCB_InvalidateDCache_by_Addr((uint32_t*)buf, len);
__DSB(); // 数据同步屏障

4. 完整代码示例：DMA串口环形缓冲区

#include "stm32h7xx.h"

#define RX_BUF_SIZE 512
__attribute__((aligned(32))) uint8_t rx_buf[RX_BUF_SIZE];
volatile uint32_t rx_head = 0, rx_tail = 0;

void UART_DMA_Init(void) {
    // 配置DMA为循环模式，外设到内存
    // ...
    SCB_InvalidateDCache_by_Addr((uint32_t*)rx_buf, RX_BUF_SIZE);
    HAL_DMA_Start_IT(&hdma_usart1_rx, (uint32_t)&USART1->RDR, (uint32_t)rx_buf, RX_BUF_SIZE);
}

// DMA半满/全满中断
void DMA1_Stream0_IRQHandler(void) {
    if (__HAL_DMA_GET_FLAG(&hdma_usart1_rx, DMA_FLAG_HTIF0_4)) {
        __HAL_DMA_CLEAR_FLAG(&hdma_usart1_rx, DMA_FLAG_HTIF0_4);
        SCB_InvalidateDCache_by_Addr((uint32_t*)rx_buf, RX_BUF_SIZE/2);
        rx_head = RX_BUF_SIZE/2;
    }
    if (__HAL_DMA_GET_FLAG(&hdma_usart1_rx, DMA_FLAG_TCIF0_4)) {
        __HAL_DMA_CLEAR_FLAG(&hdma_usart1_rx, DMA_FLAG_TCIF0_4);
        SCB_InvalidateDCache_by_Addr((uint32_t*)(rx_buf + RX_BUF_SIZE/2), RX_BUF_SIZE/2);
        rx_head = RX_BUF_SIZE;
    }
}

// 从环形缓冲区读取数据
uint8_t RingBuffer_Read(void) {
    uint8_t data = rx_buf[rx_tail];
    rx_tail = (rx_tail + 1) % RX_BUF_SIZE;
    return data;
}

5. 注意事项

  • 对齐：缓冲区地址和大小必须32字节对齐，否则Clean/Invalidate可能影响相邻数据。
  • 性能：频繁Invalidate会降低Cache效率，尽量将DMA缓冲区设为Non-Cacheable。
  • 多核：STM32H7为单核，但若使用MDMA，同样需维护一致性。
  • 调试：使用SCB_InvalidateDCache()全无效化可快速验证问题，但会严重影响性能。
  • 工具：利用STM32CubeMX配置MPU，生成初始化代码，减少手动错误。

通过以上排查路径，可系统解决STM32H7上DMA与D-Cache导致的数据撕裂问题，确保高速数据采集的可靠性。