Linux中断子系统实战：从硬件中断号到IRQ domain的完整映射解析

Linux中断子系统实战：从硬件中断号到IRQ domain的完整映射解析

在嵌入式系统和内核驱动的世界里，中断处理是系统实时性与稳定性的基石。想象一下，你正在调试一块搭载了多核处理器和多个中断控制器的复杂开发板，一个外设中断信号从产生到最终被驱动程序处理，这中间究竟经历了怎样的“旅程”？对于许多开发者而言，理解中断号如何从物理引脚上的一个电信号，最终转化为内核中一个唯一的irq_desc结构体，常常是深入内核调试和驱动开发时必须跨越的一道门槛。这个过程不仅仅是概念的堆砌，更是一套精密的软件架构与硬件事实之间的映射艺术。本文将彻底拆解这一过程，聚焦于irq domain这一核心机制，为你呈现一幅从硬件中断号到软件中断号的完整、可操作的映射图景。

我们的目标读者是那些已经熟悉Linux驱动基础，但在面对多中断控制器、级联中断等复杂硬件拓扑时感到困惑的嵌入式Linux开发者或内核驱动工程师。我们将绕过泛泛而谈的理论，直接切入实际开发中你会遇到的配置、代码和调试场景，让你不仅明白“是什么”，更清楚“怎么做”以及“为什么这么做”。

1. 中断世界的两层语言：硬件中断号与软件中断号

要理解映射的必要性，首先得认清中断子系统里存在的两种“语言体系”。这有点像网络协议栈，底层硬件说着它自己的方言，而上层通用内核框架则需要一套统一的普通话来管理所有中断。

硬件中断号，通常被称为hwirq，是中断控制器视角下的本地编号。每一个连接到特定中断控制器引脚上的外设，都会被该控制器分配一个唯一的hwirq。例如，一个简单的GPIO控制器可能将它的32个引脚分别编号为0到31。关键在于，这个编号的“唯一性”仅限于该控制器内部。如果系统中有两个同型号的GPIO控制器，那么它们各自都会有一个hwirq编号为0的中断源。

软件中断号，即IRQ number或virq，是Linux内核全局视角下的中断标识符。内核的中断核心层、驱动层都使用这个编号来引用和管理一个中断。它在整个系统范围内必须是唯一的，因为内核需要根据这个号码快速索引到对应的中断描述符irq_desc，进而调用正确的中断服务例程。

那么问题来了：当一个系统存在多个中断控制器，甚至控制器之间还存在级联时，如何将各个控制器内部的、可能重复的hwirq，翻译成全局唯一的virq？这就是irq domain要解决的核心问题。

注意：在简单的单控制器系统中，hwirq与virq常常是线性映射（例如virq = hwirq + offset），这可能会让你误以为两者是一回事。但在复杂系统中，这种假设会立刻导致系统崩溃或中断错乱。

为了更清晰地对比这两个概念，我们来看一个表格：

特性维度	硬件中断号	软件中断号
命名	HW interrupt ID, hwirq	IRQ number, virq, 虚拟中断号
作用域	局部于其所属的中断控制器	全局于整个Linux内核
唯一性	在所属中断控制器域内唯一	在整个系统范围内唯一
创建者	由硬件设计或中断控制器固定	由Linux内核irqdomain核心动态分配
驱动使用	驱动通常不直接感知	驱动申请、注册中断处理函数时使用
示例	GPIO控制器A的引脚0对应hwirq=0	该引脚可能被映射为全局virq=101

理解这层区别是后续所有操作的基础。驱动开发者打交道的主要是virq，而编写中断控制器驱动的工程师则需要深入处理hwirq到virq的映射逻辑。

2. IRQ Domain：中断的命名空间管理机制

你可以把irq domain理解为内核为每个中断控制器创建的一个独立的“中断命名空间”。每个域负责管理自己控制器上所有中断源的映射关系。这个抽象完美地对应了硬件事实：一个中断控制器及其连接的所有中断线，自然构成了一个需要独立管理的集合。

2.1 Domain的创建与初始化

中断控制器驱动在初始化时，其核心任务之一就是创建并注册一个irq_domain。这个过程通常发生在驱动探测probe函数中。我们以一款虚拟的“vGPIO”控制器为例，看看代码大概的样子：

