uvc can't open the camera (IEC-506)

[KineticChen]

Answers checklist.

• I have read the component documentation ESP-IDF Components and the issue is not addressed there.
• I am using target and esp-idf version as defined in component's idf_component.yml
• I have searched the issue tracker for a similar issue and not found any related issue.

Which component are you using? If you choose Other, provide details in More Information.

host/uvc

ESP-IDF version.

ESP-IDF V5.3.3

Development Kit.

ESP32-S3-WROOM-1-N16R8

Used Component version.

usb_host_uvc v2.4.2

More Information.

I (27) boot: ESP-IDF v5.3.3-dirty 2nd stage bootloader
I (27) boot: compile time Mar 25 2026 16:47:03
I (27) boot: Multicore bootloader
I (30) boot: chip revision: v0.2
I (34) boot: efuse block revision: v1.3
I (39) boot.esp32s3: Boot SPI Speed : 80MHz
I (44) boot.esp32s3: SPI Mode : DIO
I (48) boot.esp32s3: SPI Flash Size : 16MB
I (53) boot: Enabling RNG early entropy source...
I (59) boot: Partition Table:
I (62) boot: ## Label Usage Type ST Offset Length
I (69) boot: 0 nvs WiFi data 01 02 00009000 00006000
I (77) boot: 1 phy_init RF data 01 01 0000f000 00001000
I (84) boot: 2 factory factory app 00 00 00010000 00100000
I (92) boot: End of partition table
I (96) esp_image: segment 0: paddr=00010020 vaddr=3c030020 size=0db4ch ( 56140) map
I (114) esp_image: segment 1: paddr=0001db74 vaddr=3fc93e00 size=024a4h ( 9380) load
I (117) esp_image: segment 2: paddr=00020020 vaddr=42000020 size=218d8h (137432) map
I (146) esp_image: segment 3: paddr=00041900 vaddr=3fc962a4 size=008bch ( 2236) load
I (146) esp_image: segment 4: paddr=000421c4 vaddr=40374000 size=0fd74h ( 64884) load
I (172) boot: Loaded app from partition at offset 0x10000
I (172) boot: Disabling RNG early entropy source...
I (184) octal_psram: vendor id : 0x0d (AP)
I (184) octal_psram: dev id : 0x02 (generation 3)
I (184) octal_psram: density : 0x03 (64 Mbit)
I (189) octal_psram: good-die : 0x01 (Pass)
I (194) octal_psram: Latency : 0x01 (Fixed)
I (200) octal_psram: VCC : 0x01 (3V)
I (205) octal_psram: SRF : 0x01 (Fast Refresh)
I (211) octal_psram: BurstType : 0x01 (Hybrid Wrap)
I (216) octal_psram: BurstLen : 0x01 (32 Byte)
I (222) octal_psram: Readlatency : 0x02 (10 cycles@Fixed)
I (228) octal_psram: DriveStrength: 0x00 (1/1)
I (234) MSPI Timing: PSRAM timing tuning index: 5
I (239) esp_psram: Found 8MB PSRAM device
I (243) esp_psram: Speed: 80MHz
I (247) cpu_start: Multicore app
I (703) esp_psram: SPI SRAM memory test OK
I (712) cpu_start: Pro cpu start user code
I (712) cpu_start: cpu freq: 240000000 Hz
I (712) app_init: Application information:
I (715) app_init: Project name: uvc
I (720) app_init: App version: 1
I (724) app_init: Compile time: Mar 25 2026 19:06:40
I (730) app_init: ELF file SHA256: 18bf33cbf...
I (735) app_init: ESP-IDF: v5.3.3-dirty
I (741) efuse_init: Min chip rev: v0.0
I (745) efuse_init: Max chip rev: v0.99
I (750) efuse_init: Chip rev: v0.2
I (755) heap_init: Initializing. RAM available for dynamic allocation:
I (762) heap_init: At 3FC97448 len 000522C8 (328 KiB): RAM
I (768) heap_init: At 3FCE9710 len 00005724 (21 KiB): RAM
I (775) heap_init: At 3FCF0000 len 00008000 (32 KiB): DRAM
I (781) heap_init: At 600FE000 len 00001FE8 (7 KiB): RTCRAM
I (787) esp_psram: Adding pool of 8192K of PSRAM memory to heap allocator
I (795) spi_flash: detected chip: generic
I (799) spi_flash: flash io: dio
I (803) sleep: Configure to isolate all GPIO pins in sleep state
I (810) sleep: Enable automatic switching of GPIO sleep configuration
I (817) main_task: Started on CPU0
I (827) esp_psram: Reserving pool of 146K of internal memory for DMA/internal allocations
I (827) main_task: Calling app_main()
I (837) UVC example: Installing USB Host
I (867) UVC example: Installing UVC driver
I (867) UVC example: Opening UVC device 0x0000:0x0000 640x480@30.0FPS...
I (867) main_task: Returned from app_main()
*** Configuration descriptor ***
bLength 9
bDescriptorType 2
wTotalLength 249
bNumInterfaces 2
bConfigurationValue 1
iConfiguration 0
bmAttributes 0x80
bMaxPower 500mA
*** Interface Association Descriptor ***
bLength 8
bDescriptorType 11
bFirstInterface 0
bInterfaceCount 2
bFunctionClass 0xe
bFunctionSubClass 0x3
bFunctionProtocol 0x0
iFunction 4
*** Interface descriptor ***
bLength 9
bDescriptorType 4
bInterfaceNumber 0
bAlternateSetting 0
bNumEndpoints 1
bInterfaceClass 0xe
bInterfaceSubClass 0x1
bInterfaceProtocol 0x0
iInterface 4
E (1267) uvc: uvc_claim_interface(580): Could not find frame format 640x480@30.0FPS
*** Class-specific VC Interface Descriptor ***
bLength 13
bDescriptorType 0x24
bDescriptorSubType 0x01
E (1297) uvc: uvc_host_stream_open(808): Could not find/claim streaming interface
bcdUVC 0100
wTotalLength 109
dwClockFrequency 48000000
bInCollection 1
baInterfaceNr[0] 1
I (1317) UVC example: Failed to open device
*** Input Terminal Descriptor (Camera) ***
bLength 18
bDescriptorType 0x24
bDescriptorSubType 0x02
bTerminalID 0x1
wTerminalType 0x201
bAssocTerminal 0
iTerminal 0
wObjectiveFocalLengthMin 0
wObjectiveFocalLengthMax 0
wOcularFocalLength 0
bControlSize 3
bmControls 0xE 0x0 0x0
*** Processing Unit Descriptor ***
bLength 11
bDescriptorType 0x24
bDescriptorSubType 0x05
bUnitID 2
bSourceID 1
wMaxMultiplier 16384
bControlSize 2
bmControls 0x7F 0x15 0x0
iProcessing 29
bmVideoStandards 0x24
*** Extension Unit Descriptor unsupported, skipping... ***
*** Extension Unit Descriptor unsupported, skipping... ***
*** Output Terminal Descriptor ***
bLength 9
bDescriptorType 0x24
bDescriptorSubType 0x03
bTerminalID 5
wTerminalType 0x101
bAssocTerminal 0
bSourceID 4
iTerminal 0
*** Endpoint descriptor ***
bLength 7
bDescriptorType 5
bEndpointAddress 0x87 EP 7 IN
bmAttributes 0x3 INT
wMaxPacketSize 16
bInterval 8
*** Class-specific Interrupt Endpoint Descriptor ***
bLength 5
bDescriptorType 0x25
bDescriptorSubType 3
wMaxTransferSize 1029
*** Interface descriptor ***
bLength 9
bDescriptorType 4
bInterfaceNumber 1
bAlternateSetting 0
bNumEndpoints 0
bInterfaceClass 0xe
bInterfaceSubClass 0x2
bInterfaceProtocol 0x0
iInterface 0
*** Class-specific VC Interface Descriptor ***
bLength 14
bDescriptorType 0x24
bDescriptorSubType 0x01
bcdUVC 3d01
wTotalLength 33024
dwClockFrequency 16844032
bInCollection 0
*** Extension Unit Descriptor unsupported, skipping... ***
*** VS Frame Descriptor ***
bLength 30
bDescriptorType 0x24
bDescriptorSubType 0x07
bFrameIndex 1
bmCapabilities 0x0
wWidth 640
wHeight 480
dwMinBitRate 122880000
dwMaxBitRate 122880000
dwMaxVideoFrameBufSize 614400
dwDefaultFrameInterval 400000
bFrameIntervalType 1
FrameInterval[0] 400000
*** VS Color Format Descriptor ***
bLength 6
bDescriptorType 0x24
bDescriptorSubType 0x0D
bColorPrimaries 0x1
bTransferCharacteristics 1
bMatrixCoefficients 0x4
*** Interface descriptor ***
bLength 9
bDescriptorType 4
bInterfaceNumber 1
bAlternateSetting 1
bNumEndpoints 1
bInterfaceClass 0xe
bInterfaceSubClass 0x2
bInterfaceProtocol 0x0
iInterface 0
*** Endpoint descriptor ***
bLength 7
bDescriptorType 5
bEndpointAddress 0x81 EP 1 IN
bmAttributes 0x5 ISOC
wMaxPacketSize 512
bInterval 1
*** Interface descriptor ***
bLength 9
bDescriptorType 4
bInterfaceNumber 1
bAlternateSetting 2
bNumEndpoints 1
bInterfaceClass 0xe
bInterfaceSubClass 0x2
bInterfaceProtocol 0x0
iInterface 0
*** Endpoint descriptor ***
bLength 7
bDescriptorType 5
bEndpointAddress 0x81 EP 1 IN
bmAttributes 0x5 ISOC
wMaxPacketSize 944
bInterval 1
I (6327) UVC example: Opening UVC device 0x0000:0x0000 640x480@30.0FPS...
E (6327) uvc: uvc_claim_interface(580): Could not find frame format 640x480@30.0FPS
E (6327) uvc: uvc_host_stream_open(808): Could not find/claim streaming interface
I (6337) UVC example: Failed to open device
I (11337) UVC example: Opening UVC device 0x0000:0x0000 640x480@30.0FPS...
E (11337) uvc: uvc_claim_interface(580): Could not find frame format 640x480@30.0FPS
E (11337) uvc: uvc_host_stream_open(808): Could not find/claim streaming interface
I (11347) UVC example: Failed to open device

