USB protocol >= 2.1 on ESP32 fails to bring up USB stack on Windows (WebUSB example)

[i-am-shodan]

Operating System

Windows 11

Arduino IDE version

2.3.6

Board

LilyGo T Dongle S3

ArduinoCore version

3.3.0

TinyUSB Library version

3.7.1

Sketch as ATTACHED TXT

https://github.com/adafruit/Adafruit_TinyUSB_Arduino/blob/master/examples/WebUSB/webusb_serial/webusb_serial.ino

Compiled Log as ATTACHED TXT

logs.txt

What happened ?

I'm attempting to test the WinUSB example from the examples directory on an ESP32S3 device (T Dongle S3 from LilyGo). After compiling, flashing and re-plugging, the device does not enumerate correctly in Windows 11 23H2.

I've tried to do some debugging on this, here are some rambling comments:

• It seems related to USB 2.1 support, under 2.0 the device starts but there is no request to tud_descriptor_bos_cb
• I can only get tud_descriptor_bos_cb to be called if https://github.com/espressif/arduino-esp32/blob/7bfd45189d001d0d6fcca1922eda3648f41d386d/cores/esp32/esp32-hal-tinyusb.c#L401 is commented out which doesn't seem right
• I've tried older versions of the code and still get the same issue

How to reproduce ?

1. Install latest Arduino IDE, latest ESP32 board and latest Arduino TinyUSB library
2. Take the example sketch and paste into new IDE window
3. Set USB CDC on boot to Enabled
4. Set USB DFU on boot to Disabled
5. Set USB Firmware MSC on boot to Disabled
6. Set USB mode to OTG (TinyUSB)
7. Flash firmware
8. Plug in
9. Device will fail to enumerate

Debug Log

No response

Screenshots

I have checked existing issues, pr, discussion and documentation

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

[i-am-shodan]

Can confirm when rolling back to release 2.4.1 and arduino core 2.0.17 the example works.

[i-am-shodan]

Can confirm the issue appears in release 3.0.0 on arduino core 3.0.0

[i-am-shodan]

I have a RP2040, will test that with the latest code.

Also worth saying the device itself doesn’t reset, so this is almost certainly a USB protocol error.

[i-am-shodan]

Latest release works fine on a RP2040 so this looks like an ESP32 problem

[i-am-shodan]

I've got some USB pcaps from both a working version and the most recent broken version usb_pcap.zip. Looks like in the broken version an empty descriptor is returned.

[i-am-shodan]

TinyUSB debug logs, the only thing that is different between the two traces is the USB version

notWorking.txt
working.txt

[i-am-shodan]

Looks like this is triggered by USB protocol >= 2.1. Anything even a basic serial example fails when this is set

[hathach]

it is due to arduino-esp32 tinyusb hal declare the bos descriptor callback as strong implementation. This can be fixed be making an PR to add weak to that and the vendor control xfer callback. I will make an PR to arduino-esp32 later when having time.

[ahmadfarisfs]

I also had the same issue, and downgrade to 2.4.1 solved the problem. Here's my working platformio.ini files

[env:esp32-s3-devkitc-1]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
monitor_speed = 115200
monitor_port = COM6
upload_port = COM6
lib_deps = 
    adafruit/Adafruit TinyUSB Library@2.4.1
    adafruit/Adafruit NeoPixel
board_build.arduino.memory_type = qio_opi
board_build.flash_mode = qio
board_build.psram_type = opi
board_upload.flash_size = 16MB
board_upload.maximum_size = 16777216
board_build.partitions = default_16MB.csv
board_build.extra_flags = 
  -DBOARD_HAS_PSRAM
  -DBOARD_HAS_TINYUSB
  -DARDUINO_USB_MODE=0
  -DARDUINO_USB_CDC_ON_BOOT=1
  -DARDUINO_USB_MSC_ON_BOOT=0
  -DARDUINO_USB_DFU_ON_BOOT=0

[ahmadfarisfs]

it is due to arduino-esp32 tinyusb hal declare the bos descriptor callback as strong implementation. This can be fixed be making an PR to add weak to that and the vendor control xfer callback. I will make an PR to arduino-esp32 later when having time.

Hi @hathach , thank you for pointing out, did you happen to crate the PR yet ? If not maybe I can help, can you point me out other things that needs to be PR'ed ?