引言

STM32H7 系列内置 Cortex-M7 内核，其 D-Cache（数据缓存）能显著提升 CPU 访问外部 RAM 的速度，但同时也引入了缓存一致性问题。当 DMA 外设或其它总线主设备直接访问内存时，CPU 缓存中的数据可能与物理内存不一致，导致数据损坏或程序逻辑错误。本文面向有经验的嵌入式开发者，剖析三种典型误用场景，并提供经过验证的修复方案。

D-Cache 基础回顾

Cortex-M7 的 D-Cache 是 CPU 与主存之间的高速缓冲，默认在复位后关闭。启用后，CPU 读操作优先命中缓存，写操作则可能采用写回（write-back）策略，即数据先写入缓存，在特定时机才同步到主存。这种机制提升了性能，但破坏了 CPU 与 DMA 等外设之间的数据一致性。

STM32H7 提供两个关键函数：

  • SCB_CleanDCache()：将缓存中已修改的数据写回主存，并清除脏标志。
  • SCB_InvalidateDCache()：使缓存行失效，下次访问时从主存重新加载。

误用场景一：DMA 接收数据未失效缓存

问题描述

使用 DMA 从 UART 或 ADC 接收数据到内存缓冲区，CPU 随后读取该缓冲区。由于 DMA 直接写入物理内存，而 CPU 可能命中旧的缓存行，导致读取到陈旧数据。

错误代码示例

// 错误：未处理缓存一致性
uint8_t rx_buffer[256];
HAL_UART_Receive_DMA(&huart1, rx_buffer, 256);
// 等待 DMA 完成...
process_data(rx_buffer); // 可能读取到缓存中的旧数据

修复方案

在 DMA 接收完成后，读取数据前，必须使相关缓存行失效。

// 正确：DMA 完成后失效缓存
HAL_UART_Receive_DMA(&huart1, rx_buffer, 256);
// 等待 DMA 完成（如使用回调或信号量）
SCB_InvalidateDCache_by_Addr((uint32_t*)rx_buffer, sizeof(rx_buffer));
process_data(rx_buffer);

注意：SCB_InvalidateDCache_by_Addr 需要按 32 字节对齐的地址和大小，否则可能无法正确失效。

误用场景二：DMA 发送数据未清理缓存

问题描述

CPU 准备数据缓冲区，然后启动 DMA 发送。由于 CPU 写操作可能仅停留在缓存中，DMA 从物理内存读取时可能得到不完整或旧数据。

错误代码示例

// 错误：DMA 发送前未清理缓存
uint8_t tx_buffer[128];
fill_data(tx_buffer); // CPU 写入数据
HAL_UART_Transmit_DMA(&huart1, tx_buffer, sizeof(tx_buffer)); // DMA 读取物理内存

修复方案

在启动 DMA 发送前，必须将缓存中的数据写回主存。

// 正确：DMA 发送前清理缓存
uint8_t tx_buffer[128];
fill_data(tx_buffer);
SCB_CleanDCache_by_Addr((uint32_t*)tx_buffer, sizeof(tx_buffer));
HAL_UART_Transmit_DMA(&huart1, tx_buffer, sizeof(tx_buffer));

误用场景三：RTOS 多任务共享内存

问题描述

在 RTOS 环境中，多个任务共享一个内存区域，其中一个任务通过 DMA 写入，另一个任务读取。由于任务切换和缓存策略，可能导致数据不一致。例如，任务 A 使用 DMA 接收数据，任务 B 处理数据，但任务 B 可能命中缓存中的旧数据。

错误代码示例

// 错误：任务间共享未同步缓存
uint8_t shared_data[64];

void task_A(void *arg) {
    HAL_UART_Receive_DMA(&huart1, shared_data, sizeof(shared_data));
    osSemaphoreRelease(sem); // 通知任务 B
}

void task_B(void *arg) {
    osSemaphoreAcquire(sem, osWaitForever);
    process(shared_data); // 可能读取旧数据
}

修复方案

在任务切换或信号量通知后，执行缓存维护操作。

// 正确：在任务 B 中失效缓存
void task_B(void *arg) {
    osSemaphoreAcquire(sem, osWaitForever);
    SCB_InvalidateDCache_by_Addr((uint32_t*)shared_data, sizeof(shared_data));
    process(shared_data);
}

同时，在任务 A 中，如果 DMA 发送共享数据，也需要清理缓存。

通用注意事项

  • 地址对齐：SCB_CleanDCache_by_Addr 和 SCB_InvalidateDCache_by_Addr 要求地址和长度按 32 字节对齐，否则可能引发 HardFault 或无效操作。建议使用 __ALIGN_BEGIN 或 __attribute__((aligned(32))) 声明缓冲区。
  • 性能权衡：频繁的缓存维护会降低性能，建议仅在 DMA 传输前后进行，并尽量批量操作。
  • 使用 MPU 配置：对于 DMA 频繁访问的内存区域，可配置 MPU 为强序（strongly-ordered）或非缓存（non-cacheable），从根源避免一致性问题，但会牺牲部分性能。
  • HAL 库的辅助：HAL 库的 HAL_UART_RxCpltCallback 等回调中，可自动添加缓存维护，但需确认具体实现。

总结

D-Cache 一致性是 STM32H7 开发中的关键问题，误用会导致难以调试的数据错误。通过理解缓存原理，并在 DMA 传输前后正确调用清理和失效函数，可以确保数据的一致性。本文的三种场景覆盖了最常见的错误，开发者应结合项目实际，建立统一的缓存维护策略。