3. Linux 中断子系统架构：IRQ Domain、中断控制器、中断号映射流程

在深入 PCIe MSI 中断调试之前，必须理解 Linux 中断子系统的核心架构。PCIe 设备产生的中断请求（MSI/MSI-X）需要经过中断控制器、IRQ Domain 和中断号映射等多个层次，最终才能被 CPU 处理。任何一个环节的配置错误或延迟，都可能导致中断丢失或性能下降。

3.1 中断子系统三层模型

Linux 中断子系统采用分层设计，从上到下依次为：通用中断层（Generic IRQ Layer）、中断控制器驱动层（IRQ Chip Driver） 和 硬件中断控制器层（Hardware Interrupt Controller）。PCIe MSI 中断的传递路径贯穿这三层。

3.2 IRQ Domain：中断号映射的核心

IRQ Domain 是 Linux 中断子系统中连接硬件中断与软件中断号的桥梁。每个中断控制器（如 GIC、IO-APIC、MSI 控制器）都对应一个或多个 IRQ Domain。对于 PCIe MSI 中断，MSI 控制器（如 x86 的 MSI chip 或 ARM 的 ITS）会创建一个专门的 IRQ Domain 来管理 MSI 中断号的分配与映射。

3.2.1 IRQ Domain 类型

3.3 中断号映射流程：从 PCIe 设备到 CPU

当 PCIe 设备使能 MSI 中断时，内核会执行以下映射流程：

1. 设备枚举阶段： PCI 子系统读取设备的 MSI/MSI-X Capability 结构，获取设备支持的 MSI 向量数量。
2. 中断号分配： 调用 pci_alloc_irq_vectors()，该函数会调用 MSI 控制器的 IRQ Domain 的 alloc() 回调，分配一组连续的 hwirq（硬件中断号）。
3. virq 映射： IRQ Domain 为每个 hwirq 分配一个 Linux IRQ 号（virq），并建立映射关系。对于 MSI，通常使用树形映射。
4. 中断控制器配置： 配置中断控制器的路由表，将 hwirq 映射到目标 CPU 的 LAPIC（x86）或 Redistributor（ARM GIC）。
5. 中断处理程序注册： 驱动调用 request_irq(virq, handler, flags, name, dev) 注册中断处理函数。
6. MSI 消息写入： 内核将目标 CPU 的 LAPIC ID 和中断向量写入 PCIe 设备的 MSI 地址寄存器（Address）和数据寄存器（Data）。

3.4 中断控制器与 IRQ Chip 结构

每个中断控制器在 Linux 中对应一个 irq_chip 结构体，该结构体定义了操作中断控制器的底层函数。对于 PCIe MSI 中断，常见的 irq_chip 包括：

3.5 中断号映射的调试方法

当怀疑中断号映射出现问题时，可以使用以下方法进行排查：

• 查看 /proc/interrupts： 确认 MSI 中断是否被正确分配，以及每个 CPU 上的中断计数。
• 查看 /sys/kernel/debug/irq_domain_mapping： 如果内核开启了 CONFIG_IRQ_DOMAIN_DEBUG，可以查看所有 IRQ Domain 的映射关系。
• 使用 tracepoint： 启用 irq_vectors 和 irq_handler_entry tracepoint，跟踪中断从硬件触发到处理函数执行的完整路径。
• 检查 dmesg： 内核在 IRQ Domain 分配失败时会打印错误信息，如 irq: no irq domain found for hwirq。

# 查看 MSI 中断分布
cat /proc/interrupts | grep -E "PCI-MSI|msi"

# 查看特定 IRQ 的亲和性
cat /proc/irq/128/smp_affinity

# 启用 IRQ Domain 调试（需要重新编译内核）
# 内核配置：CONFIG_IRQ_DOMAIN_DEBUG=y
# 挂载 debugfs 后查看
mount -t debugfs none /sys/kernel/debug
cat /sys/kernel/debug/irq_domain_mapping

3.6 总结：中断号映射的关键点