#include <linux/irqdomain.h>
#include <linux/of_irq.h> // 设备树支持

static int vgpio_probe(struct platform_device *pdev)
{
    struct device_node *np = pdev->dev.of_node;
    struct vgpio_ctrl *ctrl;
    // ... 控制器内存映射、硬件初始化等 ...

    /* 创建irq domain */
    ctrl->domain = irq_domain_add_linear(np, // 关联的设备树节点
                                          VGPIO_NR_IRQS, // 本控制器管理的中断数量
                                          &vgpio_irq_domain_ops, // 域操作函数集
                                          ctrl); // 私有数据指针，通常传控制器结构体
    if (!ctrl->domain) {
        dev_err(&pdev->dev, "Failed to create IRQ domain\n");
        return -ENOMEM;
    }

    // ... 其他初始化 ...
    return 0;
}

这里的关键是irq_domain_add_linear函数和vgpio_irq_domain_ops。线性映射是一种常见的策略，意味着virq的分配是连续、线性的。还有其他类型的domain，如树映射（用于支持中断控制器的级联）。vgpio_irq_domain_ops是一个包含了若干回调函数的结构体，它定义了该domain如何执行映射、翻译和中断控制器特有的操作。

2.2 核心操作函数集：struct irq_domain_ops

这个结构体是irq domain的灵魂，它定义了硬件中断号与软件中断号之间转换的规则。主要需要实现以下几个回调：

• .map 或 .alloc：当内核需要为该domain中的一个新hwirq分配一个virq时调用。这是建立映射关系的关键时刻。驱动需要在这里设置该中断的流控处理函数、芯片数据等。
• .translate：用于解析来自设备树（interrupts属性）或ACPI的中断描述符，将其转换为该domain能识别的hwirq。
• .xlate：与.translate类似，是更早期的接口。
• .unmap 或 .free：当映射被释放时调用，进行资源清理。

一个简化版的vgpio_irq_domain_ops可能如下所示：

static const struct irq_domain_ops vgpio_irq_domain_ops = {
    .map = vgpio_irq_map,
    .unmap = vgpio_irq_unmap,
    .xlate = irq_domain_xlate_twocell, // 使用标准的两单元解析器
};

static int vgpio_irq_map(struct irq_domain *d, unsigned int virq,
                         irq_hw_number_t hwirq)
{
    struct vgpio_ctrl *ctrl = d->host_data;

    /* 设置中断流控处理函数，例如处理边沿触发 */
    irq_set_chip_and_handler(virq, // 软件中断号
                             &vgpio_irq_chip, // 该中断控制器对应的irq_chip
                             handle_edge_irq); // 标准的边沿中断流控函数

    /* 将控制器私有数据设置到irq_data中，方便后续操作 */
    irq_set_chip_data(virq, ctrl);
    /* 将hwirq关联到irq_data */
    irq_set_irq_type(virq, IRQ_TYPE_EDGE_RISING); // 设置触发类型

    return 0;
}

在.map函数中，我们通过irq_set_chip_and_handler将virq、中断控制器操作集irq_chip以及通用的流控处理函数绑定在一起。irq_chip结构体包含了操作硬件控制器所需的底层函数，如ack、mask、unmask、set_type等。

3. 实战：在多控制器系统中解析中断映射

现在，让我们进入一个更贴近实际的场景：一个基于设备树描述的片上系统，它包含一个主GIC中断控制器和一个级联的GPIO控制器。GPIO控制器的某些引脚可以产生中断，并级联到GIC的某个SPI中断上。

3.1 设备树中的中断描述

设备树清晰地描述了这种硬件拓扑和连接关系：

// 部分设备树示例
gic: interrupt-controller@address {
    compatible = "arm,gic-400";
    reg = <...>;
    interrupt-controller;
    #interrupt-cells = <3>; // 对于GIC，通常需要3个单元
};

vgpio: gpio@address {
    compatible = "vendor,vgpio";
    reg = <...>;
    gpio-controller;
    #gpio-cells = <2>;
    interrupt-controller;
    #interrupt-cells = <2>; // 对于该GPIO控制器，需要2个单元
    interrupts = <GIC_SPI 42 IRQ_TYPE_LEVEL_HIGH>; // 关键！本级联到GIC的42号中断
};

