4. 中断标志位 flags 详解：IRQF_TRIGGER_RISING、IRQF_TRIGGER_FALLING、IRQF_SHARED、IRQF_ONESHOT 等

在 Linux 中断子系统中，request_irq() / devm_request_irq() 的第三个参数 unsigned long flags 是决定中断行为的关键。flags 由一组位掩码组合而成，控制中断的触发方式、共享策略、电源管理行为以及线程化安全。理解每个标志位的语义和组合约束，是中断驱动移植与调试的基础。

4.1 flags 位域总览

flags 的低 4 位用于触发方式，高 28 位用于行为控制。下表列出最常用的标志位及其内核宏定义值：

4.2 触发方式标志位详解

4.2.1 IRQF_TRIGGER_RISING 与 IRQF_TRIGGER_FALLING

边沿触发（Edge-triggered）在信号电平跳变时产生中断。上升沿触发在信号从低到高时触发一次；下降沿触发在信号从高到低时触发一次。边沿触发的特点是：

• 锁存性：中断控制器会锁存边沿事件，即使 CPU 暂时屏蔽中断，事件也不会丢失。
• 防抖需求：机械开关或噪声较大的信号线容易产生毛刺，导致多次误触发。
• 共享限制：边沿触发的中断线原则上不能共享（除非硬件支持电平检测回读）。

4.2.2 IRQF_TRIGGER_HIGH 与 IRQF_TRIGGER_LOW

电平触发（Level-triggered）在信号保持有效电平时持续产生中断请求。高电平触发在信号为高时有效；低电平触发在信号为低时有效。电平触发的特点是：

• 持续请求：只要电平有效，中断线就一直保持断言状态。
• 必须清除：中断服务程序必须操作外设寄存器清除中断源，否则会无限循环触发。
• 共享友好：电平触发天然支持中断共享，因为中断控制器可以通过读取设备状态寄存器判断哪个设备产生了中断。

4.3 IRQF_SHARED：中断共享机制

当多个外设共用一条物理 IRQ 线时，必须设置 IRQF_SHARED。共享中断的驱动必须满足以下契约：

1. 注册顺序无关：每个共享中断处理程序都会被依次调用。
2. 必须检查设备状态：处理程序第一件事是读取硬件寄存器，确认中断是否来自本设备。如果不是，立即返回 IRQ_NONE。
3. 触发方式必须一致：所有共享该 IRQ 的驱动必须使用相同的触发方式（通常为电平触发）。
4. 不能使用 IRQF_ONESHOT：共享中断与 ONESHOT 不兼容，因为 ONESHOT 会永久屏蔽中断线直到线程完成，导致其他设备无法接收中断。

4.4 IRQF_ONESHOT：线程化中断的安全屏障

IRQF_ONESHOT 是线程化中断（threaded IRQ）的关键标志。当驱动使用 request_threaded_irq() 并只提供线程处理函数时，内核会自动添加 IRQF_ONESHOT。其行为如下：

• 中断线屏蔽：在中断线程处理函数执行期间，硬件中断线被自动屏蔽，防止同一中断源嵌套触发。
• 自动恢复：线程处理函数返回后，内核自动取消屏蔽，恢复中断线。
• 避免死锁：防止线程处理函数中访问共享资源时被同一中断再次打断，导致自旋锁死锁。

以下是一个典型的线程化中断注册示例：

/* 设备结构体 */
struct my_dev {
    int irq;
    void __iomem *base;
    struct completion done;
};

/* 中断线程处理函数 */
static irqreturn_t my_threaded_handler(int irq, void *dev_id)
{
    struct my_dev *dev = dev_id;
    u32 status;

    /* 读取状态寄存器确认中断源 */
    status = ioread32(dev->base + REG_STATUS);
    if (!(status & INT_PENDING))
        return IRQ_NONE;

    /* 清除中断标志 */
    iowrite32(INT_PENDING, dev->base + REG_CLEAR);

    /* 执行耗时的数据处理 */
    process_data(dev);

    complete(&dev->done);
    return IRQ_HANDLED;
}

/* 驱动 probe 函数中注册 */
static int my_probe(struct platform_device *pdev)
{
    struct my_dev *dev;
    int ret;

    dev = devm_kzalloc(&pdev->dev, sizeof(*dev), GFP_KERNEL);
    dev->irq = platform_get_irq(pdev, 0);

    /* 注册线程化中断，内核自动添加 IRQF_ONESHOT */
    ret = devm_request_threaded_irq(&pdev->dev, dev->irq,
                                    NULL,  /* 无顶半部 */
                                    my_threaded_handler,
                                    IRQF_TRIGGER_HIGH | IRQF_ONESHOT,
                                    "my_driver", dev);
    if (ret) {
        dev_err(&pdev->dev, "failed to request threaded irq\n");
        return ret;
    }

    return 0;
}

4.5 标志位组合约束与工程陷阱

不同标志位之间存在互斥或依赖关系，驱动工程师必须熟记以下约束：

4.6 中断标志位选择决策流程

以下 SVG 流程图帮助驱动工程师在编写代码时快速确定 flags 组合：

4.7 实战：flags 组合代码模板

以下代码模板展示了不同场景下的 flags 组合方式，可直接用于驱动移植：

/* 场景1：非共享、边沿触发、顶半部处理 */
ret = request_irq(irq, handler,
                  IRQF_TRIGGER_RISING,
                  "my_device_edge", dev);

/* 场景2：共享中断、电平触发、顶半部处理 */
ret = request_irq(irq, shared_handler,
                  IRQF_TRIGGER_HIGH | IRQF_SHARED,
                  "my_device_shared", dev);

/* 场景3：非共享、电平触发、线程化处理（带ONESHOT） */
ret = request_threaded_irq(irq, NULL,
                           threaded_handler,
                           IRQF_TRIGGER_LOW | IRQF_ONESHOT,
                           "my_device_threaded", dev);

/* 场景4：唤醒源、边沿触发、线程化处理 */
ret = devm_request_threaded_irq(&pdev->dev, irq,
                                NULL, wakeup_handler,
                                IRQF_TRIGGER_FALLING |
                                IRQF_ONESHOT |
                                IRQF_NO_SUSPEND,
                                "my_wakeup", dev);
/* 同时使能设备唤醒 */
device_init_wakeup(&pdev->dev, true);

4.8 中断标志位与设备树的映射关系

设备树中通过 interrupts 属性指定触发类型，驱动中通过 irq_get_trigger_type() 获取。下表列出设备树宏与内核 flags 的对应关系：

推荐在驱动中动态获取触发方式，避免硬编码：

unsigned long irq_flags;

/* 从设备树获取触发类型 */
irq_flags = irq_get_trigger_type(dev->irq);

/* 添加其他行为标志 */
irq_flags |= IRQF_ONESHOT | IRQF_NO_SUSPEND;

ret = devm_request_threaded_irq(&pdev->dev, dev->irq,
                                NULL, handler,
                                irq_flags, "my_driver", dev);