3. Linux内核PHY驱动框架：phylib架构、phy_device与phy_driver结构体、phy_state状态机

Linux内核的PHY（Physical Layer）驱动管理经历了从分散实现到统一框架的演进。phylib（PHY Library）的出现，为网络设备驱动开发者提供了一套标准化的PHY设备抽象、驱动注册与状态管理机制。理解phylib的架构、核心数据结构以及状态机，是进行PHY寄存器配置与调试的基础。

3.1 phylib架构概述

phylib位于内核网络子系统的MAC层与物理PHY芯片之间，主要承担以下职责：

• 抽象PHY设备：将不同厂商、不同型号的PHY芯片统一表示为phy_device结构体。
• 管理PHY驱动：通过phy_driver结构体封装PHY芯片的初始化、配置、链路状态监测等操作。
• 维护状态机：自动轮询PHY状态，处理链路建立、断开、协商等事件。
• 提供通用接口：为MAC驱动提供phy_start、phy_stop、phy_read、phy_write等标准API。

3.2 phy_device 结构体

phy_device是phylib中描述一个物理PHY芯片的核心数据结构。它包含了PHY的标识、能力、状态、连接方式以及回调函数等信息。该结构体定义在include/linux/phy.h中。

3.3 phy_driver 结构体

phy_driver结构体封装了针对特定PHY芯片或系列的操作函数。每个PHY驱动需要实现一组回调，phylib核心在状态机运行过程中会调用这些回调来配置PHY寄存器。

struct phy_driver {
    u32 phy_id;                     /* PHY芯片ID掩码匹配值 */
    char *name;                     /* 驱动名称 */
    unsigned int phy_id_mask;       /* ID掩码，用于匹配 */
    u32 features;                   /* 该驱动支持的固定能力 */

    /* 核心回调函数 */
    int (*config_init)(struct phy_device *phydev);      /* PHY初始化配置 */
    int (*soft_reset)(struct phy_device *phydev);       /* 软复位 */
    int (*config_aneg)(struct phy_device *phydev);      /* 配置自动协商 */
    int (*aneg_done)(struct phy_device *phydev);        /* 检查协商是否完成 */
    int (*read_status)(struct phy_device *phydev);      /* 读取链路状态 */
    int (*config_intr)(struct phy_device *phydev);      /* 配置中断 */
    int (*did_interrupt)(struct phy_device *phydev);    /* 检查中断源 */
    void (*link_change_notify)(struct phy_device *phydev); /* 链路变化通知 */

    /* 寄存器直接读写（通常由phylib核心提供默认实现） */
    int (*read_mmd)(struct phy_device *phydev, int devad, u32 regnum);
    int (*write_mmd)(struct phy_device *phydev, int devad, u32 regnum, u16 val);

    struct device_driver driver;    /* 内核驱动基类 */
};

3.4 phy_state 状态机

phylib核心维护了一个有限状态机（FSM），用于管理PHY从初始化到正常工作的完整生命周期。状态机定义在include/linux/phy.h中的enum phy_state枚举。

enum phy_state {
    PHY_DOWN = 0,       /* PHY未启动或已停止 */
    PHY_READY,          /* PHY已初始化，准备启动 */
    PHY_HALTED,         /* PHY被暂停（如电源管理） */
    PHY_ERROR,          /* PHY发生错误 */
    PHY_UP,             /* PHY已启动，开始自动协商 */
    PHY_RUNNING,        /* PHY链路已建立，正常运行 */
    PHY_NOLINK,         /* PHY已启动但无链路 */
    PHY_CABLETEST,      /* PHY正在执行电缆测试 */
};

3.5 状态机关键转换路径

在实际工程中，以下三条状态转换路径最为常见：

1. 正常启动路径：PHY_DOWN → PHY_READY → PHY_UP → PHY_AN → PHY_RUNNING
   • MAC驱动调用phy_start()触发。
   • 自动协商成功后直接进入PHY_RUNNING。
2. 链路断开恢复路径：PHY_RUNNING → PHY_NOLINK → PHY_AN → PHY_RUNNING
   • 网线拔出时进入PHY_NOLINK，插入后重新协商。
   • 此路径中read_status回调会被频繁调用。
3. 错误恢复路径：PHY_RUNNING → PHY_ERROR → PHY_DOWN → PHY_READY → ...
   • MDIO通信超时或PHY芯片异常时触发。
   • 需要驱动层实现soft_reset回调进行恢复。

3.6 phylib核心API与驱动注册

PHY驱动的注册与注销通过以下宏完成：

/* 注册PHY驱动 */
int phy_driver_register(struct phy_driver *new_driver, struct module *owner);
void phy_driver_unregister(struct phy_driver *drv);

/* 便捷宏：模块加载/卸载时批量注册 */
module_phy_driver(phy_drivers);

一个典型的PHY驱动模块结构如下：

static struct phy_driver my_phy_driver = {
    .phy_id         = 0x01410cc0,   /* 特定PHY的ID */
    .name           = "My PHY",
    .phy_id_mask    = 0xfffffff0,   /* 掩码匹配 */
    .features       = PHY_GBIT_FEATURES | SUPPORTED_Pause,
    .config_init    = my_phy_config_init,
    .config_aneg    = genphy_config_aneg,  /* 使用通用协商配置 */
    .read_status    = my_phy_read_status,
    .soft_reset     = genphy_soft_reset,
};

module_phy_driver(my_phy_driver);

3.7 调试实践：状态机与寄存器联动分析

当PHY无法建立链路时，结合状态机与寄存器值可以快速定位问题：