[−][src]Trait usb_device::class::UsbClass
A trait for implementing USB classes.
All methods are optional callbacks that will be called by UsbBus::poll
Provided methods
fn get_configuration_descriptors(
&self,
writer: &mut DescriptorWriter
) -> Result<()>
&self,
writer: &mut DescriptorWriter
) -> Result<()>
Called when a GET_DESCRIPTOR request is received for a configuration descriptor. When
called, the implementation should write its interface, endpoint and any extra class
descriptors into writer
. The configuration descriptor itself will be written by
UsbDevice and shouldn't be written by classes.
Errors
Generally errors returned by DescriptorWriter
. Implementors should propagate any errors
using ?
.
fn get_string(&self, index: StringIndex, lang_id: u16) -> Option<&str>
Gets a class-specific string descriptor.
Note: All string descriptor requests are passed to all classes in turn, so implementations
should return None
if an unknown index is requested.
Arguments
index
- A string index allocated earlier withUsbAllocator
.lang_id
- The language ID for the string to retrieve.
fn reset(&mut self)
Called after a USB reset after the bus reset sequence is complete.
fn poll(&mut self)
Called whenever the UsbDevice
is polled.
fn control_out(&mut self, xfer: ControlOut<B>)
Called when a control request is received with direction HostToDevice.
All requests are passed to classes in turn, which can choose to accept, ignore or report an error. Classes can even choose to override standard requests, but doing that is rarely necessary.
See ControlOut
for how to respond to the transfer.
When implementing your own class, you should ignore any requests that are not meant for your class so that any other classes in the composite device can process them.
Arguments
req
- The request from the SETUP packet.xfer
- A handle to the transfer.
fn control_in(&mut self, xfer: ControlIn<B>)
Called when a control request is received with direction DeviceToHost.
All requests are passed to classes in turn, which can choose to accept, ignore or report an error. Classes can even choose to override standard requests, but doing that is rarely necessary.
See ControlIn
for how to respond to the transfer.
When implementing your own class, you should ignore any requests that are not meant for your class so that any other classes in the composite device can process them.
Arguments
req
- The request from the SETUP packet.data
- Data to send in the DATA stage of the control transfer.
fn endpoint_setup(&mut self, addr: EndpointAddress)
Called when endpoint with address addr
has received a SETUP packet. Implementing this
shouldn't be necessary in most cases, but is provided for completeness' sake.
Note: This method may be called for an endpoint address you didn't allocate, and in that case you should ignore the event.
fn endpoint_out(&mut self, addr: EndpointAddress)
Called when endpoint with address addr
has received data (OUT packet).
Note: This method may be called for an endpoint address you didn't allocate, and in that case you should ignore the event.
fn endpoint_in_complete(&mut self, addr: EndpointAddress)
Called when endpoint with address addr
has completed transmitting data (IN packet).
Note: This method may be called for an endpoint address you didn't allocate, and in that case you should ignore the event.
Implementors
impl<B: UsbBus, '_> UsbClass<B> for TestClass<'_, B>
[src]
fn reset(&mut self)
[src]
fn get_configuration_descriptors(
&self,
writer: &mut DescriptorWriter
) -> Result<()>
[src]
&self,
writer: &mut DescriptorWriter
) -> Result<()>