STM32H7 400MHz 下的隐形杀手：D-Cache 与 MPU 配置不当导致的数据一致性故障深度排查

一、问题现象：一个看似无解的 DMA 传输故障

某工业控制项目中，STM32H743 以 400MHz 运行，通过 SPI DMA 接收传感器数据，并利用 LTDC 驱动 LCD 显示。系统上电后，数据偶发错乱：LCD 出现花屏、SPI 接收缓冲区出现随机字节丢失。使用调试器观察，发现 DMA 传输完成后，CPU 读取的缓冲区数据与 DMA 写入的数据不一致，且错误毫无规律。初步排查排除了硬件电气问题，最终将矛头指向了 D-Cache 与 MPU 配置。

二、原理剖析：为什么 D-Cache 会引发数据一致性灾难

1. Cortex-M7 的 D-Cache 写回策略

Cortex-M7 内核集成的 D-Cache 默认采用 写回（Write-back） 策略。当 CPU 执行写操作时，数据首先被写入 Cache 行（通常为 32 字节），而不会立即更新到主存（SRAM 或外部 SDRAM）。只有当 Cache 行被替换或显式 Clean 操作时，数据才会写回主存。

对于普通 SRAM 变量，这种策略毫无问题，因为 CPU 始终通过 Cache 访问同一地址。但问题出现在 DMA 控制器 身上：DMA 是独立于 CPU 的总线主设备，它直接访问物理内存，不经过 D-Cache。

2. 数据不一致的两种典型场景

  • DMA 写入，CPU 读取：DMA 将数据写入 SRAM，但该地址对应的 Cache 行可能仍保留着旧数据（脏行）。CPU 读取时命中 Cache，得到的是过期数据。
  • CPU 写入，DMA 读取：CPU 修改了缓冲区，但数据仍滞留在 Cache 中，DMA 从主存读取时拿到的是旧值。

3. MPU 的内存属性映射

MPU（Memory Protection Unit）不仅用于访问保护，还负责定义内存区域的 Cache 策略。关键属性包括：

  • TEX、C、B 位：组合决定 Cache 模式（如写回、写通、非缓存）。
  • Shareable 属性：影响多总线主设备间的数据一致性。

默认情况下，STM32H7 的 SRAM 区域被配置为 Write-back 且不可共享（Non-shareable），这恰恰是 DMA 场景的陷阱。

三、解决方案：MPU 配置的正确姿势

1. 核心原则

  • DMA 缓冲区：必须配置为 Non-cacheable 或 Write-through，确保 CPU 与 DMA 看到一致的数据。
  • 普通变量区：保持 Write-back 以享受 Cache 性能。
  • 外设寄存器：必须配置为 Non-cacheable，且通常为 Device 类型。

2. 基于 CubeMX 的配置步骤

  1. 打开 STM32CubeMX，在 Cortex-M7 标签页中启用 MPU 和 D-Cache。
  2. 在 MPU Configuration 中添加区域：
    • Region 0：覆盖整个 SRAM（如 0x20000000，大小 512KB），设置为 Normal memory，Write-back，Read-allocate，Non-shareable。
    • Region 1：覆盖 DMA 缓冲区所在区域（例如 0x20010000，大小 4KB），设置为 Normal memory，Non-cacheable，Non-shareable。
  3. 确保 Region 1 的优先级高于 Region 0（数字越小优先级越高）。
  4. 生成代码后，在 main.c 中调用 MPU_Config() 和 CPU_CACHE_Enable()。

3. 手动代码配置（不依赖 CubeMX）

