2、显示缓存管理原理：显存分配策略、连续物理内存与IOMMU映射、全志DE2/DE3显示引擎对缓存的要求

显示缓存管理是DRM/KMS驱动中最核心、最易出问题的环节。在全志平台上，显示引擎（DE2/DE3）对缓冲区的物理连续性、对齐方式和访问带宽有严格约束，而系统内存分配器（如CMA、DMA-Heap）与IOMMU映射策略直接决定了显示缓存能否被正确使用。本节从分配策略、物理连续性、IOMMU映射和DE引擎约束四个维度展开。

2.1 显存分配策略：从系统内存到显示专用缓冲区

嵌入式Linux中，显示缓冲区通常不通过标准malloc或vmalloc分配，而是使用内核提供的连续物理内存分配器。全志平台常用的分配路径如下：

2.2 连续物理内存：为什么显示引擎离不开它？

全志DE2/DE3显示引擎内部没有复杂的MMU或TLB，其UI图层（Vi通道）和视频图层（UI通道）的DMA引擎只能处理物理连续的帧缓冲区。原因如下：

• 突发传输（Burst Transfer）：DE引擎在读取一行像素时，会以128字节或256字节的突发长度从DDR中读取数据。如果物理地址不连续，突发传输会被截断，导致总线效率骤降甚至数据错误。
• 硬件管线无分页支持：DE2/DE3的fetch单元只接受起始地址和行跨度（stride），不支持按页表跳转。这意味着每一帧的像素数据在物理地址空间上必须是线性连续的。
• 带宽保障：连续物理内存允许DE引擎使用固定的DDR burst通道，避免因页表切换引入的额外延迟，这对4K@60fps的显示输出至关重要。

2.3 IOMMU映射：让非连续内存“看起来”连续

当显示引擎必须使用非连续物理内存（例如GPU渲染输出或视频解码输出）时，IOMMU（Input-Output Memory Management Unit）就派上了用场。全志平台通常集成一个系统IOMMU（也叫SMMU），可以为DE引擎提供虚拟连续地址空间。

IOMMU映射流程

1. 分配SG表：从DMA-Heap分配出多个不连续的物理页，记录在scatterlist中。
2. 映射到IOMMU：调用 iommu_map_sg() 将SG表映射到IOMMU的I/O虚拟地址空间（IOVA）。
3. 配置DE引擎：将IOVA地址写入DE图层的起始地址寄存器，而不是物理地址。
4. 启用IOMMU：确保DE引擎的AXI总线端口连接到IOMMU，且IOMMU页表已生效。

2.4 全志DE2/DE3显示引擎对缓存的具体要求

DE2和DE3是两代不同的显示引擎，对缓存的要求有显著差异。下表总结了关键参数：

DE3图层配置示例（DRM驱动中）

在DRM驱动中，配置DE3图层时，需要将dma-buf的物理地址或IOVA地址写入硬件寄存器。以下是一个简化的图层配置代码片段：

/* 全志DE3图层配置结构体 */
struct de3_plane_config {
    u32 addr;       /* 起始物理地址或IOVA地址 */
    u32 stride;     /* 行跨度（字节） */
    u32 size;       /* 总大小（字节） */
    u32 format;     /* 像素格式 */
    u32 alpha;      /* 全局alpha值 */
};

/* 配置UI图层0 */
static void de3_ui_plane_set(struct de3_plane *plane,
                             struct drm_framebuffer *fb)
{
    struct de3_plane_config cfg = {0};
    struct dma_buf_attachment *attach = fb->obj[0]->import_attach;
    struct sg_table *sgt;

    /* 获取dma-buf的SG表 */
    sgt = dma_buf_map_attachment(attach, DMA_TO_DEVICE);
    if (IS_ERR(sgt))
        return;

    /* 对于DE3，如果使用IOMMU，取sg_dma_address(sgt->sgl) */
    /* 如果不使用IOMMU，取sg_phys(sgt->sgl) */
    if (plane->use_iommu)
        cfg.addr = sg_dma_address(sgt->sgl);
    else
        cfg.addr = sg_phys(sgt->sgl);

    cfg.stride = fb->pitches[0];
    cfg.size = fb->pitches[0] * fb->height;
    cfg.format = de3_format_from_drm(fb->format->format);
    cfg.alpha = 0xff;

    /* 写入硬件寄存器 */
    de3_write_plane_regs(plane, &cfg);

    dma_buf_unmap_attachment(attach, sgt, DMA_TO_DEVICE);
}

2.5 缓存管理实战：分配、映射与释放流程

在DRM驱动中，显示缓存的生命周期管理遵循“分配 → 映射 → 使用 → 释放”的闭环。以下是全志平台上的典型流程：

1. 分配：通过 dma_alloc_attrs() 从CMA区域分配连续物理内存，或通过 dma_buf_alloc() 从DMA-Heap分配。
2. 导入：将dma-buf导入到DRM framebuffer，调用 drm_gem_prime_import()。
3. 映射：在plane更新时，通过 dma_buf_map_attachment() 获取SG表，并映射到IOMMU（如果启用）。
4. 使用：将映射后的地址写入DE引擎寄存器，启动显示。
5. 释放：在framebuffer销毁时，调用 dma_buf_unmap_attachment() 和 dma_buf_put() 释放资源。

2.6 常见问题与调试方法