基于STM32CubeMX的FreeRTOS+LAN8720A+LWIP以太网通信实战指南-开发者社区

1. 硬件准备与电路连接

使用STM32CubeMX配置以太网通信的第一步是确保硬件连接正确。我手头用的是正点原子探索者STM32F407ZGT6开发板，板载LAN8720A以太网PHY芯片。这个芯片通过RMII接口与STM32F407的MAC层通信，相比MII接口能节省一半的引脚资源。

LAN8720A的硬件连接有几个关键点需要注意：

复位引脚：开发板上LAN8720A的ETH_RESET直接连接到了PD3，这个引脚需要配置为GPIO输出模式
时钟引脚：PHY芯片的50MHz时钟可以由外部晶振提供，也可以由STM32的MCO引脚输出
RMII接口：包括TXD0/TXD1、RXD0/RXD1、CRS_DV等信号线，需要严格对应STM32的指定引脚

实测中发现，如果PHY芯片的复位时序不对，很容易导致初始化失败。我的经验是上电后先保持复位50ms以上，再释放复位，这样可以确保PHY芯片完全初始化。

2. CubeMX工程配置详解

2.1 时钟树配置

以太网对时钟精度要求很高，在CubeMX中需要特别注意：

主时钟配置为168MHz（STM32F407的最大频率）
ETH时钟必须配置为25MHz或50MHz
在Clock Configuration标签页，确保ETH时钟源选择正确

我遇到过ETH无法工作的情况，最后发现是PLL分频系数设错了。建议新手直接使用CubeMX的"Clock Configuration"视图，它会用颜色提示不合理的配置。

2.2 ETH外设配置

在Connectivity标签页使能ETH：

模式选择RMII
勾选"Auto Negotiation"
在Advanced Parameters中建议开启CRC校验

特别注意PHY地址的设置，LAN8720A的地址由PHYAD0引脚决定，探索者开发板上这个引脚接地，所以地址是0。如果地址设错，会导致PHY寄存器无法访问。

2.3 LWIP协议栈配置

在Middleware标签页启用LWIP：

勾选"LWIP_SUPPORT"
内存池大小建议设置为10KB以上
开启ICMP协议（用于ping测试）
静态IP设为192.168.1.10（与PC同一网段）

有个坑要注意：默认的MEM_SIZE可能太小，会导致网络不稳定。我一般设置为1600字节，这个值要大于最大传输单元(MTU)。

2.4 FreeRTOS任务配置

创建两个任务：

以太网初始化任务（优先级适中）
应用任务（如数据收发）

任务栈大小不要吝啬，建议给以太网任务至少1024字。我曾经因为栈溢出导致各种奇怪的网络故障，调试了很久才发现问题。

3. 关键代码实现

3.1 PHY复位代码

在StartDefaultTask中添加PHY复位代码：

void StartDefaultTask(void *argument) { // PHY硬件复位 HAL_GPIO_WritePin(ETH_RST_GPIO_Port, ETH_RST_Pin, GPIO_PIN_RESET); osDelay(100); HAL_GPIO_WritePin(ETH_RST_GPIO_Port, ETH_RST_Pin, GPIO_PIN_SET); osDelay(100); // LWIP初始化 MX_LWIP_Init(); while(1) { osDelay(1000); } }

3.2 网络状态检测

添加链路状态检测很有必要：

void ethernet_link_thread(void *arg) { struct netif *netif = (struct netif *)arg; for(;;) { if(netif_is_link_up(netif)) { // 链路正常 LED_ON; } else { // 链路断开 LED_OFF; } osDelay(500); } }

3.3 Ping测试优化

默认的ping响应可能不稳定，可以优化lwipopts.h中的配置：

#define LWIP_RAW 1 #define RAW_TTL 255 #define IP_REASSEMBLY 1 #define IP_FRAG 1

4. 常见问题排查

4.1 Ping不通的排查步骤

检查网线连接状态灯是否亮起
用示波器测量RMII参考时钟(50MHz)
查看PHY寄存器状态（特别是BSR和PHYID）
检查防火墙是否阻止了ICMP包

4.2 DMA描述符错误

如果遇到DMA错误，可能是内存对齐问题。确保tx/rx描述符和缓冲区在DMA可访问的内存区域：

__ALIGN_BEGIN ETH_DMADescTypeDef DMARxDscrTab[ETH_RX_DESC_CNT] __ALIGN_END; __ALIGN_BEGIN ETH_DMADescTypeDef DMATxDscrTab[ETH_TX_DESC_CNT] __ALIGN_END;

4.3 性能优化技巧

启用ETH中断模式而非轮询
调整LWIP内存池大小
使用Zero-copy API提高吞吐量
开启硬件校验和卸载

我在项目中发现，启用TCP窗口缩放选项可以显著提高传输速率：

#define LWIP_WND_SCALE 1 #define TCP_RCV_SCALE 2

5. 进阶应用开发

5.1 UDP数据收发示例

void udp_echoserver_recv(void *arg, struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *addr, u16_t port) { // 回传接收到的数据 udp_sendto(pcb, p, addr, port); pbuf_free(p); } void udp_echoserver_init(void) { struct udp_pcb *pcb = udp_new(); udp_bind(pcb, IP_ADDR_ANY, 7); udp_recv(pcb, udp_echoserver_recv, NULL); }

5.2 Web服务器实现

使用HTTP协议需要添加以下组件：

在CubeMX中启用HTTPD
实现网页文件系统
配置CGI处理函数

一个简单的页面更新示例：

const char * const g_pcHtmlHead = "HTTP/1.1 200 OK\r\n" "Content-type: text/html\r\n" "Connection: close\r\n\r\n"; void http_server_serve(struct netconn *conn) { struct netbuf *inbuf; char *buf; u16_t buflen; netconn_recv(conn, &inbuf); netbuf_data(inbuf, (void**)&buf, &buflen); // 解析请求并响应 netconn_write(conn, g_pcHtmlHead, strlen(g_pcHtmlHead), NETCONN_COPY); netconn_close(conn); netbuf_delete(inbuf); }

5.3 安全加固建议

启用MAC地址过滤
实现ARP防护
限制最大连接数
使用TLS加密重要通信

我在实际项目中会添加看门狗监控网络任务，防止死锁：

void NetworkTask(void *argument) { MX_LWIP_Init(); while(1) { // 处理网络事件 sys_check_timeouts(); // 喂狗 HAL_IWDG_Refresh(&hiwdg); osDelay(100); } }

基于STM32CubeMX的FreeRTOS+LAN8720A+LWIP以太网通信实战指南