关键点在于vgpio节点的interrupts属性。它声明了该GPIO控制器本身（作为一个中断设备）的中断输出线连接到了父中断控制器gic的哪个中断输入上。同时，它通过interrupt-controller和#interrupt-cells声明自己也是一个中断控制器。

当一个设备（如一个按键）连接到vgpio的某个引脚时，它的中断描述会是这样：

button {
    compatible = "gpio-keys";
    button-pin = <&vgpio 5 GPIO_ACTIVE_LOW>;
    interrupts-extended = <&vgpio 5 IRQ_TYPE_EDGE_FALLING>;
};

interrupts-extended属性指向了中断控制器vgpio，参数5表示该控制器上的hwirq编号（即GPIO引脚5），IRQ_TYPE_EDGE_FALLING是触发类型。

3.2 内核中的映射流程

当内核解析到这个按键设备时，中断映射的“魔法”就开始了：

1. 解析interrupts-extended：内核发现它引用的是vgpio这个中断控制器。
2. 调用vgpio的.xlate：vgpio的irq_domain_ops中的.xlate函数被调用，将设备树中的两个单元<5 IRQ_TYPE_EDGE_FALLING>翻译成该domain内部的hwirq=5和触发标志。
3. 分配virq：内核中断核心层需要为这个中断请求分配一个全局唯一的virq。它会询问vgpio domain。
4. vgpio domain的.map被调用：vgpio_irq_map函数被调用，参数中包含了分配到的virq和hwirq=5。该函数如前所述，设置irq_chip和流控函数。但这里有一个级联，所以vgpio自己也需要一个virq来连接到父控制器gic。
5. 处理级联：实际上，在vgpio domain创建时，其父domain（gic）就已经通过irq_domain_add_hierarchy或类似机制建立了关联。vgpio控制器本身的hwirq（对应其连接到GIC的线）到virq的映射也已经建立（对应设备树中interrupts = <GIC_SPI 42 ...>，virq可能是16+42=58之类的数字）。
6. 建立层级关系：内核会建立virq(button) -> irq_data(vgpio domain) -> parent_data(gic domain)的链式关系。当中断发生时，硬件流程是：按键触发 -> vgpio控制器感知 -> vgpio控制器向gic的42号线发出中断信号 -> gic通知CPU。
7. 软件处理流程：CPU进入GIC的中断服务程序，根据中断号找到virq=58对应的处理函数，这个函数实际上是vgpio控制器的级联中断处理函数。该函数会查询vgpio控制器的状态寄存器，发现是引脚5触发了中断，然后它再通过vgpio domain找到hwirq=5对应的virq（假设是101），最终调用注册在virq=101上的、按键驱动程序的中断处理函数。

这个过程虽然复杂，但irq domain和内核中断核心层为我们妥善处理了所有细节。对于按键驱动开发者来说，他只需要像申请普通中断一样，使用request_irq(virq, ...)，其中的virq参数内核已经通过platform_get_irq()或irq_of_parse_and_map()自动转换好了。

4. 调试技巧与常见问题排查

理解了原理，但在实际开发中，映射出错、中断无法触发是最令人头疼的问题。掌握以下调试技巧至关重要。

首先，利用/proc/interrupts。这是查看中断映射和触发情况的第一窗口。在级联系统中，输出可能如下：

           CPU0       CPU1
 58:          0          0       GICv3  42 Level      vgpio
 101:         125       0       vgpio   5 Edge       gpio-keys

• 第一列是virq。
• 中断控制器列显示了处理该中断的硬件控制器名称。可以看到virq 58由GICv3处理，而virq 101由vgpio处理，这清晰地反映了级联关系。
• 最后一列是中断名称，由驱动在申请中断时指定。

其次，使用irq_domain调试信息。内核编译时打开CONFIG_IRQ_DOMAIN_DEBUG，可以在/sys/kernel/debug/irq/domains下看到所有注册的irq domain及其映射信息。

常见问题排查清单：

