国产MCU上LwIP协议栈移植与稳定性优化实战

1. 项目缘起与整体设计思路1.1 为什么要在国产MCU上跑LwIP这几年国产MCU的出货量涨得很快GD32、兆易创新、华大、极海、国民技术这些牌子在工业控制、物联网终端、电力采集、智能家居网关里用得越来越多。很多项目原本跑在STM32F4或者F7上用的是ST官方的以太网外设加LwIP协议栈方案成熟、资料多、踩坑少。但一旦切换到国产MCU尤其是带以太网MAC的型号比如GD32F4系列、GD32F407、GD32F450或者一些国产RISC-V内核带MAC的芯片LwIP的移植和调优就变成了一个绕不开的坎。LwIP本身是一个轻量级IP协议栈设计目标就是在资源受限的嵌入式系统里跑TCP/IP。它的内存占用可以压到几十KB RAM加几十KB Flash支持TCP、UDP、ICMP、DHCP、DNS、MQTT、HTTP等常用协议。但“能跑”和“跑得稳”之间差距很大。我在实际项目里见过太多情况ping通了几百个包就开始丢TCP连接一并发就卡死DHCP获取地址偶尔失败长时间运行后内存碎片导致系统崩溃。这些问题在STM32上可能不明显因为ST的驱动和LwIP适配层已经打磨了很多年但换到国产MCU上PHY驱动、DMA描述符、Cache一致性、中断优先级这些细节都需要重新审视。这个项目的核心目标很明确在国产MCU平台上把LwIP从“能通”做到“稳定运行”覆盖协议栈配置优化、网络驱动适配、内存管理、异常恢复这几个关键环节。适合正在做国产化替代的嵌入式工程师、物联网终端开发者以及需要把网络功能落到实际产品里的团队参考。1.2 整体方案选型与架构设计在国产MCU上跑LwIP架构上一般有两种选择裸机加LwIP或者RTOS加LwIP。裸机方案适合功能单一、实时性要求不高的场景比如简单的数据上报终端。RTOS方案适合多任务、需要同时处理网络和本地逻辑的场景比如网关设备。我这次的项目用的是FreeRTOS加LwIP的组合MCU选的是GD32F450带10/100M以太网MACPHY用的是LAN8720A通过RMII接口连接。为什么选这个组合第一GD32F450的以太网MAC和STM32F4的MAC寄存器高度相似LwIP的ethernetif驱动可以基于ST的模板改移植成本低。第二FreeRTOS在国产MCU上的移植已经非常成熟任务调度和信号量机制可以很好地配合LwIP的tcpip_thread。第三LAN8720A这颗PHY便宜、供货稳、驱动简单RMII接口只需要两根线加一个时钟硬件设计上比MII省引脚。整体架构分三层最底层是MCU的以太网MAC加DMA描述符环中间是PHY驱动和LwIP的ethernetif接口层最上面是LwIP协议栈和应用层。应用层通过netconn或者socket API和协议栈交互协议栈内部通过tcpip_thread统一处理收发。这个架构的关键在于MAC的DMA收发中断要正确配置PHY的链路状态要实时监测LwIP的内存池要按实际业务量调整否则稳定性无从谈起。1.3 国产MCU与STM32在LwIP移植上的差异点很多人觉得国产MCU就是抄STM32寄存器一样、库一样直接拿ST的代码改改就能跑。实际做下来差异点不少而且这些差异往往就是稳定性问题的根源。第一个差异是以太网MAC的DMA描述符对齐和Cache处理。GD32F450有CacheSTM32F4也有但两者的Cache配置和MPU设置不完全一样。LwIP的收发缓冲区如果放在Cacheable区域DMA写入后CPU读到的可能是旧数据必须做Cache无效化操作。ST的驱动里有一套Cache维护的宏移植到GD32时需要确认这些宏是否适用否则会出现“ping通但数据错乱”的怪现象。第二个差异是中断优先级和中断嵌套。GD32的中断控制器和STM32的NVIC在优先级分组上兼容但国产MCU的中断响应延迟可能略有不同。以太网收发中断的优先级如果设得太低高速收发时容易丢包设得太高又可能影响其他关键中断。我一般把以太网中断设在中等优先级比SysTick高比电机控制或串口DMA中断低。第三个差异是PHY的复位和时钟配置。LAN8720A需要50MHz的REF_CLKGD32F450可以通过MCO输出或者外部晶振提供。如果时钟不稳PHY链路会频繁掉线。这个问题在STM32上可能被ST的默认配置掩盖了但国产MCU的时钟树配置需要自己仔细核对。2. LwIP协议栈配置与内存管理优化2.1 lwipopts.h关键参数逐项拆解LwIP的配置全在lwipopts.h里这个文件决定了协议栈的行为和资源占用。很多人直接拿示例配置改个IP就用了结果跑起来各种问题。我把几个关键参数按实际项目经验拆开讲。MEM_SIZE这是LwIP的堆大小用于动态分配pbuf和协议栈内部结构。默认值1600太小跑TCP并发连接肯定不够。我的建议是按业务量算每个TCP连接大约需要2-4KB的堆空间加上pbuf池和协议控制块如果同时有5个TCP连接MEM_SIZE至少设到16KB。但也不能太大国产MCU的RAM通常只有128KB到256KB堆太大会挤占其他任务的空间。MEMP_NUM_PBUFpbuf结构体的数量。每个pbuf大约16字节这个参数决定了同时能有多少个pbuf在流转。如果做高速数据收发比如每秒几MB的吞吐这个值要设到32以上。我实测GD32F450跑100M以太网MEMP_NUM_PBUF设16时大包收发会丢设32后稳定。PBUF_POOL_SIZEpbuf池的大小用于接收数据。每个pbuf池元素包含一个pbuf结构体加一个数据缓冲区缓冲区大小由PBUF_POOL_BUFSIZE决定。如果PBUF_POOL_BUFSIZE设成1528以太网最大帧每个元素占大约1.5KBPBUF_POOL_SIZE设8就是12KB RAM。这个值要根据同时接收的帧数来定太小会丢包太大浪费RAM。TCP_SND_BUF和TCP_WND发送缓冲区和接收窗口大小。这两个值直接影响TCP吞吐。默认的TCP_SND_BUF是256太小TCP会频繁等待ACK。我一般设到4倍MSSMSS通常是1460所以TCP_SND_BUF设5840。TCP_WND同理设5840。但要注意这两个值乘以并发连接数不能超过MEM_SIZE。TCPIP_THREAD_STACKSIZEtcpip_thread的栈大小。这个线程处理所有协议栈内部逻辑栈太小会溢出。默认值可能只有几百字节我设到1024以上跑MQTT和HTTP时设2048。LWIP_NETCONN和LWIP_SOCKET如果应用层用netconn API开LWIP_NETCONN如果用socket API开LWIP_SOCKET。两者可以同时开但socket API会多占一些资源。我一般用netconn更轻量。2.2 内存池与堆的分配策略LwIP的内存管理有两种内存池memp和堆mem。内存池用于固定大小的结构体比如pbuf、TCP控制块、UDP控制块分配和释放速度快不会产生碎片。堆用于变长分配比如应用层的数据缓冲区灵活但可能碎片化。在国产MCU上RAM紧张必须精打细算。我的策略是所有协议栈内部结构用内存池应用层数据用静态数组或自己的内存管理尽量不用LwIP的堆。具体做法是把MEM_SIZE设小一点比如4KB只用于协议栈内部的临时分配pbuf池和TCP控制块池按实际需求设够。这样即使长时间运行也不会因为堆碎片导致分配失败。还有一个细节LwIP的内存池可以配置为从静态数组分配不依赖malloc。在lwipopts.h里定义MEM_LIBC_MALLOC为0然后LwIP会用自己的内存池实现。这样避免了和RTOS的堆管理器冲突也更容易排查内存问题。2.3 国产MCU RAM受限下的裁剪技巧国产MCU的RAM通常比同档STM32小比如GD32F450有256KB RAM但有些型号只有128KB甚至64KB。在RAM受限的情况下LwIP需要做裁剪。第一个裁剪点是关闭不用的协议。如果只需要TCP和UDP可以关掉ICMP、IGMP、DNS、DHCP。但注意关掉ICMP后ping不通调试会不方便建议调试阶段开着量产再关。第二个裁剪点是减小pbuf池的缓冲区大小。如果业务数据都是小包比如传感器上报可以把PBUF_POOL_BUFSIZE从1528降到512这样每个pbuf池元素只占512字节PBUF_POOL_SIZE可以设更多。但要注意如果收到大包LwIP会用pbuf链来拼接会增加处理开销。第三个裁剪点是调整TCP控制块的数量。MEMP_NUM_TCP_PCB决定了同时能有多少个TCP连接。如果业务只需要2个连接设4就够了设多了浪费RAM。第四个裁剪点是关闭统计和调试输出。LWIP_STATS和LWIP_DEBUG会占用不少Flash和RAM量产时关掉。3. 以太网驱动适配与PHY调试实战3.1 GD32F450以太网MAC初始化流程GD32F450的以太网MAC初始化分几步时钟使能、GPIO配置、MAC寄存器配置、DMA描述符初始化、PHY初始化、中断配置。每一步都有坑。时钟使能方面GD32F450的以太网MAC挂在AHB1总线上需要使能RCU_AHB1EN中的ENET时钟。同时RMII的REF_CLK需要配置PA1为AF11或者用MCO输出50MHz。我一般用外部25MHz晶振经PLL倍频后通过MCO输出这样时钟更稳。GPIO配置方面RMII接口需要配置PA1REF_CLK、PA2MDIO、PA7CRS_DV、PC1MDC、PC4RXD0、PC5RXD1、PB11TX_EN、PB12TXD0、PB13TXD1。这些引脚要设为复用推挽输出速度设到最高。注意PA1如果用作REF_CLK输入要设为浮空输入或复用输入。MAC寄存器配置方面关键寄存器是ENET_MAC_CFG和ENET_MAC_FRMF。ENET_MAC_CFG要设置速度10M/100M、双工模式、CRC校验、自动填充等。ENET_MAC_FRMF要设置接收所有帧或只接收目标地址匹配的帧。调试阶段可以设接收所有帧方便抓包。DMA描述符初始化是重点。GD32F450的以太网DMA有独立的发送和接收描述符环每个描述符包含状态、控制、缓冲区地址等字段。描述符必须按4字节对齐缓冲区地址必须按4字节对齐。我一般把描述符和缓冲区放在非Cache区域或者手动做Cache维护。3.2 LAN8720A PHY的寄存器配置与链路检测LAN8720A的配置相对简单但有几个关键寄存器必须设对。BCR基本控制寄存器的bit15是软复位bit13是速度选择bit12是自动协商使能。BSR基本状态寄存器的bit2是链路状态bit5是自动协商完成。PHY地址由PHYAD0引脚决定LAN8720A的PHYAD0默认下拉地址是0。初始化流程先软复位PHY等待复位完成然后设置自动协商等待协商完成最后读取BSR确认链路状态和速度。如果链路没起来检查REF_CLK是否有50MHzMDIO/MDC是否通信正常。链路检测我一般用两种方式一是轮询BSR的bit2二是用PHY的中断引脚。轮询简单但占CPU中断高效但需要配置PHY的中断寄存器。实际项目里我用轮询每500ms读一次BSR链路状态变化时更新LwIP的netif状态。3.3 DMA描述符与Cache一致性处理Cache一致性是国产MCU跑LwIP最容易出问题的地方。GD32F450有L1 CacheDMA直接访问RAM时如果RAM区域是Cacheable的CPU读到的可能是Cache里的旧数据。解决方法有两种一是把DMA缓冲区放在非Cache区域通过MPU配置二是每次DMA收发后手动做Cache无效化或清理。我一般用第二种因为MPU配置容易影响其他区域。具体做法接收时DMA把数据写入缓冲区后CPU在读取前调用SCB_InvalidateDCache_by_Addr无效化对应Cache行发送时CPU把数据写入缓冲区后在启动DMA前调用SCB_CleanDCache_by_Addr清理Cache。注意地址要按32字节对齐长度要按Cache行大小对齐。还有一个坑描述符本身也可能被Cache缓存。如果描述符在Cacheable区域DMA更新描述符状态后CPU读到的可能是旧状态。所以描述符区域最好也做Cache维护或者直接放在非Cache区域。3.4 中断优先级与收发中断处理以太网中断的优先级配置很关键。GD32F450的中断优先级分组一般用NVIC_PRIORITYGROUP_44位抢占优先级0位子优先级。以太网中断我设在抢占优先级5比SysTick通常15高比串口DMA通常3低。这样网络收发不会被SysTick打断但也不会阻塞串口通信。收发中断处理要尽量短。接收中断里只做一件事把DMA描述符的状态清零然后给tcpip_thread发信号量让它在任务上下文里处理pbuf。发送中断里释放已发送的pbuf更新发送队列。不要在中断里调用LwIP的API因为LwIP不是中断安全的。如果收发量大中断会频繁触发CPU占用高。可以考虑用轮询加中断的混合模式低速时用中断高速时用轮询。但实现复杂一般项目用中断就够了。4. 网络稳定性实战与问题排查4.1 长时间运行下的内存泄漏排查LwIP跑久了出问题十有八九是内存泄漏。表现是刚开始正常跑几小时后ping延迟变大TCP连接建立失败最后系统死机。排查方法是打开LwIP的统计功能定期打印memp和mem的使用情况。具体操作在lwipopts.h里开LWIP_STATS和MEMP_STATS然后在应用里每隔一段时间调用stats_display()或者直接读memp_pools数组的used字段。如果发现某个池的used数持续增长不下降说明有泄漏。常见的泄漏点TCP连接关闭后没有释放pcbpbuf没有freenetconn没有delete。我遇到过一种情况TCP客户端断开后服务器端的pcb没有进入TIME_WAIT状态而是一直保持在ESTABLISHED导致pcb池耗尽。原因是TCP的keepalive没开或者应用层没有正确处理断开事件。解决方法是开LWIP_TCP_KEEPALIVE设置合理的keepidle、keepintvl、keepcnt。4.2 TCP并发连接卡死的定位与解决TCP并发连接卡死是另一个常见问题。表现是单个连接正常多个连接同时收发时某个连接突然不响应超时后断开。定位方法是抓包加日志。抓包看TCP的窗口大小和重传情况日志看LwIP的pbuf分配和tcpip_thread的处理时间。我遇到过一次4个TCP连接同时传数据跑了十几分钟后其中一个连接卡死。抓包发现该连接的接收窗口变成0说明LwIP的接收缓冲区满了应用层没及时读走数据。原因是应用层的任务优先级太低被其他任务抢占导致netconn_recv调用不及时。解决方法是提高应用任务的优先级或者增大TCP_WND。还有一个原因是tcpip_thread的栈溢出。tcpip_thread处理所有协议栈消息如果栈太小处理大包时会溢出导致系统异常。我把TCPIP_THREAD_STACKSIZE从1024加到2048后问题消失。4.3 DHCP获取地址失败的排查路径DHCP获取地址失败在国产MCU上也不少见。排查路径先确认链路是否起来PHY的BSR bit2是否为1再确认LwIP的netif是否upnetif-flags是否包含NETIF_FLAG_UP然后确认DHCP的端口67和68是否被防火墙拦截最后看DHCP服务器的地址池是否耗尽。我遇到过一次GD32F450的DHCP一直获取不到地址但手动设静态IP能通。抓包发现DHCP Discover发出去了但没收到Offer。检查发现是MAC地址过滤的问题交换机的端口安全只允许特定MAC。改成静态MAC后解决。还有一个坑LwIP的DHCP默认会尝试无限次如果网络里没有DHCP服务器会一直发Discover占用CPU。可以设置DHCP_DOES_ARP_CHECK为0减少ARP检查或者设置DHCP_TIMEOUT为有限次失败后回退到静态IP。4.4 常见问题速查表问题现象可能原因排查方法解决方案ping不通链路未起、IP冲突、防火墙查PHY BSR、抓包检查REF_CLK、改IP、关防火墙ping通但丢包Cache不一致、DMA描述符错查Cache维护、描述符对齐做Cache无效化、对齐描述符TCP连接卡死接收窗口满、栈溢出抓包看窗口、查栈使用增大TCP_WND、加栈DHCP失败MAC过滤、无服务器抓包看Discover/Offer改MAC、设静态IP长时间运行死机内存泄漏、碎片查memp used、mem统计修泄漏、用内存池吞吐低TCP_SND_BUF小、中断频繁查配置、测吞吐增大缓冲、优化中断4.5 实操心得与避坑技巧第一个心得调试LwIP一定要有抓包工具。Wireshark加交换机端口镜像或者用MCU的调试串口打印LwIP的调试信息。没有抓包很多问题只能猜。第二个心得国产MCU的以太网驱动不要直接抄ST的要逐寄存器核对。GD32和STM32的MAC寄存器大部分兼容但有些位定义不同比如DMA的突发长度、中断使能位。抄错了可能当时能跑压力测试就出问题。第三个心得LwIP的配置要按业务量算不要拍脑袋。MEM_SIZE、PBUF_POOL_SIZE、TCP_SND_BUF这些参数先估算并发连接数和数据吞吐再留50%余量。设太小会丢包设太大浪费RAM。第四个心得长时间运行测试至少跑72小时。很多内存泄漏和碎片问题在短时间内看不出来跑一天可能没事跑三天就崩。测试时用脚本定期ping和传数据记录延迟和丢包率。第五个心得PHY的复位引脚一定要接不要省。有些硬件设计为了省一个GPIO把PHY复位直接接电源结果PHY上电时序不对链路起不来。加一个GPIO控制复位初始化时拉低再拉高能解决很多玄学问题。第六个心得如果MCU没有USB差分信号引脚又想用USB转以太网可以考虑用SPI接口的以太网控制器比如ENC28J60或W5500。W5500自带硬件TCP/IP协议栈不占MCU的LwIP资源适合RAM特别紧张的国产MCU。但W5500的吞吐不如内置MAC适合低速场景。第七个心得AI辅助设计MCU编程现在越来越成熟比如用AI工具生成LwIP的配置代码、排查编译错误、解释寄存器定义。但AI生成的代码不能直接量产必须自己核对寄存器和时序。我一般用AI做初稿然后逐行审查。第八个心得MCU日志存储对排查网络问题很有帮助。可以在Flash里划一块区域用环形缓冲区记录LwIP的关键事件比如连接建立、断开、错误码。出问题时把日志读出来比串口打印更可靠因为串口可能被其他任务占用。这个项目后续还可以扩展的方向加MQTT over TLS用mbedTLS做加密加OTA升级通过HTTP或MQTT下发固件加多网口冗余用两个PHY做链路备份。但每一步都要先保证基础网络的稳定性否则上层功能都是空中楼阁。