[github-actions]

Hi @KineticChen! Please be aware that the following suggestions are generated by a bot and haven't been fact-checked by Espressif Systems. We hope that this message will help you until an Espressif Engineer looks at your issue.

---

Looking at the error log, the issue is clear:

E (1267) uvc: uvc_claim_interface(580): Could not find frame format 640x480@30.0FPS

The camera's descriptor shows it only supports 640x480 at 25 FPS (not 30 FPS):

*** VS Frame Descriptor ***
bFrameIndex 1
wWidth 640
wHeight 480
dwDefaultFrameInterval 400000   ← 400000 * 100ns = 40ms = 25 FPS
bFrameIntervalType 1
FrameInterval[0] 400000         ← only one interval supported: 25 FPS

The camera advertises a single frame interval of 400000 (in 100ns units), which equals 25 FPS, not 30 FPS. Since the example is configured to request 640x480@30.0FPS, the UVC driver cannot find a matching format and fails to open the stream.

Fix

Change the requested frame rate from 30.0 to 25.0 FPS in your stream_config. For example, in main.c where stream_config is defined, update the FPS field to match what the camera actually supports:

// Change from:
// .fps = 30,
// To:
.fps = 25,

Additionally, there is a known limitation relevant to your setup: on ESP32-S2/S3 with Full Speed USB, the MPS (maximum packet size) is limited to 512 bytes, and the achievable throughput is approximately 0.5 MB/s. The most commonly supported formats at Full Speed are 320x240 @ 30 FPS MJPEG and 640x480 @ 15 FPS MJPEG. [USB Camera Example]