• 中断申请失败：首先检查platform_get_irq()返回值是否为负数。确保设备树中的interrupts属性格式正确，且与中断控制器声明的#interrupt-cells匹配。
• 中断触发了但处理函数没被调用：
  • 检查/proc/interrupts对应virq的计数是否增加。如果不增加，可能是硬件连接、GPIO复用配置或中断控制器使能问题。
  • 如果计数增加但驱动没反应，检查驱动申请中断时使用的virq号是否正确，触发类型IRQ_TYPE_...是否与硬件实际信号匹配（例如，硬件是低电平触发，驱动却申请了边沿触发）。
• 级联中断问题：如果父中断（如上面例子中的virq 58）有计数，但子中断（virq 101）没有，问题很可能出在级联中断处理函数（即vgpio控制器的驱动）中，它可能没有正确读取和分发子中断状态。

一个实用的调试代码片段，可以在驱动初始化时打印映射信息：

int irq = platform_get_irq(pdev, 0);
struct irq_data *irq_data = irq_get_irq_data(irq);
struct irq_domain *domain = irq_data->domain;

pr_info("Device IRQ virq = %d\n", irq);
if (domain) {
    pr_info("Belongs to domain: %s\n", domain->name);
    pr_info("HW interrupt ID (hwirq) = %lu\n", irq_data->hwirq);
}

通过这段代码，你可以快速确认驱动获取到的virq，以及它背后对应的irq_domain和hwirq，这对于验证设备树配置和驱动代码逻辑是否正确对齐非常有帮助。

5. 深入流控处理：连接硬件与通用框架的桥梁

在irq domain的.map函数中，我们指定了一个如handle_edge_irq的流控处理函数。这是连接具体硬件行为和内核通用中断处理框架的桥梁。理解不同的流控函数有助于你在编写中断控制器驱动或调试复杂中断行为时做出正确选择。

流控处理主要封装了在中断处理前后，针对不同硬件特性必须进行的一系列标准操作。主要类型包括：

• handle_level_irq：用于电平触发中断。这类中断只要中断线保持在有效电平，就会持续产生中断请求。因此，流控逻辑通常包括：
  • 进入中断处理时，先mask_irq屏蔽该中断线，防止在服务程序执行期间重复进入。
  • 执行驱动注册的中断服务例程。
  • 服务例程完成后，可能需要等待硬件条件改变（如读取某个寄存器清除中断源），然后unmask_irq重新使能中断。
• handle_edge_irq：用于边沿触发中断。中断在信号边沿（上升沿或下降沿）产生一次请求。其流控相对简单，通常只需要在中断服务开始或结束时ack（应答）中断控制器即可。因为边沿是瞬态的，不存在重复触发的问题。
• handle_fasteoi_irq：用于那些需要在中断服务例程结束时向控制器发送EOI（End Of Interrupt）命令的控制器。许多高级可编程中断控制器使用此模式。它的操作顺序是：响应中断 -> 执行服务例程 -> 发送EOI。
• handle_simple_irq：用于最简单的、不需要任何流控操作的中断。通常用于软件中断或某些极其简单的硬件中断。

选择错误的流控函数是导致中断行为异常（如丢失中断、中断风暴）的常见原因。例如，为一个电平中断配置了handle_edge_irq，可能会导致中断服务程序被连续疯狂调用，形成“中断风暴”，因为控制器会在电平持续期间不断检测到“边沿”。相反，为边沿中断配置handle_level_irq并执行mask操作，则可能在特定条件下丢失后续的中断。

在irq_chip的实现中，你需要提供与流控函数配套的底层硬件操作。例如，对于handle_level_irq，你的irq_chip.mask和.unmask函数必须正确实现；对于handle_fasteoi_irq，则需要实现.irq_eoi函数。

最后，关于性能的考量。在数据吞吐量极大的网络或存储驱动中，中断处理的效率至关重要。除了传统的上下半部机制，threaded IRQ（线程化中断）和affinity（中断亲和性）设置是常用的优化手段。线程化中断可以将中断处理程序推送到一个内核线程中执行，允许睡眠和更长的执行时间，并且可以通过设置线程的CPU亲和性，更好地利用多核性能。你可以通过request_threaded_irq()来申请这类中断，并结合irq_set_affinity()来绑定到特定的CPU核心，减少缓存失效和核间通信开销，这对于多队列网卡或NVMe驱动优化尤其有效。