Kenji Arai / mbed-os_TYBLE16

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   TYBLE16_simple_data_logger TYBLE16_MP3_Air

Embed: (wiki syntax)

« Back to documentation index

udp.h File Reference
Data Structures | Typedefs | Functions

udp.h File Reference

UDP API (to be used from TCPIP thread)
See also UDP. More...

Go to the source code of this file.

Data Structures

struct  udp_pcb
 the UDP protocol control block More...

Typedefs

typedef void(* udp_recv_fn )(void *arg, struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *addr, u16_t port)
 Function prototype for udp pcb receive callback functions addr and port are in same byte order as in the pcb The callback is responsible for freeing the pbuf if it's not used any more.

Functions

struct udp_pcb * udp_new (void)
 Creates a new UDP pcb which can be used for UDP communication.
struct udp_pcb * udp_new_ip_type (u8_t type)
 Create a UDP PCB for specific IP type.
void udp_remove (struct udp_pcb *pcb)
 Removes and deallocates the pcb.
err_t udp_bind (struct udp_pcb *pcb, const ip_addr_t *ipaddr, u16_t port)
 Bind an UDP PCB.
void udp_bind_netif (struct udp_pcb *pcb, const struct netif *netif)
 Bind an UDP PCB to a specific netif.
err_t udp_connect (struct udp_pcb *pcb, const ip_addr_t *ipaddr, u16_t port)
 Sets the remote end of the pcb.
void udp_disconnect (struct udp_pcb *pcb)
 Remove the remote end of the pcb.
void udp_recv (struct udp_pcb *pcb, udp_recv_fn recv, void *recv_arg)
 Set a receive callback for a UDP PCB.
err_t udp_sendto_if (struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif)
 Send data to a specified address using UDP.
err_t udp_sendto_if_src (struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif, const ip_addr_t *src_ip)
 Same as udp_sendto_if, but with source address.
err_t udp_sendto (struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip, u16_t dst_port)
 Send data to a specified address using UDP.
err_t udp_send (struct udp_pcb *pcb, struct pbuf *p)
 Sends the pbuf p using UDP.
err_t udp_sendto_if_chksum (struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif, u8_t have_chksum, u16_t chksum)
 Same as udp_sendto_if(), but with checksum.
err_t udp_sendto_chksum (struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip, u16_t dst_port, u8_t have_chksum, u16_t chksum)
 Same as udp_sendto(), but with checksum.
err_t udp_send_chksum (struct udp_pcb *pcb, struct pbuf *p, u8_t have_chksum, u16_t chksum)
 Same as udp_send() but with checksum.
err_t udp_sendto_if_src_chksum (struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif, u8_t have_chksum, u16_t chksum, const ip_addr_t *src_ip)
 Same as udp_sendto_if_src(), but with checksum.
void udp_input (struct pbuf *p, struct netif *inp)
 Process an incoming UDP datagram.
void udp_init (void)
 Initialize this module.
void udp_debug_print (struct udp_hdr *udphdr)
 Print UDP header information for debug purposes.
void udp_netif_ip_addr_changed (const ip_addr_t *old_addr, const ip_addr_t *new_addr)
 This function is called from netif.c when address is changed.

Detailed Description

UDP API (to be used from TCPIP thread)
See also UDP.

Definition in file lwipstack/lwip/src/include/lwip/udp.h.

Typedef Documentation

typedef void(* udp_recv_fn)(void *arg, struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *addr, u16_t port)

Function prototype for udp pcb receive callback functions addr and port are in same byte order as in the pcb The callback is responsible for freeing the pbuf if it's not used any more.

ATTENTION: Be aware that 'addr' might point into the pbuf 'p' so freeing this pbuf can make 'addr' invalid, too.

Parameters:
arguser supplied argument (udp_pcb.recv_arg)
pcbthe udp_pcb which received data
pthe packet buffer that was received
addrthe remote IP address from which the packet was received
portthe remote port from which the packet was received

Definition at line 77 of file lwipstack/lwip/src/include/lwip/udp.h.

Function Documentation

void udp_debug_print ( struct udp_hdr *  udphdr )

Print UDP header information for debug purposes.

Parameters:
udphdrpointer to the udp header in memory.

Definition at line 1301 of file lwip_udp.c.

void udp_init ( void   )

Initialize this module.

Definition at line 87 of file lwip_udp.c.

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

Process an incoming UDP datagram.

Given an incoming UDP datagram (as a chain of pbufs) this function finds a corresponding UDP PCB and hands over the pbuf to the pcbs recv function. If no pcb is found or the datagram is incorrect, the pbuf is freed.

Parameters:
ppbuf to be demultiplexed to a UDP PCB (p->payload pointing to the UDP header)
inpnetwork interface on which the datagram was received.

Definition at line 194 of file lwip_udp.c.

void udp_netif_ip_addr_changed ( const ip_addr_t *  old_addr,
const ip_addr_t *  new_addr 
)

This function is called from netif.c when address is changed.

Parameters:
old_addrIP address of the netif before change
new_addrIP address of the netif after change

Definition at line 1278 of file lwip_udp.c.

err_t udp_sendto_if_chksum ( struct udp_pcb *  pcb,
struct pbuf *  p,
const ip_addr_t *  dst_ip,
u16_t  dst_port,
struct netif *  netif,
u8_t  have_chksum,
u16_t  chksum 
)

Same as udp_sendto_if(), but with checksum.

Definition at line 633 of file lwip_udp.c.

err_t udp_sendto_if_src_chksum ( struct udp_pcb *  pcb,
struct pbuf *  p,
const ip_addr_t *  dst_ip,
u16_t  dst_port,
struct netif *  netif,
u8_t  have_chksum,
u16_t  chksum,
const ip_addr_t *  src_ip 
)

Same as udp_sendto_if_src(), but with checksum.

Definition at line 708 of file lwip_udp.c.

Generated on Tue Jul 12 2022 13:55:20 by  doxygen 1.7.2