4. pci_set_master 函数源码分析：Linux 内核中的实现路径与 PCI 命令寄存器操作

当驱动调用 pci_set_master 关闭 Bus Master 位后，DMA 传输超时的根因往往隐藏在该函数对 PCI 命令寄存器的操作细节中。本节深入 Linux 内核源码，逐层解析 pci_set_master 的实现路径，并重点分析其对 PCI 命令寄存器（Command Register, offset 0x04） 中 Master Enable 位的操作逻辑。

4.1 函数调用链全景

pci_set_master 并非一个简单的寄存器赋值函数，它经过多层封装，最终通过 PCI 配置空间访问原语修改命令寄存器。完整的调用链如下：

4.2 核心源码逐行解析

以下截取 Linux 内核 6.x 版本中 drivers/pci/pci.c 的核心实现，并添加中文注释：

// drivers/pci/pci.c
void pci_set_master(struct pci_dev *dev)
{
    // 1. 获取设备锁，防止并发配置空间访问
    pci_dev_lock(dev);

    // 2. 设置设备标志，表示已使能 Bus Master
    dev->is_busmaster = 1;

    // 3. 读取当前 PCI 命令寄存器（16位）
    u16 cmd;
    pci_read_config_word(dev, PCI_COMMAND, &cmd);

    // 4. 设置 Master Enable 位（bit 2）
    cmd |= PCI_COMMAND_MASTER;

    // 5. 写回命令寄存器
    pci_write_config_word(dev, PCI_COMMAND, cmd);

    // 6. 调用架构相关的后处理函数
    pcibios_enable_device(dev, 0);

    // 7. 解锁设备
    pci_dev_unlock(dev);
}
EXPORT_SYMBOL(pci_set_master);

// 对应的关闭函数 pci_clear_master
void pci_clear_master(struct pci_dev *dev)
{
    pci_dev_lock(dev);

    dev->is_busmaster = 0;

    u16 cmd;
    pci_read_config_word(dev, PCI_COMMAND, &cmd);

    // 清除 Master Enable 位
    cmd &= ~PCI_COMMAND_MASTER;

    pci_write_config_word(dev, PCI_COMMAND, cmd);

    // 注意：此处没有 pcibios_enable_device 调用
    // 也没有等待 DMA 完成的机制

    pci_dev_unlock(dev);
}
EXPORT_SYMBOL(pci_clear_master);

4.3 PCI 命令寄存器位布局

PCI 命令寄存器位于配置空间偏移 0x04，共 16 位。与 Bus Master 直接相关的位如下：

4.4 配置空间访问路径：从 API 到硬件

pci_read_config_word 和 pci_write_config_word 的底层实现因架构而异。以 x86 为例，其访问路径如下：

1. PCI 配置空间访问 API：pci_read_config_word 调用 pci_bus_read_config_word。
2. 总线级操作：通过 pci_bus->ops->read 函数指针，指向 pci_conf1_read 或 pci_conf2_read。
3. IO 端口操作：使用 outl/inl 指令操作 0xCF8（配置地址端口）和 0xCFC（配置数据端口）。
4. 硬件层面：PCI 桥接器将 IO 端口访问转换为 PCI 配置周期，通过 IDSEL 选择目标设备。

4.5 内联 SVG：pci_set_master 函数执行流程图

4.6 关闭 Bus Master 时的隐藏陷阱

当驱动调用 pci_clear_master 时，内核执行以下操作：

1. 清除标志位：dev->is_busmaster = 0
2. 读取命令寄存器：获取当前值
3. 清除 bit 2：cmd &= ~PCI_COMMAND_MASTER
4. 写回寄存器：立即生效

但这里存在三个关键问题：

4.7 内联 SVG：PCI 命令寄存器位操作示意图

4.8 与 DMA 超时的直接关联

从源码分析可以得出以下结论：

• 立即生效性：pci_write_config_word 写回后，PCI 硬件立即禁止设备发起新的 DMA 事务。
• 未完成事务处理：硬件行为取决于 PCI 控制器实现。多数控制器会等待当前事务完成，但不会等待软件层面的 DMA 描述符链处理完毕。
• 超时根因：如果驱动在关闭 Master 后立即检查 DMA 完成状态，而此时硬件仍在处理最后几个数据包，就会触发超时。