Struct NetInterface

pub struct NetInterface<D: NetworkDevice> {
    device: DeviceAdapter<D>,
    iface: Interface,
    sockets: SocketSet<'static>,
    dhcp_handle: Option<SocketHandle>,
    dns_handle: SocketHandle,
    state: NetState,
    gateway: Option<Ipv4Address>,
    dns: Option<Ipv4Address>,
    last_poll_ms: u64,
}

Full network interface with IP stack.

Wraps a NetworkDevice with complete smoltcp integration.

Fields

device: DeviceAdapter<D>

The underlying device adapter.

iface: Interface

smoltcp interface.

sockets: SocketSet<'static>

Socket set.

dhcp_handle: Option<SocketHandle>

DHCP socket handle (if using DHCP).

dns_handle: SocketHandle

DNS socket handle.

state: NetState

Current state.

gateway: Option<Ipv4Address>

Configured gateway.

dns: Option<Ipv4Address>

Configured DNS server.

last_poll_ms: u64

Last poll timestamp (milliseconds).

Implementations

impl<D: NetworkDevice> NetInterface<D>

pub fn new(device: D, config: NetConfig) -> Self

Create a new network interface.

Arguments

• device - The network device to use
• config - IP configuration (DHCP or static)

pub fn state(&self) -> NetState

Get current state.

pub fn has_ip(&self) -> bool

Check if interface has an IP address configured.

pub fn ipv4_addr(&self) -> Option<Ipv4Addr>

Get the current IPv4 address (if configured).

pub fn gateway(&self) -> Option<Ipv4Addr>

Get the gateway address.

pub fn dns(&self) -> Option<Ipv4Addr>

Get the DNS server address.

pub fn start_dns_query(&mut self, hostname: &str) -> Result<QueryHandle>

Start a DNS query for a hostname. Returns a query handle.

pub fn get_dns_result( &mut self, handle: QueryHandle, ) -> Result<Option<Ipv4Addr>>

Check DNS query result. Returns Ok(Some(ip)) if resolved, Ok(None) if pending, Err if failed.

pub fn mac_address(&self) -> [u8; 6]

Get the MAC address.

pub fn poll(&mut self, timestamp_ms: u64) -> bool

Poll the interface - must be called regularly.

Returns true if any socket activity occurred.

pub fn tcp_socket(&mut self) -> Result<SocketHandle>

Create a TCP socket and return its handle.

pub fn tcp_connect( &mut self, handle: SocketHandle, remote_ip: Ipv4Addr, remote_port: u16, ) -> Result<()>

Connect a TCP socket to a remote endpoint.

pub fn tcp_is_connected(&self, handle: SocketHandle) -> bool

Check if a TCP socket is connected.

pub fn tcp_can_send(&self, handle: SocketHandle) -> bool

Check if a TCP socket can send data.

pub fn tcp_can_recv(&self, handle: SocketHandle) -> bool

Check if a TCP socket can receive data.

pub fn tcp_send(&mut self, handle: SocketHandle, data: &[u8]) -> Result<usize>

Send data on a TCP socket.

pub fn tcp_recv( &mut self, handle: SocketHandle, buffer: &mut [u8], ) -> Result<usize>

Receive data from a TCP socket.

pub fn tcp_close(&mut self, handle: SocketHandle)

Close a TCP socket.

pub fn remove_socket(&mut self, handle: SocketHandle)

Remove a socket from the set.

pub fn tcp_state(&self, handle: SocketHandle) -> TcpState

Get TCP socket state.

fn ephemeral_port(&self) -> u16

Generate an ephemeral port number.

pub fn device(&self) -> &D

Get reference to the underlying device.

pub fn device_mut(&mut self) -> &mut D

Get mutable reference to the underlying device.