LwIP移植教程：降低嵌入式系统内存需求的TCP/IP协议实现

4星 · 超过85%的资源需积分: 12 99 浏览量更新于2024-07-31 收藏 251KB PDF 举报

LwIP移植说明文档是一份详细的指南，它基于LwIP-1.4.0版本，旨在帮助开发者理解和移植这个轻量级的TCP/IP协议栈到各种嵌入式系统中。LwIP是由Adam Dunkels在瑞典SICS的计算机网络架构实验室开发的，其设计目标是提供一个内存效率高且功能完备的TCP/IP解决方案，特别适合资源受限的环境，如内存仅有几十KB的嵌入式设备。文档的核心内容包括LwIP的基本介绍，指出它作为TCP/IP协议集的精简实现，强调了其在减少RAM占用的同时仍能保持TCP协议的完整功能。这对于在RAM有限且代码空间紧张的系统中运行至关重要。LwIP的特点主要包括： 1. IP协议支持：文档详细解释了LwIP如何通过多个网络接口进行包转发，增强了系统的网络连接能力。 2. ICMP（Internet Control Message Protocol）支持：LwIP提供了对ICMP的支持，允许设备发送和接收控制消息，例如ping请求和回应等。 3. 路由功能：文档会涵盖如何配置和管理网络路由，确保数据在网络中的有效传输。 4. TCP和UDP支持：尽管内存优化是重点，但LwIP仍然提供了完整的TCP和用户数据报协议（User Datagram Protocol，UDP）功能，满足不同应用需求。 5. SYS_ARCH接口：文档中提到的SYS_ARCH接口是LwIP与底层硬件平台交互的关键部分，这部分内容参考了焦海波关于在uC/OS-II平台上移植LwIP的笔记，说明了如何定制和集成LwIP到特定的嵌入式操作系统环境。需要注意的是，由于翻译者的水平限制，文档可能存在不准确或翻译错误的地方，因此鼓励读者在阅读时积极指出并分享自己的理解和修正。这份文档的目的是为了方便社区成员共同学习和提高，促进技术交流。 LwIP移植说明文档是嵌入式开发人员在移植和优化LwIP协议栈时的重要参考资料，提供了全面的指导，涵盖了从API到系统架构的各个方面，有助于开发者在有限资源环境下高效地部署和利用LwIP。

翻译：Lizhiming Mail：seu.zhiming@gmail.com

8 / 43

将数据入队写至由参数 dataptr 指定的内存区域。数据的长度作为 len 参数传递。拷贝参数为 0 或 1，用于指示是否为

将要拷贝来的数据分配新的内存。如果该参数为 0，将不分配新的内存，并且数据仅能通过指针来引用。

The tcp_write() function will fail and return ERR_MEM if the length of the data exceeds

the current send buffer size or if the length of the queue of outgoing segment is larger than

the upper limit defined in lwipopts.h. The number of bytes available in the output queue can

be retrieved with the tcp_sndbuf() function.

如果数据的最大长度超过了当前发送数据缓冲区的大小，或输出片段队列的长度超过了 lwipopts.h 文件中定义的上限，

tcp_write()将失败并返回 EER_MEM，在输出队列中可获得的字节数可通过 tcp_sndbuf()函数检索。

The proper way to use this function is to call the function with at most tcp_sndbuf() bytes

of data. If the function returns ERR_MEM, the application should wait until some of the

currently enqueued data has been successfully received by the other host and try again.

使用该函数的正确方式是调用该函数，并将参数指定为 tcp_sndbuf()获得的最大字节数。如果函数返回 ERR_MEM，应

用程序应等待直到当前入队数据正确地被其他主机接受并重试。

- void tcp_sent(struct tcp_pcb *pcb,

err_t (* sent)(void *arg, struct tcp_pcb *tpcb,u16_t len))

Specifies the callback function that should be called when data has successfully been received

(i.e., acknowledged) by the remote host. The len argument passed to the callback function

gives the amount bytes that was acknowledged by the last acknowledgment.

指定当数据被远程主机成功接收时应调用的回调函数。传递给回调函数的 len 参数给出了在最后一次确认中确认的字节

数。

--- Receiving TCP data

--- 接收 TCP 数据

TCP data reception is callback based - an application specified callback function is called

when new data arrives. When the application has taken the data, it has to call the tcp_recved()

