设备树PHY节点配置详解：从基础属性到高级调优
1. PHY节点基础配置入门
第一次接触设备树中的PHY节点时，我完全被那些陌生的属性搞懵了。后来才发现，只要掌握几个核心属性，就能让PHY芯片正常工作。先来看一个最简单的PHY节点配置示例：
ethernet-phy@0 { compatible = "ethernet-phy-id0141.0e90"; reg = <0>; interrupt-parent = <&gpio0>; interrupts = <12 IRQ_TYPE_EDGE_FALLING>; };这个配置包含了PHY节点的三个必需属性：
compatible：这是PHY的身份证，格式通常是
ethernet-phy-idAAAA.BBBB。AAAA对应PHY标识寄存器1的值，BBBB对应寄存器2的值。我常用ethernet-phy-ieee802.3-c22作为兼容性回退选项。reg：PHY在MDIO总线上的地址，范围通常是0-31。有一次调试时我把地址设错，导致内核死活找不到PHY，后来用
mdio-tool工具扫描才发现问题。interrupts：中断配置，需要配合interrupt-parent使用。记得有次没配置中断，PHY链路状态变化时系统完全没反应。
提示：使用
mdio-tool -w /dev/mdio0 0x1e 0x0002可以强制PHY进入回环测试模式，这对硬件调试特别有用。
2. 关键可选属性详解
除了必需属性，PHY节点还支持许多可选属性来增强功能。最常用的几个属性我整理成了表格：
| 属性名 | 作用 | 典型值 | 注意事项 |
|---|---|---|---|
| max-speed | 限制PHY最大速率 | 10/100/1000 | 实际速率还受硬件设计限制 |
| reset-gpios | 硬件复位引脚 | &gpio1 4 GPIO_ACTIVE_LOW | 需要配合reset时序参数 |
| reset-assert-us | 复位保持时间 | 1000(1ms) | 必须大于PHY规格书要求 |
| reset-deassert-us | 复位释放延时 | 2000(2ms) | 确保PHY稳定后再操作 |
实际项目中遇到过一个坑：某款PHY芯片要求复位信号至少保持10ms，但设备树里只配了1ms，导致上电后PHY工作不稳定。后来在规格书里找到这个参数，修改后问题解决。
中断配置也有讲究：
interrupts = <12 IRQ_TYPE_EDGE_FALLING>;第二个参数可选：
- IRQ_TYPE_LEVEL_HIGH/LOW：电平触发
- IRQ_TYPE_EDGE_RISING/FALLING：边沿触发
我曾经用错触发方式，导致中断频繁触发，系统负载飙升。后来改用边沿触发才恢复正常。
3. 高级调优技巧
3.1 解决硬件设计问题
当PCB设计存在缺陷时，这些属性能救命：
enet-phy-lane-swap; // 交换TX/RX差分对 enet-phy-lane-no-swap; // 禁用自动交换 phy-is-integrated; // 表示PHY与MAC集成遇到过PCB设计把TX+/TX-接反的情况，当时通过添加enet-phy-lane-swap属性就解决了，省去了改板的成本。
3.2 节能以太网配置
EEE(Energy Efficient Ethernet)相关属性：
eee-broken-100tx; // 禁用100M EEE eee-broken-1000t; // 禁用1G EEE某次产品功耗测试发现EEE会导致ping时延波动，禁用后问题解决。但要注意这会影响节能效果，需要权衡。
3.3 复位时序优化
完整的复位配置示例：
reset-gpios = <&gpio1 4 GPIO_ACTIVE_LOW>; reset-assert-us = <15000>; // 15ms复位 reset-deassert-us = <40000>; // 40ms稳定时间建议用示波器测量实际复位时序，我曾遇到GPIO控制器驱动延时不准的问题，最后通过调整这些值解决。
4. 实战案例分析
4.1 千兆PHY完整配置
phy0: ethernet-phy@0 { compatible = "ethernet-phy-id0141.0e90", "ethernet-phy-ieee802.3-c22"; reg = <0>; /* 中断配置 */ interrupt-parent = <&gpio0>; interrupts = <12 IRQ_TYPE_EDGE_FALLING>; /* 复位配置 */ reset-gpios = <&gpio1 4 GPIO_ACTIVE_LOW>; reset-assert-us = <10000>; reset-deassert-us = <20000>; /* 高级功能 */ max-speed = <1000>; enet-phy-lane-swap; eee-broken-1000t; };这个配置我在多个项目中验证过稳定可靠，关键点：
- 复位时间严格遵循PHY规格书
- 明确限制最大速率
- 启用Lane交换补偿PCB设计
- 禁用1G EEE避免时延问题
4.2 多PHY管理
当系统有多个PHY时，建议这样组织：
mdio { #address-cells = <1>; #size-cells = <0>; phy1: ethernet-phy@1 { reg = <1>; /* 配置略 */ }; phy2: ethernet-phy@2 { reg = <2>; /* 配置略 */ }; };调试多PHY系统时，我发现给每个PHY添加标签(如phy1、phy2)特别有用，在驱动中可以直接通过标签引用。
5. 常见问题排查
根据我的踩坑经验，PHY相关问题90%可以通过以下步骤解决：
- 检查MDIO通信：
mdio-tool -r /dev/mdio0 0x1e # 读取PHY ID如果返回全F，说明MDIO通信异常
- 验证中断配置：
cat /proc/interrupts | grep eth查看中断计数是否增加
- 检查PHY状态：
ethtool eth0重点看"Link detected"和"Speed"
- 查看内核日志：
dmesg | grep phy曾经有个奇葩问题：PHY能识别但无法建立链接，最后发现是变压器中心抽头电压不对。这类硬件问题往往需要结合示波器分析。