Also note: the camera's descriptor shows it uses an uncompressed format (VS Frame Descriptor with bDescriptorSubType 0x07 = uncompressed), not MJPEG. Uncompressed 640x480 requires significantly more bandwidth than MJPEG, which may cause issues at Full Speed USB. You may want to verify whether your camera supports MJPEG format as well, as that is generally recommended for use with ESP32-S3. [USB Camera Solution]

Summary of steps to try:

1. Set the requested FPS to 25 to match the camera's advertised frame interval.
2. Confirm whether the camera supports MJPEG; if not, uncompressed 640x480 may exceed the bandwidth limits of Full Speed USB on ESP32-S3.

[KineticChen]

嗨！请注意，以下建议由机器人生成，未经Espressif Systems事实核查。我们希望这条信息能帮到你，直到Espressif工程师来处理你的问题。

查看错误日志，问题很明显：

E (1267) uvc: uvc_claim_interface(580): Could not find frame format 640x480@30.0FPS

相机描述符显示它只支持640x480的25 FPS（不是30 FPS）：

*** VS Frame Descriptor ***
bFrameIndex 1
wWidth 640
wHeight 480
dwDefaultFrameInterval 400000   ← 400000 * 100ns = 40ms = 25 FPS
bFrameIntervalType 1
FrameInterval[0] 400000         ← only one interval supported: 25 FPS

