Add USBHost #4321
Draft
Add USBHost #4321
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…isochronuous channels
Use stat_tx and stat_rx instead of nak() flag
Should only be included for usb_v4 peripherals.
0.000431 DEBUG Detecting device
└─ usb_host_keyboard::____embassy_main_task::{async_fn#0} @ src/bin/usb_host_keyboard.rs:25
Found device with speed = Low
0.161293 ERROR panicked at src/bin/usb_host_keyboard.rs:36:65:
called `Result::unwrap()` on an `Err` value: ChannelError(Stall)
USBDescriptor trait requires the descriptor to be of a fixed size and this function is meant for getting descriptors of variable size.
Notice how in following DS4 gamepad configuration descriptor there are multiple interface descriptors with bInterfaceNumber = 1. //Decoded with http://eleccelerator.com/usbdescreqparser/ 0x09, // bLength 0x02, // bDescriptorType (Configuration) 0xE1, 0x00, // wTotalLength 225 0x04, // bNumInterfaces 4 0x01, // bConfigurationValue 0x00, // iConfiguration (String Index) 0xC0, // bmAttributes Self Powered 0xFA, // bMaxPower 500mA 0x09, // bLength 0x04, // bDescriptorType (Interface) 0x00, // bInterfaceNumber 0 0x00, // bAlternateSetting 0x00, // bNumEndpoints 0 0x01, // bInterfaceClass (Audio) 0x01, // bInterfaceSubClass (Audio Control) 0x00, // bInterfaceProtocol 0x00, // iInterface (String Index) 0x0A, // bLength 0x24, // bDescriptorType (See Next Line) 0x01, // bDescriptorSubtype (CS_INTERFACE -> HEADER) 0x00, 0x01, // bcdADC 1.00 0x47, 0x00, // wTotalLength 71 0x02, // binCollection 0x02 0x01, // baInterfaceNr 1 0x02, // baInterfaceNr 2 0x0C, // bLength 0x24, // bDescriptorType (See Next Line) 0x02, // bDescriptorSubtype (CS_INTERFACE -> INPUT_TERMINAL) 0x01, // bTerminalID 0x01, 0x01, // wTerminalType (USB Streaming) 0x06, // bAssocTerminal 0x02, // bNrChannels 2 0x03, 0x00, // wChannelConfig (Left and Right Front) 0x00, // iChannelNames 0x00, // iTerminal 0x0A, // bLength 0x24, // bDescriptorType (See Next Line) 0x06, // bDescriptorSubtype (CS_INTERFACE -> FEATURE_UNIT) 0x02, // bUnitID 0x01, // bSourceID 0x01, // bControlSize 1 0x03, 0x00, // bmaControls[0] (Mute,Volume) 0x00, 0x00, // bmaControls[1] (None) 0x09, // bLength 0x24, // bDescriptorType (See Next Line) 0x03, // bDescriptorSubtype (CS_INTERFACE -> OUTPUT_TERMINAL) 0x03, // bTerminalID 0x02, 0x04, // wTerminalType (Headset) 0x04, // bAssocTerminal 0x02, // bSourceID 0x00, // iTerminal 0x0C, // bLength 0x24, // bDescriptorType (See Next Line) 0x02, // bDescriptorSubtype (CS_INTERFACE -> INPUT_TERMINAL) 0x04, // bTerminalID 0x02, 0x04, // wTerminalType (Headset) 0x03, // bAssocTerminal 0x01, // bNrChannels 1 0x00, 0x00, // wChannelConfig 0x00, // iChannelNames 0x00, // iTerminal 0x09, // bLength 0x24, // bDescriptorType (See Next Line) 0x06, // bDescriptorSubtype (CS_INTERFACE -> FEATURE_UNIT) 0x05, // bUnitID 0x04, // bSourceID 0x01, // bControlSize 1 0x03, 0x00, // bmaControls[0] (Mute,Volume) 0x00, // iFeature 0x09, // bLength 0x24, // bDescriptorType (See Next Line) 0x03, // bDescriptorSubtype (CS_INTERFACE -> OUTPUT_TERMINAL) 0x06, // bTerminalID 0x01, 0x01, // wTerminalType (USB Streaming) 0x01, // bAssocTerminal 0x05, // bSourceID 0x00, // iTerminal 0x09, // bLength 0x04, // bDescriptorType (Interface) 0x01, // bInterfaceNumber 1 0x00, // bAlternateSetting 0x00, // bNumEndpoints 0 0x01, // bInterfaceClass (Audio) 0x02, // bInterfaceSubClass (Audio Streaming) 0x00, // bInterfaceProtocol 0x00, // iInterface (String Index) 0x09, // bLength 0x04, // bDescriptorType (Interface) 0x01, // bInterfaceNumber 1 0x01, // bAlternateSetting 0x01, // bNumEndpoints 1 0x01, // bInterfaceClass (Audio) 0x02, // bInterfaceSubClass (Audio Streaming) 0x00, // bInterfaceProtocol 0x00, // iInterface (String Index) 0x07, // bLength 0x24, // bDescriptorType (See Next Line) 0x01, // bDescriptorSubtype (CS_INTERFACE -> AS_GENERAL) 0x01, // bTerminalLink 0x01, // bDelay 1 0x01, 0x00, // wFormatTag (PCM) 0x0B, // bLength 0x24, // bDescriptorType (See Next Line) 0x02, // bDescriptorSubtype (CS_INTERFACE -> FORMAT_TYPE) 0x01, // bFormatType 1 0x02, // bNrChannels (Stereo) 0x02, // bSubFrameSize 2 0x10, // bBitResolution 16 0x01, // bSamFreqType 1 0x00, 0x7D, 0x00, // tSamFreq[1] 32000 Hz 0x09, // bLength 0x05, // bDescriptorType (See Next Line) 0x01, // bEndpointAddress (OUT/H2D) 0x09, // bmAttributes (Isochronous, Adaptive, Data EP) 0x84, 0x00, // wMaxPacketSize 132 0x01, // bInterval 1 (unit depends on device speed) 0x00, // bRefresh 0x00, // bSyncAddress 0x07, // bLength 0x25, // bDescriptorType (See Next Line) 0x01, // bDescriptorSubtype (CS_ENDPOINT -> EP_GENERAL) 0x00, // bmAttributes (None) 0x00, // bLockDelayUnits 0x00, 0x00, // wLockDelay 0 0x09, // bLength 0x04, // bDescriptorType (Interface) 0x02, // bInterfaceNumber 2 0x00, // bAlternateSetting 0x00, // bNumEndpoints 0 0x01, // bInterfaceClass (Audio) 0x02, // bInterfaceSubClass (Audio Streaming) 0x00, // bInterfaceProtocol 0x00, // iInterface (String Index) 0x09, // bLength 0x04, // bDescriptorType (Interface) 0x02, // bInterfaceNumber 2 0x01, // bAlternateSetting 0x01, // bNumEndpoints 1 0x01, // bInterfaceClass (Audio) 0x02, // bInterfaceSubClass (Audio Streaming) 0x00, // bInterfaceProtocol 0x00, // iInterface (String Index) 0x07, // bLength 0x24, // bDescriptorType (See Next Line) 0x01, // bDescriptorSubtype (CS_INTERFACE -> AS_GENERAL) 0x06, // bTerminalLink 0x01, // bDelay 1 0x01, 0x00, // wFormatTag (PCM) 0x0B, // bLength 0x24, // bDescriptorType (See Next Line) 0x02, // bDescriptorSubtype (CS_INTERFACE -> FORMAT_TYPE) 0x01, // bFormatType 1 0x01, // bNrChannels (Mono) 0x02, // bSubFrameSize 2 0x10, // bBitResolution 16 0x01, // bSamFreqType 1 0x80, 0x3E, 0x00, // tSamFreq[1] 16000 Hz 0x09, // bLength 0x05, // bDescriptorType (See Next Line) 0x82, // bEndpointAddress (IN/D2H) 0x05, // bmAttributes (Isochronous, Async, Data EP) 0x22, 0x00, // wMaxPacketSize 34 0x01, // bInterval 1 (unit depends on device speed) 0x00, // bRefresh 0x00, // bSyncAddress 0x07, // bLength 0x25, // bDescriptorType (See Next Line) 0x01, // bDescriptorSubtype (CS_ENDPOINT -> EP_GENERAL) 0x00, // bmAttributes (None) 0x00, // bLockDelayUnits 0x00, 0x00, // wLockDelay 0 0x09, // bLength 0x04, // bDescriptorType (Interface) 0x03, // bInterfaceNumber 3 0x00, // bAlternateSetting 0x02, // bNumEndpoints 2 0x03, // bInterfaceClass 0x00, // bInterfaceSubClass 0x00, // bInterfaceProtocol 0x00, // iInterface (String Index) 0x09, // bLength 0x21, // bDescriptorType (HID) 0x11, 0x01, // bcdHID 1.11 0x00, // bCountryCode 0x01, // bNumDescriptors 0x22, // bDescriptorType[0] (HID) 0xFB, 0x01, // wDescriptorLength[0] 507 0x07, // bLength 0x05, // bDescriptorType (Endpoint) 0x84, // bEndpointAddress (IN/D2H) 0x03, // bmAttributes (Interrupt) 0x40, 0x00, // wMaxPacketSize 64 0x05, // bInterval 5 (unit depends on device speed) 0x07, // bLength 0x05, // bDescriptorType (Endpoint) 0x03, // bEndpointAddress (OUT/H2D) 0x03, // bmAttributes (Interrupt) 0x40, 0x00, // wMaxPacketSize 64 0x05, // bInterval 5 (unit depends on device speed) // 225 bytes
Nothing is using them anyway
Examples for stm32g0 not build.
lynxD
commented
Jun 24, 2025
There was a problem hiding this comment.
ControlPipe trait assumes endpoint to be 0, however the spec allows for multiple control endpoints.
https://stackoverflow.com/questions/22417493/what-is-the-use-of-multiple-control-endpoints-non-ep0
This seems to be of limited use but at least the API should allow for it.
Anybody has idea how to handle this best? Add endpoint number parameter to setup method?
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
I'm opening new pr since author of previous one has become unresponsive.
Previous PR: #4032
I've rebased code form the previous pr.
This code is WIP.
Currently there are a lot of warnings due to missing doc-strings and the like.