1. 课程导入
PCIe（Peripheral Component Interconnect Express）是现代计算系统中最重要的高速串行总线之一。在服务器、存储阵列、AI 加速卡、网络接口卡以及嵌入式 SoC 中，PCIe Endpoint（端点设备）承担着与主机（Host/Root Complex）进行数据交换的关键角色。本课程聚焦于 Linux 环境下 PCIe Endpoint 驱动的开发与调试，帮助学员从零建立完整的驱动工程能力。
一、学习目标
完成本课程后，学员应能够独立完成以下任务：
- 理解 PCIe 拓扑结构、配置空间、BAR、Capability 等核心硬件概念；
- 掌握 Linux PCI 子系统（
pci_driver、pci_device_id、probe/remove）的注册与匹配机制； - 能够编写字符设备、DMA 映射、中断处理（MSI/MSI-X）等典型 Endpoint 驱动模块；
- 使用
lspci、setpci、dmesg、sysfs等工具进行驱动加载与问题定位； - 理解 RC 侧与 EP 侧驱动协同、地址映射与数据通路的完整链路。
二、核心概念地图
PCIe Endpoint 驱动工程涉及硬件、总线协议与内核驱动三层知识。下图展示了从主机 Root Complex 到 Endpoint 设备，再到 Linux 驱动模块的完整关系结构，帮助学员建立整体认知框架。
三、方法流程：从设备枚举到驱动加载
Linux 内核在启动或热插拔时会对 PCIe 总线进行枚举，读取每个 Endpoint 的配置空间，生成 pci_dev 对象。随后内核将设备与已注册的 pci_driver 进行匹配，匹配成功后调用驱动的 probe() 函数。典型流程如下：
- 内核枚举 PCIe 总线，读取 Vendor ID / Device ID / Class Code；
- 为每个设备创建
pci_dev，并分配 BAR 资源； - 驱动模块通过
pci_register_driver()注册pci_driver； - 内核根据
pci_device_id表进行匹配； - 匹配成功后调用
probe()，完成 BAR 映射、中断注册、DMA 初始化； - 设备卸载时调用
remove()，释放资源并注销驱动。
static struct pci_driver my_ep_driver = {
.name = "my_pcie_ep",
.id_table = my_ep_ids,
.probe = my_ep_probe,
.remove = my_ep_remove,
};
module_pci_driver(my_ep_driver);四、典型场景与误区复盘
在实际项目中，最常见的场景包括：AI 加速卡通过 BAR 暴露寄存器、网卡通过 MSI-X 上报中断、存储设备通过 DMA 搬运数据。初学者容易陷入以下误区：
| 误区 | 现象 | 正确做法 |
|---|---|---|
| 直接读写物理地址 | 内核崩溃或数据错误 | 使用 pci_iomap() 映射 BAR 后再访问 |
| 忽略 DMA 一致性 | 数据缓存不一致 | 使用 dma_alloc_coherent() 或正确同步 |
| 中断未注册就使能 | 中断丢失或系统挂起 | 先 request_irq() 再配置设备中断使能位 |
| 忘记释放资源 | 模块无法重复加载 | 在 remove() 中逆序释放所有资源 |
学习建议：每学一个概念，立即在 QEMU 或真实开发板上验证。使用
lspci -vvv 查看配置空间，用 dmesg -w 观察驱动加载日志，形成“代码—日志—硬件”三位一体的调试习惯。
注意：PCIe Endpoint 驱动涉及直接硬件操作，错误的寄存器访问可能导致系统死机。建议在虚拟机或专用开发板上进行实验，并始终保留串口调试通道。
本课程后续将按照“硬件基础 → 内核框架 → 驱动实战 → 性能调优”的路线逐步展开，每一节都配有可运行的代码示例和调试命令，帮助学员从理解走向落地。