samples:subsys:usb:webusb: esp32s3 after enabling spi ram, device configuration is not supported

[zhang-wenchao]

Describe the bug

Use esp32s3 chip.

#85600

Regression

• This is a regression.

Steps to reproduce

Edit prj.conf add CONFIG_ESP_SPIRAM=y and CONFIG_SPIRAM_MODE_OCT=y

west build -b esp32s3_devkitm/esp32s3/procpu samples/subsys/usb/webusb

Flash:

west flash

Relevant log output

Before successful:

ESP-ROM:esp32s3-20210327
Build:Mar 27 2021
rst:0x1 (POWERON),boot:0x2b (SPI_FAST_FLASH_BOOT)
SPIWP:0xee
mode:DIO, clock div:1
load:0x3fc8f5d0,len:0x22b8
load:0x40374000,len:0xb5c0
SHA-256 comparison failed:
Calculated: 28564cddd6ee50ea1e047a9cab985194199fa26f82a67a1435e35748202e229b
Expected: 0000000040270000000000000000000000000000000000000000000000000000
Attempting to boot anyway...
entry 0x4037a3d8
I (61) soc_init: ESP Simple boot
I (61) soc_init: compile time Sep 28 2025 23:18:02
W (62) soc_init: Unicore bootloader
I (62) soc_init: chip revision: v0.2
I (64) flash_init: Boot SPI Speed : 80MHz
I (68) flash_init: SPI Mode       : DIO
I (71) flash_init: SPI Flash Size : 8MB
I (75) boot: DRAM       : lma=00000020h vma=3fc8f5d0h size=022b8h (  8888)
I (81) boot: IRAM       : lma=000022e0h vma=40374000h size=0b5c0h ( 46528)
I (87) boot: IRAM       : lma=0000d8b8h vma=00000000h size=02740h ( 10048)
I (93) boot: IRAM       : lma=00010000h vma=42000000h size=0a848h ( 43080)
I (99) boot: IRAM       : lma=0001a850h vma=00000000h size=057a8h ( 22440)
I (105) boot: IRAM      : lma=00020000h vma=3c010000h size=02778h ( 10104)
I (112) boot: IROM      : lma=00010000h vma=42000000h size=0A846h ( 43078) map
I (118) boot: DROM      : lma=00020000h vma=3c010000h size=02780h ( 10112) map
I (136) boot: libc heap size 331 kB.
I (136) spi_flash: detected chip: gd
I (136) spi_flash: flash io: dio
W (136) spi_flash: Detected size(16384k) larger than the size in the binary image header(8192k). Using the size in the binary image header.
*** Booting Zephyr OS build v4.2.0-4553-g7fc8051b0f4b ***
[00:00:00.206,000] <wrn> udc_dwc2: Experimental DMA enabled
[00:00:00.248,000] <inf> main: USBD message: Bus reset
[00:00:00.426,000] <inf> main: USBD message: Bus reset
[00:00:00.502,000] <inf> sfunc: Configuration enabled
[00:00:00.502,000] <inf> main: USBD message: New device configuration

After adding CONFIG_ESP_SPIRAM=y and CONFIG_SPIRAM_MODE_OCT=y :

