Enum UsbError 

#[non_exhaustive]
pub enum UsbError {
    Stall,
    Timeout,
    Overflow,
    BitStuffError,
    CrcError,
    DataSeqError,
    BufferTooSmall,
    AllPipesInUse,
    ProtocolError,
    TooManyDevices,
    NoSuchEndpoint,
}

Errors reported from a USB operation

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.

Stall

The device has stalled the endpoint

See USB 2.0 section 8.5.2 and 8.5.3.4, and, for a prolific user of stall conditions, the USB Mass Storage Bulk-Only Transport section 6.

Timeout

The USB transaction has timed out

A NAK response is automatically retried, but if NAKs persist, eventually the transfer will time out.

Overflow

The input FIFO overflowed

This error, produced by the USB host-controller hardware, probably represents a bug in cotton-usb-host (or perhaps a failure to service interrupts quickly enough).

BitStuffError

The USB hardware experienced a bit-stuffing error

CrcError

The USB hardware experienced a CRC error

DataSeqError

The USB hardware received a DATA1 packet when expecting DATA0, or vice versa

This probably indicates a bug in cotton-usb-host (which is intended to take care of the data toggle without client code needing to intervene).

BufferTooSmall

A buffer supplied to cotton-usb-host was too small for the intended data

AllPipesInUse

A USB transaction was attempted when all hardware resources were in use

This error is returned from HostController::try_alloc_interrupt_pipe() when all interrupt-capable pipes are already in use. Users of UsbBus::interrupt_endpoint_in() do not experience this error, as that call will wait for the next pipe to be available.

ProtocolError

The device has reacted in a way contrary to the expected protocol

TooManyDevices

The limit of attached USB devices has been reached

NoSuchEndpoint

UsbDevice::open_in_endpoint() was called with a bogus endpoint number

Trait Implementations

impl Clone for UsbError

fn clone(&self) -> UsbError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsbError

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

Formats the value using the given formatter.

impl Format for UsbError

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

Writes the defmt representation of self to fmt.

impl PartialEq for UsbError

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

impl Eq for UsbError

impl StructuralPartialEq for UsbError