引言

STM32H7 凭借双核 Cortex-M7/M4、大容量 RAM 以及强大的 DMA2D（图形加速器）和 MDMA（内存到内存 DMA），成为高端 GUI 应用的理想平台。双缓冲技术能有效消除画面撕裂，而 MDMA 负责在后台搬运帧数据，DMA2D 则执行像素格式转换、混合等操作。然而，两者协同工作时，若配置不当，轻则性能下降，重则数据错乱、系统死机。本文聚焦实际开发中的五大配置陷阱，并提供经过验证的解决方案。

陷阱一：缓存一致性（Cache Coherency）被忽视

STM32H7 的 Cortex-M7 内核带有 L1-Cache（I-Cache 和 D-Cache）。当 MDMA 或 DMA2D 直接访问内存时，它们绕过 CPU 缓存，导致 CPU 与 DMA 看到的数据不一致。

现象：图像显示花屏、数据更新延迟。

解决方案：

  • 对帧缓冲区和 MDMA 源/目的地址区域，在配置 DMA 前调用 SCB_CleanDCache()（若 DMA 读取）或 SCB_InvalidateDCache()（若 DMA 写入）。
  • 更优做法：将帧缓冲区放置在未缓存的 MPU 区域（如 SRAM 的特定区段），通过 MPU 配置为 Device 或 Strongly-ordered，避免每次手动维护。
// 示例：MPU 配置帧缓冲区为不缓存
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_REGION_NOT_BUFFERABLE;
MPU_InitStruct.IsCacheable = MPU_REGION_NOT_CACHEABLE;
MPU_InitStruct.IsShareable = MPU_REGION_NOT_SHAREABLE;
HAL_MPU_ConfigRegion(&MPU_InitStruct);

陷阱二：MDMA 与 DMA2D 的优先级反转

MDMA 和 DMA2D 都挂在 AXI 总线上，但 MDMA 的优先级默认低于 DMA2D。若 MDMA 正在搬运关键数据，而 DMA2D 频繁抢占总线，可能导致 MDMA 传输超时或数据错位。

解决方案：

  • 在 MDMA 初始化时，将优先级设为 MDMA_PRIORITY_HIGH 或 VERY_HIGH。
  • 若使用中断，确保 MDMA 中断优先级高于 DMA2D 中断，避免中断嵌套导致的数据竞争。
// MDMA 配置示例
MDMA_InitTypeDef MDMA_InitStruct = {0};
MDMA_InitStruct.Priority = MDMA_PRIORITY_VERY_HIGH;
MDMA_InitStruct.Endianness = MDMA_LITTLE_ENDIANNESS_PRESERVE;
// ... 其他参数
HAL_MDMA_Init(&hdma_mdma, &MDMA_InitStruct);

陷阱三：地址对齐要求不满足

MDMA 要求源和目的地址按传输宽度对齐（如 32 位传输时地址需 4 字节对齐），而 DMA2D 要求帧缓冲地址按像素格式对齐（如 ARGB8888 需 4 字节对齐）。若地址未对齐，可能触发总线错误或数据错乱。

现象：HardFault 或图像偏移。

解决方案：

  • 分配缓冲区时使用 __attribute__((aligned(32))) 或使用 memalign 函数。
  • 在配置 MDMA 时，设置 MDMA_InitStruct.DataAlignment = MDMA_DATAALIGN_PACK 以允许非对齐传输，但会降低性能，建议从根源对齐。
// 分配 32 字节对齐的缓冲区
uint32_t buffer[1024] __attribute__((aligned(32)));

陷阱四：中断处理不当导致数据覆盖

双缓冲通常使用两个帧缓冲（前缓冲和后缓冲）。当 DMA2D 正在渲染后缓冲时，MDMA 可能正在将前缓冲数据传输到显示控制器。若中断处理中未正确切换缓冲索引，可能导致 MDMA 覆盖正在渲染的数据。

解决方案：

  • 使用双缓冲索引变量，并在 DMA2D 传输完成中断中切换索引。
  • 确保 MDMA 传输完成中断中，只更新前缓冲的指针，不触碰后缓冲。
  • 使用临界区保护索引切换，防止中断嵌套。
