Struct usb_device::device::UsbDevice

pub struct UsbDevice<'a, B: UsbBus> { /* fields omitted */ }

A USB device consisting of one or more device classes.

Methods

impl<B: UsbBus, '_> UsbDevice<'_, B>

pub fn state(&self) -> UsbDeviceState

Gets the current state of the device.

In general class traffic is only possible in the Configured state.

pub fn remote_wakeup_enabled(&self) -> bool

Gets whether host remote wakeup has been enabled by the host.

pub fn self_powered(&self) -> bool

Gets whether the device is currently self powered.

pub fn set_self_powered(&mut self, is_self_powered: bool)

Sets whether the device is currently self powered.

pub fn force_reset(&mut self) -> Result<()>

Simulates a disconnect from the USB bus, causing the host to reset and re-enumerate the device.

Mostly useful for development. Calling this at the start of your program ensures that the host re-enumerates your device after a new program has been flashed.

pub fn poll(&mut self, classes: &mut [&'a mut dyn UsbClass<B>]) -> bool

Polls the UsbBus for new events and dispatches them to the provided classes. Returns true if one of the classes may have data available for reading or be ready for writing, false otherwise. This should be called periodically as often as possible for the best data rate, or preferably from an interrupt handler. Must be called at least once every 10 milliseconds while connected to the USB host to be USB compliant.

Note: The list of classes passed in must be the same classes in the same order for every call while the device is configured, or the device may enumerate incorrectly or otherwise misbehave. The easiest way to do this is to call the poll method in only one place in your code, as follows:

usb_dev.poll(&mut [&mut class1, &mut class2]);

Strictly speaking the list of classes is allowed to change between polls if the device has been reset, which is indicated by state being equal to UsbDeviceState::Default.