LwIP Application Developers Manual12---Configuring lwIP
1.前言
2.LwIP makefiles
- With minimal features
C_SOURCES = \ src/api/err.c \ src/core/init.c \ src/core/mem.c \ src/core/memp.c \ src/core/netif.c \ src/core/pbuf.c \ src/core/stats.c \ src/core/udp.c \ src/core/ipv4/icmp.c \ src/core/ipv4/inet.c \ src/core/ipv4/ip.c \ src/core/ipv4/ip_addr.c \ src/core/ipv4/ip_frag.c \ src/netif/etharp.c \
- With all other features (with any Sequential API)
C_SOURCES = \ src/api/netifapi.c \ src/api/err.c \ src/core/dhcp.c \ src/core/init.c \ src/core/mem.c \ src/core/memp.c \ src/core/netif.c \ src/core/pbuf.c \ src/core/raw.c \ src/core/stats.c \ src/core/udp.c \ src/core/ipv4/autoip.c \ src/core/ipv4/icmp.c \ src/core/ipv4/igmp.c \ src/core/ipv4/inet.c \ src/core/ipv4/ip.c \ src/core/ipv4/ip_addr.c \ src/core/ipv4/ip_frag.c \ src/core/snmp/asn1_dec.c \ src/core/snmp/asn1_enc.c \ src/core/snmp/mib2.c \ src/core/snmp/mib_structs.c \ src/core/snmp/msg_in.c \ src/core/snmp/msg_out.c \ src/netif/etharp.c \
- With all other features (with Socket API)
C_SOURCES = \ src/api/api_lib.c \ src/api/api_msg.c \ src/api/err.c \ src/api/netbuf.c \ src/api/netifapi.c \ src/api/sockets.c \ src/api/tcpip.c \ src/core/dhcp.c \ src/core/init.c \ src/core/mem.c \ src/core/memp.c \ src/core/netif.c \ src/core/pbuf.c \ src/core/raw.c \ src/core/stats.c \ src/core/udp.c \ src/core/ipv4/autoip.c \ src/core/ipv4/icmp.c \ src/core/ipv4/igmp.c \ src/core/ipv4/inet.c \ src/core/ipv4/ip.c \ src/core/ipv4/ip_addr.c \ src/core/ipv4/ip_frag.c \ src/core/snmp/asn1_dec.c \ src/core/snmp/asn1_enc.c \ src/core/snmp/mib2.c \ src/core/snmp/mib_structs.c \ src/core/snmp/msg_in.c \ src/core/snmp/msg_out.c \ src/netif/etharp.c \
3. Lwipopts.h
lwipopts.h是一个用户文件，你可以使用它来配置lwIP和它的所有模块。你可以不需要定义每一个lwIP的选项，如果你没有定义该选项，一个默认的选项将会被使用。因此，你的lwipopts.h可以重定义许多lwIP的行为
3.1 Module support (Code size)
你可以调整代码的大小通过只编译你想要的特性。如下列表给出了原装lwIP编译时支持的特性：
1. 默认包含
- ARP (LWIP_ARP)
- IP and fragmentation (IP_FRAG) and reassembly (IP_REASSEMBLY)
- Raw IP PCB support (LWIP_RAW)
- UDP (LWIP_UDP) and UDP-Lite (LWIP_UDPLITE)
- TCP (LWIP_TCP) -- this is a big one!
- Statistics (LWIP_STATS)
2.默认不包含的
如果你想要改变这些特性，你只需要设置其相关的选项。举例，如果你想要失能UDP并且使能DHCP，那么你可以在lwipopts.h文件中加入如下代码：
// Disable UDP #define LWIP_UDP 0 // Enable DHCP #define LWIP_DHCP 1
3.2 Memory management (RAM usage)
3.2.1.内存池
在一个嵌入式环境中，内存池（memory pools）使内存的分配更加快速和高效。
lwIP提供一个灵活的方法来管理和组织内存池。lwIP在数据段中保留了一个固定大小的静态内存，该内存被分成各种池来保存各种数据结构。
比如，一个内存池专门为存放结构体tcp_pcb，另一个内存池专门为存放结构体udp_pcb。
每个池可以被配置用来保存固定数目的数据结构，该数目的大小可以通过改变lwipopts.h文件里面定义的MEMP_NUM_*数值，比如，MEMP_NUM_TCP_PCB（控制tcp_pcb的数目）和MEMP_NUM_UDP_PCB（控制udp_pcb的数目）。
除了lwIP提供的标准内存池，用户还可以自定义内存池。
3.2.2.Dynamic allocation: mem_malloc
lwIP使用mem_malloc自定义函数来动态分配内存，因此，改变lwIP如何使用RAM是方便的。如下提供了3种解决方案：
1）.(默认)lwIP自定义基于堆的函数mem_malloc。默认，lwIP使用一个已分配的静态内存块，像堆，来进行内存处理。使用MEM_SIZE可以改变lwIP堆的大小。
2）.C标准库中的malloc和free。如果你希望lwIP使用标准函数库（由编译器/架构提供）来进行内存管理，那么你就要定义选项MEM_LIBC_MALLOC。
3）.内存池。lwIP可以仿真内存的动态分配，通过使用custom memory pools（详情请查看相关章节）。如果要使用该解决方案则要包含了MEM_USE_POOLS和MEMP_USE_CUSTOM_POOLS选项和一个新的定制文件lwippools.h。
3.2.3.Understanding/changing memory usage
lwIP使用内存来：
- n 存放代码（使用ROM还是RAM取决于你的系统）
- n 静态分配变量（一些有初始化，一些则没有）
- n 任务的堆栈
- n 动态内存分配：堆和memp内存池
除非你使用C库堆的实现（通过定义MEM_LIBC_MALLOC=1），否则已分配的动态内存必须在其它地方静态分配。
这意味着你要保留一定大小的内存给堆（heap）或memp池使用，在运行时代码会动态分配内存。堆和memp池的大小可以被调整来减少RAM的使用：
- 有3种类型的pbufs:REF/ROM,RAM和POOL。POOL的大小由PBUF_POOL_SIZE*PBUF_POOL_BUFSIZE来决定。(TODO)
- RAM pbufs在内存中分配的大小由MEM_SIZE（该内存并不经常被使用，除了RAM pbufs）决定。它在mem_memory中被分配。(TODO)
- REF/ROM pbufs和pcbs还有其他一些stuff通过专用的内存池并根据其结构类型来分配大小。结构体的数量由各种MEMP_NUM_*来定义。总的来说，这个内存被分配为memp_memory并且它包括了pbuf POOL.(TODO)
然而，如果你在lwipopts.h文件里定义了MEMP_MEM_MALLOC的值为1，那么每一个动态分配的内存都来自堆（heap）（该大小被MEM_SIZE定义）。如果你也定义了MEM_LIBC_MALLOC的值为1，则lwIP并不需要额外的内存来动态分配内存，使用C库的堆就够用了。然而，你还是要确保这个堆足够大来运行你的应用。为了调整各种MEMP_NUM_数值，你可以定义LWIP_STATS=1和LWIP_STATS_DISPLAY=1并且调用stats_display来查看每个池使用的具体情况（或者查看全局变量lwip_stats）。
3.3 Fine-tuning even more
你可以打开lwip/src/include/lwip/opt.h文件来查看你可设置哪些选项。该文件注释完整并且解释了多少选项可以被使用。
4. lwIP code size
todo
5. Maximizing throughput
todo
6. Tuning TCP
todo
7. Custom memory pools
todo
