3. PCIe 设备枚举：pci_register_driver、pci_device_id 匹配表、probe/remove 回调

PCIe 设备枚举是驱动加载的第一个关键阶段。内核通过 pci_register_driver 注册驱动，利用 pci_device_id 匹配表与硬件 ID 进行比对，匹配成功后调用 probe 回调初始化设备，卸载时调用 remove 回调释放资源。本节将拆解这一完整流程，并给出调试条件断点的设置思路。

3.1 驱动注册与匹配流程

PCI 子系统采用 驱动-设备 分离模型。驱动注册后，内核遍历 PCI 总线上的所有设备，将驱动的 pci_device_id 表与设备的 Vendor ID、Device ID、Subsystem ID 等进行逐项比对。匹配成功则触发 probe，失败则继续等待。

3.2 pci_device_id 匹配表结构

pci_device_id 是驱动与硬件之间的“身份证”对照表。内核使用 PCI_DEVICE 宏填充关键字段，匹配时按顺序扫描，直到找到完全匹配或通配匹配的条目。

3.3 probe 回调：设备初始化战场

probe 回调是驱动与硬件建立联系的起点。内核在匹配成功后，将 struct pci_dev * 和 struct pci_device_id * 传入 probe 函数。驱动在此完成：

• 启用设备： pci_enable_device() 开启 I/O 和内存空间。
• 设置 DMA 掩码： dma_set_mask() 和 dma_set_coherent_mask()。
• 请求 MMIO/BAR 资源： pci_request_regions()。
• 映射 BAR 空间： pcim_iomap() 或 ioremap()。
• 注册中断： request_irq() 或 pci_alloc_irq_vectors()。
• 创建字符/网络设备： 注册到内核框架。

static int my_pci_probe(struct pci_dev *pdev, const struct pci_device_id *id)
{
    int ret;
    struct my_dev *dev;

    // 1. 启用 PCI 设备
    ret = pci_enable_device(pdev);
    if (ret)
        return ret;

    // 2. 设置 DMA 掩码（64 位优先）
    ret = dma_set_mask(&pdev->dev, DMA_BIT_MASK(64));
    if (ret) {
        ret = dma_set_mask(&pdev->dev, DMA_BIT_MASK(32));
        if (ret)
            goto err_disable;
    }

    // 3. 请求 MMIO 区域
    ret = pci_request_regions(pdev, "my_driver");
    if (ret)
        goto err_disable;

    // 4. 映射 BAR0
    dev->regs = pcim_iomap(pdev, 0, pci_resource_len(pdev, 0));
    if (!dev->regs) {
        ret = -ENOMEM;
        goto err_release;
    }

    // 5. 注册中断
    ret = request_irq(pdev->irq, my_interrupt, IRQF_SHARED,
                      "my_driver", dev);
    if (ret)
        goto err_iounmap;

    // 6. 保存私有数据
    pci_set_drvdata(pdev, dev);

    return 0;

err_iounmap:
    pcim_iounmap(pdev, dev->regs);
err_release:
    pci_release_regions(pdev);
err_disable:
    pci_disable_device(pdev);
    return ret;
}

3.4 remove 回调：资源清理与故障恢复

remove 回调在驱动卸载或设备热移除时被调用。其职责是 probe 的逆操作，必须按 反向顺序 释放资源，否则可能导致内核崩溃或资源泄漏。

static void my_pci_remove(struct pci_dev *pdev)
{
    struct my_dev *dev = pci_get_drvdata(pdev);

    // 1. 释放中断
    free_irq(pdev->irq, dev);

    // 2. 取消 MMIO 映射
    pcim_iounmap(pdev, dev->regs);

    // 3. 释放 PCI 区域
    pci_release_regions(pdev);

    // 4. 禁用设备
    pci_disable_device(pdev);

    // 5. 释放私有数据结构
    kfree(dev);
}

3.5 枚举失败调试清单

当驱动加载后 probe 未被调用，按以下清单逐项排查：

1. 检查设备是否被其他驱动占用： lspci -k -s <BDF> 查看 Kernel driver in use。
2. 验证 pci_device_id 表： 对比 lspci -n 输出，确认 vendor/device 完全一致。
3. 确认驱动注册成功： cat /sys/bus/pci/drivers/<驱动名>/ 是否存在。
4. 检查 probe 返回值： dmesg | grep <驱动名> 搜索错误码。
5. 使用条件断点跟踪匹配循环： 在 pci_bus_match 或 pci_match_device 设置断点，观察匹配过程。

3.6 条件断点实战：跟踪 probe 调用

在调试 probe 未被调用的场景时，条件断点是最有效的工具。以下是在 kgdb 或 gdb 中设置条件断点的示例：

# 在 probe 函数入口设置条件断点，只捕获目标设备
(gdb) break my_pci_probe if pdev->vendor == 0x8086 && pdev->device == 0x10fb

# 在 pci_match_device 中观察匹配过程
(gdb) break pci_match_device if id->vendor == 0x8086

# 在 pci_bus_match 中观察总线匹配
(gdb) break pci_bus_match if dev->vendor == 0x8086