网络

以太网

`esp_eth_phy_802_3_reset_hw()` API 变更

此变更仅适用于维护自己的以太网 PHY 驱动程序，该驱动程序基于 esp_eth/src/phy/esp_eth_phy_802_3.c 通用函数。现在 esp_eth_phy_802_3_reset_hw() API 仅接受一个参数，并使用初始化期间定义的内部时序配置重置以太网 PHY。以前，该 API 需要一个 reset_assert_us 参数来指定复位引脚断言时间。此参数已删除。

使用示例：

esp_eth_phy_802_3_reset_hw(phy_802_3);

移除 RMII 时钟 Kconfig 选项

已从 components/esp_eth 中移除了以下 RMII 时钟相关的 Kconfig 选项。时钟配置现在仅通过 EMAC 配置结构体进行管理。

移除的选项： - ETH_PHY_INTERFACE_RMII、ETH_RMII_CLK_INPUT、ETH_RMII_CLK_OUTPUT - ETH_RMII_CLK_IN_GPIO、ETH_RMII_CLK_OUTPUT_GPIO0、ETH_RMII_CLK_OUT_GPIO

迁移方式：

// 之前：通过 Kconfig 配置
// CONFIG_ETH_RMII_CLK_INPUT=y

// 之后：在代码中显式配置
eth_esp32_emac_config_t emac_config = ETH_ESP32_EMAC_DEFAULT_CONFIG();
emac_config.clock_config.rmii.clock_mode = EMAC_CLK_OUT;  // 或 EMAC_CLK_EXT_IN
emac_config.clock_config.rmii.clock_gpio = 0;  // ESP32 使用 GPIO0

影响：使用 ETH_ESP32_EMAC_DEFAULT_CONFIG() 的应用程序可继续正常工作。自定义时钟配置需在 EMAC 配置结构体中显式设置，或使用 Ethernet Init 组件。

ESP-NETIF

移除弃用的 `esp_netif_next()`

已从 ESP-NETIF 中移除弃用的迭代辅助函数 esp_netif_next()。该 API 在迭代过程中不会对接口列表或 TCP/IP 上下文进行加锁，因而并不安全。

请使用以下替代方案：

仅在完全可控的上下文中直接调用 esp_netif_next_unsafe()，或在 esp_netif_tcpip_exec() 中执行以保证在 TCP/IP 上下文内安全运行。
使用 esp_netif_find_if() 并配合谓词查找特定接口，从而避免手动迭代。

迁移方式

之前：

esp_netif_t *it = NULL;
while ((it = esp_netif_next(it)) != NULL) {
    // 使用 "it"
}

之后（在可控上下文中进行不加锁迭代）：

esp_netif_t *it = NULL;
while ((it = esp_netif_next_unsafe(it)) != NULL) {
    // 使用 "it"
}

推荐方式（在 TCP/IP 上下文中迭代）：

static esp_err_t iterate_netifs(void *ctx)
{
    esp_netif_t *it = NULL;
    while ((it = esp_netif_next_unsafe(it)) != NULL) {
        // 使用 "it"
    }
    return ESP_OK;
}

// 在 TCP/IP 上下文中安全执行迭代
ESP_ERROR_CHECK(esp_netif_tcpip_exec(iterate_netifs, NULL));

替代方式（使用谓词查找）：

static bool match_by_key(void *ctx, esp_netif_t *netif)
{
    const char *wanted = (const char *)ctx;
    const char *key = esp_netif_get_ifkey(netif);
    return key && strcmp(key, wanted) == 0;
}

esp_netif_t *target = esp_netif_find_if(match_by_key, (void *)"WIFI_STA_DEF");
if (target) {
    // 使用 "target"
}

此文档对您有帮助吗？

反馈已收到，谢谢！
如果您有其他意见，欢迎填写乐鑫文档反馈表。

我们重视您的反馈。
您可以填写乐鑫文档反馈表告诉我们如何改进该文档。

网络