ESP-ROM:esp32s3-20210327
Build:Mar 27 2021
rst:0x1 (POWERON),boot:0x2b (SPI_FAST_FLASH_BOOT)
SPIWP:0xee
mode:DIO, clock div:1
load:0x3fc8ff20,len:0x28ec
load:0x40374000,len:0xbf10
SHA-256 comparison failed:
Calculated: fe65b42fd69e11643ba8811c334d17024cac06bce22163e25881dfd065e0cce1
Expected: 00000000c0170000000000000000000000000000000000000000000000000000
Attempting to boot anyway...
entry 0x4037a528
I (64) soc_init: ESP Simple boot
I (64) soc_init: compile time Sep 28 2025 22:51:39
W (64) soc_init: Unicore bootloader
I (64) soc_init: chip revision: v0.2
I (66) flash_init: Boot SPI Speed : 80MHz
I (70) flash_init: SPI Mode       : DIO
I (74) flash_init: SPI Flash Size : 8MB
I (77) boot: DRAM       : lma=00000020h vma=3fc8ff20h size=028ech ( 10476)
I (83) boot: IRAM       : lma=00002914h vma=40374000h size=0bf10h ( 48912)
I (89) boot: IRAM       : lma=0000e838h vma=00000000h size=017c0h (  6080)
I (95) boot: IRAM       : lma=00010000h vma=42000000h size=0c2c8h ( 49864)
I (101) boot: IRAM      : lma=0001c2d0h vma=00000000h size=03d28h ( 15656)
I (108) boot: IRAM      : lma=00020000h vma=3c010000h size=02c7ch ( 11388)
I (114) boot: IROM      : lma=00010000h vma=42000000h size=0C2C6h ( 49862) map
I (120) boot: DROM      : lma=00020000h vma=3c010000h size=02C80h ( 11392) map
I (138) boot: libc heap size 326 kB.
I (138) spi_flash: detected chip: gd
I (138) spi_flash: flash io: dio
W (139) spi_flash: Detected size(16384k) larger than the size in the binary image header(8192k). Using the size in the binary image header.
I (149) octal_psram: vendor id    : 0x0d (AP)
I (153) octal_psram: dev id       : 0x02 (generation 3)
I (158) octal_psram: density      : 0x03 (64 Mbit)
I (162) octal_psram: good-die     : 0x01 (Pass)
I (166) octal_psram: Latency      : 0x01 (Fixed)
I (171) octal_psram: VCC          : 0x01 (3V)
I (175) octal_psram: SRF          : 0x01 (Fast Refresh)
I (180) octal_psram: BurstType    : 0x01 (Hybrid Wrap)
I (185) octal_psram: BurstLen     : 0x01 (32 Byte)
I (190) octal_psram: Readlatency  : 0x02 (10 cycles@Fixed)
I (194) octal_psram: DriveStrength: 0x00 (1/1)
I (199) esp_psram: Found 8MB PSRAM device
I (202) esp_psram: Speed: 40MHz
I (936) esp_psram: SPI SRAM memory test OK
*** Booting Zephyr OS build v4.2.0-4553-g7fc8051b0f4b ***
[00:00:00.988,000] <wrn> udc_dwc2: Experimental DMA enabled

Impact

Functional Limitation – Some features not working as expected, but system usable.

Environment

OS: Debian
SHA: 7fc8051

Additional Context

No response

[zhang-wenchao]

I don't understand why the usb functionality would be related to the spi ram.

[zhang-wenchao]

Other usb examples also have problems, I don't repeat open issues, record them.

[sylvioalves]

@zhang-wenchao, I'll take a look to find the root cause. For now, please disable SPIRAM tests that are enabled by default: CONFIG_ESP_SPIRAM_MEMTEST=n

The issue is not related to SPIRAM itself but to timing. The interval taken by the SPIRAM test is causing the issue.

[zhang-wenchao]

In my use case, this still didn't work, even after I moved the initialization code to the main. disabling is a probability it worked, I'll temporarily disable spi ram and wait for a fix.

I have I2C and other SPI peripherals, which may have affected the USB initialization time.

ESP-ROM:esp32s3-20210327
Build:Mar 27 2021
rst:0x1 (POWERON),boot:0x2b (SPI_FAST_FLASH_BOOT)
SPIWP:0xee
mode:DIO, clock div:1
load:0x3fcb5400,len:0x1e80
load:0x403ba400,len:0x873c
load:0x403c6400,len:0x4cc
entry 0x403bdae0
I (38) soc_init: MCUboot 2nd stage bootloader
I (38) soc_init: compile time Sep 28 2025 21:44:52
W (38) soc_init: Unicore bootloader
I (39) soc_init: chip revision: v0.2
I (42) flash_init: Boot SPI Speed : 80MHz
I (45) flash_init: SPI Mode       : DIO
I (49) flash_init: SPI Flash Size : 8MB
I (87) boot: Image index: 0, Swap type: none
I (87) boot: Loading image 0 - slot 0 from flash, area id: 2
I (87) boot: Application start=4037b66ch
I (88) boot: DRAM       : lma=0002c41ch vma=3fc903b0h size=02f54h ( 12116) load
I (96) boot: IRAM       : lma=00020080h vma=40374000h size=0c39ch ( 50076) load
I (113) boot: IROM      : lma=00030000h vma=42000000h size=6910Eh (430350) map
I (113) boot: DROM      : lma=000a0000h vma=3c070000h size=2B6F0h (177904) map
I (126) boot: libc heap size 132 kB.
I (126) spi_flash: detected chip: gd
I (126) spi_flash: flash io: dio
W (126) spi_flash: Detected size(16384k) larger than the size in the binary image header(8192k). Using the size in the binary image header.
[00:00:00.173,000] <wrn> gpio_pca_series: pca interrupt enabled w/o int-gpios configured in dts
[00:00:00.173,000] <inf> gpio_pca_series: pca9557@19 init ok
[00:00:00.356,000] <wrn> udc_dwc2: Experimental DMA enabled
[00:00:00.368,000] <inf> fs_nvs: 48 Sectors of 4096 bytes
[00:00:00.368,000] <inf> fs_nvs: alloc wra: 0, fe0
[00:00:00.368,000] <inf> fs_nvs: data wra: 0, 5c

