STM32F4裸机移植LWIP：PHY-MAC-DMA协同与DHCP实现

1. LWIP无操作系统移植的核心文件架构

在STM32F4系列平台上完成LWIP协议栈的裸机移植，绝非简单地将源码复制粘贴即可。其核心在于构建一个稳定、高效且可维护的硬件抽象层（HAL），该层需精确桥接LWIP的网络协议逻辑与底层以太网控制器（MAC）及物理层（PHY）的硬件操作。整个移植工程的骨架由三类关键文件构成，它们共同定义了数据通路、内存管理与协议栈初始化流程。这三类文件并非孤立存在，而是形成一个严密的数据流闭环： lan8720.c/h 负责最底层的PHY芯片控制与寄存器级交互； stm32f427_eth.c （或类似命名）承担MAC与DMA控制器的配置、描述符链表管理及中断服务；而 lwip_com.c/h 则作为顶层胶水，将LWIP的网络接口（netif）抽象与底层驱动绑定，并实现DHCP等关键应用逻辑。理解这三者的职责边界与协作机制，是掌握整个移植过程的基石。

1.1 LAN8720 PHY驱动文件解析

LAN8720是一款广泛应用于嵌入式以太网设计的10/100M PHY芯片，其驱动文件 lan8720.c 与 lan8720.h 构成了与物理层通信的唯一入口。该驱动的设计遵循了ST官方以太网库的约定，其核心并非直接操作PHY寄存器，而是通过SMI（Serial Management Interface）总线，调用ST提供的标准化函数 ETH_ReadPHYRegister 和 ETH_WritePHYRegister 来完成读写。这种设计极大提升了代码的可移植性，因为无论PHY芯片型号如何变化，只要其符合IEEE 802.3标准并支持SMI，上层驱动逻辑几乎无需修改。

在 lan8720.h 中，首要的宏定义是 LAN8720_PHY_ADDRESS ，其值为 0x00 。这个地址并非随意指定，而是由硬件电路决定的PHY芯片在SMI总线上的唯一身份标识。F4系列MCU的以太网MAC控制器最多可管理32个PHY，每个PHY通过不同的地址进行区分，因此，在PCB设计阶段，必须通过外部引脚（如PHYAD[4:0]）将LAN8720的地址精确配置为 0x00 ，否则后续所有寄存器读写操作都将失败。紧随其后的是 LAN8720_RESET_PIN ，它被定义为 GPIO_PIN_3 ，对应于GPIO端口D的第3引脚（即 GPIOD_Pin3 ）。这个引脚用于硬件复位LAN8720芯片。设计中采用低电平有效复位，即 GPIOD_Pin3 默认拉低，使PHY处于复位状态。这是一种至关重要的热管理策略。LAN8720作为模拟器件，其功耗与发热量显著。若在系统未加载任何网络固件时便让其持续工作，开发板右上角的网络区域会迅速升温，影响系统稳定性。因此，驱动中的 LAN8720_Init() 函数首先执行一个5ms的复位脉冲：先将 GPIOD_Pin3 置高（退出复位），再短暂拉低，最后再次拉高，从而确保PHY在软件控制下可靠启动。

文件中另一组关键声明是四个指针变量： tx_desc （发送描述符）、 rx_desc （接收描述符）、 tx_buff （发送缓冲区）和 rx_buff （接收缓冲区）。这些变量在头文件中使用 extern 关键字声明，意味着它们的实际内存分配和定义位于 lan8720.c 文件内部。这种分离设计是C语言模块化编程的典范，它强制实现了接口与实现的解耦。 lan8720.c 在初始化时，会为这四个指针动态分配内存（通常使用 mem_malloc ），并将它们的地址赋值给头文件中声明的 extern 变量。这样，当其他模块（如 stm32f427_eth.c ）包含 lan8720.h 时，就能无缝访问这些已分配好的内存区域，而无需关心其具体的分配细节。

1.2 STM32F427以太网MAC/DMA驱动详解

stm32f427_eth.c （或类似名称，如 ethernetif.c ）是整个移植工程中最复杂、最关键的文件。它直接与STM32F427的硬件外设打交道，其任务是将LWIP协议栈发出的抽象网络数据包，转化为DMA引擎能够理解的、基于描述符（Descriptor）的物理内存操作。该文件的结构清晰地反映了以太网数据处理的生命周期：初始化、中断服务、数据收发。

初始化流程始于时钟使能。 ETH_MACDMA_Config() 函数首先开启 RCC_APB1Periph_ETHMAC 、 RCC_APB1Periph_ETHMAC_Tx 和 RCC_APB1Periph_ETHMAC_Rx 三个时钟源，这是所有后续操作的前提。紧接着，它调用 ETH_DeInit() 对MAC和DMA进行软件复位。此操作通过向DMA总线模式寄存器（DMA_BMR）的 SWR 位（Bit 0）写入 1 来触发。复位完成后，该位会自动清零，驱动程序必须轮询此位直至其为 0 ，才能继续执行。这是一个极易出错的环节，若复位过程卡死，最常见的原因是外部参考时钟（REF_CLK）未能正常起振。F427的以太网MAC依赖于一个25MHz的外部晶振作为其参考时钟源，若该晶振电路焊接不良或负载电容不匹配，将导致MAC内部逻辑无法同步，进而使复位操作无限期等待。

复位成功后，驱动进入核心配置阶段。 ETH_Init() 函数接收一个 ETH_InitTypeDef 结构体，该结构体的初始值由ST官方库函数 ETH_StructInit() 提供。此函数将结构体所有成员填充为硬件推荐的默认值，这是一种极为稳健的编程实践。手动逐个设置数十个寄存器位极易引入错误，而使用官方提供的默认值作为起点，再根据实际需求（如修改MAC地址、调整环形缓冲区大小）进行局部覆盖，能最大限度地保证配置的正确性与兼容性。其中， ETH_InitStruct.ETH_MACAddress[6] 被赋予了设备的物理MAC地址，该地址最终会被写入MAC地址0寄存器（ ETH_MAC_ADDR0_HR 和 ETH_MAC_ADDR0_LR ）。

描述符链表的构建是驱动的灵魂所在。 ETH_Init() 函数内部调用了两个关键的辅助函数： ETH_DescAssignMemory() 和 ETH_DescInit() . ETH_DescAssignMemory() 负责将 tx_desc 和 rx_desc 这两个全局指针所指向的描述符数组，与 tx_buff 和 rx_buff 所指向的数据缓冲区数组进行一一映射。 ETH_DescInit() 则负责将这些独立的描述符“串联”成一个环形链表（Ring Buffer）。对于发送描述符链表，其核心逻辑