LwIP的特性如下:
(1) 支持多网络接口下的IP转发
(2) 支持ICMP协议
(3) 包括实验性扩展的的UDP( 用户数据报协议
![lwip移植 - 一生有你 - 一生有你 lwip移植 - 一生有你 - 一生有你](http://www.zoomino.cn/static-ox/images/blank.gif)
(4) 包括阻塞控制,RTT估算和快速恢复和快速转发的TCP( 传输控制协议
![lwip移植 - 一生有你 - 一生有你 lwip移植 - 一生有你 - 一生有你](http://www.zoomino.cn/static-ox/images/blank.gif)
(5) 提供专门的内部回调接口(Raw API)用于提高应用程序性能
(6) 可选择的Berkeley接口API(多线程情况下)
(7) 在最新的版本中支持ppp
(8) 新版本中增加了的IP fragment的支持.
(9) 支持DHCP协议,动态分配ip地址.
以上内容摘自网络 关于ucos 上的lwip移植
二、移植介绍
整个移植过程主要参考网络上关于移植到ucos 的说明和源码。
1. 目录及文件介绍
原版的lwIP1.1.0包含两个目录src 和 doc
移植后增加如下文件和目录
[Arch]
Lib_arch.c本系统没用,系统中没有实现的C库函数可以写到这里
Sys_arch.c 移植的主要工作在这里,关于信号量、消息队列、任务创建
[RX4000] 项目目录
[Include]
[Arch]
cc.h 类型定义 大小端设置 PACK定义等
init.h
lib.h 跟Lib_arch.c对应 函数声明
perf.h 没用
sys_arch.h 跟Sys_arch.c对应的一些类型定义和宏定义
[Netif]
Dm9000a.h
Ne2kif.h
[Netif]
Dm_netif.c 网卡驱动与系统关联的抽象层
Dm9000a.c网卡的硬件操作函数
Ne2kif.c 没用
[Init]
Lwip.c 协议栈初始化和DHCP初始化
Lwipopts.h 协议栈相关参数设置
[Dns]
Dns.c 增加域名解析函数 gethostbyname (非可重入函数)
Dns.h
2. 移植相关函数介绍
1) sys_init
这个很简单,就是一些全局量的初始化
2) sys_thread_new sys_arch_timeouts
相关的三个全局变量如下
struct sys_timeouts lwip_timeouts[LWIP_TASK_MAX];
为每一个由sys_thread_new创建的任务分配一个存放信号量超时信息的列表
struct sys_timeouts null_timeouts;
为一个超过任务上限数的任务和不是由sys_thread_new创建的任务取超时列表时返回使用。
MMAC_RTOS_TASK_ID LWIP_TASKS[LWIP_TASK_MAX];
任务id存放顺序与lwip_timeouts相对应
sys_thread_new用来创建一个新的任务,保存任务ID。sys_arch_timeouts
就是通过取得任务ID返回任务对应的timeouts结构,从而可以添加、删除和判断超时的功能
3) sys_sem_new sys_sem_free sys_sem_signal sys_arch_sem_wait
sys_sem_new创建一个信号灯并初始化灯的数量返回sys_sem_t 类型的变量,定义是这样的typedef MMAC_RTOS_SEMAPHORE *sys_sem_t; 由于返回失败要返回NULL值所以就定义了系统信号量的指针为抽象信号量类型。因此在sys_sem_new和 sys_sem_free 分别要进行内存申请和释放的工作。
sys_sem_signal释放一个灯,sys_arch_sem_wait 等待信号,其中参数timeout是以ms为单位的,若wei零则表示永远等待一直到信号的来临。
在这个信号系统中本人还存在一个疑问,具体在5”存在的问题”中进行说明
4) sys_mbox_new sys_mbox_free sys_mbox_post sys_arch_mbox_fetch
同上原因在类型的定义成指针的。那sys_mbox_new 和sys_mbox_free同样要进行内存的申请和释放。在系统中消息队列发送和接收的都是指向数据的指针,因为在发送前所有的数据都已经存放在一个全 局的用来管理内存的变量中。所以发送的内容就是四个字节。发送是还要判断发送msg是否为NULL。因为发送的是msg的指针,而不是内容还要取一下地 址,NULL明显不能取址,所以有一个专门的static int *msg_null=NULL (这里的=NULL 并不重要可以使任何值 * 也可以不要,因为要的是变量的地址在内存中的唯一性)用来发送“NULL”信息,使msg = &msg_null再发送。接收到后也要进行 *msg ==&msg_null的判断。接收时也要进行msg NULL的判断,若msg为NULL就需要零时申请一个空间进行接收。还要注意发送和接收时msg的类型,发送是void* 的 ,接收是void **,要做好相应的处理。
3. 移植中相关配置的介绍
1) SYS_LIGHTWEIGHT_PROT
我的理解应该是是否使用系统临界区变量,由于本系统没有单独的临界区变量,所以就设置成 0 ,那就用信号灯来完成该任务。且sys_arch.h中的最后三个宏也要定义成空。
2) 累加和
关闭所有的累加检查,因为硬件已有该功能了
#define CHECKSUM_GEN_IP 0
#define CHECKSUM_GEN_UDP 0
#define CHECKSUM_GEN_TCP 0
#define CHECKSUM_CHECK_IP 0
#define CHECKSUM_CHECK_UDP 0
#define CHECKSUM_CHECK_TCP 0
3) LWIP_HAVE_LOOPIF
是否开启回环,在还没有网卡驱动的时候,可以设置为 1 添加loop设备进行调试运行。
4)内存分配设定
在协议栈中很多内存都是事先申请的,有协议栈自己进行管理。据我了解有三大块内存PBUF MEMP MEM。在lwipopts.h中的Memory options中定义了各块内存的种类及各种类的数量。这部分的设置要仔细斟酌。具体就不再详述了。
5) TCP_SND_BUF
该设置对网络传输的速度由很大的影响。Ucos+lwIP的源码中的默认设置是256,用socket进行速度测试时却只有区区的1KB/S左右的速度。最后改成8192后速度达到 600KB/S。
6) LWIP_DHCP
本系统需要DHCP支持因此需要设置为 1。在他下面有一个DHCP_DOES_ARP_CHECK的宏设置为 0。 开启后出现错误。原因不明。
4. 移植中碰到的问题总结
1) 同时支持UDP及TCP及DHCP的支持
不再详述看出始化代码
void Task_lwip_init(void * pParam)
{
struct ip_addr ipaddr, netmask, gw;
sys_sem_t sem;
err_t result ;
int icount = 0;
int idhcpre=0;
#if LWIP_STATS
stats_init();
#endif
// initial lwIP stack
sys_init();
mem_init();
memp_init();
pbuf_init();
netif_init();
printf("LWIP:TCP/IP initializing...\n");
sem = sys_sem_new(0);
tcpip_init(tcpip_init_done_ok, &sem);
sys_sem_wait(sem);
sys_sem_free(sem);
printf("LWIP:TCP/IP initialized.\n");
/*
//add loop interface //set local loop-interface 127.0.0.1
IP4_ADDR(&gw, 127,0,0,1);
IP4_ADDR(&ipaddr, 127,0,0,1);
IP4_ADDR(&netmask, 255,0,0,0);
netif_add(&loop_if, &ipaddr, &netmask, &gw, NULL, loopif_init, tcpip_input);
netif_set_default(&loop_if);
netif_set_up(&loop_if);
//*/
#if 0
IP4_ADDR(&gw, 192,168,0,2);
IP4_ADDR(&ipaddr, 192,168,0,186);
IP4_ADDR(&netmask, 255,255,255,0);
netif_add(&dm9if_if, &ipaddr, &netmask, &gw, NULL, dm9_netif_init, tcpip_input);
netif_set_default(&dm9if_if);
netif_set_up(&dm9if_if);
#else
IP4_ADDR(&gw, 0,0,0,0);
IP4_ADDR(&ipaddr, 0,0,0,0);
IP4_ADDR(&netmask, 0,0,0,0);
netif_add(&dm9if_if, &ipaddr, &netmask, &gw, NULL, dm9_netif_init, udp_input);//添加udp支持
printf("LWIP:waiting for neif init \n");
MMAC_RTOS_Sleep( 3500);
for(idhcpre = 0; idhcpre<4; idhcpre++ )//dhcp最多重试4遍
{
printf("LWIP:start dhcp request \n");
result = dhcp_start(&dm9if_if);//广播dhcp请求
IP4_ADDR(&ipaddr, 0,0,0,0);
for(icount = 0; (icount < 10) && (ipaddr.addr == 0); icount ++ )
{
ipaddr.addr = dm9if_if.ip_addr.addr;
MMAC_RTOS_Sleep( 1000);
} // if failed ipaddr = 0.0.0.0 ;timeout = 10 * 1000 ms
//等待dhcp是否接受到IP了
// add dns server ip
dns_add(0,&dm9if_if.dhcp->offered_dns_addr[0]);
dns_add(1,&dm9if_if.dhcp->offered_dns_addr[1]);
//不需要dns的去掉上面两句
dhcp_stop(&dm9if_if); //一次dhcp结束
if (ipaddr.addr != 0)
break;
}
gw.addr = dm9if_if.gw.addr;
ipaddr.addr = dm9if_if.ip_addr.addr;
netmask.addr = dm9if_if.netmask.addr;
//netif_remove(&dm9if_if);
netif_add(&dm9if_if_tcp, &ipaddr, &netmask, &gw, NULL, dm9_netif_init, tcpip_input);//添加tcp支持
netif_set_up(&dm9if_if_tcp);
netif_set_up(&dm9if_if);
netif_set_default(&dm9if_if_tcp);
#endif
sprintf(STRIPADDR,"%d.%d.%d.%d",ip4_addr1(&ipaddr), ip4_addr2(&ipaddr),ip4_addr3(&ipaddr),ip4_addr4(&ipaddr));
printf("LWIP:IPADDR = %s\n",STRIPADDR);
if (ipaddr.addr != 0)
{
//------------------------------------------------------------
//
// http thread, a web page can be browsed
// sys_thread_new(httpd_init, (void*)"httpd",TCPIP_THREAD_PRIO);
//------------------------------------------------------------
sys_thread_new(test_net, NULL, TCPIP_THREAD_PRIO);
}
/* Block for ever. */
sem = sys_sem_new(0);
sys_sem_wait(sem);
}
2)对齐问题
PBUF_LINK_HLEN 16
static u8_t ip_reassbitmap[MEM_ALIGN_SIZE(IP_REASS_BUFSIZE / (8 * 8))];
在调试的时候经常碰到内存访问错误的异常,最后查得原因是内存的起始地址不再4的倍数上,导致不能访问。因为内存申请时有字节数来的,有时要强制转换为 某种结构。为了保证地址不错,PBUF_LINK_HLEN 定义为16,ip_reassbitmap的大小也变成4的倍数。因为它的大小不是4的倍数,就导致附近的内存分配起始不是4的倍数。这个解决办法由点不 好,但是没有办法,我用 align 等声明没有作用。
3)大包ping问题
原因是以太网络中,最大允许的包大小为1514字 节,若用pc机ping –l 2000 ip地址 测试,pc会把ip包分解成多个发送,lwIP接受后会把他数据合成方在pbuf中,并直接发送出去,可惜程序中不会把包分解发送。导致发送网络不允许的 包。这样不但pc接受不到包,而且lwIP也出现问题。
解决方法,在发送的地方,若包大于1514就不给发送。虽然解决不了大包ping不通问题,但至少lwIP不会死。
5. 存在的问题
1)没有对应得任务释放函数,除非以后的任务都是一直存在不需释放的
2)DNS gethostbyname 的不可重入问题
3)DHCP_DOES_ARP_CHECK 设置为1 死机
4)信号量中timeout 管理的疑问
操作系统中本身带有的函数就已经有timeout参数了,用它多此一举。但想想是不是为了没有timeout的操作系统准备的呢。但它在运行过程中又没有 使用到,也没有找到什么代码来确定某个sem已经超时,而仅仅使用了我使用嵌入式操作系统的timeout。
三、上层开发接口
1.Socket 接口 sockets.h
#define accept(a,b,c) lwip_accept(a,b,c)
#define bind(a,b,c) lwip_bind(a,b,c)
#define shutdown(a,b) lwip_shutdown(a,b)
#define close(s) lwip_close(s)
#define connect(a,b,c) lwip_connect(a,b,c)
#define getsockname(a,b,c) lwip_getsockname(a,b,c)
#define getpeername(a,b,c) lwip_getpeername(a,b,c)
#define setsockopt(a,b,c,d,e) lwip_setsockopt(a,b,c,d,e)
#define getsockopt(a,b,c,d,e) lwip_getsockopt(a,b,c,d,e)
#define listen(a,b) lwip_listen(a,b)
#define recv(a,b,c,d) lwip_recv(a,b,c,d)
#define read(a,b,c) lwip_read(a,b,c)
#define recvfrom(a,b,c,d,e,f) lwip_recvfrom(a,b,c,d,e,f)
#define send(a,b,c,d) lwip_send(a,b,c,d)
#define sendto(a,b,c,d,e,f) lwip_sendto(a,b,c,d,e,f)
#define socket(a,b,c) lwip_socket(a,b,c)
#define write(a,b,c) lwip_write(a,b,c)
#define select(a,b,c,d,e) lwip_select(a,b,c,d,e)
#define ioctlsocket(a,b,c) lwip_ioctl(a,b,c)
2.Dns 客户端 dns.h
struct hostent *gethostbyname(const char *name);