STM32的以太网库函数主要涉及HAL库或标准外设库中对以太网控制器（ETH）的驱动，以及与TCP/IP协议栈（如LWIP）的集成。以下是关键内容的中文总结：

1. HAL库中的以太网驱动

• 初始化函数：

  HAL_StatusTypeDef HAL_ETH_Init(ETH_HandleTypeDef *heth);

  用于初始化以太网外设，需配置ETH_InitTypeDef结构体，包括：

  • MAC地址（MACAddr）
  • 自动协商（AutoNegotiation）
  • 速度和双工模式（Speed/DuplexMode）
  • 接收/发送缓冲区描述符（Rx/TxDesc）

• 数据发送/接收：

  HAL_StatusTypeDef HAL_ETH_TransmitFrame(ETH_HandleTypeDef *heth, uint32_t FrameLength);
  HAL_StatusTypeDef HAL_ETH_GetReceivedFrame(ETH_HandleTypeDef *heth);

  发送和接收以太网帧，需配合DMA描述符链表操作。

• 中断处理：

  void HAL_ETH_IRQHandler(ETH_HandleTypeDef *heth);

  处理以太网中断事件（如接收完成、发送完成）。

2. PHY芯片驱动

以太网物理层（PHY）需单独配置，常见芯片如LAN8742：

HAL_StatusTypeDef HAL_ETH_WritePHYRegister(ETH_HandleTypeDef *heth, uint32_t PHYReg, uint32_t RegValue);
HAL_StatusTypeDef HAL_ETH_ReadPHYRegister(ETH_HandleTypeDef *heth, uint32_t PHYReg, uint32_t *pRegValue);

用于读写PHY寄存器，配置速度、双工模式和链路状态。

3. LWIP协议栈集成

STM32CubeMX可自动生成LWIP的初始化代码：

• 初始化流程：

  MX_LWIP_Init(); // 初始化LWIP协议栈
  netif_add(&gnetif, &ipaddr, &netmask, &gw, NULL, ðernetif_init, &tcpip_input);
  netif_set_up(&gnetif); // 启用网络接口

• 数据接收回调：

  ethernetif_input(&gnetif); // 从以太网缓冲区读取数据并传递给LWIP

• 发送数据： 使用LWIP的API（如tcp_write()、udp_send()）发送数据，底层自动调用HAL_ETH_TransmitFrame。

4. 示例代码片段

// 初始化ETH和LWIP
ETH_HandleTypeDef heth;
MX_ETH_Init(); // 配置ETH时钟、GPIO、MAC、DMA描述符
MX_LWIP_Init();

// 发送数据（示例）
struct pbuf *p = pbuf_alloc(PBUF_TRANSPORT, data_len, PBUF_RAM);
memcpy(p->payload, data, data_len);
etharp_output(&gnetif, NULL, &p);

常见问题

1. PHY通信失败：

   • 检查PHY地址（通过PHY_ADDRESS定义）。
   • 确认MDIO/MDC时钟配置正确（通常为ETH_MDIO_CLOCK_DIV_16）。

2. DMA描述符错误：

   • 确保描述符链表连续且对齐（使用__attribute__((section(".RxDescArraySection")))）。

3. LWIP丢包：

   • 增大PBUF_POOL_SIZE和MEM_SIZE以优化缓冲区。

资源推荐

• ST官方文档：AN5402 - LWIP协议栈在STM32上的应用
• 示例代码：STM32CubeF4/STM32CubeF7中的ETH_*和LwIP_*例程

建议结合STM32CubeMX生成初始化代码，再根据需求调整以太网参数。