ESP-ROM:esp32s3-20210327
Build:Mar 27 2021
rst:0x1 (POWERON),boot:0x2b (SPI_FAST_FLASH_BOOT)
SPIWP:0xee
mode:DIO, clock div:1
load:0x3fcb5400,len:0x1e80
load:0x403ba400,len:0x873c
load:0x403c6400,len:0x4cc
entry 0x403bdae0
I (38) soc_init: MCUboot 2nd stage bootloader
I (38) soc_init: compile time Sep 28 2025 21:44:52
W (38) soc_init: Unicore bootloader
I (39) soc_init: chip revision: v0.2
I (42) flash_init: Boot SPI Speed : 80MHz
I (45) flash_init: SPI Mode       : DIO
I (49) flash_init: SPI Flash Size : 8MB
I (87) boot: Image index: 0, Swap type: none
I (87) boot: Loading image 0 - slot 0 from flash, area id: 2
I (87) boot: Application start=4037b66ch
I (88) boot: DRAM       : lma=0002c41ch vma=3fc903b0h size=02f54h ( 12116) load
I (96) boot: IRAM       : lma=00020080h vma=40374000h size=0c39ch ( 50076) load
I (113) boot: IROM      : lma=00030000h vma=42000000h size=6910Eh (430350) map
I (113) boot: DROM      : lma=000a0000h vma=3c070000h size=2B6F0h (177904) map
I (126) boot: libc heap size 132 kB.
I (126) spi_flash: detected chip: gd
I (126) spi_flash: flash io: dio
W (126) spi_flash: Detected size(16384k) larger than the size in the binary image header(8192k). Using the size in the binary image header.
[00:00:00.173,000] <wrn> gpio_pca_series: pca interrupt enabled w/o int-gpios configured in dts
[00:00:00.173,000] <inf> gpio_pca_series: pca9557@19 init ok
[00:00:00.356,000] <wrn> udc_dwc2: Experimental DMA enabled
[00:00:00.368,000] <inf> fs_nvs: 48 Sectors of 4096 bytes
[00:00:00.368,000] <inf> fs_nvs: alloc wra: 0, fe0
[00:00:00.368,000] <inf> fs_nvs: data wra: 0, 5c
[00:00:00.807,000] <inf> webusb: USBD message: Bus reset
[00:00:00.880,000] <inf> webusb: USBD message: Bus reset
[00:00:00.956,000] <inf> sfunc: Configuration enabled
[00:00:00.956,000] <inf> webusb: USBD message: New device configuration

[sylvioalves]

Once the application starts, what happens if you unplug then plug the USB cable? I guess it works, right?

[sylvioalves]

@zhang-wenchao, sounds the USB clock was late and any pre-delays would affect its initialization.
Find the possible fix: ##96694

[zhang-wenchao]

I'll test it later. thank you for your support.

[zhang-wenchao]

I've tested it, and the USB initialization is working correctly. However, I'm starting to experience other issues. I'm trying to confirm if it has something to do with the USB stack.

[00:00:00.495,000] <err> os:  ** FATAL EXCEPTION
[00:00:00.495,000] <err> os:  ** CPU 0 EXCCAUSE 63 (zephyr exception)
[00:00:00.495,000] <err> os:  **  PC 0x403779c3 VADDR 0
[00:00:00.495,000] <err> os:  **  PS 0x60220
[00:00:00.495,000] <err> os:  **    (INTLEVEL:0 EXCM: 0 UM:1 RING:0 WOE:1 OWB:2 CALLINC:2)
[00:00:00.495,000] <err> os:  **  A0 0x80378ebc  SP 0x3fc96790  A2 0x2  A3 0x60821
[00:00:00.495,000] <err> os:  **  A4 0x64  A5 0  A6 0  A7 0
[00:00:00.495,000] <err> os:  **  A8 0x3fcc8e6c  A9 0 A10 0x57619f1 A11 0x248950
[00:00:00.495,000] <err> os:  ** A12 0x60823 A13 0x244140 A14 0xffff8c90 A15 0
[00:00:00.495,000] <err> os:  ** LBEG 0 LEND 0 LCOUNT 0
[00:00:00.495,000] <err> os:  ** SAR 0x1a
[00:00:00.495,000] <err> os:  **  THREADPTR 0x3fc96770
[00:00:00.496,000] <err> os: >>> ZEPHYR FATAL ERROR 2: Stack overflow on CPU 0
[00:00:00.496,000] <err> os: Current thread: 0x3fcb60e8 (unknown)
[00:00:00.622,000] <err> os: Halting system

[zhang-wenchao]

The fix should be fine. My new issue is probably related to my own code. You can close this issue. Could you please tell me which memory limit might be related to the USB stack? I have searched several options but none of them worked.