相机宣传的帧间隔为100纳秒单位，相当于**25帧，**而非30帧。由于示例设置为请求 ，UVC 驱动找不到匹配格式，无法打开流。400000``640x480@30.0FPS

修复

在你的 .例如，在定义中，更新FPS字段以匹配摄像机实际支持的帧率：30.0``25.0``stream_config``main.c``stream_config

// Change from:
// .fps = 30,
// To:
.fps = 25,
此外，你的设置还有一个已知的限制：在ESP32-S2/S3的全速USB上，MPS（最大数据包大小）限制在512字节，可实现的吞吐量大约是0.5 MB/s。全速支持的最常见格式有 和 。[USB摄像头示例320x240 @ 30 FPS MJPEG``640x480 @ 15 FPS MJPEG]

另外注意：相机的描述符显示它使用未压缩格式（=未压缩），而不是MJPEG。未压缩的640x480需要的带宽远多于MJPEG，这可能会在全速USB下引发问题。你可能想确认你的相机是否支持 MJPEG 格式，因为一般推荐用于 ESP32-S3。[USB摄像头解决方案VS Frame Descriptor``bDescriptorSubType 0x07]

步骤总结：

1. 将请求的帧率设置为与相机标称的帧间隔相匹配。25
2. 确认相机是否支持 MJPEG;如果不行，未压缩的640x480可能超过ESP32-S3上全速USB的带宽限制。

