动态 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 的内存类型
- 通过页分配器(如
__get_free_page*())获取的内存 - 通过通用内存分配器(如
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);
};
附录:贡献者名单
(按字母顺序排列)
- Andrea Arcangeli andrea@suse.de
- David Mosberger-Tang davidm@hpl.hp.com
- Jay Estabrook Jay.Estabrook@compaq.com
- Jens Axboe jens.axboe@oracle.com
- Leo Dagum dagum@barrel.engr.sgi.com
- Ralf Baechle ralf@oss.sgi.com
- Russell King rmk@arm.linux.org.uk
- Thomas Sailer sailer@ife.ee.ethz.ch
专业术语说明
- IOMMU:输入输出内存管理单元,负责物理地址与总线地址的转换
- TLB:转译后备缓冲器,用于加速虚拟地址到物理地址的转换
- MMIO:内存映射I/O,通过内存地址访问设备寄存器的技术
- DMA:直接内存访问,允许设备直接读写内存而不经过CPU