1. 课程导入
在嵌入式与服务器平台的DMA驱动开发中，设备能否稳定、高效、安全地访问内存，往往不只取决于驱动本身的寄存器操作，还取决于设备地址转换与内存保护机制是否正确配置。IOMMU（Input-Output Memory Management Unit）与SMMU（System Memory Management Unit）正是承担这一职责的关键硬件单元。本课程围绕“DMA驱动开发中的IOMMU与SMMU配置问题”展开，目标不是停留在概念背诵，而是建立从硬件拓扑、地址映射、驱动接口到故障定位的完整工程能力。
一、学习目标：从“能跑”到“可定位、可优化”
本课程的学习目标可以归纳为四个层次。第一，理解IOMMU/SMMU在DMA路径中的位置与作用，明确设备虚拟地址（IOVA）、物理地址（PA）与系统物理地址（SPA）之间的转换关系。第二，掌握Linux内核中DMA映射API与IOMMU域（domain）的关联方式，能够判断一次DMA映射究竟走的是直接映射、IOMMU映射还是SMMU旁路。第三，能够阅读设备树（Device Tree）与ACPI中的IOMMU/SMMU描述，识别stream ID、SID、SSID、iommu-map等关键属性。第四，具备典型故障的排查能力，例如DMA地址错误、SMMU translation fault、设备无法访问内存、性能下降等。
核心判断：DMA驱动问题中，约一半以上的“设备异常”并非驱动逻辑错误，而是地址域配置、stream映射或页表属性不一致导致的。学会区分“驱动问题”与“IOMMU配置问题”，是本课程的第一道分水岭。
二、核心概念：设备地址转换与保护边界
IOMMU与SMMU本质上是同一类硬件在不同体系结构中的称呼。在x86平台通常称为IOMMU，在ARM平台通常称为SMMU。它们位于设备与内存控制器之间，对设备发出的DMA地址进行翻译和权限检查。没有IOMMU时，设备直接使用物理地址访问内存；有IOMMU时，设备使用IOVA，由IOMMU查页表转换为物理地址。
关键概念包括：Stream ID，用于标识来自某个设备的DMA事务；IOVA，设备视角的虚拟地址；页表，描述IOVA到PA的映射；Domain，一组共享同一地址空间的设备集合；Bypass模式，关闭翻译直接透传。理解这些概念之间的关系，是后续配置与排障的基础。
三、整体框架：从硬件拓扑到驱动接口
本课程的整体框架分为五层。最底层是硬件拓扑层，包括设备、总线、SMMU/IOMMU、内存控制器之间的连接关系。第二层是固件描述层，即设备树或ACPI中如何声明IOMMU节点、stream ID与设备关联。第三层是内核IOMMU子系统层，包括iommu_ops、domain、group等抽象。第四层是DMA映射API层，驱动通过dma_map_single、dma_map_sg等接口申请IOVA并建立映射。第五层是驱动业务层，网络、存储、加速器等驱动在收发数据时实际使用DMA地址。
这五层中，任何一层配置不一致，都会表现为DMA异常。例如设备树中stream ID写错，SMMU无法找到对应页表，就会产生translation fault；驱动使用了错误的DMA掩码，可能导致IOVA超出设备可寻址范围。
四、工程实践路线：配置、验证、排障三步走
工程实践路线建议按以下步骤推进：
- 确认硬件能力：通过lspci、/sys/kernel/debug/iommu或ACPI表确认平台是否存在IOMMU/SMMU，以及设备是否在受控范围内。
- 检查固件描述：核对设备树中的iommus、iommu-map、stream ID与SMMU节点，确保设备与SMMU的关联正确。
- 验证内核配置：确认CONFIG_IOMMU_SUPPORT、CONFIG_ARM_SMMU_V3等选项已启用，并检查启动参数如iommu=pt、iommu.passthrough。
- 驱动映射检查：在驱动中确认DMA API返回值、DMA掩码、coherent属性与IOMMU domain匹配。
- 故障定位：通过dmesg、SMMU fault日志、tracepoint定位是地址错误、权限错误还是stream映射错误。
| 排查对象 | 典型命令/文件 | 关注点 |
|---|---|---|
| IOMMU/SMMU存在性 | dmesg | grep -i iommu | 是否探测到SMMU/IOMMU，版本与实例数 |
| 设备与SMMU关联 | /sys/kernel/debug/iommu/devices | 设备是否绑定到正确domain |
| DMA映射状态 | /sys/kernel/debug/iommu/domains | IOVA范围、页表属性、映射数量 |
| 故障日志 | dmesg | grep -i "smmu\|iommu.*fault" | fault地址、stream ID、权限位 |
| 启动参数 | /proc/cmdline | iommu=pt、iommu.passthrough等 |
五、典型场景与误区复盘
常见场景一：网卡驱动在启用SMMU后无法收包。排查发现设备树中网卡的iommus属性指向了错误的SMMU实例，导致stream ID不匹配，DMA请求被拒绝。修正后恢复正常。
常见场景二：驱动使用dma_alloc_coherent分配缓冲区，但设备仍访问旧物理地址。原因是IOMMU domain未正确绑定，驱动拿到的是CPU物理地址而非IOVA。通过检查dma_map返回值与domain绑定关系定位。
常见误区：认为“打开IOMMU只会影响性能，不会影响功能”。实际上，IOMMU/SMMU配置错误会直接导致DMA失败、设备超时甚至系统崩溃。另一个误区是只关注驱动代码，忽略设备树与ACPI中的stream映射描述。排障时应先确认地址域与映射关系，再检查驱动逻辑。
# 典型SMMU fault日志片段
arm-smmu-v3 0000:00:0a.0: event 0x02 received
stream id: 0x0000000000000021
fault address: 0x00000000deadbe00
reason: translation fault, level 2
permission: read, write
# 排查入口
dmesg | grep -i "smmu\|iommu"
cat /sys/kernel/debug/iommu/devices
cat /sys/kernel/debug/iommu/domains通过本课程的学习，读者应能建立“硬件拓扑—固件描述—内核子系统—驱动API—业务行为”的完整链路认知，并在遇到DMA异常时，快速判断问题位于IOMMU/SMMU配置的哪一层，从而高效定位与解决。