欢迎查看本文所在的系列，STM32的LWIP应用，点击跳转
1、udp_new()
该函数用于建立一个用于UDP通信的UDP控制块（pcb)，但是这个pcb并没有被激活，除非该pcb已经被绑定到一个本地地址上或者连接到一个固定地址的远程主机。在定义一个udp_pcb控制块后该函数应该首先被调用，以建立该控制块的连接标志
|
功能
|
建立一个用于UDP通信的UDP控制块（pcb)
|
|
原型
|
struct udp_pcb *udp_new(void)
|
|
参数
|
无
|
|
返回
|
udp_pcb：建立的UDP连接的控制块(pcb)
|
2、udp_remove()
该函数用于删除一个指定的连接，通常是控制块在建立成功后，即在函数udp_new()调用之后，当不需要该网络连接来通信了，就需要将其删除，以释放该连接(pcb)所占用的资源。
|
功能
|
删除并释放掉一个udp_pcb
|
|
原型
|
void udp_remove(struct udp_pcb *pcb)
|
|
参数
|
pcb：指定要删除的连接(pcb)
|
|
返回
|
无
|
3、udp_bind()
该函数用户绑定本地的IP地址和端口号，用户可以将其绑定在一个任意的本地IP地址上，它也只能在函数udp_new()调用之后才能调用
|
功能
|
为指定的连接绑定本地IP地址和端口号
|
|
原型
|
err_t udp_bind(struct udp_pcb *pcb,
struct ip_addr *ipaddr,
u16_t port)
|
|
参数
|
pcb： 指定一个连接(pcb)
ipaddr：绑定的本地IP地址。如果为IP_ADDR_ANY，则将连接绑定到所有的本地IP地址上
port： 绑定的本地端口号。注意：千万不要和其它的应用程序产生冲突
|
|
返回
|
ERR_OK： 正确地绑定了指定的连接
ERR_USE： 指定的端口号已经绑定了一个连接，产生了冲突
|
4、udp_connect()
该函数将一个指定的连接(pcb)连接到远程主机。由于UDP通信是面向无连接的，所以这不会参数任何的网络流量(网络数据收发)，它仅仅是设置了一个远程连接的IP地址和端口号。
|
功能
|
将参数“pcb”指定的连接控制块连接到远程主机
|
|
原型
|
err_t udp_connect(struct udp_pcb *pcb,
struct ip_addr *ipaddr,
u16_t port)
|
|
参数
|
pcb： 指定一个连接(pcb)
ipaddr：设置连接的远程主机IP地址
port： 设置连接的远程主机端口号
|
|
返回
|
ERR_OK：正确连接到远程主机
其它值： LwIP的一些错误代码标志，表示连接没有正确建立
|
5、udp_disconnect()
该函数关闭参数“pcb”指定的连接，同函数udp_connect()作用相反。由于UDP通信是面向无连接的，所以这个函数同样不会参数任何的网络流量（(网络数据收发)，它仅仅是删除了远程连接的地址
|
功能
|
关闭参数“pcb”指定的连接, 同函数udp_connect()作用相反
|
|
原型
|
void udp_disconnect(struct udp_pcb *pcb)
|
|
参数
|
pcb：指定要删除的连接(pcb)
|
|
返回
|
无
|
6、udp_send()
该函数使用UDP协议发送pbuf p指向的数据。在需要发送数据时调用，发送后，该pbuf结构并没有被释放。调用该函数后，数据包将被发送到存放在pcb中的当前指定的IP地址和端口号上。如果该pcb没有连接到一个固定的端口号，那么该函数将会自动随机地分配一个端口号，并将数据包发送出去。通常，在调用前都会先调用函数udp_connect()
|
功能
|
使用UDP协议发送pbuf p指向的数据
|
|
原型
|
err_t udp_send(struct udp_pcb *pcb, struct pbuf *p)
|
|
参数
|
pcb：指定发送数据的连接(pcb)
p： 包含需要发送数据的pbuf链
|
|
返回
|
ERR_OK：数据包成功发送，没有任何错误发生
ERR_MEM：内存不可用
ERR_RTE：不能找到到达远程主机的路由
其它值：其它的一些错误码，都表示发送了错误
|
7、udp_sendto()
该函数同udp_send()作用一样，但是它指定了发送的目的主机IP地址和端口号，相当于udp_connect()和函数udp_send()合在一起使用的效果。但是，如果在调用该函数前已经调用过函数udp_connect()，那么发送目的主机的IP地址和端口号将以本函数指定的为准，由函数udp_connect()指定的将会被刷新
|
功能
|
向具有指定的IP地址和端口号远程主机发送UDP数据
|
|
原型
|
err_t udp_sendto(struct udp_pcb *pcb,
struct pbuf *p,
struct ip_addr *dst_ip,
u16_t dst_port)
|
|
参数
|
pcb： 指定发送数据的连接(pcb)
p： 包含需要发送数据的pbuf链
dst_ip：发送数据的远程主机IP地址
dst_port：发送数据的远程主机端口号
|
|
返回
|
同函数udp_send()的返回值一样
|
8、udp_recv()
该函数用于指定当有新的UDP数据接收到时被调用的回调函数，回调函数将的参数将传递进远程主机的IP地址、端口号及接收到的数据等信息
|
功能
|
指定一个接收到UDP数据包时被调用的回调函数
|
|
原型
|
void udp_recv(struct udp_pcb *pcb,
void (* recv)(void *arg,
struct udp_pcb *upcb,
struct pbuf *p,
struct ip_addr *addr,
u16_t port),
void *recv_arg)
|
|
参数
|
pcb： 指定一个连接(pcb)
recv： 指定数据包接收到时的回调函数
recv_arg：传递给回调函数的参数
|
|
返回
|
无
|
欢迎查看本文所在的系列，STM32的LWIP应用，点击跳转
1、udp_new()
该函数用于建立一个用于UDP通信的UDP控制块（pcb)，但是这个pcb并没有被激活，除非该pcb已经被绑定到一个本地地址上或者连接到一个固定地址的远程主机。在定义一个udp_pcb控制块后该函数应该首先被调用，以建立该控制块的连接标志
|
功能
|
建立一个用于UDP通信的UDP控制块（pcb)
|
|
原型
|
struct udp_pcb *udp_new(void)
|
|
参数
|
无
|
|
返回
|
udp_pcb：建立的UDP连接的控制块(pcb)
|
2、udp_remove()
该函数用于删除一个指定的连接，通常是控制块在建立成功后，即在函数udp_new()调用之后，当不需要该网络连接来通信了，就需要将其删除，以释放该连接(pcb)所占用的资源。
|
功能
|
删除并释放掉一个udp_pcb
|
|
原型
|
void udp_remove(struct udp_pcb *pcb)
|
|
参数
|
pcb：指定要删除的连接(pcb)
|
|
返回
|
无
|
3、udp_bind()
该函数用户绑定本地的IP地址和端口号，用户可以将其绑定在一个任意的本地IP地址上，它也只能在函数udp_new()调用之后才能调用
|
功能
|
为指定的连接绑定本地IP地址和端口号
|
|
原型
|
err_t udp_bind(struct udp_pcb *pcb,
struct ip_addr *ipaddr,
u16_t port)
|
|
参数
|
pcb： 指定一个连接(pcb)
ipaddr：绑定的本地IP地址。如果为IP_ADDR_ANY，则将连接绑定到所有的本地IP地址上
port： 绑定的本地端口号。注意：千万不要和其它的应用程序产生冲突
|
|
返回
|
ERR_OK： 正确地绑定了指定的连接
ERR_USE： 指定的端口号已经绑定了一个连接，产生了冲突
|
4、udp_connect()
该函数将一个指定的连接(pcb)连接到远程主机。由于UDP通信是面向无连接的，所以这不会参数任何的网络流量(网络数据收发)，它仅仅是设置了一个远程连接的IP地址和端口号。
|
功能
|
将参数“pcb”指定的连接控制块连接到远程主机
|
|
原型
|
err_t udp_connect(struct udp_pcb *pcb,
struct ip_addr *ipaddr,
u16_t port)
|
|
参数
|
pcb： 指定一个连接(pcb)
ipaddr：设置连接的远程主机IP地址
port： 设置连接的远程主机端口号
|
|
返回
|
ERR_OK：正确连接到远程主机
其它值： LwIP的一些错误代码标志，表示连接没有正确建立
|
5、udp_disconnect()
该函数关闭参数“pcb”指定的连接，同函数udp_connect()作用相反。由于UDP通信是面向无连接的，所以这个函数同样不会参数任何的网络流量（(网络数据收发)，它仅仅是删除了远程连接的地址
|
功能
|
关闭参数“pcb”指定的连接, 同函数udp_connect()作用相反
|
|
原型
|
void udp_disconnect(struct udp_pcb *pcb)
|
|
参数
|
pcb：指定要删除的连接(pcb)
|
|
返回
|
无
|
6、udp_send()
该函数使用UDP协议发送pbuf p指向的数据。在需要发送数据时调用，发送后，该pbuf结构并没有被释放。调用该函数后，数据包将被发送到存放在pcb中的当前指定的IP地址和端口号上。如果该pcb没有连接到一个固定的端口号，那么该函数将会自动随机地分配一个端口号，并将数据包发送出去。通常，在调用前都会先调用函数udp_connect()
|
功能
|
使用UDP协议发送pbuf p指向的数据
|
|
原型
|
err_t udp_send(struct udp_pcb *pcb, struct pbuf *p)
|
|
参数
|
pcb：指定发送数据的连接(pcb)
p： 包含需要发送数据的pbuf链
|
|
返回
|
ERR_OK：数据包成功发送，没有任何错误发生
ERR_MEM：内存不可用
ERR_RTE：不能找到到达远程主机的路由
其它值：其它的一些错误码，都表示发送了错误
|
7、udp_sendto()
该函数同udp_send()作用一样，但是它指定了发送的目的主机IP地址和端口号，相当于udp_connect()和函数udp_send()合在一起使用的效果。但是，如果在调用该函数前已经调用过函数udp_connect()，那么发送目的主机的IP地址和端口号将以本函数指定的为准，由函数udp_connect()指定的将会被刷新
|
功能
|
向具有指定的IP地址和端口号远程主机发送UDP数据
|
|
原型
|
err_t udp_sendto(struct udp_pcb *pcb,
struct pbuf *p,
struct ip_addr *dst_ip,
u16_t dst_port)
|
|
参数
|
pcb： 指定发送数据的连接(pcb)
p： 包含需要发送数据的pbuf链
dst_ip：发送数据的远程主机IP地址
dst_port：发送数据的远程主机端口号
|
|
返回
|
同函数udp_send()的返回值一样
|
8、udp_recv()
该函数用于指定当有新的UDP数据接收到时被调用的回调函数，回调函数将的参数将传递进远程主机的IP地址、端口号及接收到的数据等信息
|
功能
|
指定一个接收到UDP数据包时被调用的回调函数
|
|
原型
|
void udp_recv(struct udp_pcb *pcb,
void (* recv)(void *arg,
struct udp_pcb *upcb,
struct pbuf *p,
struct ip_addr *addr,
u16_t port),
void *recv_arg)
|
|
参数
|
pcb： 指定一个连接(pcb)
recv： 指定数据包接收到时的回调函数
recv_arg：传递给回调函数的参数
|
|
返回
|
无
|