1. RTL8125BG芯片与RK平台适配背景
在嵌入式系统开发领域，网络性能往往是制约整体系统效能的瓶颈之一。RTL8125BG作为Realtek推出的2.5G以太网控制器芯片，凭借其优异的性价比和稳定的性能表现，已成为工业控制、NAS存储和边缘计算设备的首选网络解决方案。而RK平台（Rockchip系列处理器）在嵌入式Linux设备中的广泛应用，使得两者结合的场景日益增多。
RTL8125BG采用QFN-48封装，支持PCIe 2.0 x1接口标准，理论传输速率可达2.5Gbps。其核心优势在于：
- 兼容IEEE 802.3az节能以太网标准
- 支持Jumbo Frame（最大支持9KB帧）
- 内置硬件CRC校验和TCP/IP分载引擎
- 提供Windows/Linux/BSD全平台驱动支持
在实际项目中，开发者常遇到驱动兼容性、中断响应延迟、DMA缓冲区配置等问题。特别是在RK3588等新一代Rockchip处理器上，PCIE控制器的时钟域配置与RTL8125BG的链路训练过程需要特别注意。
2. 开发环境搭建与驱动准备
2.1 硬件准备清单
- RK开发板（建议使用RK3588系列）
- RTL8125BG模块（或含该芯片的PCIE网卡）
- 5类及以上规格的RJ45网线
- 支持2.5G速率的交换机/路由器
- 示波器（用于信号完整性检测，可选）
2.2 内核驱动移植
Realtek官方提供的r8125驱动需要针对RK平台进行交叉编译。建议从以下途径获取驱动源码：
bash复制git clone https://github.com/awesometic/realtek-r8125-dkms
关键编译参数：
makefile复制CONFIG_R8125=y
CONFIG_R8125_S5WOL=y # 支持深度睡眠唤醒
CONFIG_R8125_ASPM=y # 启用PCIe节能模式
在RK平台的SDK中，需要确保内核配置已启用：
code复制Device Drivers →
Network device support →
Ethernet driver support →
Realtek devices →
<*> Realtek RTL8125B/RTL8125BG PCIe 2.5G Ethernet adapter
2.3 设备树配置
在RK平台的设备树文件（通常为rk3588-evb.dts）中添加PCIE节点：
dts复制&pcie2x1l2 {
status = "okay";
reset-gpios = <&gpio3 20 GPIO_ACTIVE_HIGH>;
vpcie3v3-supply = <&vcc3v3_pcie2x1l2>;
pcie@0 {
reg = <0x00000000 0 0 0 0>;
#address-cells = <3>;
#size-cells = <2>;
ranges;
rtl8125bg: ethernet@0 {
compatible = "realtek,r8125bg";
reg = <0x000000 0 0 0 0>;
interrupt-parent = <&gpio3>;
interrupts = <21 IRQ_TYPE_LEVEL_LOW>;
realtek,led-config = <0x87>; // LED行为配置
};
};
};
关键提示：RK平台的PCIE控制器供电时序需要特别注意，建议在uboot阶段通过
rockchip_pcie_enable_clock()函数提前初始化时钟。
3. 驱动加载与链路调试
3.1 内核模块加载
编译完成后，通过insmod加载驱动：
bash复制insmod r8125.ko speed=2500 duplex=full autoneg=on
验证驱动加载状态：
bash复制dmesg | grep r8125
# 预期输出：
# r8125: loading out-of-tree module taints kernel.
# r8125: module verification failed: signature and/or required key missing
# r8125 0000:01:00.0: enabling device (0000 -> 0002)
# r8125: This product is covered by one or more patents.
# r8125 0000:01:00.0 eth0: RTL8125BGU (PF) at 0xffffb4f0c200, ...
3.2 链路速率协商
通过ethtool工具检查链路状态：
bash复制ethtool eth0
# 关键参数检查：
# Speed: 2500Mb/s
# Duplex: Full
# Auto-negotiation: on
# Link detected: yes
若出现协商失败（降速到1Gbps），需检查：
- 网线质量（建议使用Cat6类线）
- 交换机端口配置（需关闭节能模式）
- 信号完整性（用示波器测量PCIE差分对）
3.3 中断与DMA优化
在高速传输场景下，需调整中断亲和性和DMA缓冲区：
bash复制# 设置IRQ亲和性
echo 2 > /proc/irq/$(grep eth0 /proc/interrupts | cut -d: -f1)/smp_affinity
# 增大RX/TX环形缓冲区
ethtool -G eth0 rx 4096 tx 4096
# 启用RSS多队列（需内核支持）
ethtool -L eth0 combined 4
4. 性能测试与调优
4.1 iperf3基准测试
服务器端：
bash复制iperf3 -s -p 5201 -i 1
客户端：
bash复制iperf3 -c <server_ip> -p 5201 -t 60 -i 1 -P 8
预期性能指标：
- 单线程TCP：1.8~2.2 Gbps
- 8线程TCP：2.3~2.48 Gbps
- 延迟：<100μs（局域网内）
4.2 常见性能瓶颈排查
案例1：CPU软中断过高
现象：top显示si占用超过30%
解决方案：
bash复制# 启用GRO/GSO
ethtool -K eth0 gro on gso on
# 调整NAPI权重
echo 50 > /sys/class/net/eth0/queues/rx-0/rps_cpus
案例2：DMA缓冲区溢出
现象：dmesg出现r8125: eth0: tx timeout
解决方案：
bash复制# 增大DMA缓冲区
echo 2048 > /sys/class/net/eth0/queues/tx-0/tx_maxbytes
echo 1024 > /sys/class/net/eth0/queues/rx-0/rx_maxbytes
案例3：PCIe带宽不足
现象：实际吞吐量卡在1.2Gbps左右
解决方案：
- 检查
lspci -vv中LnkSta字段确认运行在PCIe 2.0 x1模式 - 在BIOS中关闭PCIe ASPM节能模式
- 使用
setpci -d 10ec:8125 CAP_EXP+0x10.l=0x42强制Gen2速率
5. 生产环境部署建议
5.1 驱动热补丁方案
为避免内核升级导致的驱动不兼容，建议采用DKMS动态内核模块支持：
bash复制sudo apt install dkms
sudo cp -r r8125 /usr/src/r8125-1.0.0
sudo dkms add -m r8125 -v 1.0.0
sudo dkms build -m r8125 -v 1.0.0
sudo dkms install -m r8125 -v 1.0.0
5.2 看门狗与链路监控
创建自动恢复脚本/usr/local/bin/netwatchdog：
bash复制#!/bin/bash
INTERFACE=eth0
MAX_FAILS=3
count=0
while true; do
if ! ping -c 1 -I $INTERFACE 8.8.8.8 &> /dev/null; then
((count++))
if [ $count -ge $MAX_FAILS ]; then
echo "$(date) - Restarting network interface" >> /var/log/netwatchdog.log
ifdown $INTERFACE && ifup $INTERFACE
count=0
fi
else
count=0
fi
sleep 10
done
5.3 电源管理优化
对于电池供电设备，需平衡性能与功耗：
bash复制# 启用EEE节能模式
ethtool --set-eee eth0 eee on
# 调整中断节流
echo 64 > /sys/class/net/eth0/queues/rx-0/rps_flow_cnt
通过以上步骤，RTL8125BG在RK平台上可实现稳定的2.5G网络性能。在实际项目中，建议使用内核版本5.10及以上以获得最佳兼容性。对于需要低延迟的场景，可考虑关闭TSO/GRO等卸载功能以减少CPU中断延迟。