前言在嵌入式开发领域网络功能已经成为越来越多产品的标配。从智能家居设备到工业控制器从物联网网关到车载电子几乎都离不开 TCP/IP 网络通信。而在资源受限的嵌入式系统中LWIPLightweight Internet Protocol无疑是最流行、最实用的 TCP/IP 协议栈实现。我在过去几年的嵌入式开发工作中多次在不同的 MCU 平台STM32F1/F4/F7、ESP32、TLSR8258 等上移植和使用 LWIP踩过无数的坑也积累了一些经验。这篇文章不是 LWIP 的 API 手册而是我个人学习和使用 LWIP 的心得体会希望能帮助正在入门 LWIP 的朋友们少走弯路快速掌握这门必备技能。一、LWIP 是什么为什么要学它1.1 LWIP 简介LWIP 是由瑞典计算机科学学院SICS的 Adam Dunkels 开发的一个轻量级 TCP/IP 协议栈专门为资源受限的嵌入式系统设计。它的核心设计目标是在保持 TCP 协议主要功能的前提下尽可能减少内存占用和代码量。一个最小的 LWIP 内核只需要几十 KB 的 ROM 和几 KB 的 RAM这使得它可以运行在只有几十 KB RAM 的 8 位或 16 位单片机上。同时LWIP 也支持多线程操作系统能够充分利用 32 位 MCU 的性能。1.2 为什么选择 LWIP在嵌入式网络开发中我们有多种选择使用 MCU 厂商提供的网络库如 STM32 的 HAL 库网络部分使用商业 TCP/IP 协议栈使用开源的 LWIP 协议栈我强烈推荐学习和使用 LWIP原因如下开源免费LWIP 采用 BSD 许可证可以免费用于商业产品没有版权问题轻量级资源占用极低适合绝大多数嵌入式系统功能完整支持 IP、ICMP、UDP、TCP、DNS、DHCP、HTTP、TFTP 等常用协议可移植性强与硬件和操作系统无关几乎可以移植到任何平台社区活跃持续更新有大量的资料和案例可以参考行业标准几乎所有的嵌入式网络开发岗位都要求掌握 LWIP1.3 学习 LWIP 的前提条件在学习 LWIP 之前你需要具备以下基础知识C 语言编程基础指针、结构体、函数指针等基本的计算机网络知识TCP/IP 协议、IP 地址、端口号等嵌入式开发基础单片机原理、GPIO、串口、定时器等至少会使用一种 RTOS如 FreeRTOS、RT-Thread 等二、学习 LWIP 的正确路径很多初学者在学习 LWIP 时一上来就去看源码结果越看越糊涂最后放弃了。其实学习 LWIP 有一个循序渐进的过程按照正确的路径学习会事半功倍。2.1 第一阶段快速上手跑通第一个例程目标在自己的开发板上跑通 LWIP 的基本例程建立感性认识学习内容了解 LWIP 的目录结构和基本文件学习如何将 LWIP 移植到自己的平台重点是网卡驱动和系统接口跑通 ping 例程确保网络连通跑通 TCP 客户端和服务器例程跑通 UDP 例程学习方法不要一开始就深入源码先学会使用参考官方例程和开发板提供的例程使用 Wireshark 抓包观察网络数据包的交互遇到问题先查官方文档和社区论坛2.2 第二阶段深入理解核心概念目标理解 LWIP 的设计思想和核心机制能够解决常见问题学习内容LWIP 的内存管理机制内存池、堆内存pbuf 结构体和数据包处理流程netif 网络接口结构LWIP 的三种编程接口RAW API、NETCONN API、SOCKET APITCP 连接的建立、数据传输和关闭过程UDP 数据报的发送和接收过程学习方法结合源码和文档逐行分析关键函数单步调试跟踪数据包的处理流程自己动手修改例程验证自己的理解总结常见问题的解决方法2.3 第三阶段实战应用开发实际项目目标能够在实际项目中灵活运用 LWIP开发稳定可靠的网络应用学习内容HTTP 服务器和客户端开发MQTT 客户端开发DNS 域名解析DHCP 自动获取 IP 地址网络性能优化网络错误处理和重连机制学习方法从简单的应用开始逐步增加功能注重代码的稳定性和可维护性进行充分的测试特别是长时间稳定性测试学习优秀的开源项目代码2.4 第四阶段深入源码优化和定制目标能够根据项目需求修改和优化 LWIP 源码学习内容LWIP 的内核架构和任务调度TCP 拥塞控制算法内存管理优化性能优化自定义协议的实现学习方法通读 LWIP 的核心源码分析 LWIP 的性能瓶颈针对项目需求进行定制化修改参与 LWIP 社区与其他开发者交流三、LWIP 核心概念详解3.1 内存管理内存管理是 LWIP 最重要的部分之一也是最容易出问题的地方。LWIP 提供了两种内存管理方式内存池memp用于分配固定大小的内存块速度快不会产生内存碎片堆内存mem用于分配任意大小的内存块灵活但可能产生内存碎片关键配置项MEMP_NUM_PBUFpbuf 结构体的数量MEMP_NUM_TCP_PCBTCP 控制块的数量MEMP_NUM_UDP_PCBUDP 控制块的数量MEM_SIZE堆内存的大小常见问题内存泄漏忘记释放内存导致系统运行一段时间后崩溃内存不足配置的内存太小无法分配足够的内存块内存碎片频繁分配和释放不同大小的堆内存3.2 pbuf 结构体pbufPacket Buffer是 LWIP 中用来表示网络数据包的结构体。所有的网络数据都通过 pbuf 来传递。pbuf 有四种类型PBUF_RAM数据存储在 RAM 中由 LWIP 分配PBUF_ROM数据存储在 ROM 中不需要释放PBUF_REF引用外部数据不需要释放PBUF_POOL从内存池中分配速度最快重要函数pbuf_alloc()分配一个 pbufpbuf_free()释放一个 pbufpbuf_copy()复制一个 pbufpbuf_chain()将多个 pbuf 链接在一起3.3 三种编程接口LWIP 提供了三种不同层次的编程接口适用于不同的应用场景表格接口类型特点适用场景RAW API基于回调函数不需要操作系统性能最高资源非常受限的系统对性能要求高的应用NETCONN API基于操作系统的信号量和邮箱线程安全大多数嵌入式应用平衡性能和易用性SOCKET API标准的 BSD Socket 接口最易用有足够资源的系统需要快速开发的应用我的建议如果你的系统没有操作系统只能使用 RAW API如果你的系统有操作系统优先使用 NETCONN API它比 SOCKET API 性能更好除非你有特殊需求否则不要使用 SOCKET API它在 LWIP 中的实现效率不高3.4 TCP 连接管理TCP 是一个面向连接的、可靠的传输层协议。LWIP 的 TCP 实现虽然精简但包含了 TCP 协议的所有核心功能。TCP 连接的三个阶段建立连接三次握手数据传输滑动窗口、确认重传、拥塞控制关闭连接四次挥手关键配置项TCP_WNDTCP 接收窗口大小TCP_SND_BUFTCP 发送缓冲区大小TCP_MSS最大分段大小TCP_TMR_INTERVALTCP 定时器间隔四、LWIP 开发常见坑点与解决方案这部分是我踩过无数坑总结出来的经验也是这篇文章最有价值的部分。4.1 内存相关问题问题 1系统运行一段时间后无法建立新的 TCP 连接原因TCP 控制块内存泄漏当 TCP 连接异常关闭时控制块没有被正确释放解决方案确保在所有可能的情况下都调用了tcp_close()或tcp_abort()增加MEMP_NUM_TCP_PCB的数量使用tcp_poll()函数定期检查连接状态问题 2发送大数据时系统崩溃或数据丢失原因发送缓冲区不足或者 pbuf 链太长解决方案增加TCP_SND_BUF的大小分块发送数据不要一次性发送太大的数据使用tcp_sndbuf()函数检查发送缓冲区的可用空间4.2 网络连接问题问题 3ping 不通开发板原因网卡驱动有问题或者 LWIP 配置错误解决方案检查网卡的硬件连接检查 MAC 地址和 IP 地址的配置检查网卡驱动的接收和发送函数使用 Wireshark 抓包看是否有数据包发出问题 4TCP 连接建立后很快就断开原因TCP 保活机制没有开启或者网络不稳定解决方案开启 TCP 保活机制#define LWIP_TCP_KEEPALIVE 1实现应用层的心跳机制增加重连机制4.3 性能问题问题 5网络传输速度慢原因LWIP 配置不合理或者网卡驱动效率低解决方案增加TCP_WND和TCP_SND_BUF的大小开启TCP_NODELAY选项禁用 Nagle 算法优化网卡驱动使用 DMA 传输关闭不必要的调试信息五、LWIP 实用调试技巧5.1 开启 LWIP 调试信息LWIP 提供了非常详细的调试信息可以帮助我们快速定位问题。在lwipopts.h文件中开启相应的调试选项#define LWIP_DEBUG 1 #define TCP_DEBUG LWIP_DBG_ON #define UDP_DEBUG LWIP_DBG_ON #define IP_DEBUG LWIP_DBG_ON #define NETIF_DEBUG LWIP_DBG_ON5.2 使用 Wireshark 抓包Wireshark 是网络调试的神器没有之一。通过 Wireshark 抓包我们可以清楚地看到网络数据包的交互过程从而定位问题所在。常用过滤规则ip.addr 192.168.1.100只显示与指定 IP 地址的通信tcp.port 80只显示 80 端口的 TCP 通信udp.port 53只显示 DNS 查询icmp只显示 ping 包5.3 统计信息查看LWIP 提供了统计信息功能可以查看各种协议的数据包收发情况、错误情况等#include lwip/stats.h void print_lwip_stats(void) { printf(IP stats:\n); printf( rx: %d\n, stats.ip.recv); printf( tx: %d\n, stats.ip.xmit); printf( drop: %d\n, stats.ip.drop); printf(TCP stats:\n); printf( rx: %d\n, stats.tcp.recv); printf( tx: %d\n, stats.tcp.xmit); printf( drop: %d\n, stats.tcp.drop); }六、进阶学习方向当你掌握了 LWIP 的基本使用后可以向以下方向深入学习网络安全学习 TLS/SSL 协议使用 mbedtls 库实现加密通信物联网协议学习 MQTT、CoAP 等物联网常用协议网络性能优化深入研究 TCP 拥塞控制算法优化网络传输性能IPv6 支持学习 LWIP 的 IPv6 实现网络驱动开发学习以太网、WiFi、蓝牙等网络接口的驱动开发七、学习资源推荐7.1 官方资源LWIP 官方网站https://www.nongnu.org/lwip/LWIP 官方文档https://www.nongnu.org/lwip/2_1_x/index.htmlLWIP 源码仓库https://git.savannah.gnu.org/git/lwip.git7.2 书籍推荐《TCP/IP 详解 卷 1协议》网络协议的圣经必读《嵌入式网络那些事STM32 物联实战》非常适合初学者的 LWIP 入门书籍《LWIP 协议栈源码详解与应用开发》深入讲解 LWIP 源码的书籍7.3 在线资源CSDN 博客有大量的 LWIP 移植和使用教程正点原子、野火等开发板的教程GitHub 上的开源项目八、总结LWIP 是嵌入式网络开发的基石掌握 LWIP 是每个嵌入式工程师的必备技能。学习 LWIP 不是一蹴而就的事情需要理论与实践相结合不断地踩坑、总结、再实践。这篇文章只是一个入门指南更多的知识还需要你在实际开发中去学习和积累。希望这篇文章能够帮助你打开 LWIP 的大门在嵌入式网络开发的道路上越走越远。最后送给大家一句话纸上得来终觉浅绝知此事要躬行。多动手多实践才是学习 LWIP 的最好方法。互动环节你在学习 LWIP 的过程中遇到过哪些问题欢迎在评论区留言我们一起交流讨论。如果这篇文章对你有帮助别忘了点赞、收藏、关注三连你的支持是我创作的最大动力