Linux MDIO子系统核心数据结构与驱动开发解析

1. Linux MDIO子系统核心数据结构解析

在Linux网络设备驱动开发中，MDIO（Management Data Input/Output）子系统扮演着至关重要的角色。作为连接MAC控制器和PHY芯片的桥梁，MDIO总线负责管理和配置物理层设备。本文将深入剖析MDIO子系统中的三大核心数据结构：mii_bus、phy_device和phy_driver，揭示它们的设计哲学和实现细节。

1.1 struct mii_bus：MDIO总线的软件抽象

struct mii_bus是内核中对MDIO总线控制器的软件抽象，相当于一个交通指挥中心，负责协调总线上所有PHY设备的通信。这个结构体定义在include/linux/phy.h中，包含了管理物理MDIO总线所需的所有信息和操作接口。

1.1.1 关键字段解析

总线操作函数指针：

c复制int (*read)(struct mii_bus *bus, int addr, int regnum);
int (*write)(struct mii_bus *bus, int addr, int regnum, u16 val);

这两个函数指针是MDIO控制器的核心，相当于总线的"读写能力"。驱动开发者必须实现这两个函数，它们将高层MDIO请求转换为具体的硬件寄存器操作。例如，在Marvell的88E1111 PHY驱动中，read函数最终会操作SoC的MDIO控制寄存器来完成实际的数据读取。

总线状态管理：

c复制enum {
    MDIOBUS_ALLOCATED = 1,
    MDIOBUS_REGISTERED,
    MDIOBUS_UNREGISTERED,
    MDIOBUS_RELEASED,
} state;

这个枚举类型跟踪总线的生命周期状态，确保总线在被使用时不会被意外释放。内核通过状态检查来防止竞态条件的发生。

设备映射表：

c复制struct mdio_device *mdio_map[PHY_MAX_ADDR];

这是一个重要的数组，保存了总线上每个可能地址（0-31）对应的设备指针。当我们在地址5发现一个PHY时，mdio_map[5]就会指向对应的phy_device结构。

1.1.2 实际应用示例

在编写MDIO控制器驱动时，开发者需要完成以下关键步骤：

1. 分配mii_bus结构体：

c复制struct mii_bus *bus = mdiobus_alloc();
if (!bus)
    return -ENOMEM;

2. 设置总线参数和操作函数：

c复制bus->name = "my_mdio_bus";
bus->read = my_mdio_read;
bus->write = my_mdio_write;
bus->parent = &pdev->dev;

3. 注册总线到MDIO子系统：

c复制err = mdiobus_register(bus);
if (err) {
    mdiobus_free(bus);
    return err;
}

注意：在实现read/write函数时，必须处理好并发访问问题。内核已经提供了mdio_lock互斥锁，但硬件层面的原子性仍需驱动开发者保证。

1.2 struct phy_device：PHY设备的完整描述

struct phy_device代表一个具体的PHY芯片实例，相当于每个网络设备的"身份证"和"健康档案"。它不仅记录PHY的静态信息（如厂商ID、型号），还维护动态状态（如链路状态、速度等）。

1.2.1 关键字段深度解读

标识信息：

c复制u32 phy_id;
struct phy_c45_device_ids c45_ids;
unsigned is_c45:1;

phy_id是PHY的身份证号，由两个16位寄存器组成（ID1和ID2）。对于符合IEEE 802.3 Clause 45标准的PHY，is_c45标志会被设置，此时c45_ids将包含更详细的设备信息。

链路状态信息：

c复制unsigned link:1;
int speed;
int duplex;

这些字段反映了PHY的当前连接状态。link表示是否有物理连接，speed和duplex记录协商结果（如SPEED_1000、DUPLEX_FULL）。驱动需要定期更新这些状态，通常通过轮询或中断实现。

能力描述：

c复制__ETHTOOL_DECLARE_LINK_MODE_MASK(supported);
__ETHTOOL_DECLARE_LINK_MODE_MASK(advertising);

这两个位掩码分别表示PHY支持的能力和当前广告的能力。例如，当PHY支持1000BaseT全双工时，会在supported掩码中设置相应的位。

1.2.2 PHY状态机解析

phy_device内部维护了一个状态机，通过state字段表示当前状态：

c复制enum phy_state {
    PHY_DOWN = 0,
    PHY_READY,
    PHY_HALTED,
    PHY_UP,
    PHY_RUNNING,
    PHY_NOLINK,
    PHY_FORCING,
    PHY_CHANGELINK,
    PHY_HALTED,
    PHY_RESUMING
};

典型的状态转移过程如下：

1. PHY_DOWN：设备未初始化
2. PHY_READY：基本配置完成，准备启动
3. PHY_UP：接口已启动，但链路未建立
4. PHY_RUNNING：链路已建立，数据传输中

经验分享：调试PHY状态问题时，可以通过phy_state_to_str()函数将state转换为可读字符串，方便日志记录。

1.3 struct phy_driver：PHY设备的操作集合

struct phy_driver定义了针对特定PHY芯片的操作方法，相当于PHY的"驱动程序接口规范"。每个PHY型号都需要一个对应的phy_driver实现。

1.3.1 驱动匹配机制

PHY驱动通过以下字段识别支持的设备：

c复制u32 phy_id;
u32 phy_id_mask;

