LWIP UDP 编程

一、udp.c实现的函数

1、void udp_input(struct pbuf *p, struct netif *inp)

说明：处理接收到的udp数据包。

参数：p数据包缓存区；inp网络接口。

2、err_t udp_send（struct udp_pcb *pcb, struct pbuf *p)

说明：发送udp包。这个函数直接调用udp_sendto()函数。

参数：pcb协议控制块；p数据包发送缓存区。

返回：ERR_OK发送成功；ERR_MEM发送溢出；ERR_RTE不能发送到指定ip；其它表示发送失败。

说明：发送udp包到指定ip地址。

参数：pcb协议控制块；p数据包发送缓存区；dst_ip目的ip地址；dst_port目的端口号。

说明：按照指定的网络接口和ip地址发送udp包。

参数：pcb协议控制块；p数据包发送缓存区；dest_ip目的ip地址；dst_port目的端口号，netif网络接口。

5、err_t udp_bind(struct udp_pcb *pcb, struct ip_addr *ipaddr, u16_t port)

说明：在协议控制块中绑定本地ip地址和本地端口号

参数：pcb协议控制块；ipaddr本地ip地址；port本地端口号。

返回：ERR_OK成功；ERR_USE已经被占用。

6、err_t udp_connect(struct udp_pcb *pcb, struct ip_addr *ipaddr, u16_t port)

说明：与远端udp主机建立连接。

参数：pcb所需连接的协议控制块；ipaddr远端ip地址；port远端端口号。

7、void udp_disconnect(struct udp_pcb *pcb)

说明：断开指定连接。

参数：pcb所需断开连接的协议控制块。

说明：设置接收到数据包时调用的回调函数及其参数。

参数：pcb协议控制块；recv回调函数名（地址）；rev_arg回调函数参数。

这个函数直接修改pcb->recv和pcb->recv_arg的值。

9、void udp_remove(struct udp_pcb *pcb)

说明：删除指定udp协议控制块，从协议控制链表中删除并释放内存资源。

参数：pcb所要删除的协议控制块。

10、struct udp_pcb * udp_new(void)

说明：创建udp协议控制块，并不分配资源。

返回：协议控制块指针，指向NULL。

– UDP functions

err_t udp_bind(struct udp_pcb *pcb, struct ip_addr *ipaddr, u16_t port)
函数遍历整个UDP PCB链表，以排除在没有设置REUSE_ADDR或者REUSE_PORT标志的情况下绑定到一个以相同port绑定的pcb或者以相同port及ip绑定的pcb。如果需要绑定的port无效，则分配最小可用port。如果该pcb未在原来PCB链表中，则加入链表。具体流程参看流程图。
err_t udp_connect(struct udp_pcb *pcb, struct ip_addr *ipaddr, u16_t port)
连接到远程端口。如果还未分配本地port，则分配一个空闲port。然后将一下两种地址绑定类型进行转换：
a. *.local_port  foreign_ip.foreign_port: 调用ip_router确定本地ip。
b. *.*  *.foreign_port: 转换为 *.local_port  *.foreign_port

err_t udp_sendto(struct udp_pcb *pcb, struct pbuf *p,
struct ip_addr *dst_ip, u16_t dst_port)
该函数借用当前的pcb调用udp_send发送UDP包，完成后，回复原来pcb内容。

err_t udp_send(struct udp_pcb *pcb, struct pbuf *p)
如果pcb未绑定，则调用udp_bind获取一个可用的port绑定之。然后构造UDP包，查找能够到达remote_ip的router接口，如果有必要，将该接口的本地ip作为UDP的src ip。如果UDP需要校验和，则调用inet_chksum_pseudo函数，计算校验和。最后调用ip_output_if将UDP包传送到下层IP层发送。

void udp_input(struct pbuf *p, struct netif *inp)
该函数接受来自ip层的UDP包。将所有PCB都遍历，如果有多个绑定，则给每一个进程复制一份数据报，实际调用pcb->recv()。
其中的数据报的地址绑定匹配优先级和协议上的略有区别：
    Local                            Foreign
local_ip(*).local_port  foreign_ip(*).foreign_port

local_ip(*).local_port  *.*

UDP发送过程：

然后调用udp_bind()绑定在UDP端口上。在这个调用过程中，我们必须编写一个用于处理这个UDP套接字接收到的数据报文的函数，并把这个函数作为udp_bind()的参数，以后当套接字接收到数据报文时会自动调用这个函数，我们将在后面介绍这个函数怎么调用的。

绑定结束之后，必须调用udp_connect()将数据报文的目的地址绑定在UDP的数据结构中，最后就是调用udp_send()把数据报文发送出去。

 udp_bind()的处理流程图

UDP接收过程：

接收过程与发送过程刚好相反：

数据报文首先调用ethernet_input()函数到达数据链路层，去掉以太网头部之后如果是ARP报文传给调用arp_input()交给ARP协议处理，如果是IP报文就调用ip_input()进入IP层处理。

ip_input()函数中比较数据报文的目的IP地址，如果与某个网络接口的IP地址相同，则接收这个报文，依照IP头部的协议字段，调用各自协议的输入处理函数，本例中将调用udp_input()。

在udp_input()中提取数据报文的端口号，然后在已登记的套接字中查找与该端口号符合的UDP接收函数，如果没有找到相应的套接字，调用icmp_output()发送一个ICMP不可达报文，如果找到了，就调用该函数（这个函数就是我们在udp_bind()时传入的其中一个参数）。

udp_input处理流程图：