Struct PacketBuilder 

pub struct PacketBuilder {
    pub addr: Address,
    pub ctrl: ControlByte,
    pub scb: Option<Scb>,
    pub code: u8,
    pub data: Vec<u8>,
}

Builder for a single OSDP packet.

Caller fills in the high-level fields and calls PacketBuilder::encode (for non-secure packets) or PacketBuilder::encode_with_mac (for SCS_15..=SCS_18) to produce the bytes ready for transmission.

Fields

addr: Address

Address byte (with reply flag if PD → ACU).

ctrl: ControlByte

CTRL byte (SQN + flags).

scb: Option<Scb>

Security Control Block (None if CTRL.HAS_SCB is clear).

code: u8

Command or reply code byte.

data: Vec<u8>

DATA payload (already encrypted, if SCS_17/18).

Implementations

impl PacketBuilder

pub fn plain(addr: Address, ctrl: ControlByte, code: u8, data: Vec<u8>) -> Self

Build a packet with neither SCB nor MAC.

pub fn encode(&self) -> Result<Vec<u8>, Error>

Encode the packet without any MAC.

If the CTRL byte has crate::packet::CtrlFlags::HAS_SCB set but the SCB type would require a MAC, the caller must use Self::encode_with_mac instead.

pub fn encode_with_mac<F>(&self, mac_fn: F) -> Result<Vec<u8>, Error>

where F: FnOnce(&[u8]) -> [u8; 4],

Encode the packet, computing the MAC trailer with mac_fn.

mac_fn receives the bytes from SOM through end-of-DATA (i.e. what the wire MAC is computed over) and returns the first 4 bytes of the resulting MAC.

Trait Implementations

impl Clone for PacketBuilder

fn clone(&self) -> PacketBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PacketBuilder

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

Formats the value using the given formatter.