RK3576平台RTL8111HS网络指示灯不亮问题排查与修复

1. 问题背景与现象描述

最近在RK3576平台上调试PCIe转以太网芯片RTL8111HS时遇到一个典型问题：网络通信功能完全正常，但电路板上的网络状态指示灯（LED0和LED1）始终不亮。这种情况在实际硬件调试中并不少见，但排查过程往往需要结合芯片手册、驱动代码和硬件设计三方面知识。

RTL8111HS是Realtek推出的一款高性能PCIe千兆以太网控制器芯片，广泛应用于嵌入式系统和工业设备。其指示灯控制逻辑主要通过CustomLED寄存器（Offset 0x18）实现。正常情况下，LED应该根据网络状态（连接、活动、速度等）显示不同状态，但当前完全无反应。

提示：网络指示灯不亮但通信正常的情况，90%的问题出在LED控制寄存器配置或驱动实现上，而非物理电路故障。

2. 芯片LED控制机制深度解析

2.1 RTL8111HS的LED控制架构

RTL8111HS芯片提供两组LED输出（LED0和LED1），其行为由以下要素共同决定：

1. CustomLED寄存器（0x18）：主控制寄存器，定义LED模式
2. PHY寄存器页：需要通过Page Select寄存器切换
3. EEPROM/EFUSE配置：存储厂商预定义的LED行为
4. 驱动配置：Linux内核中的r8168驱动实现

芯片上电后的初始化流程为：

1. 从EEPROM/EFUSE加载默认配置
2. 驱动读取并应用配置
3. 运行时根据网络状态更新LED

2.2 关键寄存器详解

CustomLED寄存器（Offset 0x18）

Page Select寄存器（Offset 0x1F）

PHY寄存器采用分页机制，LED控制需要切换到特定页面：

• Page 0x0A：LED控制相关
• Page 0x0B：扩展功能设置

3. 问题排查与修复过程

3.1 驱动代码问题定位

在分析官方r8168驱动（版本8.051.02）时，发现以下关键问题点：

文件：r8168_n.c (约7675行)

c复制// 修改前的问题代码
val = phy_read(phydev, MII_LED_CTRL_REG);
phy_write(phydev, MII_LED_CTRL_REG, val | LED_CFG_MASK);

这段代码存在两个问题：

1. val已经是读取好的寄存器值，但后续又通过宏重复读取
2. 未考虑PHY寄存器分页机制，直接操作可能指向错误页面

修正后的代码：

c复制// 修改后的正确实现
phy_write(phydev, MII_PAGE_SELECT, LED_CTRL_PAGE); // 先切换页面
val = phy_read(phydev, MII_LED_CTRL_REG);
phy_write(phydev, MII_LED_CTRL_REG, val | LED_CFG_MASK);
phy_write(phydev, MII_PAGE_SELECT, DEFAULT_PAGE);  // 恢复默认页

3.2 强制配置CustomLED寄存器

由于EEPROM中的默认配置可能不适用当前硬件设计，需要在驱动初始化时强制写入配置：

c复制// 在rtl8168_init_phy()函数中添加
rtl_ephy_write(tp, 0x1F, 0x0A); // 切换到LED控制页
rtl_ephy_write(tp, 0x18, 0x3170); // LED0: Link+Activity, LED1: Speed
rtl_ephy_write(tp, 0x1F, 0x00); // 恢复默认页

关键参数说明：

• 0x3170 = 0b0011000101110000
  • LED0模式：0011（Link + Activity）
  • LED1模式：0001（10/100M速度指示）
  • 软件控制位：1

4. 完整解决方案实施

4.1 驱动修改步骤

1. 获取驱动源码：

   bash复制git clone https://github.com/realtek/r8168
   cd r8168
   

2. 修改关键代码段：

   • 修复PHY寄存器访问逻辑
   • 添加CustomLED强制配置

3. 编译并安装：

   bash复制make clean
   make
   sudo make install
   sudo depmod -a
   sudo modprobe r8168
   

4.2 硬件设计检查要点

即使软件配置正确，仍需确认：

1. LED电路设计符合规格：

   • 限流电阻值（通常220Ω）
   • 阳极电压（3.3V）
   • 最大电流（10mA）

2. PCB走线检查：

   • LEDx信号是否直连芯片引脚
   • 无短路/断路情况

5. 验证与调试技巧

5.1 寄存器状态检查

通过debugfs查看当前配置：

bash复制cat /sys/kernel/debug/rtl8168/registers

重点关注：

• 0x18 (CustomLED)
• PHY页面选择状态

5.2 实际效果验证

5.3 常见问题排查表

6. 经验总结与进阶建议

在实际调试中，我发现RTL8111HS的LED控制有几个易忽略的细节：

1. PHY页面切换时序：写入Page Select后需要至少100ns延时才能操作目标寄存器，建议添加udelay(1)

2. EEPROM覆盖问题：某些厂商会在生产时烧写EEPROM，导致驱动配置被覆盖，可通过以下命令禁用：

   bash复制ethtool -E eth0 magic 0x8168 offset 0x1F value 0x00
   

3. 节能模式影响：当启用EEE节能功能时，LED行为可能异常，测试时可临时关闭：

   bash复制ethtool --set-eee eth0 eee off
   

对于需要自定义LED行为的场景，建议在驱动中扩展sysfs接口，实现运行时配置：

c复制// 示例：添加sysfs属性
static DEVICE_ATTR(led_mode, 0644, show_led_mode, store_led_mode);

这个调试过程让我深刻体会到，硬件功能调试必须"三位一体"：

• 吃透芯片手册的寄存器定义
• 理解驱动代码的实现逻辑
• 掌握硬件设计的实际约束

最后分享一个实用技巧：在早期硬件验证阶段，可以用示波器测量LED引脚信号，快速区分是软件配置问题还是硬件电路故障。正常情况下应该能看到脉宽调制信号，如果完全没有输出，就需要重点检查驱动配置了。