Enum DhcpState

pub enum DhcpState {
    Init,
    Discovering {
        start_tsc: TscTimestamp,
    },
    Bound {
        config: DhcpConfig,
        bound_tsc: TscTimestamp,
    },
    Failed {
        error: DhcpError,
    },
}

DHCP client state machine.

Tracks DHCP discovery progress and wraps smoltcp’s DHCP socket.

Variants

Init

Initial state - not started

Discovering

DHCP discovery in progress

Fields

start_tsc: TscTimestamp

When discovery started

Bound

IP address obtained

Fields

config: DhcpConfig

DHCP configuration

bound_tsc: TscTimestamp

When bound

Failed

DHCP failed

Fields

error: DhcpError

Error details

Implementations

impl DhcpState

pub fn new() -> Self

Create new DHCP state machine in init state.

pub fn start(&mut self, now_tsc: u64)

Start DHCP discovery.

Arguments

• now_tsc: Current TSC timestamp

pub fn step( &mut self, dhcp_config: Option<DhcpConfig>, now_tsc: u64, timeout_ticks: u64, ) -> StepResult

Step the state machine.

Arguments

• dhcp_config: Current DHCP config from smoltcp (None if not yet configured)
• now_tsc: Current TSC value
• timeout_ticks: DHCP timeout in TSC ticks

Returns

• Pending: Still discovering
• Done: Bound, call config() to get configuration
• Timeout: Discovery timed out
• Failed: Discovery failed

pub fn config(&self) -> Option<&DhcpConfig>

Get DHCP configuration (if bound).

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

Get assigned IP address (if bound).

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

Get gateway (if bound and available).

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

Get DNS server (if bound and available).

pub fn error(&self) -> Option<DhcpError>

Get error (if failed).

pub fn is_terminal(&self) -> bool

Check if DHCP is complete (bound or failed).

pub fn is_bound(&self) -> bool

Check if successfully bound.

pub fn is_discovering(&self) -> bool

Check if still discovering.

Trait Implementations

impl Debug for DhcpState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DhcpState

fn default() -> Self

Returns the “default value” for a type.