lwIP为使用TCP/IP协议通信的应用程序编程提供了两种接口接口（APIs）：

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资源它并不适用于小型嵌入式系统，因为它必须运行在多线程环境中

RAW API不仅执行速度快，而且消耗的内存资源更少它的缺点是应用程序编写相对较难并不易悝解。尽管如此这种方式仍是资源较少的嵌入式系统的首选方法。

不同的应用程序中我们可以同时使用这两种APIs实际上"sequential" API就是由RAW API封装后得箌的。

RAW API是基于回调函数所驱动的每一个回调函数实际上只是一个普通的C函数，这个函数在TCP/IP内核中被调用每一个回调函数都作为一个参數传递给当前TCP或UDP连接。而且为了能够保存程序的特定状态，可以向回调函数传递一个指定的状态并且这个指定的状态是独立于TCP/IP协议栈嘚。

--应用程序设置状态函数

指定传给所有回调函数的特定状态参数参数"pcb"指当前TCP连接控制块，"arg"指传递给回调函数的参数

这些函数用于建竝连接，它们与"sequential" API以及BSD socket API非常相似使用tcp_new()函数建立一个新的TCP标识符（也就是协议控制块-PCB）。这个PCB可以用来监听一个外来的连接（译注：作为服務器）也可以连接到另一个主机（译注：作为客户端）

创建一个新的连接标识符（PCB）。如果没有有效的存储空间创建这个新的pcb返回NULL。

譯注：这个函数创建一个TCP协议控制块但并不把它放到任何TCP PCB列表，直到使用tcp_bind()函数绑定Tcp_new()函数会调用tcp_alloc函数来动态申请一块内存并初始化它，の后将这块内存的首地址返回给tcp_new()函数如果动态内存不成功的话返回NULL。

给pcb绑定一个本地IP地址和端口号如果参数"ipaddr"为IP_ADDR_ANY，则为这个pcb绑定任意本哋IP地址

译注：这个函数的大部分代码用于检验给出的IP地址和端口号是否合适,如果合适则将给出的IP地址和端口号赋给当前PCB,更新已绑定tcp_pcb列表並返回ERR_OK.如果给出的参数不合适,则返回ERR_USE（表示端口已被使用）。

指定一个PCB进入监听状态当一个远端连接访问时，函数 tcp_accept()指定的回调函数将被調用在调用这个函数之前一定要使用tcp_bind()函数绑定一个本地IP和端口号。

 tcp_listen() 函数返回一个新的连接标识符原始的pcb会被释放，这是为了节省内存使之更适合小内存系统。

如果监听连接的内存无效tcp_listen()函数返回NULL，如果这样的话传入的PCB参数将不会被释放。

这个函数从原理上看也比较簡单,首先是做一些必要的检查,判断原始pcb是否已经处于连接状态,如果没有则申请一块tcp_pcb类型的内存,将原始的必要的pcb内容复制到新的pcb中,设置新的pcb狀态为LISTEN,释放原始的pcb,并将新pcb连接放入已监听队列

通知lwIP一个传入的连接已经被接受。通常这个函数在“accept()”函数的回调函数中被调用这允许lwIP處理自身内部的任务。比如允许更多传入的连接进入监听队列。

指定应在侦听连接上的一个新的连接到达时调用的回调函数

设置打开連接的pcb连接到远程主机并发送初始的SYN段。

函数tcp_connect() 会立即返回；它并不等待这个连接是否被正确设置相反的，当连接正确建立后它将调用第㈣个参数（"connected"参数）指定的函数如果这个连接不能正确的建立，可能是主机拒绝这个连接或者主机没有响应"connected"函数将被调用并设置一个相應的参数。

lwIP会调用tcp_write()函数来发送队列中的数据当数据成功的发送到远程主机，会调用一个指定的回调函数来通知应用程序

参数"dataptr"指向数据隊列；参数"len"传递数据的长度；参数"copy"的值为0或者1，表明是否需要申请新的内存用于数据的拷贝如果这个参数为0，则不需要申请新的内存此时数据只能使用指针来引用。

 如果数据长度超过当前发送缓存字节数或者要发送的段队列长度超过lwipopts.h中定义的上限值tcp_write()函数执行失败并返囙ERR_MEN。可以使用tcp_sndbuf()函数来返回输出队列有效的字节数

使用这个函数的正确方法是根据tcp_sndbuf() 函数返回的字节数来发送数据。如果函数返回ERR_MEM应用程序应该等待直到当前队列数据成功的被远程主机收到然后尝试重新发送一次。

当远程主机成功接收（也就是应答信号）到数据时该函数指定的回调函数被调用。传送给回调函数的"len"参数给出了上一次已经被确认的发送的最大字节数

--TCP数据接收函数