void MPU_Config(void)
{
    MPU_Region_InitTypeDef MPU_InitStruct = {0};

    // 禁用 MPU
    HAL_MPU_Disable();

    // Region 0: 整个 SRAM, Write-back
    MPU_InitStruct.Enable = MPU_REGION_ENABLE;
    MPU_InitStruct.BaseAddress = 0x20000000;
    MPU_InitStruct.Size = MPU_REGION_SIZE_512KB;
    MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    MPU_InitStruct.IsBufferable = MPU_ACCESS_BUFFERABLE;
    MPU_InitStruct.IsCacheable = MPU_ACCESS_CACHEABLE;
    MPU_InitStruct.IsShareable = MPU_ACCESS_NOT_SHAREABLE;
    MPU_InitStruct.TypeExtField = MPU_TEX_LEVEL1;
    MPU_InitStruct.SubRegionDisable = 0x00;
    MPU_InitStruct.DisableExec = MPU_INSTRUCTION_ACCESS_DISABLE;
    HAL_MPU_ConfigRegion(&MPU_InitStruct);

    // Region 1: DMA 缓冲区, Non-cacheable
    MPU_InitStruct.Enable = MPU_REGION_ENABLE;
    MPU_InitStruct.BaseAddress = 0x20010000;
    MPU_InitStruct.Size = MPU_REGION_SIZE_4KB;
    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_NOT_SHAREABLE;
    MPU_InitStruct.TypeExtField = MPU_TEX_LEVEL0;
    MPU_InitStruct.SubRegionDisable = 0x00;
    MPU_InitStruct.DisableExec = MPU_INSTRUCTION_ACCESS_DISABLE;
    HAL_MPU_ConfigRegion(&MPU_InitStruct);

    // 使能 MPU
    HAL_MPU_Enable(MPU_PRIVILEGED_DEFAULT);
}

// 在 main 函数中调用
int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MPU_Config();
    CPU_CACHE_Enable();
    // ... 其他初始化
}

4. 运行时维护：Clean 与 Invalidate

即使配置了 Non-cacheable 区域，有时仍需手动维护 Cache（例如使用外部 SDRAM 时）。STM32H7 HAL 提供了便捷 API：

/* 在 DMA 写入完成后，使 CPU 读取前调用 */
SCB_InvalidateDCache_by_Addr((uint32_t*)buffer, size);

/* 在 DMA 读取前，确保 CPU 写入的数据已写回 */
SCB_CleanDCache_by_Addr((uint32_t*)buffer, size);

注意：地址需 32 字节对齐，大小最好为 32 的倍数。

四、完整代码示例：SPI DMA 接收 + LCD 显示

以下是一个简化示例，展示如何正确使用 DMA 缓冲区：

// 定义在 Non-cacheable 区域（通过链接脚本或属性指定）
__attribute__((section(".noncacheable"))) uint8_t spi_rx_buf[256];

// SPI DMA 接收回调
void HAL_SPI_RxCpltCallback(SPI_HandleTypeDef *hspi)
{
    // 数据已在 spi_rx_buf 中，无需 Cache 操作（因为 Non-cacheable）
    ProcessSensorData(spi_rx_buf);
}

// 启动 DMA 接收
void Start_SPI_Receive(void)
{
    HAL_SPI_Receive_DMA(&hspi1, spi_rx_buf, 256);
}

若缓冲区位于普通 SRAM（Write-back），则需手动维护：

uint8_t spi_rx_buf[256] __attribute__((aligned(32)));

void HAL_SPI_RxCpltCallback(SPI_HandleTypeDef *hspi)
{
    // 使 CPU 读取前使 Cache 行无效
    SCB_InvalidateDCache_by_Addr((uint32_t*)spi_rx_buf, sizeof(spi_rx_buf));
    ProcessSensorData(spi_rx_buf);
}

五、调试技巧与注意事项

  • 使用调试器观察：在故障点暂停，对比 spi_rx_buf 在内存窗口（主存）和寄存器窗口（Cache）的值，可直观发现不一致。
  • 检查 MPU 配置：通过 MPU->RBAR 和 MPU->RASR 寄存器确认区域属性，或使用 STM32CubeMonitor 可视化。
  • 注意 Cache 行大小：STM32H7 的 D-Cache 行大小为 32 字节，缓冲区对齐可避免伪共享问题。
  • 避免在中断中频繁 Clean/Invalidate：开销较大，建议使用 Non-cacheable 区域或 DMA 双缓冲。
  • 链接脚本：为 Non-cacheable 区域单独划分内存段，防止编译器将普通变量放入。

六、总结

STM32H7 的 D-Cache 是一把双刃剑：用得好，性能飙升；用不好，数据错乱。通过合理配置 MPU，将 DMA 相关内存区域设为 Non-cacheable，并掌握 Cache 维护 API 的使用时机，即可彻底消除数据一致性隐患。记住：在涉及 DMA 或外设共享内存时，永远不要依赖默认的 Cache 配置。希望本文能帮你少踩几个坑，让 400MHz 的威力真正释放。