90 lines
3.0 KiB
Markdown
90 lines
3.0 KiB
Markdown
# lwip 移植说明
|
||
|
||
为了适配 RT-Thread 网卡设备，RT-Thread 团队基于原 [lwip](http://savannah.nongnu.org/projects/lwip/) 进行了一些修改，本文档记录了相关修改内容。
|
||
|
||
> 本 lwip-2.1.2 版本基于 [lwip STABLE-2_1_2_RELEASE](https://git.savannah.gnu.org/git/lwip.git) 版本移植而来。
|
||
|
||
|
||
| Date | Author | Notes |
|
||
| :---- | :---- | :---- |
|
||
| 2019-09-02 | MurphyZhao | 增加 lwip 2.1.2 移植说明 |
|
||
| 2020-06-18 | xiangxistu | 增加部分 lwIP 2.1.2 移植说明 |
|
||
|
||
## 修改内容
|
||
|
||
### src/api
|
||
|
||
- `src/api/sockets.c` 增加 `lwip_tryget_socket` 函数，作为 `tryget_socket` 函数的全局实现
|
||
- `src/api/sockets.c` 在 `alloc_socket` 函数中，增加 SAL 移植函数 `rt_wqueue_init`
|
||
|
||
```
|
||
#ifdef SAL_USING_POSIX
|
||
rt_wqueue_init(&sockets[i].wait_head);
|
||
#endif
|
||
```
|
||
|
||
### src/app
|
||
|
||
- 增加 `ping/ping.c`，便于在 finsh/msh 中使用 ping 功能
|
||
- 增加 `tftp/tftp_port.c`，便于在 finsh/msh 中使用 tftp_server 功能
|
||
|
||
### src/arch
|
||
|
||
增加 `src/arch` 目录，存储对接 RT-Thread 设备框架的移植文件，从 lwip-2.0.2 版本中的移植文件修改而来。
|
||
|
||
|
||
|
||
以及相对于 lwIP2.0.2 的增加修改内容：
|
||
|
||
|
||
* 在 `src/arch/sys_arch.c` 中增加 MTU 与 etharp_output 的初始化
|
||
|
||
* 在 `src/arch/sys_arch.c` 中增加新添加的邮箱函数
|
||
|
||
对邮箱机制的新增加的 sys_mbox_trypost_fromisr 函数予以实现
|
||
|
||
* 在 `src/arch/sys_arch.c` 中增加新添加的内存堆函数
|
||
|
||
对内存堆的新增加的 mem_overflow_check_raw 与 mem_overflow_init_raw 函数予以实现
|
||
|
||
* 在 `src/arch/cc.h` 中增加对 lwIP 使用的标准错误代码宏的处理，不再使用 lwIP 内置的错误宏
|
||
|
||
|
||
### src/core
|
||
|
||
- 在 `src/core/dns.c` 的 `dns_setserver` 函数中增加 RT-Thread netdev 相关的移植
|
||
- 在 `src/core/netif.c` 中增加 RT-Thread netdev 相关的移植
|
||
|
||
### src/include
|
||
|
||
- 在 `src/include/lwip/priv/sockets_priv.h` 中增加 SAL 相关的移植
|
||
|
||
在 `lwip_sock` 结构体中增加 ` rt_wqueue_t wait_head;` 成员
|
||
|
||
- 在 `src/include/lwip/prot/ieee.h` 中增加 EAPOL, EAP over LAN 标识
|
||
|
||
- 在 `src/include/lwip/init.h` 中的版本号后增加 `U` 标识
|
||
|
||
- 在 `src/include/lwip/sockets.h` 中增加 `LWIP_SOCKET_SELECT`，解决开启 RT_USING_POSIX 时的冲突
|
||
|
||
- 在 `src/include/lwip/arch.h` 中修改 `<unistd.h> `为 `"sys/types.h" `，解决编译冲突
|
||
|
||
并添加 typedef int ssize_t 定义，补足因 libc 与 dfs 未开启时 ssize_t 的定义不足问题
|
||
|
||
- 在 `src/include/netif/` 中增加 `ethernetif.h`，用于对接 RT-Thread 网卡设备
|
||
|
||
### src/netif
|
||
|
||
- 在 `src/netif/` 中增加 `ethernetif.c`，用于对接 RT-Thread 网卡设备
|
||
- 在 `src/netif/lowpan6.c` 中增加 `LWIP_6LOWPAN` 宏定义，以防止编译错误
|
||
|
||
### src
|
||
|
||
- 在 src 目录下，增加 `src/lwipopts.h`，用于 lwip 功能裁剪以及配置设置
|
||
- 在 src 目录下，增加 `src/lwippools.h`，用于定义 `LWIP_MALLOC_MEMPOOL`
|
||
|
||
### 其它
|
||
|
||
- 增加 SConscript 文件，用于 scons 构建
|
||
- 增加 README_RT-THREAD.md 文件，用于记录相对原 lwip 源码的改动
|