Enum Error 

#[non_exhaustive]
pub enum Error {
    Truncated {
        have: usize,
        need: usize,
    },
    BadSom(u8),
    BadLength {
        declared: usize,
        actual: usize,
    },
    BadControlByte(u8),
    BadCrc {
        got: u16,
        want: u16,
    },
    BadChecksum {
        got: u8,
        want: u8,
    },
    BadAddress(u8),
    BadSqn(u8),
    BadSecurityBlock(u8),
    BadSecurityBlockLength(u8),
    BadMac,
    ShortMac,
    UnknownCommand(u8),
    UnknownReply(u8),
    MalformedPayload {
        code: u8,
        reason: &'static str,
    },
    PayloadLength {
        code: u8,
        expected: usize,
        got: usize,
    },
    PayloadTooShort {
        code: u8,
        min: usize,
        got: usize,
    },
    PayloadNotMultiple {
        code: u8,
        block: usize,
        got: usize,
    },
    Multipart(MultipartError),
    SecureSession(SecureSessionError),
    Io(&'static str),
    Timeout,
    Offline,
    AddrMismatch {
        sent: u8,
        got: u8,
    },
    SqnMismatch {
        expected: u8,
        got: u8,
    },
    Nak {
        code: u8,
    },
    BufferOverflow {
        need: usize,
        have: usize,
    },
}

Crate-wide error.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Truncated

Buffer too small to hold a syntactically valid packet header.

Fields

have: usize

Bytes available.

need: usize

Bytes required.

BadSom(u8)

SOM mismatch — packet did not start with 0x53.

BadLength

LEN field disagrees with the actual buffer length.

Fields

declared: usize

Length declared in the LEN field.

actual: usize

Length actually delivered.

BadControlByte(u8)

Reserved bits in the crate::ControlByte are non-zero, or the byte is otherwise malformed.

BadCrc

CRC verification failed.

Fields

got: u16

CRC carried on the wire.

want: u16

CRC we computed from the header + payload.

BadChecksum

Checksum verification failed.

Fields

got: u8

Trailer byte carried on the wire.

want: u8

Checksum we computed.

BadAddress(u8)

Address field is reserved or invalid.

BadSqn(u8)

Sequence number is not in 0..=3.

BadSecurityBlock(u8)

Security block type is unknown.

BadSecurityBlockLength(u8)

Length of the security block is wrong for its type.

BadMac

MAC verification failed (constant-time compare).

ShortMac

MAC is too short (must be at least 4 bytes on the wire).

UnknownCommand(u8)

Command code is not recognized.

UnknownReply(u8)

Reply code is not recognized.

MalformedPayload

Payload bytes do not match the expected layout for this command/reply.

Fields

code: u8

Command or reply code.

reason: &'static str

One-line explanation.

PayloadLength

Payload length differs from the fixed length the message defines.

Fields

code: u8

Command or reply code.

expected: usize

Bytes the spec mandates.

got: usize

Bytes actually delivered.

PayloadTooShort

Payload is shorter than the minimum needed to parse the header.

Fields

code: u8

Command or reply code.

min: usize

Minimum bytes required.

got: usize

Bytes actually delivered.

PayloadNotMultiple

Record-array payload is not a positive multiple of the record size.

Fields

code: u8

Command or reply code.

block: usize

Per-record block size in bytes.

got: usize

Bytes actually delivered.

Multipart(MultipartError)

Multi-part receiver detected an invariant violation.

SecureSession(SecureSessionError)

Secure-channel state machine rejected an event.

Io(&'static str)

Transport-level I/O.

Timeout

Reply did not arrive within the configured budget.

Offline

PD declared off-line.

AddrMismatch

Address mismatch between expected PD and reply ADDR.

Fields

sent: u8

Address we sent to.

got: u8

Address echoed back in the reply.

SqnMismatch

Reply carried a sequence number we did not request. Per spec §5.7 / Table 2 the PD must echo the ACU’s SQN; a mismatch typically means a stale reply from a desynchronised PD.

Fields

expected: u8

SQN the ACU sent in the prompting command.

got: u8

SQN observed in the reply.

Nak

PD answered with crate::reply::Nak.

Fields

code: u8

Error code byte from the reply.

BufferOverflow

Output buffer was too small.

Fields

need: usize

Minimum required capacity.

have: usize

Capacity available.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<MultipartError> for Error

fn from(e: MultipartError) -> Self

Converts to this type from the input type.

impl From<SecureSessionError> for Error

fn from(e: SecureSessionError) -> Self

Converts to this type from the input type.

impl PartialEq for Error

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

impl StructuralPartialEq for Error