I (27) boot: ESP-IDF v5.3.3-dirty 2nd stage bootloader
I (27) boot: compile time Mar 25 2026 16:47:03
I (27) boot: Multicore bootloader
I (30) boot: chip revision: v0.2
I (34) boot: efuse block revision: v1.3
I (39) boot.esp32s3: Boot SPI Speed : 80MHz
I (44) boot.esp32s3: SPI Mode : DIO
I (48) boot.esp32s3: SPI Flash Size : 16MB
I (53) boot: Enabling RNG early entropy source...
I (58) boot: Partition Table:
I (62) boot: ## Label Usage Type ST Offset Length
I (69) boot: 0 nvs WiFi data 01 02 00009000 00006000
I (77) boot: 1 phy_init RF data 01 01 0000f000 00001000
I (84) boot: 2 factory factory app 00 00 00010000 00100000
I (92) boot: End of partition table
I (96) esp_image: segment 0: paddr=00010020 vaddr=3c030020 size=0db4ch ( 56140) map
I (114) esp_image: segment 1: paddr=0001db74 vaddr=3fc93e00 size=024a4h ( 9380) load
I (117) esp_image: segment 2: paddr=00020020 vaddr=42000020 size=218d8h (137432) map
I (145) esp_image: segment 3: paddr=00041900 vaddr=3fc962a4 size=008bch ( 2236) load
I (146) esp_image: segment 4: paddr=000421c4 vaddr=40374000 size=0fd74h ( 64884) load
I (172) boot: Loaded app from partition at offset 0x10000
I (172) boot: Disabling RNG early entropy source...
I (184) octal_psram: vendor id : 0x0d (AP)
I (184) octal_psram: dev id : 0x02 (generation 3)
I (184) octal_psram: density : 0x03 (64 Mbit)
I (189) octal_psram: good-die : 0x01 (Pass)
I (194) octal_psram: Latency : 0x01 (Fixed)
I (200) octal_psram: VCC : 0x01 (3V)
I (205) octal_psram: SRF : 0x01 (Fast Refresh)
I (210) octal_psram: BurstType : 0x01 (Hybrid Wrap)
I (216) octal_psram: BurstLen : 0x01 (32 Byte)
I (222) octal_psram: Readlatency : 0x02 (10 cycles@Fixed)
I (228) octal_psram: DriveStrength: 0x00 (1/1)
I (234) MSPI Timing: PSRAM timing tuning index: 5
I (238) esp_psram: Found 8MB PSRAM device
I (243) esp_psram: Speed: 80MHz
I (247) cpu_start: Multicore app
I (703) esp_psram: SPI SRAM memory test OK
I (712) cpu_start: Pro cpu start user code
I (712) cpu_start: cpu freq: 240000000 Hz
I (712) app_init: Application information:
I (715) app_init: Project name: uvc
I (720) app_init: App version: 1
I (724) app_init: Compile time: Mar 25 2026 19:06:40
I (730) app_init: ELF file SHA256: d9221539a...
I (735) app_init: ESP-IDF: v5.3.3-dirty
I (740) efuse_init: Min chip rev: v0.0
I (745) efuse_init: Max chip rev: v0.99
I (750) efuse_init: Chip rev: v0.2
I (755) heap_init: Initializing. RAM available for dynamic allocation:
I (762) heap_init: At 3FC97448 len 000522C8 (328 KiB): RAM
I (768) heap_init: At 3FCE9710 len 00005724 (21 KiB): RAM
I (774) heap_init: At 3FCF0000 len 00008000 (32 KiB): DRAM
I (781) heap_init: At 600FE000 len 00001FE8 (7 KiB): RTCRAM
I (787) esp_psram: Adding pool of 8192K of PSRAM memory to heap allocator
I (795) spi_flash: detected chip: generic
I (799) spi_flash: flash io: dio
I (803) sleep: Configure to isolate all GPIO pins in sleep state
I (810) sleep: Enable automatic switching of GPIO sleep configuration
I (817) main_task: Started on CPU0
I (827) esp_psram: Reserving pool of 146K of internal memory for DMA/internal allocations
I (827) main_task: Calling app_main()
I (837) UVC example: Installing USB Host
I (867) UVC example: Installing UVC driver
I (867) UVC example: Opening UVC device 0x0000:0x0000 640x480@25.0FPS...
I (867) main_task: Returned from app_main()
*** Configuration descriptor ***
bLength 9
bDescriptorType 2
wTotalLength 249
bNumInterfaces 2
bConfigurationValue 1
iConfiguration 0
bmAttributes 0x80
bMaxPower 500mA
*** Interface Association Descriptor ***
bLength 8
bDescriptorType 11
bFirstInterface 0
bInterfaceCount 2
bFunctionClass 0xe
bFunctionSubClass 0x3
bFunctionProtocol 0x0
iFunction 4
*** Interface descriptor ***
bLength 9
bDescriptorType 4
bInterfaceNumber 0
bAlternateSetting 0
bNumEndpoints 1
bInterfaceClass 0xe
bInterfaceSubClass 0x1
bInterfaceProtocol 0x0
iInterface 4
E (1267) uvc: uvc_claim_interface(580): Could not find frame format 640x480@25.0FPS
*** Class-specific VC Interface Descriptor ***
bLength 13
bDescriptorType 0x24
bDescriptorSubType 0x01
E (1297) uvc: uvc_host_stream_open(808): Could not find/claim streaming interface
bcdUVC 0100
wTotalLength 109
dwClockFrequency 48000000
bInCollection 1
baInterfaceNr[0] 1
I (1317) UVC example: Failed to open device
*** Input Terminal Descriptor (Camera) ***
bLength 18
bDescriptorType 0x24
bDescriptorSubType 0x02
bTerminalID 0x1
wTerminalType 0x201
bAssocTerminal 0
iTerminal 0
wObjectiveFocalLengthMin 0
wObjectiveFocalLengthMax 0
wOcularFocalLength 0
bControlSize 3
bmControls 0xE 0x0 0x0
*** Processing Unit Descriptor ***
bLength 11
bDescriptorType 0x24
bDescriptorSubType 0x05
bUnitID 2
bSourceID 1
wMaxMultiplier 16384
bControlSize 2
bmControls 0x7F 0x15 0x0
iProcessing 29
bmVideoStandards 0x24
*** Extension Unit Descriptor unsupported, skipping... ***
*** Extension Unit Descriptor unsupported, skipping... ***
*** Output Terminal Descriptor ***
bLength 9
bDescriptorType 0x24
bDescriptorSubType 0x03
bTerminalID 5
wTerminalType 0x101
bAssocTerminal 0
bSourceID 4
iTerminal 0
*** Endpoint descriptor ***
bLength 7
bDescriptorType 5
bEndpointAddress 0x87 EP 7 IN
bmAttributes 0x3 INT
wMaxPacketSize 16
bInterval 8
*** Class-specific Interrupt Endpoint Descriptor ***
bLength 5
bDescriptorType 0x25
bDescriptorSubType 3
wMaxTransferSize 1029
*** Interface descriptor ***
bLength 9
bDescriptorType 4
bInterfaceNumber 1
bAlternateSetting 0
bNumEndpoints 0
bInterfaceClass 0xe
bInterfaceSubClass 0x2
bInterfaceProtocol 0x0
iInterface 0
*** Class-specific VC Interface Descriptor ***
bLength 14
bDescriptorType 0x24
bDescriptorSubType 0x01
bcdUVC 3d01
wTotalLength 33024
dwClockFrequency 16844032
bInCollection 0
*** Extension Unit Descriptor unsupported, skipping... ***
*** VS Frame Descriptor ***
bLength 30
bDescriptorType 0x24
bDescriptorSubType 0x07
bFrameIndex 1
bmCapabilities 0x0
wWidth 640
wHeight 480
dwMinBitRate 122880000
dwMaxBitRate 122880000
dwMaxVideoFrameBufSize 614400
dwDefaultFrameInterval 400000
bFrameIntervalType 1
FrameInterval[0] 400000
*** VS Color Format Descriptor ***
bLength 6
bDescriptorType 0x24
bDescriptorSubType 0x0D
bColorPrimaries 0x1
bTransferCharacteristics 1
bMatrixCoefficients 0x4
*** Interface descriptor ***
bLength 9
bDescriptorType 4
bInterfaceNumber 1
bAlternateSetting 1
bNumEndpoints 1
bInterfaceClass 0xe
bInterfaceSubClass 0x2
bInterfaceProtocol 0x0
iInterface 0
*** Endpoint descriptor ***
bLength 7
bDescriptorType 5
bEndpointAddress 0x81 EP 1 IN
bmAttributes 0x5 ISOC
wMaxPacketSize 512
bInterval 1
*** Interface descriptor ***
bLength 9
bDescriptorType 4
bInterfaceNumber 1
bAlternateSetting 2
bNumEndpoints 1
bInterfaceClass 0xe
bInterfaceSubClass 0x2
bInterfaceProtocol 0x0
iInterface 0
*** Endpoint descriptor ***
bLength 7
bDescriptorType 5
bEndpointAddress 0x81 EP 1 IN
bmAttributes 0x5 ISOC
wMaxPacketSize 944
bInterval 1
I (6327) UVC example: Opening UVC device 0x0000:0x0000 640x480@25.0FPS...
E (6327) uvc: uvc_claim_interface(580): Could not find frame format 640x480@25.0FPS
E (6327) uvc: uvc_host_stream_open(808): Could not find/claim streaming interface
I (6337) UVC example: Failed to open device
It is also impossible to use even after modification to the corresponding frame number.

[tore-espressif]

Hello @KineticChen ,
Uncompressed format with 640x480 resolution and 25 FPS will not work on ESP32-S3.

Practical maximum is MJPEG encoded 320x240@30FPS and 640x480@15FPS

[KineticChen]

Hello @KineticChen , Uncompressed format with 640x480 resolution and 25 FPS will not work on ESP32-S3.

Practical maximum is MJPEG encoded 320x240@30FPS and 640x480@15FPS

OK, I understand. The cameras I use for testing are mainly designed for the high-speed USB 2.0 interface. Their performance in the full-speed USB 1.1 interface is mostly limited due to issues such as excessive MPS or other reasons.