LwIP移植详解与SYS_ARCH接口指南

4星 · 超过85%的资源需积分: 9 58 浏览量更新于2024-07-26 收藏 254KB PDF 举报

"LWIP移植指南" LWIP,全称为Lightweight IP, 是由Adam Dunkels在瑞典SICS计算机网络实验室开发的一个小型的TCP/IP协议栈，其主要目标是在资源受限的嵌入式系统中提供高效的网络功能，如TCP/IP协议集，同时尽量减少内存占用。它特别适合内存和代码空间有限的环境，比如只有几十千字节RAM和大约40千字节代码ROM的设备。移植LWIP至新的硬件平台时，重要的是理解和掌握其核心API（Application Programming Interface）以及SYS_ARCH接口。SYS_ARCH接口是LWIP中用于与底层硬件交互的关键部分，通常涉及操作系统特定的中断处理、内存管理等底层操作。移植过程中可能需要对这些接口进行适配，以确保其与目标平台的硬件特性兼容。焦海波的"uC/OS-II平台下的LwIP移植笔记"提供了有价值的信息，对于理解和移植LWIP到uC/OS-II这样的实时操作系统环境尤其有帮助。这个笔记可能包含了移植策略、必要的驱动程序编写技巧以及如何处理中断、缓冲区管理和网络事件等技术细节。在移植过程中，需要注意以下几点： 1. API兼容性：确保选择的LWIP版本与目标硬件平台的处理器架构相匹配，并检查API是否已针对特定硬件进行了优化或修改。 2. 内存管理：LWIP设计初衷是轻量级，但在实际移植中可能需要调整内存分配策略，以适应有限的资源。 3. 网络接口支持：确认LWIP是否能支持目标平台的网络接口类型，如串口、USB、以太网等，并正确配置相应的驱动程序。 4. 中断处理：根据SYS_ARCH提供的中断服务函数模板，实现对网络事件的响应和处理。 5. 测试和调试：在移植完成后，进行严格的测试，包括性能测试、稳定性测试和功能验证，以确保LWIP在新平台上正常运行。 LWIP的移植过程需要深入理解协议栈的工作原理，以及如何有效地将其融入到目标硬件和操作系统环境中。对于想要在嵌入式系统中利用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页未读，继续阅读

walter7777

粉丝: 2
资源: 15

LwIP移植详解与SYS_ARCH接口指南

网络实验4 RAW_TCP客户端实验.rar_RAW_实验4

lwip RAW_TCP客户端源码_RAW_lwipucos_LWIP移植_LwIP_

zynq裸机lwip不插网线初始化lwip库添加配置项方法lwipopts

rtthread+lwip2.0.2 lwip复位

enet_lwip lwip2.13

关于开启lwIP协议栈的调试输出LWIP_DEBUGF

lwip编程指南pdf

zyqn怎么使用lwip

freertos上移植lwip

最新资源