3、DMA与缓存一致性：DMA传输中的一致性问题、Streaming DMA映射与一致性DMA映射、dma_alloc_coherent与dma_map_single详解

3.1 DMA传输中的缓存一致性问题

DMA（Direct Memory Access）控制器直接访问物理内存，而CPU通过缓存（Cache）访问数据。当DMA与CPU共享同一块内存区域时，若缓存与内存中的数据不一致，将导致数据损坏或逻辑错误。这是驱动开发中最常见且最隐蔽的问题之一。

3.1.1 一致性问题场景分析

3.2 Streaming DMA映射与一致性DMA映射

Linux内核提供两种DMA映射机制来解决缓存一致性问题：Streaming DMA映射（流式映射）和一致性DMA映射（Coherent DMA映射）。两者适用场景不同，开发者需根据数据传输模式选择。

3.2.1 两种映射机制对比

3.3 dma_alloc_coherent 详解

dma_alloc_coherent 用于分配一致性DMA内存。该函数返回的虚拟地址和物理地址（或DMA总线地址）指向的内存区域，对CPU和DMA控制器而言始终保持一致。

3.3.1 函数原型与参数

#include <linux/dma-mapping.h>

void *dma_alloc_coherent(struct device *dev, size_t size,
                         dma_addr_t *dma_handle, gfp_t flag);

3.3.2 典型使用模式

struct device *dev = &pdev->dev;
dma_addr_t dma_handle;
void *cpu_addr;
size_t size = 4096;

/* 分配一致性DMA内存 */
cpu_addr = dma_alloc_coherent(dev, size, &dma_handle, GFP_KERNEL);
if (!cpu_addr) {
    dev_err(dev, "Failed to allocate coherent DMA memory\n");
    return -ENOMEM;
}

/* 使用cpu_addr访问内存（CPU侧），使用dma_handle编程DMA控制器 */
/* ... */

/* 释放一致性DMA内存 */
dma_free_coherent(dev, size, cpu_addr, dma_handle);

3.3.3 注意事项

• 内存对齐：分配的内存默认按页对齐，适合描述符环等结构
• 原子上下文：中断上下文必须使用 GFP_ATOMIC
• 内存大小：避免分配过大内存（通常不超过几MB），否则可能耗尽一致性内存池
• 释放匹配：dma_free_coherent 必须传入与分配时完全相同的 size、cpu_addr、dma_handle

3.4 dma_map_single 详解

dma_map_single 用于Streaming DMA映射，将已有的内存缓冲区映射到DMA地址空间，并在映射过程中执行必要的Cache维护操作。

3.4.1 函数原型与参数

dma_addr_t dma_map_single(struct device *dev, void *cpu_addr,
                          size_t size, enum dma_data_direction dir);

3.4.2 数据传输方向枚举

3.4.3 完整使用流程

/* 1. 分配或获取CPU缓冲区 */
void *buffer = kmalloc(BUF_SIZE, GFP_KERNEL);
if (!buffer)
    return -ENOMEM;

/* 2. 映射到DMA地址空间 */
dma_addr_t dma_addr = dma_map_single(dev, buffer, BUF_SIZE, DMA_TO_DEVICE);
if (dma_mapping_error(dev, dma_addr)) {
    dev_err(dev, "DMA mapping failed\n");
    kfree(buffer);
    return -EIO;
}

/* 3. 编程DMA控制器，使用dma_addr启动传输 */
/* ... */

/* 4. 等待DMA传输完成 */
/* ... */

/* 5. 取消映射（释放DMA地址空间并同步Cache） */
dma_unmap_single(dev, dma_addr, BUF_SIZE, DMA_TO_DEVICE);

/* 6. 释放CPU缓冲区 */
kfree(buffer);

3.4.4 手动同步操作

当DMA传输与CPU访问交错进行时，需使用 dma_sync_single_for_cpu 和 dma_sync_single_for_device 手动同步。

/* CPU准备读取DMA写入的数据 */
dma_sync_single_for_cpu(dev, dma_addr, BUF_SIZE, DMA_FROM_DEVICE);
/* 此时可以安全读取buffer */
process_data(buffer);

/* CPU完成写入，准备交给DMA读取 */
dma_sync_single_for_device(dev, dma_addr, BUF_SIZE, DMA_TO_DEVICE);
/* 启动下一次DMA传输 */

3.5 两种映射机制的选择策略

3.6 调试技巧与常见陷阱

3.6.1 调试方法

3.6.2 常见陷阱

• 栈变量映射：不能对栈上的局部变量调用 dma_map_single，因为栈可能不在DMA可访问的地址范围
• 映射后修改缓冲区：Streaming映射后，在取消映射前修改缓冲区内容，必须重新同步
• 方向错误：DMA_TO_DEVICE 和 DMA_FROM_DEVICE 混淆会导致Cache操作方向错误
• 内存泄漏：dma_map_single 后忘记 dma_unmap_single，会耗尽DMA地址空间
• 大小不匹配：映射和取消映射时的 size 必须一致，否则部分Cache行未被正确同步