📚 课程目录第1章课程导入

1. 课程导入

PCIe（Peripheral Component Interconnect Express）是现代服务器、工作站、嵌入式平台中最主流的板级高速互连总线。对内核开发者而言，掌握 PCIe 驱动开发与内核适配，意味着能够把一块 FPGA 加速卡、NVMe 控制器、网卡或自定义采集设备真正"接入"Linux 系统，并让它稳定、高效地工作。本课程的目标不是停留在寄存器手册的阅读层面，而是建立一条从硬件拓扑到内核驱动、从枚举配置到 DMA 数据通路的完整能力链。

一、学习目标：从"看懂"到"能改能调"

本课程围绕四个递进目标展开。第一层是认知层：理解 PCIe 的层次化协议结构、配置空间、BAR 地址映射与枚举过程，能读懂 lspci -vvv 输出的关键字段。第二层是编码层：能够独立编写一个可加载的 PCIe 字符设备驱动，完成 probe/remove、资源申请、中断注册与用户态接口。第三层是数据层：掌握一致性 DMA 与流式 DMA 的差异，能正确使用 dma_alloc_coherent、dma_map_single 及描述符环，避免缓存一致性与地址映射错误。第四层是适配层：面对不同内核版本、不同架构（x86/ARM64）与不同设备树/ACPI 描述方式，能够定位并解决编译、枚举、中断与性能问题。

学习完成后，你应当能够回答三个问题：设备为什么没被枚举到？驱动为什么 probe 失败？数据为什么传不对或传不快？这三个问题几乎覆盖了 PCIe 驱动开发 80% 的实战场景。

二、核心概念：一张图看清 PCIe 驱动的知识骨架

PCIe 驱动开发的知识点看似零散，实则围绕"枚举—映射—传输—中断"四条主线组织。下图给出本节的核心知识框架与实战路线图，后续章节将沿此结构逐层展开。

三、方法流程：驱动开发的标准化步骤

无论设备多么复杂，Linux PCIe 驱动的开发流程都可以归纳为一条标准链路。理解这条链路，比死记 API 更重要。

定义设备匹配表：通过 pci_device_id 数组声明 Vendor ID、Device ID，必要时加上 class 与 class_mask，让内核在枚举到设备时能匹配到你的驱动。
注册驱动：使用 module_pci_driver() 或 pci_register_driver() 将 pci_driver 结构注册进 PCI 总线。
probe 中申请资源：依次调用 pci_enable_device()、pci_request_regions()、pci_iomap()，把 BAR 映射为内核虚拟地址。
配置中断：优先使用 pci_alloc_irq_vectors() 申请 MSI/MSI-X，再通过 request_irq() 注册中断处理函数。
建立数据通路：分配 DMA 缓冲区或描述符环，配置设备寄存器，启动收发。
暴露用户接口：通过字符设备、ioctl、mmap 或 sysfs 向用户态提供访问能力。
remove 中逆序释放：释放中断、取消映射、释放 DMA、关闭设备，保证模块可反复加载卸载。

static const struct pci_device_id demo_pci_ids[] = {
    { PCI_DEVICE(0x1234, 0x5678) },
    { 0, }
};
MODULE_DEVICE_TABLE(pci, demo_pci_ids);

static struct pci_driver demo_driver = {
    .name     = "demo_pcie",
    .id_table = demo_pci_ids,
    .probe    = demo_probe,
    .remove   = demo_remove,
};
module_pci_driver(demo_driver);

四、案例场景：一块 FPGA 采集卡的上线过程

假设我们拿到一块基于 FPGA 的 PCIe 采集卡，Vendor ID 为 0x1234，Device ID 为 0x5678，使用 BAR0 映射控制寄存器，BAR2 映射数据窗口，并通过 MSI-X 上报采集完成中断。典型的上线排查顺序如下：

阶段	检查命令	期望结果	常见异常
物理枚举	`lspci -nn \| grep 1234`	能看到设备与 ID	设备未上电、链路训练失败
资源分配	`lspci -vvv -s 01:00.0`	BAR 有地址、MSI-X 使能	BAR 未分配、BIOS 资源不足
驱动匹配	`dmesg \| grep demo_pcie`	probe 成功日志	id_table 不匹配、probe 返回错误
中断工作	`cat /proc/interrupts`	中断计数增长	MSI-X 未申请、中断被共享
数据正确	读写测试 + `dmesg`	数据一致、无 DMA 错误	缓存不一致、地址映射错误

五、误区与复盘：新手最容易踩的坑

误区一：认为 probe 成功就等于驱动可用。probe 只说明资源申请与初始化通过，中断是否真正触发、DMA 是否真正搬运数据，必须通过实际读写与中断计数验证。

误区二：忽略 DMA 掩码设置。64 位设备若未调用 dma_set_mask_and_coherent()，在部分平台上会退化为 32 位地址，导致高地址缓冲区映射失败。

另一个高频问题是把 INTx 与 MSI-X 混用。现代 PCIe 设备应优先使用 MSI-X，它支持多向量、无共享中断、延迟更低。若驱动仍按 INTx 方式注册单个中断，可能在高吞吐场景下丢中断。复盘时应养成习惯：先看 lspci -vvv 中的 MSI-X: Enable+，再看 /proc/interrupts 中每个向量的计数分布，最后结合 perf 或 ftrace 定位热点。

本课程后续将沿着"枚举—映射—传输—中断—适配"这条主线，逐层拆解每个环节的内核机制与实战代码。你现在需要建立的，是一张清晰的知识地图：知道每个问题属于哪一层，知道该用哪个工具去观察，知道该改哪一段代码去修复。这比记住任何一个 API 都更有价值。