Enum DcsError 

#[non_exhaustive]
pub enum DcsError {
    UnknownPacketLength {
        got: usize,
    },
    VoiceMagicMissing {
        got: [u8; 4],
    },
    StreamIdZero,
    UnknownConnectTag {
        tag: [u8; 3],
    },
    UnlinkModuleByteInvalid {
        byte: u8,
    },
    InvalidModuleByte {
        offset: usize,
        byte: u8,
    },
    EncodeBufferTooSmall {
        need: usize,
        have: usize,
    },
    NoTxHeader,
}

Errors returned by the DCS codec functions.

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.

UnknownPacketLength

DCS packet length is not one of the known sizes.

Fields

got: usize

Observed length.

VoiceMagicMissing

Voice frame magic at [0..4] is not b"0001".

Fields

got: [u8; 4]

Observed 4-byte magic.

StreamIdZero

Stream id at [43..45] is zero.

UnknownConnectTag

Connect reply tag at [10..13] is neither ACK nor NAK.

Fields

tag: [u8; 3]

The 3-byte tag observed.

UnlinkModuleByteInvalid

UNLINK byte [9] is not the expected space (0x20).

Fields

byte: u8

Rejected byte.

InvalidModuleByte

LINK or UNLINK packet has a non-A-Z module byte at [8] or [9].

Fields

offset: usize

Byte offset within the 19- or 519-byte packet.

byte: u8

Rejected byte.

EncodeBufferTooSmall

An encoder was called with an undersized output buffer.

Programming error inside crate::session::client::SessionCore; surfaced as a variant rather than swallowed so callers can still observe the fault.

Fields

need: usize

How many bytes the encoder needed.

have: usize

How many bytes the buffer actually held.

NoTxHeader

send_voice / send_eot called before send_header cached the TX header.

The DCS wire format embeds the D-STAR header in every 100-byte voice frame, so crate::session::client::SessionCore must have a cached header before it can encode voice data or EOT. Call send_header first.

Trait Implementations

impl Clone for DcsError

fn clone(&self) -> DcsError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DcsError

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

Formats the value using the given formatter.

impl Display for DcsError

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

Formats the value using the given formatter.

impl Error for DcsError

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<DcsError> for ProtocolError

fn from(source: DcsError) -> Self

Converts to this type from the input type.

impl From<EncodeError> for DcsError

fn from(value: EncodeError) -> Self

Converts to this type from the input type.

impl PartialEq for DcsError

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

impl StructuralPartialEq for DcsError