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:传递给回调函数的参数 |
返回 | 无 |