function to indicate that TCP can advertise increase the receive window.

TCP 数据接收是基于回调函数的——当新的数据到达时，应用程序指定的回调函数被调用。当应用程序接收数据完毕，必

须调用 tcp_recved()函数用于指示 TCP 通告可以增加新的接收窗口。

- void tcp_recv(struct tcp_pcb *pcb,

err_t (* recv)(void *arg, struct tcp_pcb *tpcb, struct pbuf *p, err_t err))

Sets the callback function that will be called when new data arrives. The callback function

will be passed a NULL pbuf to indicate that the remote host has closed the connection. If

there are no errors and the callback function is to return ERR_OK, then it must free the pbuf.

Otherwise, it must not free the pbuf so that lwIP core code can store it.

当新的数据到达时，设置被调用的回调函数。如果远程主机已关闭了连接，该函数的 pbuf 参数将返回一个 NULL 空指针。

如没有错误，并且回调函数的该参数返回值为 ERR_OK，那么该函数必须释放 pbuf。否则，禁止释放 pbuf，以确保 LwIP

内核代码可以存储其值。

- void tcp_recved(struct tcp_pcb *pcb, u16_t len)

翻译：Lizhiming Mail：seu.zhiming@gmail.com

9 / 43

Must be called when the application has received the data. The len argument indicates the

length of the received data.

当应用程序已接收数据，必须调用此函数。Len 参数指示接收数据的长度。

--- Application polling

--- 应用程序轮询

When a connection is idle (i.e., no data is either transmitted or received), lwIP will

repeatedly poll the application by calling a specified callback function. This can be used

either as a watchdog timer for killing connections that have stayed idle for too long, or

as a method of waiting for memory to become available. For instance, if a call to tcp_write()

has failed because memory wasn't available, the application may use the polling functionality

to call tcp_write() again when the connection has been idle for a while.

当连接处于空闲状态（比如没有数据收发），LwIP 将通过特定的回调函数重复地询问应用程序。在这种情况下，可以用看

门狗定时器来切断长时间处于空闲状态的连接，也可以用这种方法等待获取内存的分配。例如，由于内存暂时不可获得，

调用 tcp_write()将失败，应用程序可在连接处于空闲状态时用轮询功能来再次调用 tcp_write()。

- void tcp_poll(struct tcp_pcb *pcb, u8_t interval,

err_t (* poll)(void *arg, struct tcp_pcb *tpcb))

Specifies the polling interval and the callback function that should be called to poll the

application. The interval is specified in number of TCP coarse grained timer shots, which

typically occurs twice a second. An interval of 10 means that the application would be polled

every 5 seconds.

指定轮询间隔，并调用该回调函数轮询应用程序。时间间隔由粗略的定时器中断时间来指定，通常 1 秒钟发生 2 次。值为

10 的间隔表示应用程序每隔 5 秒查询一次。

--- Closing and aborting connections

--- 关闭并中止连接

- err_t tcp_close(struct tcp_pcb *pcb)

Closes the connection. The function may return ERR_MEM if no memory was available for closing

the connection. If so, the application should wait and try again either by using the

acknowledgment callback or the polling functionality. If the close succeeds, the function

returns ERR_OK.

The pcb is deallocated by the TCP code after a call to tcp_close().

关闭连接。如果关闭连接的内存不可获得，该函数将返回 ERR_MEM。在这种情况下，应用程序应通过确认回调函数或轮

询功能来等待并重试。如果关闭成功，该函数返回 ERR_OK。

在 tcp_close()调用后，pcb 由 TCP 代码释放其内存。

- void tcp_abort(struct tcp_pcb *pcb)

Aborts the connection by sending a RST (reset) segment to the remote host. The pcb is

deallocated. This function never fails.

剩余42页未读，继续阅读

Yulri

粉丝: 8
资源: 7

LwIP移植教程：降低嵌入式系统内存需求的TCP/IP协议实现

LWIP移植说明文档

stm32107 LWIP移植范例

stm32f107的lwip官方移植说明文档1

LWIP.rar_LWIP 移植_LwIP_lwip源码_lwip移植

LWIP移植说明 码源注释 以及例程（中文）

LWIP移植心得

焦海波LWIP移植手册

lwip移植-源码工程

LwIP移植手册.pdf

杨晔lwip移植，协议实现

最新资源

LWIP移植说明码源注释以及例程（中文）