📚 课程目录第1章 LwIP协议栈源码获取与工程结构解析

1. LwIP协议栈源码获取与工程结构解析

任务目标

获取LwIP协议栈源码，梳理其核心目录结构与关键文件职责，为后续在嵌入式平台上的移植工作建立清晰的代码地图。本案例以当前最新的稳定版本lwip-2.2.0为例进行解析。

源码获取

LwIP官方源码托管在Savannah和非官方GitHub镜像上，推荐使用Git克隆或直接下载压缩包：

# 方式一：从官方Savannah仓库获取（推荐）
git clone git://git.savannah.nongnu.org/lwip.git
cd lwip
git checkout STABLE-2_2_0

# 方式二：直接下载release压缩包
# 访问 https://download.savannah.gnu.org/releases/lwip/ 下载 lwip-2.2.0.zip

顶层目录结构

获取源码后，顶层目录组织如下（仅列出核心内容）：

lwip/
├── src/                  # LwIP协议栈全部源码
│   ├── core/             # 核心协议实现（与平台无关）
│   ├── include/          # 协议栈内部头文件
│   ├── netif/            # 网络接口抽象层（网卡驱动注册等）
│   └── api/              # 高层的Sequential API和Socket API
├── doc/                  # 文档（contrib.txt, rawapi.txt等）
├── test/                 # 单元测试与集成测试
├── CHANGELOG             # 版本变更记录
└── CONTRIBUTING          # 贡献指南

src/core 核心协议栈

该目录是协议栈的心脏，全部实现与具体硬件无关，主要子目录及关键文件如下：

src/core/
├── ipv4/                 # IPv4协议实现（autoip.c, dhcp.c, ip4.c, ip4_addr.c）
├── ipv6/                 # IPv6协议实现（dhcp6.c, ip6.c, ip6_addr.c）
├── altcp/                # 应用层TCP封装（TLS等）
├── def.c                 # 字节序转换、内存拷贝等基础函数
├── dns.c                 # DNS客户端
├── init.c                # lwip_init()入口，协议栈全局初始化
├── mem.c                 # 内存堆管理（heap）
├── memp.c                # 内存池管理（pool）
├── netif.c               # 网络接口核心管理（netif_add, netif_find等）
├── pbuf.c                # 数据包缓冲区管理（pbuf结构）
├── raw.c                 # RAW API（底层回调接口）
├── stats.c               # 统计信息（需LWIP_STATS开启）
├── sys.c                # 与OS相关的超时与临界区封装
├── tcp.c                 # TCP核心（PCB管理、状态机）
├── tcp_in.c              # TCP输入处理
├── tcp_out.c             # TCP输出处理
├── udp.c                 # UDP协议实现
└── timers.c              # 协议栈内部定时器管理

src/include 头文件体系

头文件分为两类：协议栈内部头文件与用户配置文件。其中最关键的是lwip/opt.h，它是全局配置的总入口，所有编译选项均通过它进行开关：

src/include/
├── lwip/                 # 核心头文件（opt.h, mem.h, pbuf.h, tcp.h等）
│   └── lwipopts.h        # 用户自定义配置（此文件默认不存在，需用户创建）
└── netif/                # 网卡驱动接口头文件（ethernet.h等）

移植关键点：用户必须在编译时提供自己的lwipopts.h，该文件通过#include "lwip/opt.h"中预设的默认值进行覆盖。若未提供，则使用opt.h中的默认配置。

src/netif 与 src/api 层

netif目录包含以太网接口的通用实现（ethernet.c）以及loopback接口。实际网卡驱动（如STM32的ETH驱动）需要用户根据netif.h中的struct netif接口自行实现。api目录则提供了Socket API（sockets.c）和Netconn API（api_lib.c, api_msg.c），它们依赖于底层core模块，并需要操作系统信号量支持。

验证方法

源码获取与结构解析的验证不涉及编译运行，而是通过以下静态检查确认理解正确：

在源码根目录执行git describe --tags，确认当前检出版本为STABLE-2_2_0。
确认src/core/init.c中存在void lwip_init(void)函数定义。
确认src/include/lwip/opt.h文件末尾存在#ifndef LWIP_HDR_OPTS_H之类的防止重复包含的宏，且文件内包含大量#ifndef LWIP_XXX形式的默认配置宏。
在src/include/lwip/目录下执行ls lwipopts.h，预期输出为空（该文件需用户自行创建）。

以上检查全部通过，即说明源码获取完整、目录结构理解正确，且明确了移植时用户配置文件的接入位置。