开源 lwIP：单片机上的轻量 TCP/IP 协议栈

MCU 要联网时，第一反应往往是：Linux 协议栈太重，自己从零写 TCP 又不现实。中间那条路——在几万到几百 KB RAM 里跑出能用的 TCP/UDP——过去二十年里，答案高度集中在一个名字上：lwIP（Lightweight IP）。

它不是「又一个玩具 demo」。STM32Cube 一键生成网络工程、ESP-IDF 默认 TCP/IP、无数 FreeRTOS + 以太网/Wi‑Fi 模组的量产设备，底层都能摸到 lwIP 或其衍生品的影子。

• 官网 / 文档：https://savannah.nongnu.org/projects/lwip/ · https://www.nongnu.org/lwip/
• 源码：Savannah Git（lwip.git）
• 许可：BSD 风格
• 出身：Adam Dunkels 一脉（与早期 Contiki / uIP 同一作者脉络）

一、它到底是什么

名字拆开就是字面意思：Light-weight IP。设计目标从来不是取代 Linux 内核网络子系统，而是：

在 MCU 上，怎样用可控的内存与 CPU，实现「够用的」IP 通信？

核心可以记五件事：

它不是完整操作系统，也不是 HTTP 服务器本身。更贴切的比喻是：嵌入式界的「轻量网卡协议栈」——你提供收发包驱动，它负责把比特变成连接。

一句话：要完整 Unix 网络能力上 Linux；要 MCU 上能量产的 TCP/IP，先问 lwIP。

二、三个常见误解

≠ GitHub 星少就等于没人用。
官方主线在 Savannah。GitHub 上多为镜像、移植层、教学 fork，星数不能代表真实装机量。看生态：芯片厂示例、IDF、CubeMX 模板——那里才是「星」。

≠ 开了 Socket 就等于「和 Linux 一样」。
BSD Socket 兼容是「风格接近」，不是 POSIX 全集。阻塞语义、select/poll 能力、线程模型都受 lwipopts.h 与 NO_SYS 配置约束。把桌面网络代码原样拷进来，常会在细节上翻车。

≠ 默认配置就能随便打满百兆。
吞吐取决于：PBUF 池大小、TCP 窗口、校验和卸载、驱动 DMA、中断与线程优先级。很多「lwIP 好慢」其实是池太小、零拷贝没做、或应用在回调里干重活。栈能到什么速度，往往先问网卡驱动与内存配置。

三、架构：网卡之上，应用之下

软件栈从下往上看：

一包数据进来时，路径大致是：

上手时真正会碰到的，多半是下面几条：

1. lwipopts.h（软件裁什么）
   开不开 TCP、连接数、mempool、超时、校验和——几乎所有「调优」从这里开始。换板可以，换这份配置往往比换板更频繁。

2. netif 驱动
   netif_add、输入函数、输出回调、链路状态。以太网常见 DMA 环形缓冲；Wi‑Fi 则是模组事件喂进栈。

3. 定时器
   TCP 重传、ARP、DHCP 都要心跳。裸机要自己周期调用；RTOS 里常有 tcpip 线程统一处理。

4. API 选择
   极致省资源、事件驱动 → Raw；想顺序写逻辑又有 RTOS → Netconn；想少改应用代码 → Socket。

四、常见落地形态

五、谁适合用、谁不适合

多半会喜欢的：

• MCU / 小 MPU 要 TCP 或 UDP 量产联网
• 已经在 Cube / IDF / 厂商 SDK 里看到 lwIP，想搞懂而不是只会抄例程
• 需要 可裁剪：连接数不多、功能集可控
• 许可清晰，方便进商业产品
• 和 MQTT / HTTP 客户端、Modbus TCP 等应用层库组合

建议别硬上的：

• 板子已经是 Linux，还要自己维护一份用户态 lwIP——通常多余（特殊隧道/用户态栈另说）
• 要完整防火墙、复杂策略路由、容器网络——那是 Linux 的活
• 完全不看 lwipopts.h，却抱怨「连不上 / 易断 / 慢」——先查配置与内存池
• 在中断里做重逻辑、在 Raw 回调里阻塞——属于经典踩坑，不是栈「不稳」

六、怎么动手

1. 别先啃全部源码——先在官方或厂商示例上跑通 ping / TCP echo
2. 认清你的 API——例程是 Socket 还是 Raw，决定你怎么写业务
3. 打开并读一遍 lwipopts.h——连接数、MEM_SIZE、PBUF、TCP 窗口，标出和板子 RAM 的关系
4. 确认链路层——网线/DHCP 是否拿到地址；Wi‑Fi 是否关联；netif 是否 UP
5. 再用 Wireshark / 抓包——三次握手、重传、窗口，比盲目加 log 快

七、和 uIP、FreeRTOS+TCP、Zephyr 网络栈怎么选

八、优缺点

优点

• 专为受限设备设计，可裁剪、可商用（BSD 风格）
• 生态极广：ST、Espressif 等主流路径都能碰上
• 三种 API 覆盖从极致嵌入到接近 socket 编程
• 文档与社区讨论多，问题大多能搜到「同类踩坑」

缺点

• 主仓不在 GitHub 热榜，新人找「官方星标仓」容易迷路
• 配置项多，lwipopts.h 调不好就表现为偶发断连、卡死、吞吐差
• Socket 兼容是子集，桌面代码迁移要改预期
• 高性能场景要懂驱动与零拷贝，不能当黑盒

九、写在最后

下次再给单片机加网口或 Wi‑Fi 时，不妨先问一句：我们要的是 Linux 那套完整网络世界，还是一份能塞进 MCU 的、可裁剪的 TCP/IP？

lwIP 把路走窄了，也走实了：窄在不做通用 OS 网络子系统；实在无数量产固件里默默转发每一包。它不靠刷星证明自己，靠的是——你打开厂商工程时，头文件里已经写着 lwip。