以太网LWIP的UDP相关API

2019-07-14 09:48发布

欢迎查看本文所在的系列,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:传递给回调函数的参数返回