volatile uint8_t buffer_index = 0;
void DMA2D_IRQHandler(void) {
    if (__HAL_DMA2D_GET_FLAG(&hdma2d, DMA2D_FLAG_TC)) {
        __HAL_DMA2D_CLEAR_FLAG(&hdma2d, DMA2D_FLAG_TC);
        // 切换缓冲索引
        buffer_index ^= 1;
    }
}

陷阱五：MDMA 与 DMA2D 的同步机制缺失

若 MDMA 和 DMA2D 操作同一块内存（例如 MDMA 从外部存储器搬运图像到内部 SRAM，DMA2D 再从 SRAM 进行格式转换），两者必须同步。否则 DMA2D 可能读取到未完成搬运的数据。

解决方案：

  • 使用信号量或事件标志，MDMA 传输完成中断中释放信号量，DMA2D 启动前获取信号量。
  • 或者利用 MDMA 的硬件握手信号（如 MDMA 的请求信号连接到 DMA2D 的触发），但配置复杂，推荐使用软件同步。
// 使用 RTOS 信号量（如 FreeRTOS）
extern SemaphoreHandle_t dma_sync_sem;
void MDMA_IRQHandler(void) {
    // ... 清除标志
    BaseType_t xHigherPriorityTaskWoken = pdFALSE;
    xSemaphoreGiveFromISR(dma_sync_sem, &xHigherPriorityTaskWoken);
    portYIELD_FROM_ISR(xHigherPriorityTaskWoken);
}

void StartDMA2D(void) {
    xSemaphoreTake(dma_sync_sem, portMAX_DELAY);
    HAL_DMA2D_Start(&hdma2d, src_addr, dst_addr, width, height);
}

实战配置流程

  1. 初始化时钟和电源：确保 MDMA 和 DMA2D 时钟使能，且 AXI 总线频率足够。
  2. 配置 MPU：将帧缓冲区域设为非缓存，或使用缓存维护函数。
  3. 分配缓冲区：使用对齐分配，并确保大小满足需求。
  4. 初始化 MDMA：设置源/目的地址、传输宽度、优先级，并使能传输完成中断。
  5. 初始化 DMA2D：配置像素格式、混合模式、地址，并使能传输完成中断。
  6. 建立同步机制：使用信号量或标志。
  7. 启动流程：先启动 MDMA 搬运数据，完成后触发 DMA2D 处理，处理完切换缓冲。

完整代码示例（简化）

// 全局变量
uint32_t src_buffer[320*240] __attribute__((aligned(32)));
uint32_t dst_buffer[320*240] __attribute__((aligned(32)));
volatile uint8_t transfer_done = 0;

// MDMA 传输完成回调
void HAL_MDMA_IRQHandler(void) {
    // 清除标志
    transfer_done = 1;
}

// 启动一次传输
void StartTransfer(void) {
    // 1. 启动 MDMA 搬运数据到 dst_buffer
    HAL_MDMA_Start(&hdma_mdma, (uint32_t)src_buffer, (uint32_t)dst_buffer, 320*240*4, 0, 0);
    // 2. 等待 MDMA 完成（或使用信号量）
    while (!transfer_done);
    transfer_done = 0;
    // 3. 启动 DMA2D 进行格式转换（例如 RGB565 转 ARGB8888）
    HAL_DMA2D_Start(&hdma2d, (uint32_t)dst_buffer, (uint32_t)lcd_frame, 320, 240, 0, 0);
}

注意事项

  • 调试时，建议先单独测试 MDMA 和 DMA2D，再协同测试，便于定位问题。
  • 使用逻辑分析仪或 ST-Link 的 ITM 端口打印关键变量，观察时序。
  • 在 RTOS 环境下，注意中断优先级与任务调度的配合，避免优先级反转。
  • 对于低功耗模式，MDMA 和 DMA2D 在睡眠时会失效，需在唤醒后重新初始化。

结语

MDMA 与 DMA2D 的协同是 STM32H7 图形性能的关键，但陷阱重重。通过合理配置缓存、优先级、地址对齐、中断和同步机制，可以充分发挥硬件潜力，实现流畅的图形界面。希望本文的实战经验能助你在嵌入式图形开发中少走弯路。