3. 一致性DMA映射：dma_alloc_coherent详解

3.1 一致性DMA映射的基本概念

一致性DMA映射（Consistent DMA Mapping）是Linux内核提供的一种内存映射机制，保证CPU和DMA控制器在访问同一块内存区域时，能够看到完全一致的数据视图，无需软件干预缓存一致性维护。

与流式DMA映射（Streaming DMA Mapping）不同，一致性映射在分配时即完成缓存同步设置，后续访问无需调用dma_sync_single_for_cpu/device等同步操作。

3.2 dma_alloc_coherent API详解

dma_alloc_coherent()是Linux内核中最核心的一致性DMA内存分配函数，定义在<linux/dma-mapping.h>中。

// 函数原型
void *dma_alloc_coherent(struct device *dev, size_t size,
                         dma_addr_t *dma_handle, gfp_t flag);

// 参数说明：
// dev      - DMA设备结构体指针，用于关联DMA域
// size     - 分配大小（字节），会被对齐到页大小
// dma_handle - 输出参数，返回DMA总线地址
// flag     - GFP标志，控制内存分配行为

// 返回值：CPU虚拟地址（内核线性地址），失败返回NULL

// 释放函数
void dma_free_coherent(struct device *dev, size_t size,
                       void *cpu_addr, dma_addr_t dma_handle);

3.2.1 GFP标志选择

3.3 一致性内存的特点

一致性DMA内存具有以下关键特性，驱动开发者必须深刻理解：

• 非缓存属性： 内存页被标记为不可缓存（Uncached）或写合并（Write-Combine），CPU访问时绕过L1/L2缓存，直接读写物理内存。
• 地址双重性： 同时提供CPU虚拟地址和DMA总线地址，两者指向同一物理内存。
• 物理连续性： 分配的内存物理地址连续，满足DMA引擎的连续地址访问需求。
• 对齐保证： 分配的缓冲区起始地址至少对齐到页边界（PAGE_SIZE）。
• 零初始化： 分配的内存内容被清零，避免信息泄露。

3.4 使用场景与典型应用

一致性DMA映射在以下场景中具有不可替代的优势：

3.5 使用限制与注意事项

在实际开发中，使用dma_alloc_coherent()需要注意以下限制：

• 大小限制： 分配大小受限于系统连续物理内存可用量，大块分配（>4MB）容易失败，建议使用dma_alloc_attrs()配合DMA_ATTR_ALLOC_SINGLE_PAGES。
• 原子上下文： 在中断上下文或持有自旋锁时，必须使用GFP_ATOMIC标志，且分配大小不宜过大。
• 内存碎片： 系统长时间运行后物理内存碎片化，可能导致大块一致性分配失败，建议在驱动初始化时提前分配。
• 架构差异： 不同CPU架构对一致性内存的实现不同（如x86使用MTRR/PAT，ARM使用页表属性），驱动代码应保持架构无关。
• 调试困难： 一致性内存的访问错误（越界、野指针）可能导致硬件异常，且难以复现，建议配合kmemleak和DMA API调试选项。

3.6 实际代码示例

以下是一个完整的DMA一致性缓冲区分配与释放示例，展示在videobuf2驱动中的典型用法：

#include <linux/dma-mapping.h>
#include <linux/slab.h>

struct my_dma_buffer {
    void        *cpu_addr;    /* CPU虚拟地址 */
    dma_addr_t   dma_addr;    /* DMA总线地址 */
    size_t       size;        /* 缓冲区大小 */
    struct device *dev;       /* DMA设备 */
};

/**
 * my_dma_buffer_alloc - 分配一致性DMA缓冲区
 * @dev: DMA设备
 * @size: 分配大小（字节）
 *
 * 返回值：成功返回dma_buffer指针，失败返回NULL
 */
struct my_dma_buffer *my_dma_buffer_alloc(struct device *dev, size_t size)
{
    struct my_dma_buffer *buf;

    buf = kzalloc(sizeof(*buf), GFP_KERNEL);
    if (!buf)
        return NULL;

    /* 分配一致性DMA内存 */
    buf->cpu_addr = dma_alloc_coherent(dev, size, &buf->dma_addr, GFP_KERNEL);
    if (!buf->cpu_addr) {
        dev_err(dev, "Failed to allocate coherent DMA buffer\n");
        kfree(buf);
        return NULL;
    }

    buf->dev = dev;
    buf->size = size;

    dev_info(dev, "Allocated coherent DMA buffer:\n"
             "  CPU addr: 0x%px\n"
             "  DMA addr: 0x%llx\n"
             "  Size: %zu bytes\n",
             buf->cpu_addr, (unsigned long long)buf->dma_addr, size);

    return buf;
}

/**
 * my_dma_buffer_free - 释放一致性DMA缓冲区
 * @buf: 要释放的dma_buffer指针
 */
void my_dma_buffer_free(struct my_dma_buffer *buf)
{
    if (!buf)
        return;

    if (buf->cpu_addr) {
        dma_free_coherent(buf->dev, buf->size,
                          buf->cpu_addr, buf->dma_addr);
    }

    kfree(buf);
}

3.7 与videobuf2框架的关联

在videobuf2框架中，一致性DMA映射主要用于以下场景：

• 帧控制结构： vb2_buffer结构体中的状态字段、时间戳等元数据区域，使用一致性映射保证CPU和设备间的状态同步。
• 描述符表： 硬件描述符环（Descriptor Ring）必须使用一致性内存，因为描述符的更新频率高且要求实时可见。
• 小尺寸帧数据： 对于分辨率较低的压缩帧（如JPEG缩略图），可以直接使用一致性映射，简化驱动逻辑。