4、Linux内核PCIe热插拔子系统架构：pciehp驱动、pci_hotplug核心、与ACPI的交互关系

理解Linux内核PCIe热插拔子系统的分层架构，是定位Surprise Remove故障的基础。整个子系统从上到下分为三层：pciehp驱动（硬件原生层）、pci_hotplug核心（抽象管理层）、以及ACPI交互层（固件接口层）。每一层承担不同的职责，并通过标准接口协同工作。

4.1 pciehp驱动：硬件原生热插拔引擎

pciehp（PCI Express Hot Plug）是Linux内核中针对PCIe原生热插拔的驱动程序，直接操作PCIe配置空间中的热插拔相关寄存器。它不依赖ACPI的_EJ0等方法，而是通过硬件原生协议完成电源控制、链路训练和中断处理。

4.1.1 核心寄存器与功能

4.1.2 中断处理流程

当发生Surprise Remove时，硬件通过MSI或INTx向CPU发送热插拔中断。pciehp驱动的中断处理函数执行以下步骤：

1. 读取Slot Status寄存器：确认Presence Detect状态位变化。
2. 清除中断状态位：写1清除已处理的中断标志。
3. 启动工作队列：将实际处理任务交给pciehp工作线程，避免在中断上下文执行耗时操作。
4. 工作线程处理：执行链路训练、设备移除通知、电源关闭等操作。

4.2 pci_hotplug核心：抽象管理层

pci_hotplug核心层位于pciehp驱动之上，为所有热插拔控制器驱动（包括pciehp、shpchp、acpiphp等）提供统一的注册、回调和管理框架。它屏蔽了底层硬件差异，向上层（sysfs、用户空间）提供标准接口。

4.2.1 核心数据结构

// include/linux/pci_hotplug.h
struct hotplug_slot {
    struct list_head        slot_list;      // 全局槽位链表
    struct pci_slot         *pci_slot;      // 关联的PCI槽位对象
    struct hotplug_slot_ops *ops;           // 操作函数指针
    struct list_head        node;           // 驱动内部链表节点
    unsigned int            flags;          // 槽位标志位
};

struct hotplug_slot_ops {
    int (*enable_slot)(struct hotplug_slot *slot);
    int (*disable_slot)(struct hotplug_slot *slot);
    int (*get_power_status)(struct hotplug_slot *slot, u8 *value);
    int (*get_attention_status)(struct hotplug_slot *slot, u8 *value);
    int (*get_latch_status)(struct hotplug_slot *slot, u8 *value);
    int (*get_adapter_status)(struct hotplug_slot *slot, u8 *value);
};

4.2.2 槽位状态机

pci_hotplug核心维护一个简化的槽位状态机，用于跟踪每个热插拔槽位的生命周期：

4.3 与ACPI的交互关系

虽然pciehp驱动使用硬件原生热插拔协议，但在许多平台上，ACPI仍然扮演着重要的辅助角色。ACPI提供固件级别的热插拔事件通知、电源管理和平台配置信息。

4.3.1 交互模式对比

4.3.2 _OSC协商与热插拔控制权

在系统启动时，Linux内核通过ACPI _OSC（Operating System Capabilities）方法与固件协商PCIe热插拔控制权。关键协商位如下：

// ACPI 6.4规范，PCIe OSC定义
#define OSC_PCI_EXPRESS_NATIVE_HP_CONTROL    0x00000008  // Bit 3
#define OSC_PCI_EXPRESS_NATIVE_PME_CONTROL   0x00000010  // Bit 4
#define OSC_PCI_EXPRESS_NATIVE_AER_CONTROL   0x00000020  // Bit 5

// 内核协商流程（简化）
acpi_status pcie_osc_negotiate(struct pci_dev *root_port) {
    u32 capbuf[3] = {0};
    // 设置OS支持的原生热插拔能力
    capbuf[OSC_QUERY_DWORD] = OSC_PCI_EXPRESS_NATIVE_HP_CONTROL;
    // 发送_OSC查询
    status = acpi_evaluate_object(handle, "_OSC", &args, &buf);
    // 检查固件是否授予控制权
    if (capbuf[OSC_SUPPORT_DWORD] & OSC_PCI_EXPRESS_NATIVE_HP_CONTROL)
        pciehp_set_native_control(root_port);
    return status;
}

4.3.3 ACPI事件与pciehp的协作流程

在同时启用ACPI和pciehp的平台上，Surprise Remove的事件流如下：

1. 硬件事件触发：设备物理移除，PCIe链路断开，Slot Status寄存器Presence位变化。
2. 中断路径：pciehp驱动响应硬件中断，开始移除处理。
3. ACPI通知路径：固件通过ACPI Notify向OS发送设备移除事件（0x03）。
4. 事件合并：ACPI驱动和pciehp驱动通过pci_hotplug核心层的事件分发机制合并通知，避免重复处理。
5. 资源清理：pci_hotplug核心调用注册的回调函数，释放设备资源、更新sysfs状态。

4.4 故障排查关键点总结

• 确认热插拔模式：通过lspci -v查看Slot Capabilities中的Hot Plug Capable和Surprise Capable位，确认硬件支持。
• 检查驱动加载：lsmod | grep pciehp确认pciehp驱动已加载；dmesg | grep pciehp查看初始化日志。
• 验证_OSC协商：dmesg | grep -i osc查看ACPI _OSC协商结果，确认原生热插拔控制权已授予。
• 监控槽位状态：cat /sys/bus/pci/slots/<slot_number>/power和cat /sys/bus/pci/slots/<slot_number>/adapter实时查看状态。
• 中断统计：cat /proc/interrupts | grep pciehp查看热插拔中断计数，判断中断是否正常触发。