7. ENET PHY 组件

7.1. 概述

ENET PHY 组件为 ENET 应用和板级支持文件提供通用 PHY 端口抽象，用于将 PHY 型号选择、PHY 地址选择、初始化和链路状态轮询从应用层代码中收敛出来。

应用层应使用 board_init_enet_phy() 和 board_get_enet_phy_status() 等板级 API。板级文件通过 hpm_enet_phy_port_init() 和 hpm_enet_phy_port_get_status() 将每个 ENET 端口映射到当前板卡实际使用 的 PHY 型号和地址。

7.2. 支持的 PHY 驱动

该组件可分发到以下 ENET PHY 驱动：

  • DP83867

  • RTL8211

  • DP83848

  • RTL8201

  • LAN8720

  • JL1111

只有被板级 CMake 配置选中的 PHY 驱动会参与编译。组件本身由 CONFIG_ENET_PHY 使能。

7.3. 端口配置

通用端口配置由 hpm_enet_phy_port_config_t 定义：

typedef struct {
    ENET_Type *base;
    hpm_enet_phy_type_t type;
    uint8_t addr;
    uint8_t interface;
    uint8_t rmii_refclk_dir;
    uint32_t init_flags;
} hpm_enet_phy_port_config_t;

  • base 为 ENET 控制器基地址。

  • type 用于选择具体 PHY 驱动。

  • addr 用于选择 MDIO 总线上的 PHY 地址。

  • interface 用于选择 RGMII、RMII、MII 等 ENET 介质接口。

  • rmii_refclk_dir 用于在需要时选择 RMII 参考时钟方向。

  • init_flags 用于请求可选 PHY 初始化行为。

HPM_ENET_PHY_PORT_INIT_FLAG_DISABLE_BROADCAST_RESPONSE 用于请求关闭广播响应。 helper 会先校验所选 PHY 是否支持该选项，然后再应用。

当板卡使用所选 PHY 驱动定义的默认 PHY 地址时，addr 可设置为 HPM_ENET_PHY_USE_DEFAULT_ADDR。PHY 地址是 5 位 MDIO 地址，因此 0xFF 在该组件中作为哨兵值使用，不是有效的物理 PHY 地址。

7.4. 板级接入

单端口板卡可以创建一份端口配置并传入通用 helper：

hpm_stat_t board_init_enet_phy(ENET_Type *ptr)
{
    hpm_enet_phy_port_config_t phy_config = {0};

    phy_config.base = ptr;
    phy_config.type = hpm_enet_phy_rtl8211;
    phy_config.addr = HPM_ENET_PHY_USE_DEFAULT_ADDR;
    phy_config.interface = enet_inf_rgmii;
    phy_config.init_flags = 0;

    return hpm_enet_phy_port_init(&phy_config);
}

多端口板卡应为每个 ENET 端口创建独立配置，支持以下典型场景：

  • 不同端口使用不同 PHY 型号

  • 不同端口使用相同 PHY 型号但不同地址

  • 不同端口使用相同 PHY 型号但不同介质接口，需 PHY 支持

7.5. 应用层用法

应用和中间件应避免直接调用具体 PHY driver API，而是调用板级 API：

if (board_init_enet_phy(ENET) == status_success) {
    board_get_enet_phy_status(0, &status);
}

这样可以将 PHY 细节保留在板级文件中，使通用网络代码能够适配不同板卡和多端口 配置。