3. 中断描述符与 irq_chip：struct irq_desc 结构体分析、irq_chip 硬件接口层、中断控制器驱动模型

中断子系统在内核中的核心数据结构是 struct irq_desc（中断描述符），它串联起从硬件中断触发到软件处理函数执行的完整链路。而 struct irq_chip 则是内核与具体中断控制器硬件之间的抽象接口层，屏蔽了不同厂商（如 Intel APIC、ARM GIC、RISC-V PLIC）的寄存器差异。本章将深入分析这两个核心结构体，并梳理中断控制器驱动的标准模型。

3.1 struct irq_desc：中断描述符的完整画像

每个 IRQ 号（无论是全局的 Linux IRQ 号还是硬件 IRQ 号）在内核中都对应一个 irq_desc 实例。该结构体包含了该中断线的全部状态、处理函数链表、亲和性设置、统计信息以及底层硬件操作指针。

3.1.1 核心字段解析

3.1.2 irq_desc 与中断处理流程

当中断控制器向 CPU 发送中断信号时，CPU 跳转到入口函数（如 handle_irq() 或 generic_handle_irq()），通过 IRQ 号索引到对应的 irq_desc，然后调用 desc->handle_irq()（高层流控处理函数）。该函数根据中断类型（边沿触发、电平触发）执行不同的流控逻辑，最终遍历 desc->action 链表，调用注册的 irq_handler_t。

3.1.3 irq_desc 关系内联 SVG

3.2 irq_chip：硬件接口层的抽象

struct irq_chip 是内核与中断控制器硬件交互的契约。它定义了一组回调函数指针，用于操作中断控制器的寄存器，实现中断的使能、屏蔽、确认、结束、亲和性设置等底层操作。

3.2.1 核心回调函数

3.2.2 irq_chip 与 irq_desc 的绑定

在中断控制器驱动初始化时，会分配并填充一个 irq_chip 实例，然后通过 irq_set_chip() 或 irq_domain 映射机制将其绑定到对应的 irq_desc 的 irq_data.chip 字段。当中断流控处理函数需要操作硬件时，通过 irq_desc->irq_data.chip 调用对应的回调。

3.2.3 irq_chip 回调调用流程 SVG

3.3 中断控制器驱动模型

Linux 内核的中断控制器驱动遵循一套标准化的模型，主要围绕 irq_domain（中断域）和 irq_chip 展开。该模型将硬件中断号（hwirq）映射到 Linux IRQ 号，并关联对应的 irq_chip 回调。

3.3.1 驱动模型层次结构

1. 设备树/ACPI 解析阶段： 内核解析硬件描述信息，获取中断控制器的寄存器基地址、中断输出线数量、级联关系等。
2. irq_domain 创建： 驱动调用 irq_domain_add_linear()、irq_domain_add_tree() 或 irq_domain_add_simple() 创建映射域。线性域适用于 hwirq 连续且数量固定的场景；树形域适用于稀疏 hwirq 场景。
3. irq_chip 初始化： 驱动填充 struct irq_chip 实例，设置 name、irq_mask、irq_unmask、irq_set_affinity 等回调。
4. irq_desc 分配与绑定： 当设备请求中断时，irq_domain 分配一个空闲的 Linux IRQ 号，创建 irq_desc，并将 irq_chip 和 hwirq 信息写入 irq_data。
5. 中断处理注册： 设备驱动调用 request_irq() 或 request_threaded_irq()，将处理函数挂入 irq_desc->action 链表。

3.3.2 常见中断控制器对比

3.3.3 中断控制器驱动模型架构 SVG

3.4 关键代码片段：irq_chip 注册示例

以下是一个简化的中断控制器驱动初始化代码，展示了 irq_chip 的填充与 irq_domain 的创建过程。

/* 示例：模拟中断控制器的 irq_chip 定义 */
static struct irq_chip my_controller_chip = {
    .name           = "my_controller",
    .irq_mask       = my_controller_mask,
    .irq_unmask     = my_controller_unmask,
    .irq_ack        = my_controller_ack,
    .irq_set_affinity = my_controller_set_affinity,
    .irq_set_type   = my_controller_set_type,
};

/* irq_domain 映射回调：将 hwirq 映射到 irq_desc */
static int my_controller_domain_map(struct irq_domain *d,
                                    unsigned int virq, irq_hw_number_t hw)
{
    /* 将 irq_chip 绑定到 virq 对应的 irq_desc */
    irq_set_chip_and_handler(virq, &my_controller_chip,
                             handle_level_irq);
    /* 设置中断触发类型为高电平有效 */
    irq_set_irq_type(virq, IRQ_TYPE_LEVEL_HIGH);
    /* 设置芯片私有数据 */
    irq_set_chip_data(virq, d->host_data);
    return 0;
}

/* 驱动初始化函数 */
static int __init my_controller_init(void)
{
    struct irq_domain *domain;

    /* 创建线性 irq_domain，支持 32 个中断源 */
    domain = irq_domain_add_linear(NULL, 32,
                                   &my_controller_domain_ops, NULL);
    if (!domain)
        return -ENOMEM;

    pr_info("my_controller: irq_domain created with 32 interrupts\n");
    return 0;
}

3.5 中断描述符与 irq_chip 的协同工作

理解 irq_desc 和 irq_chip 的关系是进行中断负载均衡优化的基础。负载均衡的核心操作——设置亲和性——最终通过 irq_chip 的 irq_set_affinity 回调写入硬件寄存器。而 irq_desc 中的 affinity_hint 和 pending_mask 则为软件层面的均衡策略提供了决策依据。

• irq_desc 是“信息中心”： 存储了中断的当前状态、处理函数、统计数据和软件亲和性掩码。
• irq_chip 是“执行器”： 将软件决策（如亲和性变更、屏蔽/使能）翻译为硬件寄存器操作。
• irq_domain 是“翻译官”： 将硬件中断号（hwirq）转换为内核统一的 Linux IRQ 号，并完成 irq_desc 的初始化绑定。