tinyUSBv18 RP2040 on Windows 11 using UAC2 and CDC

[mdhosale]

Operating System

Windows 11

Commit SHA

version 0.18.0 bundled by pico

Board

RP2040 custom board

Firmware

full code example is available here: https://github.com/mdhosale/tinyUSBv18bugRP2040
this code is from a larger project but was tested and verified before uploading.

I am using a custom descriptor to get 2-channel out from USB - but from what I can tell it aligns with the format of the 1 and 4 channel descriptor embedded in the API

What happened ?

UAC2 and CDC composite work with TinyUSB v0.17.0 on windows 11 but not on TinyUSB v0.18.0
It does work on MacOS - not tested on Linux

• I have tried updating:

tusb_init();

to

    tusb_rhport_init_t dev_init = {
        .role = TUSB_ROLE_DEVICE,
        .speed = TUSB_SPEED_AUTO
     };
     tusb_init(0, &dev_init); 

with no luck - tusb_init(); should be backwards compatible with v0.018

How to reproduce ?

In the latest SDK the code does not work on Wondows 11.

to fix - I rolled back the TinyUSB Library without rolling back the pico SDK by navigating to:

../pico-sdk/lib/tinyusb

and doing the following:

git fetch --tags
git checkout 0.17.0

make clean and compile and the USB enumerates and runs on Windows 11 (and Mac)

If I roll back to USB v0.18 by navigating to:

../pico-sdk/lib/tinyusb

and doing the following:

git fetch --tags
git checkout 0.18.0

make clean and compile and the USB enumerates but the audio freezes on Windows 11; while the USB still enumerates and runs on Mac

Debug Log as txt file (LOG/CFG_TUSB_DEBUG=2)

I am receiveing this error on WIndows 11 and v0.18.0:

adportaudio_start: error Invalid device from portaudio opening stream

here's the dump from USB Device Viewer on Windows 11:

[Port2] : USB Composite Device

Is Port User Connectable: yes
Is Port Debug Capable: no
Companion Port Number: 4
Companion Hub Symbolic Link Name: USB#ROOT_HUB30#5&16684953&0&0#{f18a0e88-c30c-11d0-8815-00a0c906bed8}
Protocols Supported:
USB 1.1: yes
USB 2.0: yes
USB 3.0: no

Device Power State: PowerDeviceD0

   ---===>USB4 Information<===---

Port is USB4 Capable: No
Device is tunneled through USB4: No

   ---===>Device Information<===---

English product name: "testing"

ConnectionStatus:
Current Config Value: 0x01 -> Device Bus Speed: Full (is not SuperSpeed or higher capable)
Device Address: 0x01
Open Pipes: 3

      ===>Device Descriptor<===

bLength: 0x12
bDescriptorType: 0x01
bcdUSB: 0x0200
bDeviceClass: 0xEF -> This is a Multi-interface Function Code Device
bDeviceSubClass: 0x02 -> This is the Common Class Sub Class
bDeviceProtocol: 0x01 -> This is the Interface Association Descriptor protocol
bMaxPacketSize0: 0x40 = (64) Bytes
idVendor: 0xCAFE = Vendor ID not listed with USB.org
idProduct: 0x4011
bcdDevice: 0x0100
iManufacturer: 0x01
English (United States) "Test"
iProduct: 0x02
English (United States) "testing"
iSerialNumber: 0x03
*!*ERROR: No String Descriptor for index 3!
bNumConfigurations: 0x01

      ---===>Open Pipes<===---

      ===>Endpoint Descriptor<===

bLength: 0x07
bDescriptorType: 0x05
bEndpointAddress: 0x83 -> Direction: IN - EndpointID: 3
bmAttributes: 0x03 -> Interrupt Transfer Type
wMaxPacketSize: 0x0008 = 0x08 bytes
bInterval: 0x10

      ===>Endpoint Descriptor<===

bLength: 0x07
bDescriptorType: 0x05
bEndpointAddress: 0x04 -> Direction: OUT - EndpointID: 4
bmAttributes: 0x02 -> Bulk Transfer Type
wMaxPacketSize: 0x0040 = 0x40 bytes
bInterval: 0x00

      ===>Endpoint Descriptor<===

bLength: 0x07
bDescriptorType: 0x05
bEndpointAddress: 0x84 -> Direction: IN - EndpointID: 4
bmAttributes: 0x02 -> Bulk Transfer Type
wMaxPacketSize: 0x0040 = 0x40 bytes
bInterval: 0x00

   ---===>Full Configuration Descriptor<===---

      ===>Configuration Descriptor<===

