Linux动态 DMA 映射指南(翻译版)

动态 DMA 映射指南

本文是面向设备驱动程序开发者的指导手册,通过伪代码示例说明如何使用 DMA API。关于 API 的简明描述,请参阅 <DMA-API.txt>。

CPU 和 DMA 地址

在 DMA API 中涉及多种地址类型,理解它们的差异至关重要:

虚拟地址

  • 内核通常使用虚拟地址
  • 由 kmalloc()、vmalloc() 等接口返回的地址都是虚拟地址,可存储在 void * 类型中
  • 虚拟内存系统(TLB、页表等)将虚拟地址转换为 CPU 物理地址

物理地址

  • 存储为 phys_addr_t 或 resource_size_t
  • 内核以物理地址管理设备资源(如寄存器)
  • 物理地址需要通过 ioremap() 映射后生成虚拟地址才能被驱动使用

总线地址

  • 设备使用的第三种地址类型
  • 在 MMIO 地址中的寄存器地址或 DMA 操作使用的地址都是总线地址
  • 可能受 IOMMU 和主机桥的限制(例如某些系统可能强制设备使用 32 位 DMA 地址)

地址空间转换示意图:

复制代码
          CPU                  CPU                  总线
          虚拟地址空间          物理地址空间           地址空间
          +-------+             +------+             +------+
          |       |             |MMIO  |   偏移量     |      |
          |       | 虚拟映射    |空间   |   应用       |      |
        C +-------+ --------> B +------+ ----------> +------+ A
          |       | 映射关系    |      |   主机桥     |      |
+-----+   |       |             |      |             |      |   +--------+
|     |   |       |             +------+             |      |   |        |
| CPU |   |       |             | RAM  |             |      |   | 设备   |
|     |   |       |             |      |             |      |   |        |
+-----+   +-------+             +------+             +------+   +--------+
          |       | 虚拟映射    |缓冲区 | 映射关系     |      |
        X +-------+ --------> Y +------+ <---------- +------+ Z
          |       | 映射关系    | RAM  |  IOMMU
          |       |             |      |
          |       |             |      |
          +-------+             +------+

可进行 DMA 的内存

允许 DMA 的内存类型

  1. 通过页分配器(如 __get_free_page*())获取的内存
  2. 通过通用内存分配器(如 kmalloc() 或 kmem_cache_alloc())获取的内存

禁止 DMA 的内存类型

  • vmalloc() 返回的地址(可通过页表转换后操作底层内存)
  • 内核镜像地址(数据段/文本段/bss 段)
  • 模块镜像地址
  • 栈地址
  • kmap() 调用返回的地址

网络和块设备子系统 会确保它们的缓冲区适合 DMA 操作

DMA 寻址能力

默认配置

  • 内核默认假设设备支持 32 位 DMA 寻址
  • PCI-X 设备必须支持 64 位寻址(DAC)

设置方法

c 复制代码
// 统一设置流式映射和一致性映射
int dma_set_mask_and_coherent(struct device *dev, u64 mask);

// 单独设置流式映射
int dma_set_mask(struct device *dev, u64 mask);

// 单独设置一致性映射
int dma_set_coherent_mask(struct device *dev, u64 mask);

示例代码

c 复制代码
// 64 位设备示例
if (dma_set_mask_and_coherent(dev, DMA_BIT_MASK(64))) {
    dev_warn(dev, "mydev: 无合适的 DMA 支持\n");
    goto ignore_this_device;
}

// 24 位设备示例
if (dma_set_mask(dev, DMA_BIT_MASK(24))) {
    dev_warn(dev, "mydev: 不支持 24 位 DMA 寻址\n");
    goto ignore_this_device;
}

DMA 映射类型

一致性映射(Coherent DMA)

  • 特点:同步/一致性访问
  • 适用场景:
    • 网络卡 DMA 环形描述符
    • SCSI 适配器邮箱命令数据结构
    • 设备固件微代码
c 复制代码
// 分配示例
dma_addr_t dma_handle;
void *cpu_addr = dma_alloc_coherent(dev, size, &dma_handle, GFP_KERNEL);

// 释放示例
dma_free_coherent(dev, size, cpu_addr, dma_handle);

流式映射(Streaming DMA)

  • 特点:异步/非一致性访问
  • 适用场景:
    • 网络传输缓冲区
    • 文件系统缓冲区
c 复制代码
// 单区域映射
dma_addr_t dma_handle = dma_map_single(dev, addr, size, direction);

// 页映射
dma_addr_t dma_handle = dma_map_page(dev, page, offset, size, direction);

// 散列表映射
int count = dma_map_sg(dev, sglist, nents, direction);

DMA 方向

方向标志 说明
DMA_BIDIRECTIONAL 双向传输(性能可能下降)
DMA_TO_DEVICE 从内存到设备
DMA_FROM_DEVICE 从设备到内存
DMA_NONE 调试用途

错误处理

错误检测

c 复制代码
dma_addr_t dma_handle = dma_map_single(dev, addr, size, direction);
if (dma_mapping_error(dev, dma_handle)) {
    // 错误处理逻辑
}

网络驱动示例

c 复制代码
if (dma_mapping_error(dev, dma_handle)) {
    dev_kfree_skb(skb);
    return NETDEV_TX_OK;
}

平台注意事项

架构要求

  • 需要定义 ARCH_DMA_MINALIGN 保证 DMA 内存对齐
  • 启用 CONFIG_NEED_SG_DMA_LENGTH 支持 IOMMU

结构体优化

c 复制代码
// 优化前
struct ring_state {
    struct sk_buff *skb;
    dma_addr_t mapping;
    __u32 len;
};

// 优化后
struct ring_state {
    struct sk_buff *skb;
    DEFINE_DMA_UNMAP_ADDR(mapping);
    DEFINE_DMA_UNMAP_LEN(len);
};

附录:贡献者名单

(按字母顺序排列)

专业术语说明

  • IOMMU:输入输出内存管理单元,负责物理地址与总线地址的转换
  • TLB:转译后备缓冲器,用于加速虚拟地址到物理地址的转换
  • MMIO:内存映射I/O,通过内存地址访问设备寄存器的技术
  • DMA:直接内存访问,允许设备直接读写内存而不经过CPU
相关推荐
StarsGreen5 小时前
Linux 网络配置命令参考
linux
Eyfcom18 小时前
〖物流 SaaS 实战 02〗SaaS 租户的计费与订阅模型:从“一锤子买卖”到“按需订阅”
linux·服务器·数据库·快递系统·物流saas实战
忆挽篱笙歌20 小时前
systemV进程通信
linux·运维·服务器
无奈笑天下1 天前
银河麒麟桌面操作系统上磁盘无法自动挂载问题处理
linux·运维·服务器
木头左1 天前
【Linux运维】服务器磁盘清理与Docker日志治理实战:一次巡检释放70G空间
linux·docker·磁盘清理·日志治理
星恒随风1 天前
MySQL 从零入门(七):索引原理与 B+ 树详解——从磁盘 I/O 到 InnoDB 聚簇索引
linux·服务器·数据库·笔记·mysql
多弗朗皮卡丘2 天前
网络基础:数据链路层与其他协议或技术
linux·网络·tcp/ip