Struct UdpLink 

pub struct UdpLink { /* private fields */ }

A UDP socket presented as a ByteLink.

The peer is either learned from the first datagram received (in bind mode) or set up front (in connect mode), and every received datagram refreshes it, so a vehicle that moves ports is followed.

Implementations

impl UdpLink

pub async fn bind(local: impl ToSocketAddrs) -> Result<Self>

Binds a local address and learns the peer from the first datagram received.

Read before writing in this mode: a write before any datagram has arrived has no peer to send to. This suits a vehicle configured to send its telemetry to this port.

Arguments

• local - the local address to bind, such as "0.0.0.0:14550".

Returns

The bound link, with no peer yet.

Errors

Returns an io::Error if the address cannot be bound.

pub async fn connect( local: impl ToSocketAddrs, remote: SocketAddr, ) -> Result<Self>

Binds a local address and sets a fixed peer to send to.

This suits talking to a vehicle at a known address, such as PX4’s offboard UDP port.

Arguments

• local - the local address to bind, such as "0.0.0.0:0".
• remote - the vehicle’s address to send to.

Returns

The link, ready to send.

Errors

Returns an io::Error if the address cannot be bound.

pub fn local_addr(&self) -> Result<SocketAddr>

Returns the local address the socket is bound to.

Returns

The bound local address.

Errors

Returns an io::Error if the address cannot be read.

pub fn peer(&self) -> Option<SocketAddr>

Returns the peer address, once one is known.

Returns

The peer address, or None before any datagram has been received in bind mode.

Trait Implementations

impl ByteLink for UdpLink

async fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Reads available bytes into buf, returning how many were read.

async fn write_all(&mut self, data: &[u8]) -> Result<()>

Writes all of data to the link.