bLength: 0x09
bDescriptorType: 0x02
wTotalLength: 0x00D3 -> Validated
bNumInterfaces: 0x04
bConfigurationValue: 0x01
iConfiguration: 0x00
bmAttributes: 0x80 -> Bus Powered
MaxPower: 0x32 = 100 mA

      ===>IAD Descriptor<===

bLength: 0x08
bDescriptorType: 0x0B
bFirstInterface: 0x00
bInterfaceCount: 0x02
bFunctionClass: 0x01 -> Audio Interface Class
bFunctionSubClass: 0x00
*!*CAUTION: This appears to be an invalid bFunctionSubClass
bFunctionProtocol: 0x20
iFunction: 0x00

      ===>Interface Descriptor<===

bLength: 0x09
bDescriptorType: 0x04
bInterfaceNumber: 0x00
bAlternateSetting: 0x00
bNumEndpoints: 0x00
bInterfaceClass: 0x01 -> Audio Interface Class
bInterfaceSubClass: 0x01 -> Audio Control Interface SubClass
bInterfaceProtocol: 0x20
*!*WARNING: must be set to PC_PROTOCOL_UNDEFINED 0 for this class
iInterface: 0x04
English (United States) "UAC2"

      ===>Audio Control Interface Header Descriptor<===

bLength: 0x09
bDescriptorType: 0x24 (CS_INTERFACE)
bDescriptorSubtype: 0x01 (HEADER)
bcdADC: 0x0200
wTotalLength: 0x4003
bInCollection: 0x00

      ===>Descriptor Hex Dump<===

bLength: 0x08
bDescriptorType: 0x24
08 24 0A 04 01 01 01 00

      ===>Descriptor Hex Dump<===

bLength: 0x11
bDescriptorType: 0x24
11 24 02 01 01 02 03 04 02 00 00 00 00 00 04 00
00

      ===>Descriptor Hex Dump<===

bLength: 0x0C
bDescriptorType: 0x24
0C 24 03 03 01 01 01 02 04 00 00 00

      ===>Audio Control Feature Unit Descriptor<===

