一、前言
最近项目的上使用有线以太网功能，软件协议使用LWIP协议，操做系统使用Rt thread 3.1.3版本，硬件使用STM32F429+PHY LAN8720方式。这篇记录总结lwip的详细配置。编程
二、配置文件种类
lwip的配置文件有lwipopts.h和opt.h两个头文件，其余中opt.h文件是lwip的默认配置文件，不须要修改此文件，lwipopts.h是用于配置lwip的文件，用户的对协议的配置请在这个文件中增长与修改，lwipopts.h文件中定义宏会覆盖到opt.h默认配置宏，让用户定义的新宏起做用。因为使用操做系统rt thread, 操做系统中还有一个配置文件rtconfig.h文件，rtconfig.h中有一些关于lwip协议配置的宏。宏会被lwipopts.h所引用。api
2.1 lwIP为使用TCP/IP协议通讯的应用程序编程提供了两种接口接口（APIs）：
* 低层次的称之为"core" / "callback" 或者 "raw" API缓存
* 高层次的称之为"sequential" API 服务器
lwIP "sequential" API为使用TCP/IP协议栈编程提供符合常规的、通用的途径，它与BSD socket API很是类似。程序的执行过程一样是基于"open-read-write-close"模型的。从本质上讲，TCP/IP协议栈的通讯过程是事件驱动的，所以，TCP/IP的代码和用户应用程序的代码必须在不一样的线程里面。网络
RAW IP容许应用程序和TCP/IP代码紧密结合，程序的执行是基于在TCP/IP内核中被调用的回调函数事件驱动的。TCP/IP内核和应用程序能够运行在同一线程。lwIP "sequential" API接口会消耗大量的CPU资源，它并不适用于小型嵌入式系统，由于它必须运行在多线程环境中。session
RAW API不只执行速度快，并且消耗的内存资源更少。它的缺点是应用程序编写相对较难并不易理解。尽管如此，这种方式还是资源较少的嵌入式系统的首选方法。数据结构
不一样的应用程序中咱们能够同时使用这两种APIs，实际上"sequential" API就是由RAW API封装后获得的。多线程
2.2 通讯接口
网络的应用层编程通常都是基于socket接口编程 ，在建立socket时，会指定协议簇及链接类型，lwip协议中链接类型支持3种，TCP类型链接，UDP类型链接， RAW类型的链接。并发
socket(AF_INET, SOCK_STREAM, IPPROTO_TCP)) 建立一个tcp链接，协议内部使用占用一个TCP类型的控制块数据结构app
socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP) 建立一个udp链接，协议内部使用占用一个UDP类型的控制块数据结构
socketsocket(AF_INET , SOCK_RAW , IPPROTO_TCP) 建立一个raw(原始)链接，协议内部使用占用一个RAW类型的控制块数据结构， 此链接接收到的数据中包含tcp,ip的数据头部分
三、 配置头文件详细说明
3.1 rtconfig配置文件
rtconfig文件用于配置整个rt thread操做系统，包括使用的lwip协议，下面只节取其中关于lwip协议部分的配置。
#define RT_USING_LWIP /*控制操做系统使用lwip协议 */ /* RT_USING_LWIP141 is not set */ #define RT_USING_LWIP202 /*选用2.0.2版本的lwip协议 */ /* RT_USING_LWIP210 is not set */ /* RT_LWIP_IGMP is not set */ /* IGMP协议关闭 */ #define RT_LWIP_ICMP /* 使能ICMP协议功能 */ /* RT_LWIP_SNMP is not set */ #define RT_LWIP_DNS /* 使能DNS 动态域名解析功能 */ #define RT_LWIP_DHCP /* 使能DHCP动态主机配置协议功能*/ #define IP_SOF_BROADCAST 1 /* 使能广播包过滤功能 */ #define IP_SOF_BROADCAST_RECV 1 /* 使能接收广播过滤功能 */ /* Static IPv4 Address */ #define RT_LWIP_IPADDR "192.168.10.30" /*协议配置为静态IP时的默认IP地址，网关地址，子网掩码*/ #define RT_LWIP_GWADDR "192.168.10.1" #define RT_LWIP_MSKADDR "255.255.255.0" /* end of Static IPv4 Address */ #define RT_LWIP_UDP /*使能udp协议 */ #define RT_LWIP_TCP /*使能tcp协议 */ #define RT_LWIP_RAW /*使能raw接口编程，此接口是用于支持无操做系统，上层的TCP，UDP socket接口最后会调用RAW接口函数*/ /* RT_LWIP_PPP is not set */ #define RT_MEMP_NUM_NETCONN 8 /*内存池中netcon结构的数量8 这个参数控制着应用层能创建的socet的数量，也就是能同时支持多少个socket链接,此值应该大于MEMP_NUM_NETCONN > (MEMP_NUM_TCP_PCB+MEMP_NUM_TCP_PCB_LISTEN+MEMP_NUM_UDP_PCB+MEMP_NUM_RAW_PCB)*/ #define RT_LWIP_PBUF_NUM 16 /*pbuf的数量， pbuf用于以太网数据包的存储并在协议栈中传递数据使用*/ #define RT_LWIP_RAW_PCB_NUM 4 /*协议中支持的RAW控制块的数量，一个raw(原始)链接占用一个控制块，原始链接能够额外处理IP头，TCP头，UDP头等数据*/ #define RT_LWIP_UDP_PCB_NUM 4 /*协议中支持的udp控制块的数量，一个udp链接占用一个udp的控制块*/ #define RT_LWIP_TCP_PCB_NUM 4 /*协议中支持的tcp控制块的数量，一个tcp链接占用一个tcp控制块*/ #define RT_LWIP_TCP_SEG_NUM 40 /* TCP段的数量，应该比TCP发送段数量大TCP_SND_QUEUELEN，此数量用于分配存储TCP数据段的内存池的数量，即程序能缓冲多少个TCP数据段*/ #define RT_LWIP_TCP_SND_BUF 8196 /* TCP发送缓存的大小，发送缓存要至少能容纳2个TCP段的大小，一个TCP段的大小1460*/ #define RT_LWIP_TCP_WND 8196 /* TCP接收窗口的大小，单位字节，TCP根据本身的处理能力调节接收窗口的大小，告知发送方我如今能接收多少数据，实现了相似流量控制的功能*/ #define RT_LWIP_TCPTHREAD_PRIORITY 10 /* TCP核心处理线程的优先级，建议比底层的MAC数据的接收与发送线程优先级高，实现快速处理掉接收数据*/ #define RT_LWIP_TCPTHREAD_MBOX_SIZE 10 /* TCP核心线程的使用的消息邮箱的大小，消息邮箱大能够缓存更多的处理数据*/ #define RT_LWIP_TCPTHREAD_STACKSIZE 1024 /* TCP核心线程的堆栈大小 */ /* LWIP_NO_RX_THREAD is not set */ /* LWIP_NO_TX_THREAD is not set */ #define RT_LWIP_ETHTHREAD_PRIORITY 13 /* MAC层数据发送线程和接收线程的优先级 */ #define RT_LWIP_ETHTHREAD_STACKSIZE 1024 /* MAC层数据发送线程和接收线程的堆栈 */ #define RT_LWIP_ETHTHREAD_MBOX_SIZE 8 /* MAC层数据发送线程和接收线程的使用的邮箱大小，邮箱变大能够缓存更多的以太网mac层数据 */ /* RT_LWIP_REASSEMBLY_FRAG is not set */ #define LWIP_NETIF_STATUS_CALLBACK 1 /* 使能网络接口层的状态回调函数功能 */ #define LWIP_NETIF_LINK_CALLBACK 1 /* 使能网络接口层的link回调函数功能 */ #define SO_REUSE 1 /* 使能socket的SO_REUSEADDR功能，具体请见3.2节的功能介绍*/ #define LWIP_SO_RCVTIMEO 1 /* 使能接收超时功能，即调用接收函数recv, recvfrom能够设置超时间时间，超时到了没有数据返回错误*/ #define LWIP_SO_SNDTIMEO 1 /* 使能发送超时功能，即调用发送函数send, sendto能够设置超时间时间，超时到了没有数据返回错误*/ #define LWIP_SO_RCVBUF 1 /* 使能设置socket接收缓冲区在大小的功能选项*/ /* RT_LWIP_NETIF_LOOPBACK is not set */ #define LWIP_NETIF_LOOPBACK 0 /* 关闭环回网络接口 */ /* RT_LWIP_STATS is not set */ /* RT_LWIP_USING_HW_CHECKSUM is not set */ /* 禁止硬件MAC层计算校验和功能，采用软件计算 */ #define RT_LWIP_USING_PING /* 使能网卡接口ping命令的功能 */ /* RT_LWIP_DEBUG is not set */ /* 禁止lwip协议内部的调试打印信息 */ /* end of light weight TCP/IP stack */
3.2 SO_REUSEADDR功能
通常来讲，一个端口释放后会等待两分钟2MSL的时间以后才能再被使用，SO_REUSEADDR是让端口释放后当即就能够被再次使用。
SO_REUSEADDR用于对TCP套接字处于TIME_WAIT状态下的socket，才能够重复绑定使用
server程序老是应该在调用bind()以前设置SO_REUSEADDR套接字选项
TCP，先调用close()的一方会进入TIME_WAIT状态
SO_REUSEADDR提供以下四个功能：
- 容许启动一个监听服务器并捆绑其众所周知端口，即便之前创建的将此端口用作他们的本地端口的链接仍存在。这一般是重启监听服务器时出现，若不设置此选项，则bind时将出错
- 容许在同一端口上启动同一服务器的多个实例，只要每一个实例捆绑一个不一样的本地IP地址便可。对于TCP，咱们根本不可能启动捆绑相同IP地址和相同端口号的多个服务器。
- 容许单个进程捆绑同一端口到多个套接口上，只要每一个捆绑指定不一样的本地IP地址便可。这通常不用于TCP服务器。
- SO_REUSEADDR容许彻底重复的捆绑：
当一个IP地址和端口绑定到某个套接口上时，还容许此IP地址和端口捆绑到另外一个套接口上。通常来讲，这个特性仅在支持多播的系统上才有，并且只对UDP套接口而言（TCP不支持多播）
3.3 lwipopts.h配置文件
lwipopts.h头文件用于对lwip协议的配置的用户自定义部分。其中定义的配置宏比rtconfig.h中还要多一些，若是修改一些在rtconfig.h中没有配置，能够在此文件中修改。此文件中配置lwip协议的主要配置文件。
ifndef __LWIPOPTS_H__ #define __LWIPOPTS_H__ #include <rtconfig.h> #define ERRNO 1 #define LWIP_IPV4 1 #ifdef RT_USING_LWIP_IPV6 #define LWIP_IPV6 1 #else #define LWIP_IPV6 0 #endif /* RT_USING_LWIP_IPV6 */ #define NO_SYS 0 #define LWIP_SOCKET 1 #define LWIP_NETCONN 1 #ifdef RT_LWIP_IGMP #define LWIP_IGMP 1 #else #define LWIP_IGMP 0 #endif #ifdef RT_LWIP_ICMP #define LWIP_ICMP 1 #else #define LWIP_ICMP 0 #endif #ifdef RT_LWIP_SNMP #define LWIP_SNMP 1 #else #define LWIP_SNMP 0 #endif #ifdef RT_LWIP_DNS #define LWIP_DNS 1 #else #define LWIP_DNS 0 #endif #define LWIP_HAVE_LOOPIF 0 /*关闭环回接口，此宏用于设置本地环回接口的名称为localhost接口，打开环回功能时还要设置LWIP_NETIF_LOOPBACK 为1*/ #define LWIP_PLATFORM_BYTESWAP 0 /*LWIP硬件平台的字节顺序交换功能，未被lwip协议代码使用这个宏*/ #ifndef BYTE_ORDER #define BYTE_ORDER LITTLE_ENDIAN /*定义处理器的大端与小端功能，用于变换网络字节顺序与主机顺序时使用*/ #endif /* #define RT_LWIP_DEBUG */ #ifdef RT_LWIP_DEBUG #define LWIP_DEBUG #endif /* ---------- Debug options ---------- */ #ifdef LWIP_DEBUG #ifdef RT_LWIP_SYS_DEBUG #define SYS_DEBUG LWIP_DBG_ON #else #define SYS_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_ETHARP_DEBUG #define ETHARP_DEBUG LWIP_DBG_ON #else #define ETHARP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_PPP_DEBUG #define PPP_DEBUG LWIP_DBG_ON #else #define PPP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_MEM_DEBUG #define MEM_DEBUG LWIP_DBG_ON #else #define MEM_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_MEMP_DEBUG #define MEMP_DEBUG LWIP_DBG_ON #else #define MEMP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_PBUF_DEBUG #define PBUF_DEBUG LWIP_DBG_ON #else #define PBUF_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_API_LIB_DEBUG #define API_LIB_DEBUG LWIP_DBG_ON #else #define API_LIB_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_API_MSG_DEBUG #define API_MSG_DEBUG LWIP_DBG_ON #else #define API_MSG_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_TCPIP_DEBUG #define TCPIP_DEBUG LWIP_DBG_ON #else #define TCPIP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_NETIF_DEBUG #define NETIF_DEBUG LWIP_DBG_ON #else #define NETIF_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_SOCKETS_DEBUG #define SOCKETS_DEBUG LWIP_DBG_ON #else #define SOCKETS_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_DNS_DEBUG #define DNS_DEBUG LWIP_DBG_ON #else #define DNS_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_AUTOIP_DEBUG #define AUTOIP_DEBUG LWIP_DBG_ON #else #define AUTOIP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_DHCP_DEBUG #define DHCP_DEBUG LWIP_DBG_ON #else #define DHCP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_IP_DEBUG #define IP_DEBUG LWIP_DBG_ON #else #define IP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_IP_REASS_DEBUG #define IP_REASS_DEBUG LWIP_DBG_ON #else #define IP_REASS_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_ICMP_DEBUG #define ICMP_DEBUG LWIP_DBG_ON #else #define ICMP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_IGMP_DEBUG #define IGMP_DEBUG LWIP_DBG_ON #else #define IGMP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_UDP_DEBUG #define UDP_DEBUG LWIP_DBG_ON #else #define UDP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_TCP_DEBUG #define TCP_DEBUG LWIP_DBG_ON #else #define TCP_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_TCP_INPUT_DEBUG #define TCP_INPUT_DEBUG LWIP_DBG_ON #else #define TCP_INPUT_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_TCP_OUTPUT_DEBUG #define TCP_OUTPUT_DEBUG LWIP_DBG_ON #else #define TCP_OUTPUT_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_TCP_RTO_DEBUG #define TCP_RTO_DEBUG LWIP_DBG_ON #else #define TCP_RTO_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_TCP_CWND_DEBUG #define TCP_CWND_DEBUG LWIP_DBG_ON #else #define TCP_CWND_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_TCP_WND_DEBUG #define TCP_WND_DEBUG LWIP_DBG_ON #else #define TCP_WND_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_TCP_FR_DEBUG #define TCP_FR_DEBUG LWIP_DBG_ON #else #define TCP_FR_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_TCP_QLEN_DEBUG #define TCP_QLEN_DEBUG LWIP_DBG_ON #else #define TCP_QLEN_DEBUG LWIP_DBG_OFF #endif #ifdef RT_LWIP_TCP_RST_DEBUG #define TCP_RST_DEBUG LWIP_DBG_ON #else #define TCP_RST_DEBUG LWIP_DBG_OFF #endif #endif /* LWIP_DEBUG */ #define LWIP_DBG_TYPES_ON (LWIP_DBG_ON|LWIP_DBG_TRACE|LWIP_DBG_STATE|LWIP_DBG_FRESH|LWIP_DBG_HALT) /* ---------- Memory options ---------- */ #define MEM_ALIGNMENT 4 /*动态内存堆中按4字节对齐 */ #define MEMP_OVERFLOW_CHECK 1 // /*使能内存池的溢出检测功能 */ #define LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT 1 //// //#define MEM_LIBC_MALLOC 1 //#define MEM_USE_POOLS 1 //#define MEMP_USE_CUSTOM_POOLS 1 //#define MEM_SIZE (1024*64) #define MEMP_MEM_MALLOC 0 /* lwip的内存堆未使用协议自带的，调用系统的动态内存堆*/ /* MEMP_NUM_PBUF: the number of memp struct pbufs. If the application sends a lot of data out of ROM (or other static memory), this should be set high. */ #define MEMP_NUM_PBUF 32 //16 /* the number of struct netconns */ #ifdef RT_MEMP_NUM_NETCONN #define MEMP_NUM_NETCONN RT_MEMP_NUM_NETCONN #endif /* the number of UDP protocol control blocks. One per active RAW "connection". */ #ifdef RT_LWIP_RAW_PCB_NUM #define MEMP_NUM_RAW_PCB RT_LWIP_RAW_PCB_NUM #endif /* the number of UDP protocol control blocks. One per active UDP "connection". */ #ifdef RT_LWIP_UDP_PCB_NUM #define MEMP_NUM_UDP_PCB RT_LWIP_UDP_PCB_NUM #endif /* the number of simulatenously active TCP connections. */ #ifdef RT_LWIP_TCP_PCB_NUM #define MEMP_NUM_TCP_PCB RT_LWIP_TCP_PCB_NUM #endif /* the number of simultaneously queued TCP */ #ifdef RT_LWIP_TCP_SEG_NUM #define MEMP_NUM_TCP_SEG RT_LWIP_TCP_SEG_NUM #else #define MEMP_NUM_TCP_SEG TCP_SND_QUEUELEN #endif /* * You can re-define following setting in rtcofnig.h to overwrite the default * setting in the lwip opts.h */ /* MEMP_NUM_NETBUF: the number of struct netbufs. */ // #define MEMP_NUM_NETBUF 2 /* MEMP_NUM_NETCONN: the number of struct netconns. */ // #define MEMP_NUM_NETCONN 4 /* MEMP_NUM_TCPIP_MSG_*: the number of struct tcpip_msg, which is used for sequential API communication and incoming packets. Used in src/api/tcpip.c. */ // #define MEMP_NUM_TCPIP_MSG_API 16 // #define MEMP_NUM_TCPIP_MSG_INPKT 16 /* ---------- Pbuf options ---------- */ /* PBUF_POOL_SIZE: the number of buffers in the pbuf pool. */ #ifdef RT_LWIP_PBUF_NUM #define PBUF_POOL_SIZE RT_LWIP_PBUF_NUM #endif /* PBUF_POOL_BUFSIZE: the size of each pbuf in the pbuf pool. */ #ifdef RT_LWIP_PBUF_POOL_BUFSIZE #define PBUF_POOL_BUFSIZE RT_LWIP_PBUF_POOL_BUFSIZE #endif /* PBUF_LINK_HLEN: the number of bytes that should be allocated for a link level header. */ #define PBUF_LINK_HLEN 16 #ifdef RT_LWIP_ETH_PAD_SIZE #define ETH_PAD_SIZE RT_LWIP_ETH_PAD_SIZE #endif /** SYS_LIGHTWEIGHT_PROT * define SYS_LIGHTWEIGHT_PROT in lwipopts.h if you want inter-task protection * for certain critical regions during buffer allocation, deallocation and memory * allocation and deallocation. */ #define SYS_LIGHTWEIGHT_PROT (NO_SYS==0) /*使能关键的内存分配保护 */ #ifdef LWIP_USING_NAT #define IP_NAT 1 #else #define IP_NAT 0 #endif /* ---------- TCP options ---------- */ #ifdef RT_LWIP_TCP #define LWIP_TCP 1 #else #define LWIP_TCP 0 #endif #define TCP_TTL 255 /* Controls if TCP should queue segments that arrive out of order. Define to 0 if your device is low on memory. */ #define TCP_QUEUE_OOSEQ 1 /* TCP Maximum segment size. */ #define TCP_MSS 1460 /* 一个tcp段的大小 */ /* TCP sender buffer space (bytes). */ #ifdef RT_LWIP_TCP_SND_BUF #define TCP_SND_BUF RT_LWIP_TCP_SND_BUF #else #define TCP_SND_BUF (TCP_MSS * 2) #endif /* TCP sender buffer space (pbufs). This must be at least = 2 * TCP_SND_BUF/TCP_MSS for things to work. */ #define TCP_SND_QUEUELEN (4 * TCP_SND_BUF/TCP_MSS) /* TCP writable space (bytes). This must be less than or equal to TCP_SND_BUF. It is the amount of space which must be available in the tcp snd_buf for select to return writable */ #define TCP_SNDLOWAT (TCP_SND_BUF/2) #define TCP_SNDQUEUELOWAT TCP_SND_QUEUELEN/2 /* TCP receive window. */ #ifdef RT_LWIP_TCP_WND #define TCP_WND RT_LWIP_TCP_WND #else #define TCP_WND (TCP_MSS * 2) #endif /* Maximum number of retransmissions of data segments. */ #define TCP_MAXRTX 12 /* Maximum number of retransmissions of SYN segments. */ #define TCP_SYNMAXRTX 4 /* tcpip thread options */ #ifdef RT_LWIP_TCPTHREAD_PRIORITY #define TCPIP_MBOX_SIZE RT_LWIP_TCPTHREAD_MBOX_SIZE #define TCPIP_THREAD_PRIO RT_LWIP_TCPTHREAD_PRIORITY #define TCPIP_THREAD_STACKSIZE RT_LWIP_TCPTHREAD_STACKSIZE #else #define TCPIP_MBOX_SIZE 8 #define TCPIP_THREAD_PRIO 128 #define TCPIP_THREAD_STACKSIZE 4096 #endif #define TCPIP_THREAD_NAME "tcpip" /*tcp核心线程的名称 */ #define DEFAULT_TCP_RECVMBOX_SIZE 10 /*tcp链接接收邮箱的大小*/ /* ---------- ARP options ---------- */ #define LWIP_ARP 1 /*使能ARP功能 */ #define ARP_TABLE_SIZE 10 /*ARP地址表的大小 */ #define ARP_QUEUEING 1 /* ARP队列*/ /* ---------- Checksum options ---------- */ #ifdef RT_LWIP_USING_HW_CHECKSUM #define CHECKSUM_GEN_IP 0 #define CHECKSUM_GEN_UDP 0 #define CHECKSUM_GEN_TCP 0 #define CHECKSUM_GEN_ICMP 0 #define CHECKSUM_CHECK_IP 0 #define CHECKSUM_CHECK_UDP 0 #define CHECKSUM_CHECK_TCP 0 #define CHECKSUM_CHECK_ICMP 0 #endif /* ---------- IP options ---------- */ /* Define IP_FORWARD to 1 if you wish to have the ability to forward IP packets across network interfaces. If you are going to run lwIP on a device with only one network interface, define this to 0. */ #define IP_FORWARD 0 /* IP reassembly and segmentation.These are orthogonal even * if they both deal with IP fragments */ #ifdef RT_LWIP_REASSEMBLY_FRAG #define IP_REASSEMBLY 1 #define IP_FRAG 1 #define IP_REASS_MAX_PBUFS 10 #define MEMP_NUM_REASSDATA 10 #else #define IP_REASSEMBLY 0 #define IP_FRAG 0 #endif /* ---------- ICMP options ---------- */ #define ICMP_TTL 255 /* ---------- DHCP options ---------- */ /* Define LWIP_DHCP to 1 if you want DHCP configuration of interfaces. */ #ifdef RT_LWIP_DHCP #define LWIP_DHCP 1 #else #define LWIP_DHCP 0 #endif /* 1 if you want to do an ARP check on the offered address (recommended). */ #define DHCP_DOES_ARP_CHECK (LWIP_DHCP) /* ---------- AUTOIP options ------- */ #define LWIP_AUTOIP 0 #define LWIP_DHCP_AUTOIP_COOP (LWIP_DHCP && LWIP_AUTOIP) /* ---------- UDP options ---------- */ #ifdef RT_LWIP_UDP #define LWIP_UDP 1 #else #define LWIP_UDP 0 #endif #define LWIP_UDPLITE 0 #define UDP_TTL 255 #define DEFAULT_UDP_RECVMBOX_SIZE 1 /* UDP数据的接收的邮箱的大小 */ /* ---------- RAW options ---------- */ #ifdef RT_LWIP_RAW #define LWIP_RAW 1 #else #define LWIP_RAW 0 #endif #define DEFAULT_RAW_RECVMBOX_SIZE 1 /* RAW接收邮箱的大小 */ #define DEFAULT_ACCEPTMBOX_SIZE 10 /*accept函数的接收邮箱大小 */ /* ---------- Statistics options ---------- */ #ifdef RT_LWIP_STATS #define LWIP_STATS 1 #define LWIP_STATS_DISPLAY 1 #else #define LWIP_STATS 0 #endif #if LWIP_STATS #define LINK_STATS 1 #define IP_STATS 1 #define ICMP_STATS 1 #define IGMP_STATS 1 #define IPFRAG_STATS 1 #define UDP_STATS 1 #define TCP_STATS 1 #define MEM_STATS 1 #define MEMP_STATS 1 #define PBUF_STATS 1 #define SYS_STATS 1 #define MIB2_STATS 1 #endif /* LWIP_STATS */ /* ---------- PPP options ---------- */ #ifdef RT_LWIP_PPP /* 使能PPP协议*/ #define PPP_SUPPORT 1 /* Set > 0 for PPP */ #else #define PPP_SUPPORT 0 /* Set > 0 for PPP */ #endif #if PPP_SUPPORT #define NUM_PPP 1 /* Max PPP sessions. */ /* Select modules to enable. Ideally these would be set in the makefile but * we're limited by the command line length so you need to modify the settings * in this file. */ #ifdef RT_LWIP_PPPOE /*使能支持PPOE功能*/ #define PPPOE_SUPPORT 1 #else #define PPPOE_SUPPORT 0 #endif #ifdef RT_LWIP_PPPOS #define PPPOS_SUPPORT 1 #else #define PPPOS_SUPPORT 0 #endif /*如下为ppp协议相关的配置*/ #define PAP_SUPPORT 1 /* Set > 0 for PAP. */ #define CHAP_SUPPORT 1 /* Set > 0 for CHAP. */ #define MSCHAP_SUPPORT 0 /* Set > 0 for MSCHAP (NOT FUNCTIONAL!) */ #define CBCP_SUPPORT 0 /* Set > 0 for CBCP (NOT FUNCTIONAL!) */ #define CCP_SUPPORT 0 /* Set > 0 for CCP (NOT FUNCTIONAL!) */ #define VJ_SUPPORT 1 /* Set > 0 for VJ header compression. */ #define MD5_SUPPORT 1 /* Set > 0 for MD5 (see also CHAP) */ #endif /* PPP_SUPPORT */ /** * LWIP_POSIX_SOCKETS_IO_NAMES==1: Enable POSIX-style sockets functions names. * Disable this option if you use a POSIX operating system that uses the same * names (read, write & close). (only used if you use sockets.c) */ #ifndef LWIP_POSIX_SOCKETS_IO_NAMES #define LWIP_POSIX_SOCKETS_IO_NAMES 0 #endif /** * LWIP_TCP_KEEPALIVE==1: Enable TCP_KEEPIDLE, TCP_KEEPINTVL and TCP_KEEPCNT * options processing. Note that TCP_KEEPIDLE and TCP_KEEPINTVL have to be set * in seconds. (does not require sockets.c, and will affect tcp.c) */ #ifndef LWIP_TCP_KEEPALIVE /*使能tcp连接的keepalive功能 此功能用于协议栈自动回收长时间没有数据通讯的TCP链接，建议在tcp应用编程中开启此功能*/ #define LWIP_TCP_KEEPALIVE 1 #endif /** * LWIP_NETIF_API==1: Support netif api (in netifapi.c) */ #ifndef LWIP_NETIF_API #define LWIP_NETIF_API 1 #endif #ifdef LWIP_IGMP #include <stdlib.h> #define LWIP_RAND rand #endif /* ------------------------------------ ---------- Socket options ---------- ------------------------------------ */ /* * LWIP_SOCKET==1: Enable Socket API (require to use sockets.c) */ #ifndef LWIP_SOCKET #define LWIP_SOCKET 1 #endif /* * LWIP_COMPAT_SOCKETS==1: Enable BSD-style sockets functions names. * (only used if you use sockets.c) */ #ifdef SAL_USING_POSIX #define LWIP_COMPAT_SOCKETS 0 #else #ifndef LWIP_COMPAT_SOCKETS #define LWIP_COMPAT_SOCKETS 1 #endif #endif /** * LWIP_SO_SNDTIMEO==1: Enable send timeout for sockets/netconns and * SO_SNDTIMEO processing. */ #ifndef LWIP_SO_SNDTIMEO #define LWIP_SO_SNDTIMEO 1 #endif /** * LWIP_SO_RCVTIMEO==1: Enable receive timeout for sockets/netconns and * SO_RCVTIMEO processing. */ #ifndef LWIP_SO_RCVTIMEO #define LWIP_SO_RCVTIMEO 1 #endif /** * LWIP_SO_RCVBUF==1: Enable SO_RCVBUF processing. */ #ifndef LWIP_SO_RCVBUF #define LWIP_SO_RCVBUF 1 #endif /** * If LWIP_SO_RCVBUF is used, this is the default value for recv_bufsize. */ #ifndef RECV_BUFSIZE_DEFAULT #define RECV_BUFSIZE_DEFAULT 8192 #endif /** * SO_REUSE==1: Enable SO_REUSEADDR option. */ #ifndef SO_REUSE /*请见3.2节的功能介绍说明 */ #define SO_REUSE 0 #endif /* ------------------------------------ ------- Applications options ------- ------------------------------------ */ /** * Max. length of TFTP filename */ #ifdef RT_LWIP_TFTP_MAX_FILENAME_LEN #define TFTP_MAX_FILENAME_LEN RT_LWIP_TFTP_MAX_FILENAME_LEN #elif defined(RT_DFS_ELM_MAX_LFN) #define TFTP_MAX_FILENAME_LEN RT_DFS_ELM_MAX_LFN #else #define TFTP_MAX_FILENAME_LEN 64 #endif /* Use the hostname*/ #define LWIP_NETIF_HOSTNAME 1 #endif /* __LWIPOPTS_H__ */
opt.h头文件中定义了lwip协议的所有配置宏，都设置了默认的配置，若是在lwipopts.h,rtconfig.h中未定义的宏，将采用opt.h中的默认配置，若是想了解更全面的lwip配置请参考opt.h中的配置宏定义。
lwip配置中还有一个宏 LWIP_SO_LINGER，这个宏lwipopts.h中未使用定义，那么lwip协议栈采用的是opt.h中默认配置，此配置是关闭的。这个功能有特殊的应用，具体以下文介绍。
3.4 LWIP_SO_LINGER做用
LWIP_SO_LINGER宏用于设置函数close()关闭TCP链接时的行为。缺省close()的行为是，若是有数据残留在socket发送缓冲区中则系统将继续发送这些数据给对方，等待被确认，而后返回。
利用此选项，能够将此缺省行为设置为如下两种
a.当即关闭该链接，经过发送RST分组(而不是用正常的FIN|ACK|FIN|ACK四个分组)来关闭该链接。至于发送缓冲区中若是有未发送完的数据，则丢弃。主动关闭一方的TCP状态则跳过TIMEWAIT，直接进入CLOSED。网上不少人想利用这一点来解决服务器上出现大量的TIMEWAIT状态的socket的问题，可是，这并非一个好主意，这种关闭方式的用途并不在这儿，实际用途在于服务器在应用层的需求。
b.将链接的关闭设置一个超时。若是socket发送缓冲区中仍残留数据，进程进入睡眠，内核进入定时状态去尽可能去发送这些数据。
在超时以前，若是全部数据都发送完且被对方确认，内核用正常的FIN|ACK|FIN|ACK四个分组来关闭该链接，close()成功返回。
若是超时之时，数据仍然未能成功发送及被确认，用上述a方式来关闭此链接。close()返回EWOULDBLOCK。
SO_LINGER选项使用以下结构：
struct linger {
int l_onoff;
int l_linger;
};
l_onoff为0，则该选项关闭，l_linger的值被忽略，close()用上述缺省方式关闭链接。
l_onoff非0，l_linger为0，close()用上述a方式关闭链接。
l_onoff非0，l_linger非0，close()用上述b方式关闭链接。 值得一说的是，无论你用什么方式使用SO_LINGER，都须要大量耐心的测试来确保你的服务器程序确实是按照你的意愿在跑，由于这个选项对服务器处理小量请求的行为影响很是细微，简单的功能测试很难验证它的行为，上线后量大的状况下可能会出问题，让你的服务器立刻下线，大并发量的模拟实际场景压测才能保证其正确性:)