RK3568 开发实战：巧用 u-boot ethact 环境变量实现双网口智能切换与管理
1. RK3568双网口开发中的网络切换痛点
刚拿到正点原子ATomPi-CA1开发板时，我发现这个搭载RK3568芯片的板子有个特别的设计——双千兆以太网口。在实际调试中，我发现当网线插在非默认网口时，u-boot阶段的网络操作总会先经历漫长的超时等待，然后才切换到可用网口。这种动辄10秒以上的延迟，在批量烧录或网络启动场景下简直让人崩溃。
通过mii device命令查看，板载的两个网口控制器分别对应ethernet@fe010000和ethernet@fe2a0000两个设备节点。默认情况下，u-boot的网络子系统会优先使用第一个网口，这与Linux内核能同时管理多个网口的特性完全不同。这就导致了一个典型问题：当你用ping或tftp命令时，如果网线接在第二个网口，系统会先尝试第一个网口，直到超时失败后才切换，严重影响开发效率。
2. ethact环境变量的工作原理
2.1 u-boot网络栈的运行机制
u-boot的网络子系统采用单活跃设备架构，这意味着同一时刻只有一个网口能处理网络流量。ethact就是这个架构中的"交通指挥员"，它记录着当前活跃的以太网设备名称。当执行网络命令时，u-boot会检查ethact指向的设备，如果该设备无响应，部分版本会尝试自动切换，但这种容错机制反而成了开发中的性能杀手。
通过实验发现，当执行ping 192.168.1.1时：
- u-boot读取
ethact值（如ethernet@fe010000） - 尝试通过该设备发送ICMP请求
- 若15秒内无响应，可能触发自动切换（取决于u-boot版本）
- 最终使用响应成功的设备更新
ethact
2.2 手动控制网络设备的方法
与其依赖不靠谱的自动切换，不如主动掌控。通过以下命令可以精准控制网络路径：
# 查看所有可用网口 mii device # 查看当前活跃设备 env print ethact # 切换至第二个网口 setenv ethact ethernet@fe2a0000 # 立即测试网络连通性 ping 192.168.1.1我在实际项目中测试发现，手动指定ethact后，网络响应时间从原来的15秒以上降低到1秒以内。这个改进在需要频繁进行tftp传输的开发阶段尤其重要。
3. 永久化网络配置的技巧
3.1 环境变量的保存与加载
u-boot的环境变量存储在特定的存储区域（通常是eMMC或SPI Flash），通过saveenv命令可以将当前内存中的配置持久化。但需要注意几个细节：
- 存储介质需要提前分区并格式化
- 某些开发板可能需要先设置
env import相关参数 - 保存前建议用
env print确认所有网络参数：
setenv ipaddr 192.168.1.100 setenv netmask 255.255.255.0 setenv gatewayip 192.168.1.1 setenv serverip 192.168.1.2 setenv ethact ethernet@fe2a0000 saveenv3.2 自动化初始化脚本
对于需要频繁切换环境的开发者，可以在bootcmd中加入初始化逻辑：
setenv init_net 'if test "${ethact}" = ""; then setenv ethact ethernet@fe2a0000; fi;' setenv bootcmd 'run init_net; tftp 0x80080000 zImage; bootm 0x80080000' saveenv这个技巧在我参与的工业控制器项目中特别有用，确保了不同车间部署时都能自动适配本地网络环境。
4. 高级调试与故障排查
4.1 网络初始化过程监控
通过增加调试输出可以观察网络初始化的详细过程：
setenv debug_level 7 reset在启动日志中搜索"eth"关键词，可以看到类似这样的关键信息：
net: eth0: ethernet@fe010000, eth1: ethernet@fe2a0000 net: ethact is not set, defaulting to eth0这解释了为什么首次启动总是尝试第一个网口。
4.2 常见问题解决方案
场景1：saveenv后配置不生效
- 检查存储介质是否可写（
mmc dev 0） - 确认环境变量分区大小（
env info） - 尝试强制写入（
env default -a; saveenv）
场景2：网络时断时续
- 检查PHY协商状态（
mii info ethernet@fe2a0000） - 验证时钟配置（
clk dump） - 调整复位时序（在设备树中修改reset-gpios属性）
场景3：tftp传输不稳定
- 设置合适的超时参数：
setenv tftptimeout 5000 setenv tftptimeoutcount 10在最近的一个智慧网关项目中，我们通过组合使用ethact指定和PHY参数调整，成功将产线烧录效率提升了40%。关键点在于理解u-boot网络栈的"单通道"特性，以及如何通过环境变量精确控制硬件行为。