Linux-RGMII PHY 88E1512 双模式驱动适配与调试实战
1. 认识88E1512 PHY芯片与RGMII接口
第一次接触88E1512这颗PHY芯片是在一个工业网关项目上，当时我们需要在AM5728平台上实现双网口功能。Marvell的88E1512确实是个很有意思的芯片，它支持RGMII-to-Copper和RGMII-to-SGMII两种工作模式，相当于一颗PHY能当两颗用。RGMII接口大家应该不陌生，这是目前嵌入式系统中最常见的MAC-PHY接口标准之一，全称Reduced Gigabit Media Independent Interface。
RGMII和SGMII的区别很有意思。简单来说，RGMII就像是双向四车道的高速公路，数据线和时钟线分开传输；而SGMII更像是单车道但速度更快的隧道。在实际项目中，RGMII接口最大的特点就是它只需要12根信号线（相比GMII的24根少了一半），但代价是需要精确的时序控制。我记得有一次调试时，就因为PCB走线长度差了几毫米，导致网络时通时断，后来加了时序补偿才解决。
88E1512的灵活之处在于它的模式切换功能。通过配置寄存器，我们可以让它工作在不同的模式：
- RGMII-to-Copper模式：直接连接RJ45网口
- RGMII-to-SGMII模式：可以对接其他交换芯片 这种设计特别适合需要多种网络接口的场景，比如我们的网关就需要同时连接本地设备和上级网络。
2. 硬件环境搭建与设备树配置
在AM5728平台上使用88E1512，第一步就是要正确配置设备树。创龙的AM5728开发板默认使用的是KSZ9031 PHY，所以我们需要针对88E1512做一些调整。设备树配置中最关键的几个参数是：
&cpsw_emac0 { phy-mode = "rgmii-id"; phy-handle = <&phy0>; dual_emac_res_vlan = <1>; }; &cpsw_emac1 { phy-mode = "rgmii-id"; phy-handle = <&phy1>; dual_emac_res_vlan = <2>; };这里有个容易踩坑的地方：rgmii-id和rgmii的区别。前者表示RX/TX的延时都由PHY来补偿，后者则需要MAC来补偿。我们项目里用的是rgmii-id，所以后面还需要关闭AM5728内部的延时补偿功能。
为了让驱动能区分两种工作模式，我添加了一个自定义属性：
phy0: phy@0 { reg = <0>; operating-mode = <0>; /* 0 for RGMII-to-Copper */ }; phy1: phy@1 { reg = <1>; operating-mode = <2>; /* 2 for RGMII-to-SGMII */ };这个operating-mode属性后面会在驱动中用到。配置设备树时还要注意检查PHY的地址是否正确，88E1512通常是通过硬件引脚配置地址的，如果地址不对，后面怎么调试都没用。
3. 驱动修改与模式切换实现
驱动修改是整个过程的核心部分。88E1512使用的是Marvell的通用PHY驱动，源码在drivers/net/phy/marvell.c中。我们需要修改的主要是m88e1510_config_init函数。
先来看看关键的寄存器操作流程：
- 选择Page 18（88E1512的功能配置寄存器都在这个页面）
- 修改Register 20的MODE[2:0]字段
- 执行软复位使配置生效
具体代码实现如下：
static int m88e1510_config_init(struct phy_device *phydev) { int err, temp; u32 mode_num; struct device_node *np = phydev->mdio.dev.of_node; /* 读取设备树中的operating-mode属性 */ if (of_property_read_u32(np, "operating-mode", &mode_num)) { dev_err(&phydev->mdio.dev, "missing operating-mode property\n"); return -EINVAL; } if (mode_num == 0) { /* RGMII-to-Copper模式 */ dev_info(&phydev->mdio.dev, "Configuring RGMII-to-Copper mode\n"); /* 切换到Page 18 */ err = phy_write(phydev, MII_MARVELL_PHY_PAGE, 18); if (err < 0) return err; /* 配置MODE[2:0]为0x0 */ temp = phy_read(phydev, MII_88E1510_GEN_CTRL_REG_1); temp &= ~MII_88E1510_GEN_CTRL_REG_1_MODE_MASK; temp |= MII_88E1510_GEN_CTRL_REG_1_MODE_RGMII_TO_COPPER; err = phy_write(phydev, MII_88E1510_GEN_CTRL_REG_1, temp); if (err < 0) return err; /* 软复位 */ temp |= MII_88E1510_GEN_CTRL_REG_1_RESET; return phy_write(phydev, MII_88E1510_GEN_CTRL_REG_1, temp); } else if (mode_num == 2) { /* RGMII-to-SGMII模式 */ dev_info(&phydev->mdio.dev, "Configuring RGMII-to-SGMII mode\n"); /* 类似上面的流程，但MODE[2:0]设为0x4 */ err = phy_write(phydev, MII_MARVELL_PHY_PAGE, 18); if (err < 0) return err; temp = phy_read(phydev, MII_88E1510_GEN_CTRL_REG_1); temp &= ~MII_88E1510_GEN_CTRL_REG_1_MODE_MASK; temp |= MII_88E1510_GEN_CTRL_REG_1_MODE_RGMII_TO_1000BASE_X; err = phy_write(phydev, MII_88E1510_GEN_CTRL_REG_1, temp); if (err < 0) return err; temp |= MII_88E1510_GEN_CTRL_REG_1_RESET; return phy_write(phydev, MII_88E1510_GEN_CTRL_REG_1, temp); } return m88e1121_config_init(phydev); }调试这个功能时我遇到一个典型问题：修改配置后网络不工作。后来发现是忘记执行软复位了。88E1512的寄存器修改后必须通过软复位才能生效，这个细节在数据手册里虽然写了，但很容易被忽略。
4. 文件系统辅助工具与调试技巧
驱动加载成功后，还需要一些用户空间的配置才能让整个系统正常工作。特别是对于RGMII-to-SGMII模式的PHY1，还需要额外的配置：
- 使用mdio工具切换PHY页面：
mdio eth1 22 1 # 切换到Fiber Page这个命令的作用是让MAC能正确读取PHY的链路状态。因为默认情况下PHY会报告Copper Page的状态，而我们的PHY1连接的是SGMII接口。
- LED配置也很重要。在我们的硬件设计中，PHY1的LED1引脚还被用作PPS输入。如果不配置为高阻态，会影响PPS信号质量：
mdio eth1 22 3 mdio eth1 16 0xa0 # 配置LED1为Hi-Z模式- 关闭AM5728内部的RGMII延时补偿。因为我们使用的是
rgmii-id模式，延时补偿已经在PHY侧完成：
devmem2 0x4A002558 w 0x00000000调试PHY时，有几个实用技巧值得分享：
- 环回测试：88E1512支持内部环回，可以用来快速验证PHY到MAC的链路是否正常
# 设置环回模式 mdio eth0 0 16 0x4000 # 测试发包 ping -I eth0 192.168.1.1 # 恢复普通模式 mdio eth0 0 16 0x0000- 统计计数器：PHY和MAC都有丰富的统计寄存器，可以查看收发包数量、错误计数等
# 查看PHY的统计信息 ethtool -S eth0- 信号质量检查：用示波器测量RGMII时钟信号的质量，确保眼图符合要求。我们曾经遇到过因为时钟信号抖动太大导致网络性能下降的问题。
5. 常见问题排查与解决方案
在实际项目中，调试88E1512遇到问题在所难免。下面分享几个典型问题及其解决方法：
问题1：PHY无法被识别
- 检查MDIO总线是否正常：
mdio eth0 0 0应该能读取到PHY ID - 确认PHY地址正确，88E1512的地址由硬件引脚决定
- 测量PHY的电源和复位信号是否正常
问题2：链路时通时断
- 检查RGMII时序，特别是TX/RX时钟的相位关系
- 确认延时补偿配置正确（PHY或MAC一侧补偿，不要两边都补偿）
- 用示波器检查信号完整性，排除PCB设计问题
问题3：RGMII-to-SGMII模式不工作
- 确认对端设备（交换芯片）的SGMII配置正确
- 检查PHY是否成功切换到Fiber Page
- 验证SGMII的自动协商是否完成
问题4：网络性能不达标
- 检查DMA配置，确保MAC的DMA缓冲区足够大
- 使用
ethtool -k eth0检查offload功能是否启用 - 测量系统负载，排除CPU性能瓶颈
调试时的一个好习惯是保存各种状态的寄存器快照。我通常会记录以下信息：
- PHY的基本控制寄存器（Reg 0）
- 特定模式的配置寄存器（如Page 18的Reg 20）
- 中断状态寄存器
- 统计计数器值
当问题出现时，对比正常状态和异常状态的寄存器值，往往能快速定位问题根源。例如，有一次我们发现网络会随机断开，通过对比寄存器发现是自动协商被意外改动了，最终追踪到是某个驱动在错误地重置PHY。