Enum EmacError 

#[non_exhaustive]
pub enum EmacError {
    Timeout,
    DmaResetTimeout,
    DmaError,
    InvalidConfig,
    InvalidPhyAddress,
    InvalidLength,
    FrameTooLarge,
    NoDescriptorsAvailable,
    DescriptorBusy,
    NoFrameAvailable,
    FrameError,
    BufferTooSmall,
    NotInitialized,
    AlreadyInitialized,
    TxFlushTimeout,
}

EMAC driver 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.

Timeout

MDIO operation timed out (no PHY response within the SMI window).

DmaResetTimeout

DMA software reset (DMABUSMODE.SWR) did not self-clear within the crate::reset::ResetController timeout. Distinct from Self::Timeout so callers can tell SMI-bus errors apart from DMA-controller stuckness.

DmaError

DMA descriptor or buffer error.

InvalidConfig

Invalid configuration (bad pin, clock, etc.).

InvalidPhyAddress

PHY address out of range (must be 0-31).

InvalidLength

Frame length is zero or otherwise invalid.

FrameTooLarge

Frame too large for available descriptors/buffers.

NoDescriptorsAvailable

No TX descriptors available (ring full).

DescriptorBusy

Descriptor is still owned by DMA.

NoFrameAvailable

No received frame available.

FrameError

Received frame has errors (CRC, overflow, etc.).

BufferTooSmall

Caller-provided buffer too small for the received frame.

NotInitialized

DMA engine not initialized.

AlreadyInitialized

init() was called twice.

TxFlushTimeout

stop() could not flush the TX FIFO within TX_FIFO_FLUSH_TIMEOUT_US. Teardown still proceeded — the driver state is back to crate::EmacState::Initialized and MAC/DMA are quiesced — but at least one in-flight TX frame may have been truncated on the wire. The caller decides whether to treat this as a recoverable warning (sample, log, start() again — the engine is ready) or as terminal: there is no in-crate “re-init” path because crate::Emac::init is one-shot, so a hard recovery means a peripheral / SoC reset from the application layer.

Trait Implementations

impl Clone for EmacError

fn clone(&self) -> EmacError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmacError

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

Formats the value using the given formatter.

impl Format for EmacError

fn format(&self, f: Formatter<'_>)

Writes the defmt representation of self to fmt.

impl From<ResetError> for EmacError

fn from(e: ResetError) -> Self

Converts to this type from the input type.

impl PartialEq for EmacError

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

impl Eq for EmacError

impl StructuralPartialEq for EmacError