RK3566安卓11千兆网卡移植避坑指南:RTL8211F驱动配置与性能调优实战
最近在RK3566平台上折腾安卓11系统,想把RTL8211F这颗千兆PHY芯片给跑起来,本以为照着官方文档配一下设备树就能搞定,结果一脚踩进了好几个坑里。从时钟配置混乱导致DMA报错,到电源域配错让网卡“假死”,再到好不容易通了网却发现吞吐量上不去,最后连个LED灯都点不亮。这一路下来,感觉不是在做驱动移植,更像是在玩一个硬核的解谜游戏。如果你也正在RK3566上搞网络,特别是用RTL8211F这颗芯片,那这篇文章或许能帮你省下不少折腾的时间。我会把从硬件原理确认、驱动配置、电源管理,到性能测试和LED控制的完整流程,结合我踩过的坑,掰开揉碎了讲清楚。
1. 硬件原理图确认与时钟模式解析
移植千兆网卡,第一步绝对不能省,就是老老实实对着原理图,把MAC和PHY之间的连接关系彻底搞清楚。RK3566的GMAC控制器支持RGMII和RMII两种主流接口模式,而RTL8211F这颗PHY也支持多种时钟方案。如果这里配错了,后面所有的软件调试都是白费力气。
1.1 RGMII接口的四种时钟配置“名场面”
RGMII模式最让人头疼的就是时钟。它不像RMII那样相对固定,RK的文档里把它分成了四种典型的配置场景,并给每个场景起了一个“name”。这个“name”是你后续在设备树(DTS)里配置 clock_in_out 和 assigned-clock-parents 等属性的关键依据。很多人直接抄别人的DTS配置,结果不work,八成就是“name”没对上。
我们先看硬件上几个关键的信号引脚:
- MAC侧:
GMACx_MCLKINOUT(MAC时钟输入/输出)、ETHx_REFCLKO_25M(25MHz参考时钟输出) - PHY侧:
CLKOUT(125MHz时钟输出)、XTAL_IN/XTAL_OUT(晶体输入/输出)
这四根线怎么接,决定了时钟的走向。下面这个表格帮你快速对号入座:
| MAC侧配置 | PHY侧配置 | 对应的“name” (RK文档) | 时钟路径简述 |
|---|---|---|---|
GMACx_MCLKINOUT 悬空 | XTAL_IN/OUT 接25MHz晶体 | PLL output 125M for TX_CLK, Crystal 25M for PHY | MAC内部的PLL产生125MHz TX时钟给PHY;PHY使用自己的25MHz晶体。 |
GMACx_MCLKINOUT 悬空 | XTAL_IN 接地,XTAL_OUT 由MAC的ETHx_REFCLKO_25M驱动 | PLL output 125M for TX_CLK, PLL 25M for PHY | MAC的PLL产生125MHz TX时钟和25MHz时钟(通过ETHx_REFCLKO_25M输出)给PHY。 |
GMACx_MCLKINOUT 由PHY的CLKOUT驱动 | XTAL_IN/OUT 接25MHz晶体 | 125M TX_CLK input from PHY, Crystal 25M for PHY | PHY产生125MHz TX时钟(通过CLKOUT)给MAC;PHY使用自己的25MHz晶体。 |
GMACx_MCLKINOUT 由PHY的CLKOUT驱动 | XTAL_IN 接地,XTAL_OUT 由MAC的ETHx_REFCLKO_25M驱动 | 125M TX_CLK input from PHY, PLL 25M for PHY | PHY产生125MHz TX时钟给MAC;MAC产生25MHz时钟给PHY。 |
注意:表格中的“悬空”指的是该引脚在硬件上没有连接外部时钟源或负载,但软件配置仍需与之匹配。
我手头的板子,原理图显示 GMAC1_MCLKINOUT_M0 和 ETH1_REFCLKO_25M_M0 都是悬空的,PHY的 XTAL_IN/OUT 接了颗25MHz的晶体。所以,我对应的“name”就是第一种:PLL output 125M for TX_CLK, Crystal 25M for PHY。
1.2 RMII模式的时钟相对简单
如果你的设计用的是RMII接口,那事情会简单一些。RMII的时钟频率是50MHz。主要就两种场景:
- RMII Clock Output:MAC的
GMACx_MCLKINOUT输出50MHz时钟给PHY的XTAL_OUT(此时XTAL_IN接地)。ETHx_REFCLKO_25M悬空。 - RMII Clock Input:PHY的
PHY_TXCLK输出50MHz时钟给MAC的GMACx_MCLKINOUT。PHY的XTAL_IN/OUT接自己的晶体。ETHx_REFCLKO_25M悬空。
1.3 将“name”转化为DTS配置
确定了“name”,接下来就是在DTS里做文章了。以我遇到的RGMII第一种场景为例,关键配置如下:
&gmac1 {
status = "okay";
phy-mode = "rgmii"; // 接口类型
phy-handle = <&rgmii_phy1>;
snps,reset-gpio = <&gpio4 RK_PC2 GPIO_ACTIVE_LOW>;
snps,reset-active-low;
snps,reset-delays-us = <0 20000 100000>; // 复位延时:释放后稳定20ms,再等100ms
/* 时钟配置 - 对应 "PLL output 125M for TX_CLK, Crystal 25M for PHY" */
clock_in_out = "output"; // MAC输出125MHz TX时钟
assigned-clocks = <&cru SCLK_GMAC1_RX_TX>, <&cru SCLK_GMAC1>;
assigned-clock-parents = <&cru SCLK_GMAC1_RGMII_SPEED>, <&gmac1_clkin>;
assigned-clock-rates = <0>, <125000000>; // 设置GMAC1时钟为125MHz
pinctrl-names = "default";
pinctrl-0 = <&gmac1m0_miim
&gmac1m0_tx_bus2
&gmac1m0_rx_bus2
&gmac1m0_rgmii_clk
&gmac1m0_rgmii_bus>;
/* TX/RX延迟线配置,对千兆性能至关重要 */
tx_delay = <0x4d>;
rx_delay = <0x2d>;
};
这里最容易出错的就是 clock_in_out 和 assigned-clock-parents。根据我的“name”,clock_in_out 应该是 "output"。但有趣的是,我在调试时发现,即使我误配置成 "input",网络有时也能通(可能是PHY或MAC的容错性?),但性能绝对是不稳定的,而且内核日志里可能会出现诡异的DMA超时错误。所以,以原理图和文档为准,不要依赖偶然现象。
关于 tx_delay 和 rx_delay 这两个参数,它们用于调整RGMII接口数据相对于时钟的时序,以补偿PCB走线带来的延迟。值不对会导致数据采样错误,轻则丢包,重则链路不通。这个值需要参考另一份文档 《Rockchip_Developer_Guide_Linux_GMAC_RGMII_Delayline_CN.pdf》,根据你的PCB设计来确定。我这里的 0x4d 和 0x2d 只是示例。
2. 驱动使能与电源域配置陷阱
硬件时钟配对了,只是万里长征第一步。接下来要让内核认识并控制这颗PHY。
2.1 内核驱动配置
RTL8211F的驱动在内核中已经存在,位于 drivers/net/phy/realtek.c。你需要确保编译内核时启用了这个驱动。通常在内核配置菜单中:
Device Drivers --->
Network device support --->
PHY Device support and infrastructure --->
<*> Drivers for Realtek PHYs
或者直接在你的内核 defconfig 文件里加上:
CONFIG_REALTEK_PHY=y
这一步一般不会出问题,但务必确认编译出的内核镜像中包含了该驱动模块。
2.2 最隐蔽的坑:IO电源域配置
这是我踩过最深的一个坑,现象极其迷惑:系统启动后,ifconfig eth0 能看到网卡,dmesg 里没有明显的错误日志,PHY能被识别,链路也能显示 Link is Up - 1Gbps/Full,但就是拿不到IP地址,ping 任何地址都不通。所有软件层面的排查都指向“正常”。
问题出在MAC控制器的IO电源域上。RK3566的GMAC控制器引脚(即RGMII的那些数据线、时钟线)需要特定的电压供电,比如1.8V或3.3V。这个电压由哪个电源芯片(LDO)提供,是在原理图上决定的。软件必须正确配置这个映射关系,否则IO电平不对,信号根本无法正常传输。
查看RK3566的TRM和数据手册,GMAC1的IO电源域控制信号是 vccio5。我们需要在DTS的 pmu_io_domains 节点中,将 vccio5-supply 指向正确的稳压器。假设原理图上GMAC1的IO电压由 vcc_1v8 这个LDO提供,那么配置应该是:
&pmu_io_domains {
status = "okay";
pmuio1-supply = <&vcc3v3_pmu>;
pmuio2-supply = <&vcca1v8_pmu>;
vccio1-supply = <&vccio_acodec>;
vccio3-supply = <&vccio_sd>;
vccio4-supply = <&vcca1v8_pmu>;
/* 关键修改:将vccio5的供电从默认的3.3V改为1.8V */
vccio5-supply = <&vcc_1v8>;
vccio6-supply = <&vcc1v8_dvp>;
vccio7-supply = <&vcc_3v3>;
};
如果这里配置错误(例如实际是1.8V却配了3.3V的supply),硬件可能处于一种“半死不活”的状态:逻辑检测能过,但物理电平无法正确驱动,导致数据收发失败。这个配置错误不会导致内核崩溃或明显报错,但网络就是不通,非常具有欺骗性。
3. 网络性能测试与调优实战
网卡通了,指示灯亮了,这只是及格线。对于千兆网卡,我们更关心它的实际吞吐量能否接近理论值。我使用 iperf3 这个工具进行测试。
3.1 测试环境搭建
- PC端(服务端):从iperf3官网下载Windows版本,将
iperf3.exe和cygwin1.dll放到C:\Windows\System32目录,方便命令行直接调用。PC有线网卡确保连接千兆交换机或直接与RK3566设备相连。 - RK3566设备端(客户端):安卓SDK通常自带了iperf3源码,路径在
external/iperf3。编译并推送:# 在SDK根目录下 source build/envsetup.sh lunch rk3566_rgo-userdebug # 选择你的目标 mmm external/iperf3 # 编译完成后,将二进制文件推送到设备 adb push out/target/product/rk3566_rgo/system/bin/iperf3 /data/local/tmp/ adb shell chmod +x /data/local/tmp/iperf3
3.2 双向吞吐量测试与结果分析
测试时,PC和设备处于同一局域网,关闭防火墙。
测试1:RK3566发送,PC接收(测试设备TX性能)
- PC端启动服务端:
iperf3 -s - RK3566设备端作为客户端发起测试:
/data/local/tmp/iperf3 -c [PC_IP_ADDRESS] -i 1 -w 1M -t 30 -l 16000-c: 客户端模式,后接服务器IP。-i 1: 每秒报告一次。-w 1M: 设置TCP窗口大小为1MB,对于千兆网络,增大窗口有助于提升吞吐量。-t 30: 测试时长30秒。-l 16000: 设置读写缓冲区长度为16000字节。
一个健康的千兆连接,发送(TX)带宽应该稳定在940Mbps左右(扣除TCP/IP协议开销)。这是我某次测试的片段,可以看到基本达标:
[ ID] Interval Transfer Bitrate Retr
[ 5] 0.00-1.00 sec 112 MBytes 940 Mbits/sec 0
[ 5] 1.00-2.00 sec 112 MBytes 940 Mbits/sec 0
...
[ 5] 0.00-30.00 sec 3.28 GBytes 939 Mbits/sec 0 sender
测试2:PC发送,RK3566接收(测试设备RX性能)
- RK3566设备端启动服务端:
/data/local/tmp/iperf3 -s - PC端作为客户端:
iperf3 -c [DEVICE_IP_ADDRESS] -i 1 -w 1M -t 30
接收性能也应接近940Mbps。如果测试结果远低于此,比如只有400-500Mbps,就需要排查了。
3.3 性能瓶颈排查思路
如果吞吐量不理想,可以按以下顺序排查:
- 确认物理链路:
ethtool eth0查看是否确认为Speed: 1000Mb/s和Duplex: Full。 - 检查中断亲和性与CPU负载:使用
top或htop查看softirq处理是否集中在某一个CPU核心上。对于多核CPU,可以考虑设置中断亲和性,将网络中断分散到不同核心。# 查看中断号 cat /proc/interrupts | grep gmac # 假设中断号是50,将其绑定到CPU0和CPU1 echo 3 > /proc/irq/50/smp_affinity # 3的二进制是0011,代表CPU0和CPU1 - 调整TCP参数:在RK3566上尝试调整内核网络参数,如增大TCP缓冲区。
# 临时设置 sysctl -w net.core.rmem_max=134217728 sysctl -w net.core.wmem_max=134217728 sysctl -w net.ipv4.tcp_rmem="4096 87380 134217728" sysctl -w net.ipv4.tcp_wmem="4096 65536 134217728" - 检查DMA和缓存设置:确保GMAC的DMA配置合理,CPU缓存策略(如Cache Coherency)设置正确。这通常需要在DTS或驱动中检查。
- 使用
perf工具进行性能剖析:在运行iperf测试的同时,使用perf top或perf record分析热点函数,看是CPU瓶颈还是内存拷贝瓶颈。
4. PHY寄存器调试与LED控制进阶
基本的网络功能稳定后,我们可能还需要根据产品需求进行一些定制化配置,例如控制网络状态指示灯。RTL8211F的LED行为可以通过其内部寄存器来配置。
4.1 RTL8211F寄存器访问机制
RTL8211F的寄存器空间是分页(Page)的。要操作非标准页(Page 0)的寄存器,需要两步:
- 向 Page Select Register(地址0x1F) 写入目标页地址。
- 然后对目标寄存器进行读写操作。
例如,要配置LED的寄存器位于 Page 0xD04,寄存器地址为 0x10。
4.2 编写LED控制修复函数
我们希望当网卡以千兆速率连接时,两个LED(假设对应bit8和bit13)都点亮。我们需要在内核网络驱动中增加一个修复函数(fixup),在PHY初始化后被调用。
以下是一个实现在 stmmac 主驱动中的例子。选择在 stmmac_main.c 的 stmmac_dvr_probe 函数中注册一个PHY修复回调。
/* 在drivers/net/ethernet/stmicro/stmmac/stmmac_main.c 文件顶部附近添加定义 */
#define PHY_ID_RTL8211F 0x001cc916
#define RTL8211F_PAGE_SELECT 0x1F
#define RTL8211F_LED_PAGE 0xD04
#define RTL8211F_LED_CONTROL 0x10
/* 新增的PHY修复函数 */
static int phy_rtl8211f_led_fixup(struct phy_device *phydev)
{
int val;
/* 检查PHY型号 */
if (phydev->phy_id != PHY_ID_RTL8211F)
return 0;
/* 选择LED配置页 */
phy_write(phydev, RTL8211F_PAGE_SELECT, RTL8211F_LED_PAGE);
/* 读取LED控制寄存器,并设置千兆模式下点亮LED1和LED2的位 */
val = phy_read(phydev, RTL8211F_LED_CONTROL);
val |= (1 << 8) | (1 << 13); // 请根据你的硬件原理图确认具体的bit位
phy_write(phydev, RTL8211F_LED_CONTROL, val);
/* 可选:切换回标准页0 */
phy_write(phydev, RTL8211F_PAGE_SELECT, 0);
return 0;
}
然后,在 stmmac_dvr_probe 函数中找到合适的位置(例如,在平台设备探测成功之后,网络设备注册之前)注册这个修复函数:
/* ... 其他初始化代码 ... */
ret = phy_register_fixup_for_uid(PHY_ID_RTL8211F, 0xffffffff, phy_rtl8211f_led_fixup);
if (ret)
pr_warn("Cannot register PHY board fixup for RTL8211F LED.\n");
/* ... 后续代码 ... */
这样,每当内核识别到一个PHY ID为RTL8211F的设备时,就会自动调用这个函数来配置LED行为。这种方法比修改通用PHY驱动更干净,属于板级定制。
4.3 调试技巧:手动读写PHY寄存器
在驱动代码生效前,你可以通过 ethtool 在用户空间验证寄存器配置是否正确。
# 1. 查看PHY状态和ID
ethtool eth0
# 2. 使用ethtool的寄存器读写功能(需要内核编译时开启CONFIG_MDIO_BUS和用户空间工具支持)
# 但更直接的方法是使用mdio-tool(如果有)或编写简单的小程序通过ioctl调用。
# 另一种方法是使用debugfs(如果PHY驱动支持):
# cat /sys/kernel/debug/mdio_bus/.../regs
不过,对于复杂的页切换操作,用户空间工具可能不太方便,最可靠的还是在驱动层面通过 phy_write/phy_read 来操作。
移植工作就像拼图,硬件原理图、芯片手册、内核DTS、驱动代码,每一块都不能错。RK3566配合RTL8211F这套组合,关键点就在于时钟模式、电源域和延迟线这三个硬件相关配置。软件层面,性能调优和PHY特定功能定制则是锦上添花。下次再遇到网卡“似通非通”或者性能不达标的情况,不妨按照时钟、电源、驱动、参数的顺序捋一遍,多半能发现问题所在。
234



被折叠的 条评论
为什么被折叠?



