hal::usb

USB device packets, not an addressed SPI/I2C transaction or a byte stream. Controllers own packet memory; a class driver turns packets into a stream.

Enums

EndpointType

enum EndpointType {
    Bulk,
    Interrupt,
}

Implements: Clone, Copy, Debug, Eq, PartialEq, StructuralPartialEq

Error

enum Error {
    Busy,
    InvalidEndpoint,
    PacketTooLarge,
    Hardware,
    Unsupported,
}

Implements: Clone, Copy, Debug, Eq, PartialEq, StructuralPartialEq

Event

enum Event {
    Reset,
    Setup([u8; 8]),
    Out(u8),
    InComplete(u8),
    Suspend,
    Resume,
}

Implements: Clone, Copy, Debug, Eq, PartialEq, StructuralPartialEq

ResetTarget

enum ResetTarget {
    Application,
    Bootloader,
}

Implements: Clone, Copy, Debug, Eq, PartialEq, StructuralPartialEq

Traits

DeviceController

trait DeviceController: Send {
    fn poll(&mut self) -> Result<Option<Event>, Error>
    fn configure(&mut self, endpoint: u8, kind: EndpointType) -> Result<(), Error>
    fn close_data_endpoints(&mut self)
    fn set_address(&mut self, address: u8)
    fn write_in(&mut self, endpoint: u8, data: &[u8]) -> Result<(), Error>
    fn arm_out(&mut self, endpoint: u8) -> Result<(), Error>
    fn read_out(&mut self, endpoint: u8, data: &mut [u8]) -> Result<usize, Error>
    fn set_stall(&mut self, endpoint: u8, stalled: bool) -> Result<(), Error>
    fn stalled(&self, endpoint: u8) -> bool
}

Exclusive, full-speed device controller. Every call is bounded and nonblocking. Endpoint addresses include bit 7 for IN. EP0 is always open, 64 bytes. poll consumes one event; call periodically even without interrupts (errata). Reset/SETUP cancel old EP0 work before returning their event. Reset closes all other endpoints. Buffer ownership transfers only on successful calls.