Enum AckState 

pub enum AckState {
    Queued {
        needs_forward_confirmation: bool,
    },
    AwaitingForward {
        confirm_deadline_ms: u64,
    },
    RetryQueued,
    AwaitingAck,
}

Tracks which phase of the two-stage ACK lifecycle a pending transmission is in.

UMSH ACK-requested sends go through several waiting phases before the coordinator either confirms delivery or gives up:

1. Queued — the send has been accepted by the coordinator but has not yet gone on-air. Deadlines do not begin running until the first successful transmit.

2. AwaitingForward — after a forwarded send is transmitted, the coordinator listens to see if the frame is re-broadcast by a repeater within confirm_deadline_ms. Because LoRa links are half-duplex, the sender may not be in direct range of the destination but can hear the repeater that retransmitted the frame, providing an early, cheap confirmation that the packet made it to the next hop.

3. RetryQueued — the forwarding-confirmation timer expired, so the coordinator scheduled a retransmission after jittered retry backoff. No forwarding-confirmation timer runs in this state; a new one is armed only after the retransmission actually goes on-air.

4. AwaitingAck — the coordinator waits for the destination to return a MAC ACK packet containing the correct ACK tag (a CMAC-derived value only the destination can compute after successfully decrypting the original frame). The absolute deadline is PendingAck::ack_deadline_ms; expiry means the send failed.

Nodes in direct radio range of the destination skip AwaitingForward entirely and move from Queued straight to AwaitingAck after the first successful transmit.

Variants

Queued

Accepted for transmission but not yet sent.

Fields

needs_forward_confirmation: bool

AwaitingForward

Waiting to overhear forwarding confirmation from the next hop.

Fields

confirm_deadline_ms: u64

RetryQueued

Retransmission is queued with a retry backoff delay.

AwaitingAck

Waiting for the final destination’s transport ACK.

Trait Implementations

impl Clone for AckState

fn clone(&self) -> AckState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AckState

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

Formats the value using the given formatter.

impl PartialEq for AckState

fn eq(&self, other: &AckState) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for AckState

impl Eq for AckState

impl StructuralPartialEq for AckState