Enum Packet 

pub enum Packet {
    PushData {
        token: u16,
        gateway: Eui,
        uplink: Uplink,
    },
    PushAck {
        token: u16,
    },
    PullData {
        token: u16,
        gateway: Eui,
    },
    PullAck {
        token: u16,
    },
    PullResp {
        token: u16,
        transmit: Txpk,
    },
    TxAck {
        token: u16,
        gateway: Eui,
        status: TxStatus,
    },
}

One datagram of the protocol.

to_bytes writes it and parse reads one, so the same type serves a gateway and a server.

Variants

PushData

What the gateway heard, and how its own radio is doing.

Fields

token: u16

The random token the acknowledgment carries back.

gateway: Eui

The gateway’s identifier.

uplink: Uplink

The packets and the status report.

PushAck

The server acknowledging a PUSH_DATA, which says only that it arrived.

Fields

token: u16

The token of the PUSH_DATA being acknowledged.

PullData

The gateway holding a route open for downlinks.

Fields

token: u16

The random token the acknowledgment carries back.

gateway: Eui

The gateway’s identifier.

PullAck

The server acknowledging a PULL_DATA.

Fields

token: u16

The token of the PULL_DATA being acknowledged.

PullResp

The server asking the gateway to transmit a packet.

Fields

token: u16

The random token the TX_ACK carries back.

transmit: Txpk

What to transmit, and when.

TxAck

The gateway reporting what became of a PULL_RESP.

Fields

token: u16

The token of the PULL_RESP being answered.

gateway: Eui

The gateway’s identifier.

status: TxStatus

Whether it was scheduled, or why it was refused.

Implementations

impl Packet

pub const fn kind(&self) -> PacketKind

Returns which kind of datagram this is.

Returns

The kind.

pub const fn token(&self) -> u16

Returns the token, which pairs a datagram with its answer.

Returns

The token.

pub const fn gateway(&self) -> Option<Eui>

Returns the gateway’s identifier, for the kinds that carry it.

Returns

The identifier, or None for the datagrams a server sends, which do not name one.

pub fn acknowledgment(&self) -> Option<Packet>

Returns the acknowledgment a server owes this datagram.

Returns

The PUSH_ACK or PULL_ACK to send back, or None for a datagram that is itself an answer. A PULL_RESP is answered with a TX_ACK, which names the gateway and what became of the transmission, so the gateway builds that one itself.

pub fn to_bytes(&self) -> Vec<u8>

Writes the datagram.

Returns

The bytes to send.

pub fn parse(bytes: &[u8]) -> Result<Packet, ProtocolError>

Reads a datagram.

Arguments

• bytes - the datagram as it arrived.

Returns

The packet.

Errors

Returns ProtocolError for a datagram shorter than its header, another protocol version, an identifier the protocol does not define, a datagram missing the fields its kind carries, or a payload that is not the JSON object described for it.

Trait Implementations

impl Clone for Packet

fn clone(&self) -> Packet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Packet

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

Formats the value using the given formatter.

impl PartialEq for Packet

fn eq(&self, other: &Packet) -> 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 StructuralPartialEq for Packet