1. 课程导入
在嵌入式与服务器Linux开发中，CPU搬运数据的速度往往成为系统瓶颈。DMA（Direct Memory Access，直接内存访问）允许外设在不占用CPU周期的情况下直接读写系统内存，从而把CPU从繁重的数据搬运中解放出来。但DMA带来性能提升的同时，也引入了一个隐蔽而危险的问题：缓存一致性。当CPU通过Cache访问内存，而DMA控制器绕过Cache直接访问物理内存时，两者看到的数据可能不一致，轻则数据错乱，重则系统崩溃。本课程的目标，就是让学员既能写出高性能的DMA驱动，又能正确处理缓存一致性，做到“跑得快、数据对”。
一、学习目标：从会用API到理解机制
本课程不是简单的API手册复述，而是围绕“机制—接口—实战—排障”四个层次展开。学完本课程，学员应达到以下目标：
- 理解DMA的三种映射方式：一致性映射、流式映射、Scatter-Gather映射，并知道各自适用场景。
- 掌握Linux内核DMA API的使用规范，包括
dma_alloc_coherent()、dma_map_single()、dma_sync_single_for_cpu()等关键接口。 - 理解Cache的写回（Write-back）与写通（Write-through）策略，以及它们对DMA数据可见性的影响。
- 能够分析DMA与Cache交互中的典型故障，如数据陈旧、Cache行伪共享、方向参数写反等。
- 具备在真实硬件平台上调试DMA一致性问题的能力，能借助工具定位问题根因。
二、核心概念：DMA、Cache与一致性
要理解缓存一致性，先要理解三个核心对象之间的关系。CPU访问内存时，数据会被加载到Cache中；DMA控制器访问内存时，通常不经过Cache。于是同一块物理内存可能出现两份副本：一份在Cache里，一份在内存里。当CPU修改了Cache中的数据但尚未写回内存，DMA读取到的就是旧数据；反之，DMA写入内存的新数据，CPU可能仍从Cache中读到旧值。这就是缓存一致性的本质问题。
Linux内核提供了两类DMA映射来解决这个问题。一致性映射（Coherent Mapping）在分配时就保证CPU与设备看到同一份数据，通常用于长期存在的控制结构，如描述符环、状态寄存器。流式映射（Streaming Mapping）用于一次性数据传输，需要开发者显式调用同步接口来保证数据可见性。理解这两类映射的差异，是编写正确DMA驱动的第一步。
关键判断：如果设备与CPU会频繁交替访问同一块内存，且对实时性要求高，优先考虑一致性映射；如果是单向、大批量、一次性的数据传输，流式映射性能更好，但必须配对使用map/unmap与sync。
三、整体知识框架与实战路线图
本课程共30章，整体知识框架可以概括为“一条主线、两个视角、三层实战”。一条主线是数据从设备到内存再到CPU的完整路径；两个视角分别是硬件视角（总线、Cache控制器、DMA引擎）和软件视角（内核API、驱动模型、内存管理）；三层实战包括基础映射、高级S-G传输、真实平台排障。
下面的SVG图展示了本课程的整体知识框架与实战路线图，从概念基础出发，经过接口与机制，最终到达工程实战与排障。
四、典型场景与误区复盘
以一个常见的网卡收包场景为例：驱动为接收描述符分配一致性内存，DMA将网络包写入内核缓冲区，然后驱动通过流式映射将数据传递给协议栈。如果开发者忘记在DMA写入后调用dma_sync_single_for_cpu()，CPU可能从Cache中读到旧数据，导致协议栈解析出错。这类问题在x86平台上可能因为硬件缓存一致性协议而不易复现，但在ARM、RISC-V等平台上却非常常见。
另一个高频误区是dma_map_single()的方向参数写反。方向参数决定了内核执行何种Cache操作：DMA_TO_DEVICE会执行写回（clean），DMA_FROM_DEVICE会执行无效化（invalidate）。如果写反，轻则性能下降，重则数据损坏。下表列出了常见误区与正确做法。
| 常见误区 | 后果 | 正确做法 |
|---|---|---|
| 流式映射后不调用sync | CPU读到陈旧数据 | 在CPU访问前调用dma_sync_single_for_cpu() |
| 方向参数写反 | Cache操作错误，数据损坏 | 根据数据流向选择DMA_TO_DEVICE或DMA_FROM_DEVICE |
| 一致性内存用于高频小传输 | 性能低下 | 高频小传输用流式映射，长期控制结构用一致性映射 |
| 忘记unmap | 内存泄漏、IOMMU映射耗尽 | 传输完成后立即调用dma_unmap_single() |
| 在中断上下文中睡眠 | 内核崩溃 | DMA映射API不睡眠，但分配大块一致性内存可能睡眠，需注意上下文 |
排障提示：当遇到“DMA传输完成但数据不对”的问题时，优先检查三件事：映射方向是否正确、sync调用是否配对、一致性内存与流式内存是否混用。大多数缓存一致性问题都能通过这三步定位。
五、实战工程路线图
本课程的实战路线遵循“先跑通、再优化、后排障”的节奏。前10章聚焦基础概念与API，中间10章进入真实驱动场景，包括网卡、存储、音频等典型DMA应用，最后10章深入性能调优与故障排查。每一章都配有可运行的代码片段和调试命令，例如使用dma-debug子系统检查映射泄漏：
# 启用DMA调试
echo 1 > /sys/kernel/debug/dma-api/dump
# 查看未释放的DMA映射
cat /sys/kernel/debug/dma-api/num_errors
cat /sys/kernel/debug/dma-api/num_entries
通过这些工具，学员可以在实验环境中复现问题、观察现象、验证修复，真正把知识转化为工程能力。缓存一致性不是靠背诵API解决的，而是靠理解数据流、尊重硬件行为、严谨配对调用来保证的。接下来的章节将逐一展开这些内容，帮助学员建立完整的DMA与缓存一致性知识体系。