bLength: 0x12
bDescriptorType: 0x24 (CS_INTERFACE)
bDescriptorSubtype: 0x06 (FEATURE_UNIT)
bUnitID: 0x02
bSourceID: 0x01
bControlSize: 0x0F
*!*WARNING: bLength is greater than number of bmaControls (bLength > ( 7 + (ch + 1) * n)
*!*WARNING: Either bLength or bControlSize are invalid. The calculated logical channel count is -1. ((bLength - 7)/ n) - 1

      ===>Descriptor Hex Dump<===

bLength: 0x12
bDescriptorType: 0x24
12 24 06 02 01 0F 00 00 00 0F 00 00 00 0F 00 00
00 00

      ===>Interface Descriptor<===

bLength: 0x09
bDescriptorType: 0x04
bInterfaceNumber: 0x01
bAlternateSetting: 0x00
bNumEndpoints: 0x00
bInterfaceClass: 0x01 -> Audio Interface Class
bInterfaceSubClass: 0x02 -> Audio Streaming Interface SubClass
bInterfaceProtocol: 0x20
*!*WARNING: must be set to PC_PROTOCOL_UNDEFINED 0 for this class
iInterface: 0x00

      ===>Interface Descriptor<===

bLength: 0x09
bDescriptorType: 0x04
bInterfaceNumber: 0x01
bAlternateSetting: 0x01
bNumEndpoints: 0x01
bInterfaceClass: 0x01 -> Audio Interface Class
bInterfaceSubClass: 0x02 -> Audio Streaming Interface SubClass
bInterfaceProtocol: 0x20
*!*WARNING: must be set to PC_PROTOCOL_UNDEFINED 0 for this class
iInterface: 0x00

      ===>Descriptor Hex Dump<===

bLength: 0x10
bDescriptorType: 0x24
10 24 01 03 00 01 01 00 00 00 02 00 00 00 00 00

      ===>Audio Streaming Format Type Descriptor<===

bLength: 0x06
bDescriptorType: 0x24 (CS_INTERFACE)
bDescriptorSubtype: 0x02 (FORMAT_TYPE)
bFormatType: 0x01 (FORMAT_TYPE_I)
bNrChannels: 0x02
bSubframeSize: 0x10
bBitResolution: 0x07 (7)
bSamFreqType: 0x05 (Discrete)
tSamFreq[1]: 0xC40581 (12846465 Hz)
tSamFreq[2]: 0x080100 (524544 Hz)
tSamFreq[3]: 0x000125 (293 Hz)
tSamFreq[4]: 0x000000 (0 Hz)
tSamFreq[5]: 0x0B0800 (722944 Hz)

      ===>Endpoint Descriptor<===

bLength: 0x07
bDescriptorType: 0x05
bEndpointAddress: 0x81 -> Direction: IN - EndpointID: 1
bmAttributes: 0x05 -> Isochronous Transfer Type, Synchronization Type = Asynchronous, Usage Type = Data Endpoint
wMaxPacketSize: 0x00C4 = 0xC4 bytes
bInterval: 0x01

      ===>Descriptor Hex Dump<===

bLength: 0x08
bDescriptorType: 0x25
08 25 01 00 00 00 00 00

      ===>IAD Descriptor<===

bLength: 0x08
bDescriptorType: 0x0B
bFirstInterface: 0x02
bInterfaceCount: 0x02
bFunctionClass: 0x02 -> This is Communications (CDC Control) USB Device Interface Class
bFunctionSubClass: 0x02
bFunctionProtocol: 0x00
iFunction: 0x00

      ===>Interface Descriptor<===

bLength: 0x09
bDescriptorType: 0x04
bInterfaceNumber: 0x02
bAlternateSetting: 0x00
bNumEndpoints: 0x01
bInterfaceClass: 0x02 -> This is Communications (CDC Control) USB Device Interface Class
bInterfaceSubClass: 0x02
bInterfaceProtocol: 0x00
iInterface: 0x05
English (United States) "CDC"
-> This is a Communications (CDC Control) USB Device Interface Class

      ===>Descriptor Hex Dump<===

bLength: 0x05
bDescriptorType: 0x24
05 24 00 20 01
-> This is a Communications (CDC Control) USB Device Interface Class

      ===>Descriptor Hex Dump<===

bLength: 0x05
bDescriptorType: 0x24
05 24 01 00 03
-> This is a Communications (CDC Control) USB Device Interface Class

      ===>Descriptor Hex Dump<===

bLength: 0x04
bDescriptorType: 0x24
04 24 02 06
-> This is a Communications (CDC Control) USB Device Interface Class

      ===>Descriptor Hex Dump<===

bLength: 0x05
bDescriptorType: 0x24
05 24 06 02 03

      ===>Endpoint Descriptor<===

bLength: 0x07
bDescriptorType: 0x05
bEndpointAddress: 0x83 -> Direction: IN - EndpointID: 3
bmAttributes: 0x03 -> Interrupt Transfer Type
wMaxPacketSize: 0x0008 = 0x08 bytes
bInterval: 0x10

      ===>Interface Descriptor<===

bLength: 0x09
bDescriptorType: 0x04
bInterfaceNumber: 0x03
bAlternateSetting: 0x00
bNumEndpoints: 0x02
bInterfaceClass: 0x0A -> This is a CDC Data USB Device Interface Class
bInterfaceSubClass: 0x00
bInterfaceProtocol: 0x00
iInterface: 0x00

      ===>Endpoint Descriptor<===

bLength: 0x07
bDescriptorType: 0x05
bEndpointAddress: 0x04 -> Direction: OUT - EndpointID: 4
bmAttributes: 0x02 -> Bulk Transfer Type
wMaxPacketSize: 0x0040 = 0x40 bytes
bInterval: 0x00

      ===>Endpoint Descriptor<===

bLength: 0x07
bDescriptorType: 0x05
bEndpointAddress: 0x84 -> Direction: IN - EndpointID: 4
bmAttributes: 0x02 -> Bulk Transfer Type
wMaxPacketSize: 0x0040 = 0x40 bytes
bInterval: 0x00

Screenshots

No response

I have checked existing issues, discussion and documentation

• I confirm I have checked existing issues, discussion and documentation.

[HiFiPhile]

What is adportaudio_start ? It doesn't like an error emit by Windows.

Your log is hard to read, please use usbtreeview and look error from device manager.

The latest master have some RP2040 audio fixes.

[mdhosale]

Thank you for your reply...

What is adportaudio_start ? It doesn't like an error emit by Windows.

apologes - I am testing the audio in Max by Cyling74 - this is the error it provided when thw audio froze.

Your log is hard to read, please use usbtreeview and look error from device manager.
device manager reports the device is working properly

Device USB\VID_CAFE&PID_4011&MI_00\7&332144be&1&0000 was configured.

Driver Name: usbaudio2.inf
Driver Package ID: usbaudio2.inf_amd64_2390f0bffa9b0cab
Class GUID: {4d36e96c-e325-11ce-bfc1-08002be10318}
Driver Date: 07/03/2024
Driver Version: 10.0.26100.1150
Driver Provider: Microsoft
Driver Section: usbaudio2_Device.NT
Driver Rank: 0xFF2003
Matching Device ID: USB\Class_01&SubClass_00&Prot_20
Outranked Drivers: wdma_usb.inf:USB\Class_01:00FFFFFF:USB\Class_01&SubClass_00&Prot_20
Device Updated: false
Parent Device: USB\VID_CAFE&PID_4011\6&c179f6d&0&2

here is the dump from usbtreeview:

=========================== USB Port2 ===========================

Connection Status : 0x01 (Device is connected)
Port Chain : 4-2
Properties : 0x01
IsUserConnectable : yes
PortIsDebugCapable : no
PortHasMultiCompanions : no
PortConnectorIsTypeC : no
ConnectionIndex : 0x02 (Port 2)
CompanionIndex : 0
CompanionHubSymLnk : USB#ROOT_HUB30#5&16684953&0&0#{f18a0e88-c30c-11d0-8815-00a0c906bed8}
CompanionPortNumber : 0x04 (Port 4)
-> CompanionPortChain : 4-4

  ========================== Summary =========================

Vendor ID : 0xCAFE (Unknown Vendor)
Product ID : 0x4011
Manufacturer String : ERROR iManufacturer=1 but String Descriptor not found
Product String : ERROR iProduct=2 but String Descriptor not found
Serial : ERROR iSerial=3 but String Descriptor not found
USB Version : 2.0 (but 12 Mbit/s FullSpeed only)
Port maximum Speed : High-Speed (Companion Port 4-4 is doing the SuperSpeed)
Device maximum Speed : Full-Speed
Device Connection Speed : Full-Speed
Used Endpoints : 4
Hint : Requesting String Descriptors took 7015 ms

  ======================== USB Device ========================

    +++++++++++++++++ Device Information ++++++++++++++++++

Device Description : USB Composite Device
Device Path : \?\USB#VID_CAFE&PID_4011#6&c179f6d&0&2#{a5dcbf10-6530-11d2-901f-00c04fb951ed} (GUID_DEVINTERFACE_USB_DEVICE)
Kernel Name : \Device\USBPDO-10
Device ID : USB\VID_CAFE&PID_4011\6&C179F6D&0&2
Hardware IDs : USB\VID_CAFE&PID_4011&REV_0100 USB\VID_CAFE&PID_4011
Driver KeyName : {36fc9e60-c465-11cf-8056-444553540000}\0024 (GUID_DEVCLASS_USB)
Driver : \SystemRoot\System32\drivers\usbccgp.sys (Version: 10.0.26100.3912 Date: 2025-06-13 Company: Microsoft Corporation)
Driver Inf : C:\WINDOWS\inf\usb.inf
Legacy BusType : PNPBus
Class : USB
Class GUID : {36fc9e60-c465-11cf-8056-444553540000} (GUID_DEVCLASS_USB)
Service : usbccgp
Enumerator : USB
Location Info : Port_#0002.Hub_#0002
Address : 2
Manufacturer Info : (Standard USB Host Controller)
Capabilities : 0x84 (Removable, SurpriseRemovalOK)
Status : 0x0180600A (DN_DRIVER_LOADED, DN_STARTED, DN_DISABLEABLE, DN_REMOVABLE, DN_NT_ENUMERATOR, DN_NT_DRIVER)
Problem Code : 0
Address : 2
First Install Date : 2025-07-29 18:27:29
Last Arrival Date : 2025-08-13 11:20:55
Bus Relations : USB\VID_CAFE&PID_4011&MI_00\7&332144be&1&0000, USB\VID_CAFE&PID_4011&MI_02\7&332144be&1&0002
EnhancedPowerMgmtEnabled : 0
Power State : D0 (supported: D0, D3, wake from D0)

    +++++++++++++++++ Registry USB Flags +++++++++++++++++

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\usbflags\CAFE40110100
osvc : REG_BINARY 00 00
NewInterfaceUsage : REG_DWORD 00000000 (0)

    ---------------- Connection Information ---------------

Connection Index : 0x02 (Port 2)
Connection Status : 0x01 (DeviceConnected)
Current Config Value : 0x01 (Configuration 1)
Device Address : 0x01 (1)
Is Hub : 0x00 (no)
Device Bus Speed : 0x01 (Full-Speed)
Number of open Pipes : 0x03 (3 pipes to data endpoints)
Pipe[0] : EndpointID=3 Direction=IN ScheduleOffset=0 Type=Interrupt wMaxPacketSize=0x8 bInterval=16 -> 196 Bits/ms = 24500 Bytes/s
Pipe[1] : EndpointID=4 Direction=OUT ScheduleOffset=0 Type=Bulk wMaxPacketSize=0x40 bInterval=0
Pipe[2] : EndpointID=4 Direction=IN ScheduleOffset=0 Type=Bulk wMaxPacketSize=0x40 bInterval=0
Data (HexDump) : 02 00 00 00 12 01 00 02 EF 02 01 40 FE CA 11 40 ...........@...@
00 01 01 02 03 01 01 01 00 01 00 03 00 00 00 01 ................
00 00 00 07 05 83 03 08 00 10 00 00 00 00 07 05 ................
04 02 40 00 00 00 00 00 00 07 05 84 02 40 00 00 ..@..........@..
00 00 00 00 ....

    --------------- Connection Information V2 -------------

Connection Index : 0x02 (2)
Length : 0x10 (16 bytes)
SupportedUsbProtocols : 0x03
Usb110 : 1 (yes, port supports USB 1.1)
Usb200 : 1 (yes, port supports USB 2.0)
Usb300 : 0 (no, port not supports USB 3.0) -> but Companion Port 4-4 does
ReservedMBZ : 0x00
Flags : 0x00
DevIsOpAtSsOrHigher : 0 (Device is not operating at SuperSpeed or higher)
DevIsSsCapOrHigher : 0 (Device is not SuperSpeed capable or higher)
DevIsOpAtSsPlusOrHigher : 0 (Device is not operating at SuperSpeedPlus or higher)
DevIsSsPlusCapOrHigher : 0 (Device is not SuperSpeedPlus capable or higher)
ReservedMBZ : 0x00
Data (HexDump) : 02 00 00 00 10 00 00 00 03 00 00 00 00 00 00 00 ................

---------------------- Device Descriptor ----------------------

bLength : 0x12 (18 bytes)
bDescriptorType : 0x01 (Device Descriptor)
bcdUSB : 0x200 (USB Version 2.0)
bDeviceClass : 0xEF (Miscellaneous)
bDeviceSubClass : 0x02
bDeviceProtocol : 0x01 (IAD - Interface Association Descriptor)
bMaxPacketSize0 : 0x40 (64 bytes)
idVendor : 0xCAFE (Unknown Vendor)
idProduct : 0x4011
bcdDevice : 0x0100
iManufacturer : 0x01 (String Descriptor 1)
*!*ERROR String descriptor not found
iProduct : 0x02 (String Descriptor 2)
*!*ERROR String descriptor not found
iSerialNumber : 0x03 (String Descriptor 3)
*!*ERROR String descriptor not found
bNumConfigurations : 0x01 (1 Configuration)
Data (HexDump) : 12 01 00 02 EF 02 01 40 FE CA 11 40 00 01 01 02 .......@...@....
03 01 ..

ConfigDescriptor 1 Error : WAIT_TIMEOUT

  -------------------- String Descriptors -------------------

none

The latest master have some RP2040 audio fixes.

I thought I was on the latest master, but I will check

[mdhosale]

verfied that I am on the latest master, but no luck

[HiFiPhile]

Lastest master have some fundamental changes to audio class, especially transfers occurs in ISR now.

Please start with one of the example and adapt to your needs, your code is a little too old.

If device manager shows Ok then it looks like some audio specific control request didn't goes well, you can use Wireshark or other capture tools to check the bad request.

[mdhosale]

Thank you for you quick responses. - I think that's where I am struggling - I noticed the updated doc that added the

void USB0_IRQHandler(void) {
  tusb_int_handler(0, true);
}

but I haven't found an example that describes how to implement this on a rp2040. In the example files, as far as I can tell, there isn't any indication of that being implemented. Sorry if I am missing something and thank you again for your help...

[HiFiPhile]

Thank you for you quick responses. - I think that's where I am struggling - I noticed the updated doc that added the

void USB0_IRQHandler(void) {
  tusb_int_handler(0, true);
}

but I haven't found an example that describes how to implement this on a rp2040. In the example files, as far as I can tell, there isn't any indication of that being implemented. Sorry if I am missing something and thank you again for your help...

Personally I only use industrially proven MCUs instead of RP2xxx so I can't give you more details. But as far as I can tell pico-sdk handle interrupts differently, you can ignore this part written for general purpose MCU.

[mdhosale]

OKay thanks- then it sounds like I am using the API correctly? If it was an issue of depcrecated code then why would it work on Mac and not Windows?

[HiFiPhile]

I've no idea how Max by Cyling74 works and the meaning of its error message.

I think the easiest way is build and test 4ch_mic example. Your code has some issues such as set a buffer size of only 1x endpoint size and queue 2 silent frames on streaming start.