匹配过程实际上是检查(phydev->phy_id & phy_id_mask) == phy_id。这种设计允许一个驱动支持多个相似型号的PHY芯片。

例如，Realtek 8211F系列驱动的配置：

c复制static struct phy_driver realtek_drvs[] = {
    {
        .phy_id         = 0x001cc916,
        .phy_id_mask    = 0x001fffff,
        .name           = "Realtek RTL8211F Gigabit Ethernet",
        /* 操作函数 */
    }
};

这里phy_id_mask的低21位被置1，表示只关心PHY ID的前21位，这样同一个驱动可以支持RTL8211F及其衍生型号。

1.3.2 关键操作函数解析

配置与状态读取：

c复制int (*config_init)(struct phy_device *phydev);
int (*read_status)(struct phy_device *phydev);

config_init用于初始化PHY的默认配置，而read_status则读取当前链路状态。几乎所有PHY驱动都必须实现这两个函数。

自动协商处理：

c复制int (*config_aneg)(struct phy_device *phydev);
int (*aneg_done)(struct phy_device *phydev);

自动协商是以太网PHY确定最佳连接参数的过程。config_aneg配置协商参数，aneg_done检查协商是否完成。

中断处理：

c复制int (*config_intr)(struct phy_device *phydev);
irqreturn_t (*handle_interrupt)(struct phy_device *phydev);

现代PHY通常支持中断来通知链路状态变化，这些函数负责中断的配置和处理。

1.3.3 驱动注册实践

注册PHY驱动的标准做法是使用module_phy_driver宏：

c复制module_phy_driver(realtek_drvs);

MODULE_DESCRIPTION("Realtek PHY driver");
MODULE_AUTHOR("Author Name");
MODULE_LICENSE("GPL");

这个宏会自动生成模块的init和exit函数，简化了驱动开发流程。

2. MDIO子系统数据结构交互关系

2.1 三大结构体的协作流程

图3展示了mii_bus、phy_device和phy_driver之间的关系。我们可以用一个公司的管理架构来类比：

• mii_bus：公司的部门经理，负责协调资源
• phy_device：员工个人档案，记录状态和能力
• phy_driver：岗位说明书，定义工作规范

具体交互过程如下：

1. 系统启动时，MDIO控制器驱动创建并注册mii_bus
2. 总线扫描期间，为每个探测到的PHY创建phy_device
3. 根据phy_device的ID匹配对应的phy_driver
4. 将phy_device与phy_driver绑定，完成初始化

2.2 典型代码执行路径

以读取PHY寄存器为例，调用栈如下：

1. phy_read() → 通用PHY接口
2. phydev->bus->read() → 调用mii_bus的读函数
3. 控制器驱动实现的read() → 操作硬件寄存器
4. 结果通过phy_device返回给调用者

调试技巧：在MDIO操作失败时，可以通过ftrace捕获完整的调用栈，帮助定位问题层次。

3. 高级特性与最佳实践

3.1 Clause 22与Clause 45支持

IEEE 802.3定义了两种MDIO规范：

• Clause 22：传统5位地址空间，适合简单PHY
• Clause 45：扩展的32位地址空间，支持更多功能

现代驱动通常需要同时支持两种模式。phy_device中的is_c45标志指示设备使用的模式，驱动应根据此标志调整访问方式。

3.2 电源管理实现

PHY驱动需要实现suspend/resume回调以支持电源管理：

c复制static int phy_suspend(struct phy_device *phydev)
{
    /* 保存关键寄存器值 */
    /* 配置低功耗模式 */
    return 0;
}

static int phy_resume(struct phy_device *phydev)
{
    /* 恢复寄存器配置 */
    /* 重新启动自动协商 */
    return 0;
}

3.3 调试与性能优化

调试技巧：

1. 通过phy_register_fixup()注册修复函数，解决硬件兼容性问题
2. 使用ethtool -d查看PHY寄存器dump
3. 检查/sys/kernel/debug/mdio_bus/下的调试信息

性能优化：

1. 启用中断模式而非轮询，减少CPU开销
2. 合理设置状态检查间隔（phydev->state_queue.delay）
3. 对于频繁访问的寄存器，考虑实现缓存机制

4. 常见问题与解决方案

4.1 PHY探测失败排查步骤

1. 确认MDIO总线已正确注册（检查/sys/bus/mdio_bus/devices）
2. 验证物理连接和电源
3. 检查read/write函数是否能正确访问PHY
4. 确认PHY地址设置正确（不冲突且未被phy_mask排除）

4.2 链路不稳定问题处理

1. 检查电缆质量和连接器状态
2. 验证自动协商配置（强制模式与协商模式）
3. 调整PHY的LED配置寄存器，获取更多状态信息
4. 检查电源噪声和参考时钟质量

4.3 驱动匹配问题解决

当驱动未能正确绑定到PHY时：

1. 确认phy_id和phy_id_mask设置正确
2. 检查内核是否编译了对应驱动
3. 通过phy_id = phy_read(phydev, MII_PHYSID1)获取实际PHY ID
4. 考虑使用device tree明确指定驱动

在实际项目中，我曾遇到过一个典型案例：某定制板卡的PHY无法被识别。通过分析发现，硬件设计将PHY地址配置为8，而驱动默认只探测0-7地址。通过在设备树中添加明确的PHY节点并指定地址，最终解决了这个问题。