Struct BusHandle 

pub struct BusHandle<'d, A: UsbHostAllocator<'d>> { /* private fields */ }

Shareable handle for pipe allocation and device enumeration.

A BusHandle bundles a UsbHostAllocator produced by a UsbHostController with a reference to the bus-wide BusState.

BusHandle itself implements UsbHostAllocator by forwarding to its inner allocator, so it can be passed directly to class driver constructors.

Implementations

impl<'d, A: UsbHostAllocator<'d>> BusHandle<'d, A>

pub fn state(&self) -> &'d BusState

Borrow the shared bus state.

pub fn free_address(&self, addr: u8)

Release a previously allocated device address.

Equivalent to self.state().free_address(addr). Must be called by application code when a device is removed.

pub async fn enumerate( &self, route: BusRoute, config_buf: &mut [u8], ) -> Result<(EnumerationInfo, usize), EnumerationError>

Enumerate a connected device.

Performs the standard enumeration sequence:

1. Get device descriptor (first 8 bytes) to learn EP0 max packet size
2. SET_ADDRESS to assign a unique address
3. Get full device descriptor
4. Get configuration descriptor
5. SET_CONFIGURATION

route describes how the device is reached on the bus (directly at its native speed, or via split transactions / legacy PRE through a hub’s transaction translator).

Enumerations are serialised bus-wide through the BusState’s enumeration mutex.

Preconditions

The caller must have placed the device into the default (address 0) state before calling this method. For a root-port device that means an upstream bus reset has completed; for a hub-attached device, the parent hub’s port reset must have completed and BusRoute::Translated must carry the appropriate SplitInfo.

Returns the EnumerationInfo for the device and the number of bytes written to config_buf.

Trait Implementations

impl<'d, A: Clone + UsbHostAllocator<'d>> Clone for BusHandle<'d, A>

fn clone(&self) -> BusHandle<'d, A>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'d, A: UsbHostAllocator<'d>> UsbHostAllocator<'d> for BusHandle<'d, A>

type Pipe<T: Type, D: Direction> = <A as UsbHostAllocator<'d>>::Pipe<T, D>

Pipe implementation produced by this allocator.

fn alloc_pipe<T: Type, D: Direction>( &self, addr: u8, endpoint: &EndpointInfo, split: Option<SplitInfo>, ) -> Result<Self::Pipe<T, D>, HostError>

Allocate a pipe for communication with a device endpoint.