Linux内核PCIe驱动调试 反汇编分析与链路故障定位 - 第2节

2. Linux内核PCIe子系统架构

Linux 内核 PCIe 子系统使用两个核心数据结构来抽象物理拓扑：pci_bus 表示一条 PCI 总线，pci_dev 表示总线上的一个设备（包括桥设备）。理解这两个结构体是调试链路故障的基础。

2.1.1 pci_bus 结构体关键字段

2.1.2 pci_dev 结构体关键字段

2.1.3 数据结构关系图

2.2 pci_driver 注册流程

PCIe 设备驱动通过 pci_register_driver() 向内核注册，内核在枚举设备时自动匹配并调用 probe。整个流程涉及设备模型、PCI 核心和电源管理框架。

2.2.1 注册流程步骤

1. 驱动初始化：驱动模块入口调用 pci_register_driver()，传入 struct pci_driver 实例。
2. ID 表注册：内核将 pci_driver->id_table 加入 PCI 子系统 ID 匹配链表。
3. 设备枚举触发：对系统中所有已枚举的 pci_dev，遍历 ID 表进行匹配。
4. 匹配成功：调用 pci_driver->probe()，传入匹配的 pci_dev 指针。
5. 资源分配：probe 函数中调用 pci_enable_device()、pci_request_regions() 等 API。
6. 中断注册：通过 request_irq() 或 pci_alloc_irq_vectors() 注册中断处理。
7. 设备添加：调用 pci_set_drvdata() 保存私有数据，设备进入就绪状态。

2.2.2 pci_driver 结构体关键成员

2.2.3 注册与匹配流程图

2.3 probe/remove 回调机制

probe 和 remove 是 PCIe 驱动生命周期中最重要的两个回调，分别在设备绑定和解除绑定时执行。理解其调用时机和典型实现，对调试驱动加载失败、资源泄漏等问题至关重要。

2.3.1 probe 回调典型实现

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

    // 1. 启用 PCI 设备（包括总线主控、IO/内存空间）
    ret = pci_enable_device(pdev);
    if (ret)
        return ret;

    // 2. 请求 BAR 资源
    ret = pci_request_regions(pdev, "my_driver");
    if (ret)
        goto err_disable;

    // 3. 设置 DMA 掩码
    ret = dma_set_mask(&pdev->dev, DMA_BIT_MASK(64));
    if (ret)
        goto err_release;

    // 4. 分配私有数据结构
    priv = devm_kzalloc(&pdev->dev, sizeof(*priv), GFP_KERNEL);
    if (!priv) {
        ret = -ENOMEM;
        goto err_release;
    }

    // 5. 映射 BAR 地址
    priv->bar_addr = pci_iomap(pdev, 0, 0);
    if (!priv->bar_addr) {
        ret = -EIO;
        goto err_free;
    }

    // 6. 注册中断
    ret = request_irq(pdev->irq, my_isr, IRQF_SHARED, "my_driver", priv);
    if (ret)
        goto err_unmap;

    // 7. 保存私有数据
    pci_set_drvdata(pdev, priv);

    // 8. 启用设备（设置 Bus Master 等）
    pci_set_master(pdev);

    return 0;

err_unmap:
    pci_iounmap(pdev, priv->bar_addr);
err_free:
    devm_kfree(&pdev->dev, priv);
err_release:
    pci_release_regions(pdev);
err_disable:
    pci_disable_device(pdev);
    return ret;
}

2.3.2 remove 回调典型实现

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

    if (!priv)
        return;

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

    // 2. 取消映射 BAR
    pci_iounmap(pdev, priv->bar_addr);

    // 3. 释放资源
    pci_release_regions(pdev);

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

    // 5. 私有数据由 devm 自动释放
}

2.3.3 probe/remove 调用时序图

2.3.4 probe 失败常见原因