2. 中断基础：Linux中断子系统架构、中断号、中断处理函数注册

在Linux网络驱动中，中断是硬件通知软件“有事发生”的核心机制。对于PHY链路检测而言，链路状态变化（Link Up/Down）正是通过中断信号从PHY芯片传递到CPU，进而触发驱动执行链路重协商、状态更新等操作。理解中断子系统是掌握网络驱动协同工作的前提。

2.1 Linux中断子系统整体架构

Linux中断子系统采用分层设计，从上到下依次为：中断处理函数层、中断分发层、硬件中断控制器层。这种分层使得驱动开发者只需关注上层API，而无需关心底层中断控制器的具体实现。

2.2 中断号：从硬件到软件的桥梁

中断号是中断子系统中最核心的标识符。在Linux中，中断号分为两个层次：硬件中断号（HW IRQ Number）和Linux IRQ号（Virtual IRQ Number）。驱动开发中，我们通常操作的是Linux IRQ号。

2.3 中断处理函数注册：request_irq

request_irq() 是Linux驱动中最经典的中断注册函数，用于注册一个顶半部（Top Half）中断处理函数。顶半部在中断上下文中执行，要求快速、不可睡眠。

int request_irq(unsigned int irq,
                irq_handler_t handler,
                unsigned long flags,
                const char *name,
                void *dev_id);

2.4 线程化中断：request_threaded_irq

对于PHY链路检测这类需要执行耗时操作（如MDIO读写、状态机切换）的中断场景，顶半部显然不合适。Linux提供了线程化中断（Threaded IRQ）机制，将中断处理分为：

• 顶半部（handler）：在中断上下文中快速执行，返回 IRQ_WAKE_THREAD 唤醒线程。
• 线程化处理函数（thread_fn）：在进程上下文中执行，可以睡眠、可以持有锁、可以调用 phy_read() 等耗时函数。

int request_threaded_irq(unsigned int irq,
                         irq_handler_t handler,
                         irq_handler_t thread_fn,
                         unsigned long flags,
                         const char *name,
                         void *dev_id);

2.5 request_irq vs request_threaded_irq 对比

2.6 中断注册实战：PHY中断示例

以下代码展示了在PHY驱动中注册线程化中断的典型模式：

/* PHY中断顶半部：快速确认中断源 */
static irqreturn_t phy_interrupt_handler(int irq, void *dev_id)
{
    struct phy_device *phydev = dev_id;

    /* 读取中断状态寄存器，确认中断是否来自本PHY */
    int irq_status = phy_read(phydev, MII_INT_STATUS);
    if (irq_status & PHY_INT_LINK_CHANGE) {
        /* 清除中断标志 */
        phy_write(phydev, MII_INT_STATUS, irq_status);
        return IRQ_WAKE_THREAD;  /* 唤醒线程化处理 */
    }

    return IRQ_NONE;  /* 非本设备中断 */
}

/* PHY中断线程化处理：执行链路状态检测 */
static irqreturn_t phy_link_change_thread(int irq, void *dev_id)
{
    struct phy_device *phydev = dev_id;

    /* 在进程上下文中读取PHY状态寄存器 */
    int bmsr = phy_read(phydev, MII_BMSR);
    int lpa  = phy_read(phydev, MII_LPA);

    /* 更新链路状态 */
    if (bmsr & BMSR_LSTATUS) {
        netif_carrier_on(phydev->attached_dev);
        phydev->link = 1;
    } else {
        netif_carrier_off(phydev->attached_dev);
        phydev->link = 0;
    }

    /* 触发上层状态机 */
    phy_state_machine(phydev);

    return IRQ_HANDLED;
}

/* 中断注册（在PHY驱动probe函数中调用） */
int phy_request_irq(struct phy_device *phydev)
{
    int ret;

    ret = request_threaded_irq(phydev->irq,
                               phy_interrupt_handler,      /* 顶半部 */
                               phy_link_change_thread,     /* 线程化函数 */
                               IRQF_TRIGGER_LOW | IRQF_SHARED,
                               "phy_link_irq",
                               phydev);
    if (ret)
        dev_err(&phydev->mdio.dev, "Failed to request PHY IRQ\n");

    return ret;
}

2.7 中断释放与注意事项

在驱动卸载或PHY设备移除时，必须释放已注册的中断：

void phy_free_irq(struct phy_device *phydev)
{
    if (phydev->irq >= 0)
        free_irq(phydev->irq, phydev);
}

中断注册与释放的注意事项：

• 中断号有效性检查：注册前确认 phydev->irq 不为 0 或负数。
• 共享中断的dev_id：使用 IRQF_SHARED 标志时，dev_id 必须唯一且非NULL，用于 free_irq() 时区分。
• 中断触发类型匹配：PHY芯片的中断触发类型（电平/边沿）必须与设备树或平台数据一致，否则可能导致中断丢失或风暴。
• 禁止在顶半部调用phy_read：MDIO总线操作可能睡眠，必须放在线程化函数中。