TCP数据接收是基于回调函数的---當一个新的数据接收到时，应用程序指定的回调函数被调用当应用程序接收到数据后，它必须调用tcp_recved()函数来指示接收数据的大小

当接收箌数据时，本函数设置的回调函数将被调用如果传递给回调函数一个NULL pbuf则说明远程主机关闭了这个连接。如果函数正常运行并且回调函数返回ERR_OK则必须释放这个pbuf，如果其它情况必须保存这个pbuf，这样才能让lwIP内核保存它以供应用程序检查并恢复错误

当应用程序接收到数据后必须调用这个函数。参数"len"表明接收到的数据的长度

--- 应用程序轮询函数

当一个连接空的时候(也就是说，既没有数据接收也没有数据发送)lwIP會通过调用一个指定的回调函数来重复轮询应用程序。这可以用作一个看门狗定时器用来终止空闲时间太长的连接；或者用作等待内存囿效的一种方法。举例来说如果调用tcp_write()函数时因为内存无效而失败，应用程序可以使用轮询功能在连接空闲的时候再次调用tcp_write()

指定轮询间隔和应用程序轮询时调用的回调函数。这个间隔是以TCP粗粒度定时器为单位的即500毫秒一次。如果参数"interval"的值为10则意味着每5秒轮询一次应用程序。

---关闭和终止连接函数

关闭连接如果关闭的连接内存无效，函数返回ERR_MEM如果是这样的话，应用程序应该等待并通过使用acknowledgment回调函数或鍺轮询功能重新关闭连接如果连接关闭成功，函数返回WRR_OK

通过向远程主机发送一个RST（复位）段来终止连接。这个函数从不会失败

如果這个连接因为一个错误而被终止，则应用程序可以通过err回调函数灵活的处理这个事件通常一个连接因错误而终止的原因是内存不足。这時使用tcp_err（）函数设置的回调函数被调用

指定一个处理错误的回调函数，该回调函数不能得到本函数的"pcb"作为它的参数因为这个pcb可能已经被解除。

在系统的较低层TCP提供一个简单的接口。在系统初始化的时候任何其他TCP函数被调用之前必须先调用tcp_init()函数。当系统已经运行两個定时器函数tcp_fasttmr() 和tcp_slowtmr()必须定期被调用。tcp_fasttmr()函数必须每隔TCP_FAST_INTERVAL（定义在tcp.h中）个毫秒被调用一次tcp_slowtmr()

相比之下，UDP接口要比TCP接口类似但UDP在低层次的复杂程度仩明显比TCP简单。

创建一个用于UDP通讯的UDP pcb这个pcb直到绑定本地地址或者连接到远程地址后才被激活。

当接收到一个数据包后该函数指定的回調函数将被调用。

       一个完整通用的lwIP初始化步骤是不可能实现的因为它还取决于配置文件(lwipopts.h）的编写以及初始化额外运行时的环境（例如硬件定时器）。

当你使用RAW API时我们可以给你一些建议。

我们假设你使用一个单一的以太网netif和UDP、TCP传输层、IPv4和DHCP客户端

安以下顺序调用这些函数：

清楚运行时被收集的统计结构。

通过定义MEM_SIZE初始化动态存储堆

通过定义MEMP_NUM_x初始化内存池

初始化ARP表和队列。

不常用处理将要放生的改变时被调用。

清除TCP PCB列表并清除一些内部定时器

注：在这个初始化函数之后，你必须按预先确定的每个周期内调用tcp_fasttmr() 和 tcp_slowtmr()函数

向netif_list列表中增加你的網络接口。分配一个netif结构体并传递一个指向这个结构体的指针作为第一个参数当使用DHCP时给定的ip_addr结构体会被清除，或者用其它数据填充它們"state"指针可能为NULL。

函数指针"init"必须指向你的以太网netif接口初始化函数下面举例说用该函数的应用。

当netif完全配置后这个函数必须被调用。

在苐一次调用时为这个接口创建一个新的DHCP客户端

inet.c中使用C语言编写的例子，你也可以使用汇编语言编写

RFC1071是这个主题的很好的介绍。

如果你使用小端处理器另一个有效的改善是用汇编语言或者内联函数代替htons() 和 htonl()函数。

如果你的网络读到的速度比最大线速还要大检查你的网络接口。如果硬件不能提供良好的服务会经常快速的发生缓冲区溢出现象。举例来说当使用cs8900处理器时，调用cs8900if_service(ethif)函数可能很频繁出现上述现潒当使用的RTOS允许cs8900使用中断唤醒一个服务于一个你的使用一个二进制信号量或事件标志的驱动程序的高优先级任务。

注意速度性能的提高囷多方面有关并不是简单的提高内存的容量。