Zephyr USB UVC sample video-emul Unaligned memory access error #88730

Sambsc19 · 2025-04-16T20:15:46Z

Sambsc19
Apr 16, 2025

Hi I have an issue running the uvc sample with emulated camera. I pulled the latest today from https://github.com/tinyvision-ai-inc/zephyr/tree/pr-usb-uvc. I have the following error once i plug in the "camera" usb.

I am building with:

west build -c -b stm32h7s78_zi --sysbuild -d wsc/uvc_emul/build_emul wsc/uvc_emul -- -DEXTRA_DTC_OVERLAY_FILE="video-emul.overlay" -DSB_CONFIG_BOOTLOADER_MCUBOOT=y -DCONFIG_FLASH_BASE_ADDRESS=0x70000000

I have attached my application sample as .zip


* Booting MCUboot v2.1.0-rc1-301-gcb99195f139b ***
*** Using Zephyr OS build v4.1.0-385-g9692ddabc60f ***
I: Starting bootloader
I: Primary image: magic=unset, swap_type=0x1, copy_done=0x3, image_ok=0x3
I: Secondary image: magic=unset, swap_type=0x1, copy_done=0x3, image_ok=0x3
I: Boot source: none
I: Image index: 0, Swap type: none
I: Bootloader chainload address offset: 0x0
I: Image version: v0.0.0
I: Jumping to the first image slot
*** Booting Zephyr OS build v4.1.0-385-g9692ddabc60f ***
[00:00:00.012,000] <inf> uvc_sample: Waiting the host to select the video format
[00:04:43.881,000] <wrn> udc: Spurious suspend/resume event
[00:04:44.219,000] <err> os: ***** USAGE FAULT *****
[00:04:44.219,000] <err> os:   Unaligned memory access
[00:04:44.219,000] <err> os: r0/a1:  0x00000002  r1/a2:  0x02000000  r2/a3:  0x70011cb3
[00:04:44.219,000] <err> os: r3/a4:  0x240035a0 r12/ip:  0x9378fa35 r14/lr:  0x7000837b
[00:04:44.219,000] <err> os:  xpsr:  0x01000080
[00:04:44.219,000] <err> os: Faulting instruction address (r15/pc): 0x7000806a
[00:04:44.220,000] <err> os: >>> ZEPHYR FATAL ERROR 31: Unknown error on CPU 0
[00:04:44.220,000] <err> os: Fault during interrupt handling

[00:04:44.220,000] <err> os: Current thread: 0x24001aa8 (unknown)
[00:04:44.229,000] <err> os: Halting system

It appears to point to stm32h7rsxx_hal_rcc.c


/**
  * @brief  Return the HCLK frequency.
  * @retval HCLK frequency in Hz
  */
uint32_t HAL_RCC_GetHCLKFreq(void)
{
  uint32_t clock, prescaler;
  const uint8_t AHBPrescTable[8] = {1U, 2U, 3U, 4U, 6U, 7U, 8U, 9U};

  /* SysClk */
  clock = HAL_RCC_GetSysClockFreq();
  /* Bus matrix divider */
  prescaler = (RCC->BMCFGR & RCC_BMCFGR_BMPRE) >> RCC_BMCFGR_BMPRE_Pos;
  if (prescaler >= 8U)
  {
    clock = clock >> AHBPrescTable[prescaler - 8U];
  }
  return (clock);
}

uvc_emul.zip

Sambsc19 · 2025-04-16T22:11:45Z

Sambsc19
Apr 16, 2025
Author

enabling debug logging has resolved the USAGE FAULT. The device appears on the windows device manager as UVC sample but it has error code 10.

usb logs:


*** Booting MCUboot v2.1.0-rc1-301-gcb99195f139b ***
*** Using Zephyr OS build v4.1.0-385-g9692ddabc60f ***
I: Starting bootloader
I: Primary image: magic=unset, swap_type=0x1, copy_done=0x3, image_ok=0x3
I: Secondary image: magic=unset, swap_type=0x1, copy_done=0x3, image_ok=0x3
I: Boot source: none
I: Image index: 0, Swap type: none
I: Bootloader chainload address offset: 0x0
I: Image version: v0.0.0
I: Jumping to the first image slot
[00:00:00.000,000] <dbg> video_emul_imager: emul_imager_read_reg: Placeholder for I2C read from 0x00
[00:00:00.000,000] <dbg> video_emul_imager: emul_imager_write_reg: Placeholder for I2C write 0x00000000 to 0x01
[00:00:00.000,000] <dbg> video_emul_imager: emul_imager_write_reg: Placeholder for I2C write 0x00000010 to 0x02
--- 46 messages dropped ---
[00:00:00.020,000] <inf> usbd_uvc: Adding frame descriptor #1 for 320x240
[00:00:00.020,000] <dbg> usbd_uvc: uvc_new_fmt_desc: Allocated format/frame descriptor 2 (0x24000682)
[00:00:00.021,000] <dbg> usbd_uvc: uvc_add_vs_frame_desc: Adding discrete frame interval 1
[00:00:00.021,000] <dbg> usbd_uvc: uvc_add_vs_frame_desc: Adding discrete frame interval 3
[00:00:00.021,000] <dbg> usbd_uvc: uvc_add_vs_frame_desc: Adding discrete frame interval 5
[00:00:00.021,000] <inf> usbd_uvc: Adding format descriptor #2 for YUYV
[00:00:00.021,000] <inf> usbd_uvc: Adding frame descriptor #1 for 320x240
[00:00:00.021,000] <dbg> usbd_uvc: uvc_new_fmt_desc: Allocated format/frame descriptor 4 (0x240006f6)
[00:00:00.022,000] <dbg> usbd_uvc: uvc_add_vs_frame_desc: Adding discrete frame interval 1
[00:00:00.022,000] <dbg> usbd_uvc: uvc_get_vs_fmtfrm_desc: Walking through format 0, subtype 4, index 1, ptr 0x24000648
[00:00:00.022,000] <dbg> usbd_uvc: uvc_get_vs_fmtfrm_desc: Walking through frame 1, subtype 5, index 1, ptr 0x24000682
[00:00:00.022,000] <dbg> usbd_uvc: uvc_get_vs_format_from_desc: Found descriptor for format 1, frame 1, GUID 'RGBP', pixfmt 50424752
[00:00:00.023,000] <dbg> usbd_uvc: uvc_get_vs_fmtfrm_desc: Walking through format 0, subtype 4, index 1, ptr 0x24000648
[00:00:00.023,000] <dbg> usbd_uvc: uvc_get_vs_fmtfrm_desc: Walking through frame 1, subtype 5, index 1, ptr 0x24000682
[00:00:00.023,000] <inf> usbd_init: Init class node 0x240001dc, descriptor length 269
[00:00:00.023,000] <inf> usbd_init: bNumInterfaces 2 wTotalLength 278
[00:00:00.023,000] <inf> usbd_init: FS bNumConfigurations 1
[00:00:00.023,000] <dbg> udc_stm32: udc_stm32_enable: Enable UDC
[00:00:00.023,000] <dbg> udc_stm32: udc_stm32_mem_init: DRAM size: 1280b
[00:00:00.024,000] <dbg> udc: ep_check_config: cfg d:-|O t:-|-|-|C, mps 64
[00:00:00.024,000] <dbg> udc_stm32: udc_stm32_ep_enable: Enable ep 0x00
[00:00:00.024,000] <dbg> udc: ep_check_config: cfg d:I|- t:-|-|-|C, mps 64
[00:00:00.024,000] <dbg> udc_stm32: udc_stm32_ep_enable: Enable ep 0x80
[00:00:00.024,000] <inf> uvc_sample: Waiting the host to select the video format
[00:00:00.030,000] <dbg> usbd_core: usbd_event_handler: SUSPEND event
[00:00:29.142,000] <wrn> udc: Spurious suspend/resume event
[00:00:29.142,000] <dbg> usbd_core: usbd_event_handler: SUSPEND event
[00:00:29.479,000] <dbg> usbd_core: usbd_event_handler: RESET event
[00:00:29.479,000] <dbg> udc_stm32: udc_stm32_set_address: Set Address 0
[00:00:29.479,000] <inf> udc: ep 0x80 is not halted|disabled
[00:00:29.480,000] <dbg> udc: udc_debug_ep_enqueue: ep 0x80 queue is empty
[00:00:29.480,000] <inf> usbd_core: Actual device speed 1
[00:00:29.513,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x00, size 8
[00:00:29.513,000] <dbg> udc: udc_ctrl_update_stage: s->(in)
[00:00:29.513,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x80, size 64
[00:00:29.513,000] <inf> usbd_ch9: Handle control 0x240127b8 ep 0x00, len 8, s:1 d:0 s:0
[00:00:29.513,000] <dbg> udc: udc_buf_destroy: destroy 0x240127b8
[00:00:29.514,000] <dbg> usbd_ch9: sreq_get_descriptor: Get Descriptor request type 1 index 0
[00:00:29.514,000] <dbg> udc: udc_ep_enqueue: Queue ep 0x80 0x240127dc len 18
[00:00:29.514,000] <dbg> udc_stm32: udc_stm32_tx: TX ep 0x80 len 18
[00:00:29.514,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x00, size 0
[00:00:29.514,000] <dbg> udc_stm32: handle_msg_data_in: DataIn ep 0x80
[00:00:29.515,000] <dbg> udc: udc_ctrl_update_stage: s-in->(status)
[00:00:29.515,000] <dbg> udc: udc_buf_destroy: destroy 0x240127dc
[00:00:29.515,000] <dbg> udc_stm32: handle_msg_data_out: DataOut ep 0x00
[00:00:29.515,000] <dbg> udc: udc_ctrl_update_stage: s-in-status
[00:00:29.515,000] <inf> usbd_ch9: Handle control 0x240127b8 ep 0x00, len 0, s:0 d:0 s:1
[00:00:29.515,000] <inf> usbd_ch9: s-in-status finished
[00:00:29.515,000] <dbg> udc: udc_buf_destroy: destroy 0x240127b8
[00:00:29.570,000] <dbg> usbd_core: usbd_event_handler: RESET event
[00:00:29.570,000] <dbg> udc_stm32: udc_stm32_set_address: Set Address 0
[00:00:29.570,000] <inf> udc: ep 0x80 is not halted|disabled
[00:00:29.570,000] <dbg> udc: udc_debug_ep_enqueue: ep 0x80 queue is empty
[00:00:29.570,000] <inf> usbd_core: Actual device speed 1
[00:00:29.603,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x00, size 8
[00:00:29.603,000] <dbg> udc: udc_ctrl_update_stage: s->(status)
[00:00:29.603,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x80, size 0
[00:00:29.603,000] <inf> usbd_ch9: Handle control 0x240127b8 ep 0x00, len 8, s:1 d:0 s:0
[00:00:29.603,000] <dbg> udc: udc_buf_destroy: destroy 0x240127b8
[00:00:29.604,000] <dbg> udc: udc_ep_enqueue: Queue ep 0x80 0x240127dc len 0
--- 104 messages dropped ---
[00:00:29.641,000] <inf> usbd_ch9: s-in-status finished
[00:00:29.641,000] <dbg> udc: udc_buf_destroy: destroy 0x240127dc
[00:00:29.641,000] <inf> usbd_ch9: Handle control 0x240127b8 ep 0x00, len 8, s:1 d:0 s:0
[00:00:29.642,000] <dbg> udc: udc_buf_destroy: destroy 0x240127b8
[00:00:29.642,000] <dbg> usbd_ch9: string_ascii7_to_utf16le: wLength 255, bLength 22, tailroom 256
[00:00:29.642,000] <dbg> udc: udc_ep_enqueue: Queue ep 0x80 0x24012800 len 22
[00:00:29.642,000] <dbg> udc_stm32: udc_stm32_tx: TX ep 0x80 len 22
[00:00:29.643,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x00, size 0
[00:00:29.643,000] <dbg> udc_stm32: handle_msg_data_in: DataIn ep 0x80
[00:00:29.643,000] <dbg> udc: udc_ctrl_update_stage: s-in->(status)
[00:00:29.643,000] <dbg> udc: udc_buf_destroy: destroy 0x24012800
[00:00:29.644,000] <dbg> udc_stm32: handle_msg_data_out: DataOut ep 0x00
[00:00:29.644,000] <dbg> udc: udc_ctrl_update_stage: s-in-status
[00:00:29.644,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x00, size 8
[00:00:29.644,000] <dbg> udc: udc_ctrl_update_stage: s->(in)
[00:00:29.644,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x80, size 10
[00:00:29.645,000] <inf> usbd_ch9: Handle control 0x240127b8 ep 0x00, len 0, s:0 d:0 s:1
[00:00:29.645,000] <inf> usbd_ch9: s-in-status finished
[00:00:29.645,000] <dbg> udc: udc_buf_destroy: destroy 0x240127b8
[00:00:29.645,000] <inf> usbd_ch9: Handle control 0x24012800 ep 0x00, len 8, s:1 d:0 s:0
[00:00:29.645,000] <dbg> udc: udc_buf_destroy: destroy 0x24012800
[00:00:29.645,000] <dbg> usbd_ch9: sreq_get_descriptor: Get Descriptor request type 6 index 0
[00:00:29.646,000] <inf> usbd_ch9: protocol error:
[00:00:29.646,000] <inf> usbd_ch9: setup:
                                   80 06 00 06 00 00 0a 00                          |........         
[00:00:29.646,000] <inf> usbd_ch9: not supported
[00:00:29.646,000] <dbg> udc: udc_buf_destroy: destroy 0x240127dc
[00:00:29.646,000] <dbg> udc_stm32: udc_stm32_ep_set_halt: Halt ep 0x80
[00:00:29.745,000] <dbg> udc: udc_ctrl_update_stage: s-in->(status)
--- 29 messages dropped ---
[00:00:29.745,000] <dbg> udc: udc_buf_destroy: destroy 0x240127b8
--- 20 messages dropped ---
[00:00:29.750,000] <dbg> udc: udc_ctrl_update_stage: s-in->(status)
--- 52 messages dropped ---
[00:00:29.767,000] <dbg> udc_stm32: udc_stm32_tx: TX ep 0x80 len 22
[00:00:29.767,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x00, size 0
[00:00:29.768,000] <dbg> udc_stm32: handle_msg_data_in: DataIn ep 0x80
[00:00:29.768,000] <dbg> udc: udc_ctrl_update_stage: s-in->(status)
[00:00:29.768,000] <dbg> udc: udc_buf_destroy: destroy 0x24012800
[00:00:29.768,000] <dbg> udc_stm32: handle_msg_data_out: DataOut ep 0x00
--- 85 messages dropped ---
[00:00:29.804,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x00, size 0
[00:00:29.804,000] <dbg> udc_stm32: handle_msg_data_in: DataIn ep 0x80
[00:00:29.804,000] <dbg> udc: udc_ctrl_update_stage: s-in->(status)
--- 103 messages dropped ---
[00:00:29.832,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x00, size 0
[00:00:29.833,000] <dbg> udc_stm32: handle_msg_data_in: DataIn ep 0x80
[00:00:29.833,000] <dbg> udc: udc_ctrl_update_stage: s-in->(status)
[00:00:29.833,000] <dbg> udc: udc_buf_destroy: destroy 0x240127b8
[00:00:29.834,000] <dbg> udc: udc_ctrl_update_stage: s-in-status
[00:00:29.834,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x00, size 8
[00:00:29.834,000] <dbg> udc: udc_ctrl_update_stage: s->(in)
[00:00:29.834,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x80, size 255
[00:00:29.835,000] <inf> usbd_ch9: Handle control 0x240127dc ep 0x00, len 0, s:0 d:0 s:1
[00:00:29.835,000] <inf> usbd_ch9: s-in-status finished
[00:00:29.835,000] <dbg> udc: udc_buf_destroy: destroy 0x240127dc
[00:00:29.835,000] <inf> usbd_ch9: Handle control 0x240127b8 ep 0x00, len 8, s:1 d:0 s:0
[00:00:29.835,000] <dbg> udc: udc_buf_destroy: destroy 0x240127b8
[00:00:29.835,000] <dbg> usbd_ch9: sreq_get_descriptor: Get Descriptor request type 3 index 2
[00:00:29.836,000] <dbg> usbd_ch9: string_ascii7_to_utf16le: wLength 255, bLength 22, tailroom 256
[00:00:29.836,000] <dbg> udc: udc_ep_enqueue: Queue ep 0x80 0x24012800 len 22
[00:00:29.836,000] <dbg> udc_stm32: udc_stm32_tx: TX ep 0x80 len 22
[00:00:29.836,000] <dbg> udc: udc_ep_buf_alloc: Allocate net_buf, ep 0x00, size 0
[00:00:29.837,000] <dbg> udc_stm32: handle_msg_data_in: DataIn ep 0x80
[00:00:29.837,000] <dbg> udc: udc_ctrl_update_stage: s-in->(status)
[00:00:29.837,000] <dbg> udc: udc_buf_destroy: destroy 0x24012800
[00:00:29.837,000] <dbg> udc_stm32: handle_msg_data_out: DataOut ep 0x00
[00:00:29.837,000] <dbg> udc: udc_ctrl_update_stage: s-in-status
[00:00:29.837,000] <inf> usbd_ch9: Handle control 0x240127b8 ep 0x00, len 0, s:0 d:0 s:1
[00:00:29.837,000] <inf> usbd_ch9: s-in-status finished
[00:00:29.838,000] <dbg> udc: udc_buf_destroy: destroy 0x240127b8
[00:00:30.803,000] <wrn> udc: Spurious suspend/resume event
[00:00:30.804,000] <dbg> usbd_core: usbd_event_handler: SUSPEND event

USB device tree viewer info:


    =========================== USB Port4 ===========================

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

      ========================== Summary =========================
Vendor ID                : 0x2FE3 (Zephyr Project)
Product ID               : 0x0011
Manufacturer String      : Zephyr Project
Serial                   : 3333353932335113002E0046
USB Version              : 2.0 -> but Device is Full-Speed only
Port maximum Speed       : High-Speed (Companion Port 1-2 is doing the SuperSpeed)
Device maximum Speed     : Full-Speed
Device Connection Speed  : Full-Speed
Self powered             : yes
Demanded Current         : 250 mA
Used Endpoints           : 2
Video                    : UVC Version 1.50
                 -------- Default Video Modes --------
320 x 240 @ 15 fps       : Uncompressed

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

        +++++++++++++++++ Device Information ++++++++++++++++++
Device Description       : USB Composite Device
Device Path              : \\?\USB#VID_2FE3&PID_0011#3333353932335113002E0046#{a5dcbf10-6530-11d2-901f-00c04fb951ed} (GUID_DEVINTERFACE_USB_DEVICE)
Kernel Name              : \Device\USBPDO-6
Device ID                : USB\VID_2FE3&PID_0011\3333353932335113002E0046
Hardware IDs             : USB\VID_2FE3&PID_0011&REV_0401 USB\VID_2FE3&PID_0011
Driver KeyName           : {36fc9e60-c465-11cf-8056-444553540000}\0019 (GUID_DEVCLASS_USB)
Driver                   : \SystemRoot\System32\drivers\usbccgp.sys (Version: 10.0.26100.3624  Date: 2025-04-14  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_#0004.Hub_#0001
Address                  : 4
Location IDs             : PCIROOT(0)#PCI(1400)#USBROOT(0)#USB(4), ACPI(_SB_)#ACPI(PC00)#ACPI(XHCI)#ACPI(RHUB)#ACPI(HS04)
Container ID             : {b8850890-3cad-5441-820e-08e7eb92846f}
Manufacturer Info        : (Standard USB Host Controller)
Capabilities             : 0x94 (Removable, UniqueID, SurpriseRemovalOK)
Status                   : 0x0180600A (DN_DRIVER_LOADED, DN_STARTED, DN_DISABLEABLE, DN_REMOVABLE, DN_NT_ENUMERATOR, DN_NT_DRIVER)
Problem Code             : 0
Address                  : 4
EnhancedPowerMgmtEnabled : 0
Power State              : D2 (supported: D0, D3, wake from D0)

        +++++++++++++++++ Registry USB Flags +++++++++++++++++
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\usbflags\2FE300110401
 osvc                    : REG_BINARY 00 00

        ---------------- Connection Information ---------------
Connection Index         : 0x04 (Port 4)
Connection Status        : 0x01 (DeviceConnected)
Current Config Value     : 0x01 (Configuration 1)
Device Address           : 0x09 (9)
Is Hub                   : 0x00 (no)
Device Bus Speed         : 0x01 (Full-Speed)
Number of open Pipes     : 0x01 (1 pipe to data endpoints)
Pipe[0]                  : EndpointID=1  Direction=IN   ScheduleOffset=0  Type=Bulk  wMaxPacketSize=0x40    bInterval=0  
Data (HexDump)           : 04 00 00 00 12 01 00 02 EF 02 01 40 E3 2F 11 00   ...........@./..
                           01 04 01 02 03 01 01 01 00 09 00 01 00 00 00 01   ................
                           00 00 00 07 05 81 02 40 00 00 00 00 00 00         .......@......

        --------------- Connection Information V2 -------------
Connection Index         : 0x04 (4)
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 1-2 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)           : 04 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) -> but device is Full-Speed only
bDeviceClass             : 0xEF (Miscellaneous)
bDeviceSubClass          : 0x02
bDeviceProtocol          : 0x01 (IAD - Interface Association Descriptor)
bMaxPacketSize0          : 0x40 (64 bytes)
idVendor                 : 0x2FE3 (Zephyr Project)
idProduct                : 0x0011
bcdDevice                : 0x0401
iManufacturer            : 0x01 (String Descriptor 1)
iProduct                 : 0x02 (String Descriptor 2)
iSerialNumber            : 0x03 (String Descriptor 3)
bNumConfigurations       : 0x01 (1 Configuration)
Data (HexDump)           : 12 01 00 02 EF 02 01 40 E3 2F 11 00 01 04 01 02   .......@./......
                           03 01                                             ..

    ------------------ Configuration Descriptor -------------------
bLength                  : 0x09 (9 bytes)
bDescriptorType          : 0x02 (Configuration Descriptor)
wTotalLength             : 0x0116 (278 bytes)
bNumInterfaces           : 0x02 (2 Interfaces)
bConfigurationValue      : 0x01 (Configuration 1)
iConfiguration           : 0x04 (String Descriptor 4)
bmAttributes             : 0xC0
 D7: Reserved, set 1     : 0x01
 D6: Self Powered        : 0x01 (yes)
 D5: Remote Wakeup       : 0x00 (no)
 D4..0: Reserved, set 0  : 0x00
MaxPower                 : 0x7D (250 mA)
Data (HexDump)           : 09 02 16 01 02 01 04 C0 7D 08 0B 00 02 0E 03 00   ........}.......
                           00 09 04 00 00 00 0E 01 00 00 0D 24 01 50 01 59   ...........$.P.Y
                           00 80 C3 C9 01 01 01 12 24 02 01 01 02 00 00 00   ........$.......
                           00 00 00 00 00 03 06 00 00 07 24 04 02 01 01 00   ..........$.....
                           0D 24 05 03 02 00 00 03 00 00 00 00 00 1D 24 06   .$............$.
                           04 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................
                           00 00 01 03 04 02 00 00 00 00 09 24 03 05 01 01   ...........$....
                           01 04 00 09 04 01 00 01 0E 02 00 00 0D 24 01 02   .............$..
                           93 00 81 00 05 00 00 00 00 1B 24 04 01 01 52 47   ..........$...RG
                           42 50 00 00 10 00 80 00 00 AA 00 38 9B 71 10 01   BP.........8.q..
                           00 00 00 00 26 24 05 01 00 40 01 F0 00 00 58 02   ....&$...@....X.
                           00 00 58 02 00 00 58 02 00 2A 2C 0A 00 03 2A 2C   ..X...X..*,...*,
                           0A 00 0A 8B 02 00 2D 31 01 00 06 24 0D 01 01 04   ......-1...$....
                           1B 24 04 02 01 59 55 59 32 00 00 10 00 80 00 00   .$...YUY2.......
                           AA 00 38 9B 71 10 01 00 00 00 00 1E 24 05 01 00   ..8.q.......$...
                           40 01 F0 00 00 58 02 00 00 58 02 00 00 58 02 00   @....X...X...X..
                           2A 2C 0A 00 01 2A 2C 0A 00 06 24 0D 01 01 04 07   *,...*,...$.....
                           05 81 02 40 00 00                                 ...@..

        ------------------- IAD Descriptor --------------------
bLength                  : 0x08 (8 bytes)
bDescriptorType          : 0x0B (Interface Association Descriptor)
bFirstInterface          : 0x00 (Interface 0)
bInterfaceCount          : 0x02 (2 Interfaces)
bFunctionClass           : 0x0E (Video)
bFunctionSubClass        : 0x03 (Video Interface Collection)
bFunctionProtocol        : 0x00 (PC_PROTOCOL_UNDEFINED)
iFunction                : 0x00 (No String Descriptor)
Data (HexDump)           : 08 0B 00 02 0E 03 00 00                           ........

        ---------------- Interface Descriptor -----------------
bLength                  : 0x09 (9 bytes)
bDescriptorType          : 0x04 (Interface Descriptor)
bInterfaceNumber         : 0x00 (Interface 0)
bAlternateSetting        : 0x00
bNumEndpoints            : 0x00 (Default Control Pipe only)
bInterfaceClass          : 0x0E (Video)
bInterfaceSubClass       : 0x01 (Video Control)
bInterfaceProtocol       : 0x00 (PC_PROTOCOL_UNDEFINED)
iInterface               : 0x00 (No String Descriptor)
Data (HexDump)           : 09 04 00 00 00 0E 01 00 00                        .........

        ------- Video Control Interface Header Descriptor -----
bLength                  : 0x0D (13 bytes)
bDescriptorType          : 0x24 (Video Control Interface)
bDescriptorSubtype       : 0x01 (Video Control Header)
bcdUVC                   : 0x0150 (UVC Version 1.50)
wTotalLength             : 0x0059 (89 bytes)
dwClockFreq              : 0x01C9C380 (30 MHz)
bInCollection            : 0x01 (1 VideoStreaming interface)
baInterfaceNr[1]         : 0x01 (Interface 1)
Data (HexDump)           : 0D 24 01 50 01 59 00 80 C3 C9 01 01 01            .$.P.Y.......

        -------- Video Control Input Terminal Descriptor ------
bLength                  : 0x12 (18 bytes)
bDescriptorType          : 0x24 (Video Control Interface)
bDescriptorSubtype       : 0x02 (Input Terminal)
bTerminalID              : 0x01 (1)
wTerminalType            : 0x0201 (ITT_CAMERA)
bAssocTerminal           : 0x00 (Not associated with an Output Terminal)
iTerminal                : 0x00 (No String Descriptor)
Camera Input Terminal Data:
wObjectiveFocalLengthMin : 0x0000
wObjectiveFocalLengthMax : 0x0000
wOcularFocalLength       : 0x0000
bControlSize             : 0x03 (3 bytes)
bmControls               : 0x06, 0x00, 0x00
 D0                      : 0   no -  Scanning Mode
 D1                      : 1  yes -  Auto-Exposure Mode
 D2                      : 1  yes -  Auto-Exposure Priority
 D3                      : 0   no -  Exposure Time (Absolute)
 D4                      : 0   no -  Exposure Time (Relative)
 D5                      : 0   no -  Focus (Absolute)
 D6                      : 0   no -  Focus (Relative)
 D7                      : 0   no -  Iris (Absolute)
 D8                      : 0   no -  Iris (Relative)
 D9                      : 0   no -  Zoom (Absolute)
 D10                     : 0   no -  Zoom (Relative)
 D11                     : 0   no -  Pan (Absolute)
 D12                     : 0   no -  Pan (Relative)
 D13                     : 0   no -  Roll (Absolute)
 D14                     : 0   no -  Roll (Relative)
 D15                     : 0   no -  Tilt (Absolute)
 D16                     : 0   no -  Tilt (Relative)
 D17                     : 0   no -  Focus Auto
 D18                     : 0   no -  Reserved
 D19                     : 0   no -  Reserved
 D20                     : 0   no -  Reserved
 D21                     : 0   no -  Reserved
 D22                     : 0   no -  Reserved
 D23                     : 0   no -  Reserved
Data (HexDump)           : 12 24 02 01 01 02 00 00 00 00 00 00 00 00 03 06   .$..............
                           00 00                                             ..

        -------- Video Control Selector Unit Descriptor -------
bLength                  : 0x07 (7 bytes)
bDescriptorType          : 0x24 (Video Control Interface)
bDescriptorSubtype       : 0x04 (Selector Unit)
bUnitID                  : 0x02
bNrInPins                : 0x01 (1 Input Pin)
List of Connected Unit and Terminal IDs:
baSourceID[1]            : 0x01
iSelector                : 0x00 (No String Descriptor)
Data (HexDump)           : 07 24 04 02 01 01 00                              .$.....

        -------- Video Control Processing Unit Descriptor -----
bLength                  : 0x0D (13 bytes)
bDescriptorType          : 0x24 (Video Control Interface)
bDescriptorSubtype       : 0x05 (Processing Unit)
bUnitID                  : 0x03 (3)
bSourceID                : 0x02 (2)
wMaxMultiplier           : 0x0000
bControlSize             : 0x03 (3 bytes)
bmControls               : 0x00, 0x00, 0x00
 D0                      : 0   no -  Brightness
 D1                      : 0   no -  Contrast
 D2                      : 0   no -  Hue
 D3                      : 0   no -  Saturation
 D4                      : 0   no -  Sharpness
 D5                      : 0   no -  Gamma
 D6                      : 0   no -  White Balance Temperature
 D7                      : 0   no -  White Balance Component
 D8                      : 0   no -  Backlight Compensation
 D9                      : 0   no -  Gain
 D10                     : 0   no -  Power Line Frequency
 D11                     : 0   no -  Hue, Auto
 D12                     : 0   no -  White Balance Temperature, Auto
 D13                     : 0   no -  White Balance Component, Auto
 D14                     : 0   no -  Digital Multiplier
 D15                     : 0   no -  Digital Multiplier Limit
 D16                     : 0   no -  Analog Video Standard
 D17                     : 0   no -  Analog Video Lock Status
 D18                     : 0   no -  Contrast, Auto
 D19                     : 0   no -  Reserved
 D20                     : 0   no -  Reserved
 D21                     : 0   no -  Reserved
 D22                     : 0   no -  Reserved
 D23                     : 0   no -  Reserved
iProcessing              : 0x00 (No String Descriptor)
bmVideoStandards         : 0x00
 D0                      : 0   no -  None
 D1                      : 0   no -  NTSC  - 525/60
 D2                      : 0   no -  PAL   - 625/50
 D3                      : 0   no -  SECAM - 625/50
 D4                      : 0   no -  NTSC  - 625/50
 D5                      : 0   no -  PAL   - 525/60
 D6                      : 0   no -  Reserved
 D7                      : 0   no -  Reserved
Data (HexDump)           : 0D 24 05 03 02 00 00 03 00 00 00 00 00            .$...........

        --------- Video Control Extension Unit Descriptor -----
bLength                  : 0x1D (29 bytes)
bDescriptorType          : 0x24 (Video Control Interface)
bDescriptorSubtype       : 0x06 (Extension Unit)
bUnitID                  : 0x04 (ID 4)
guidExtensionCode        : {00000000-0000-0000-0000-000000000000}
bNumControls             : 0x00 (0 Controls)
bNrInPins                : 0x01 (1 Input Pin)
baSourceID[1]            : 0x03
bControlSize             : 0x04 (4 bytes)
bmControls               : 0x02, 0x00, 0x00, 0x00
 D0                      : 0   no -  Vendor-Specific (Optional)
 D1                      : 1  yes -  Vendor-Specific (Optional)
 D2                      : 0   no -  Vendor-Specific (Optional)
 D3                      : 0   no -  Vendor-Specific (Optional)
 D4                      : 0   no -  Vendor-Specific (Optional)
 D5                      : 0   no -  Vendor-Specific (Optional)
 D6                      : 0   no -  Vendor-Specific (Optional)
 D7                      : 0   no -  Vendor-Specific (Optional)
 D8                      : 0   no -  Vendor-Specific (Optional)
 D9                      : 0   no -  Vendor-Specific (Optional)
 D10                     : 0   no -  Vendor-Specific (Optional)
 D11                     : 0   no -  Vendor-Specific (Optional)
 D12                     : 0   no -  Vendor-Specific (Optional)
 D13                     : 0   no -  Vendor-Specific (Optional)
 D14                     : 0   no -  Vendor-Specific (Optional)
 D15                     : 0   no -  Vendor-Specific (Optional)
 D16                     : 0   no -  Vendor-Specific (Optional)
 D17                     : 0   no -  Vendor-Specific (Optional)
 D18                     : 0   no -  Vendor-Specific (Optional)
 D19                     : 0   no -  Vendor-Specific (Optional)
 D20                     : 0   no -  Vendor-Specific (Optional)
 D21                     : 0   no -  Vendor-Specific (Optional)
 D22                     : 0   no -  Vendor-Specific (Optional)
 D23                     : 0   no -  Vendor-Specific (Optional)
 D24                     : 0   no -  Vendor-Specific (Optional)
 D25                     : 0   no -  Vendor-Specific (Optional)
 D26                     : 0   no -  Vendor-Specific (Optional)
 D27                     : 0   no -  Vendor-Specific (Optional)
 D28                     : 0   no -  Vendor-Specific (Optional)
 D29                     : 0   no -  Vendor-Specific (Optional)
 D30                     : 0   no -  Vendor-Specific (Optional)
 D31                     : 0   no -  Vendor-Specific (Optional)
iExtension               : 0x00 (No String Descriptor)
Data (HexDump)           : 1D 24 06 04 00 00 00 00 00 00 00 00 00 00 00 00   .$..............
                           00 00 00 00 00 01 03 04 02 00 00 00 00            .............

        ------- Video Control Output Terminal Descriptor ------
bLength                  : 0x09 (9 bytes)
bDescriptorType          : 0x24 (Video Control Interface)
bDescriptorSubtype       : 0x03 (Output Terminal)
bTerminalID              : 0x05 (5)
wTerminalType            : 0x0101 (TT_STREAMING)
bAssocTerminal           : 0x01 (Associated with Input Terminal ID=1)
bSourceID                : 0x04 (4)
iTerminal                : 0x00 (No String Descriptor)
Data (HexDump)           : 09 24 03 05 01 01 01 04 00                        .$.......

        ---------------- Interface Descriptor -----------------
bLength                  : 0x09 (9 bytes)
bDescriptorType          : 0x04 (Interface Descriptor)
bInterfaceNumber         : 0x01 (Interface 1)
bAlternateSetting        : 0x00
bNumEndpoints            : 0x01 (1 Endpoint)
bInterfaceClass          : 0x0E (Video)
bInterfaceSubClass       : 0x02 (Video Streaming)
bInterfaceProtocol       : 0x00 (PC_PROTOCOL_UNDEFINED)
iInterface               : 0x00 (No String Descriptor)
Data (HexDump)           : 09 04 01 00 01 0E 02 00 00                        .........

        ---- VC-Specific VS Video Input Header Descriptor -----
bLength                  : 0x0D (13 bytes)
bDescriptorType          : 0x24 (Video Streaming Interface)
bDescriptorSubtype       : 0x01 (Input Header)
bNumFormats              : 0x02
wTotalLength             : 0x0093 (147 bytes)
bEndpointAddress         : 0x81 (Direction=IN  EndpointID=1)
bmInfo                   : 0x00 (Dynamic Format Change not supported)
bTerminalLink            : 0x05 (Output Terminal ID 5)
bStillCaptureMethod      : 0x00 (No Still Capture)
nbTriggerSupport         : 0x00 (Hardware Triggering not supported)
bTriggerUsage            : 0x00 (Host will initiate still image capture)
bControlSize             : 0x00 (0 bytes each)
Video Payload Format 1   : 
Video Payload Format 2   : 
Data (HexDump)           : 0D 24 01 02 93 00 81 00 05 00 00 00 00            .$...........

        ------- VS Uncompressed Format Type Descriptor --------
bLength                  : 0x1B (27 bytes)
bDescriptorType          : 0x24 (Video Streaming Interface)
bDescriptorSubtype       : 0x04 (Uncompressed Format Type)
bFormatIndex             : 0x01 (1)
bNumFrameDescriptors     : 0x01 (1 Frame Descriptor)
guidFormat               : {50424752-0000-0010-8000-00AA00389B71} (RGBP)
bBitsPerPixel            : 0x10 (16 bits per pixel)
bDefaultFrameIndex       : 0x01 (Index 1)
bAspectRatioX            : 0x00
bAspectRatioY            : 0x00
bmInterlaceFlags         : 0x00
 D0 IL stream or variable: 0 (no)
 D1 Fields per frame     : 0 (2 fields)
 D2 Field 1 first        : 0 (no)
 D3 Reserved             : 0
 D4..5 Field pattern     : 0 (Field 1 only)
 D6..7 Display Mode      : 0 (Bob only)
bCopyProtect             : 0x00 (No restrictions)
Data (HexDump)           : 1B 24 04 01 01 52 47 42 50 00 00 10 00 80 00 00   .$...RGBP.......
                           AA 00 38 9B 71 10 01 00 00 00 00                  ..8.q......

        -------- VS Uncompressed Frame Type Descriptor --------
---> This is the Default (optimum) Frame index
bLength                  : 0x26 (38 bytes)
bDescriptorType          : 0x24 (Video Streaming Interface)
bDescriptorSubtype       : 0x05 (Uncompressed Frame Type)
bFrameIndex              : 0x01
bmCapabilities           : 0x00
wWidth                   : 0x0140 (320)
wHeight                  : 0x00F0 (240)
dwMinBitRate             : 0x00025800 (153600 bps -> 19.125 KB/s)
dwMaxBitRate             : 0x00025800 (153600 bps -> 19.125 KB/s)
dwMaxVideoFrameBufferSize: 0x00025800 (153600 bytes)
dwDefaultFrameInterval   : 0x000A2C2A (66.6666 ms -> 15.0000 fps)
bFrameIntervalType       : 0x03 (3 discrete frame intervals supported)
adwFrameInterval[1]      : 0x000A2C2A (66.6666 ms -> 15.0000 fps)
adwFrameInterval[2]      : 0x00028B0A (16.6666 ms -> 60.0000 fps)
*!*ERROR:  adwFrameInterval[2] must be greater than preceding dwFrameInterval[1]
adwFrameInterval[3]      : 0x0001312D (7.8125 ms -> 128.00 fps)
*!*ERROR:  adwFrameInterval[3] must be greater than preceding dwFrameInterval[2]
Data (HexDump)           : 26 24 05 01 00 40 01 F0 00 00 58 02 00 00 58 02   &$...@....X...X.
                           00 00 58 02 00 2A 2C 0A 00 03 2A 2C 0A 00 0A 8B   ..X..*,...*,....
                           02 00 2D 31 01 00                                 ..-1..

        ------- VS Color Matching Descriptor Descriptor -------
bLength                  : 0x06 (6 bytes)
bDescriptorType          : 0x24 (Video Streaming Interface)
bDescriptorSubtype       : 0x0D (Color Matching)
bColorPrimaries          : 0x01 (BT.709, sRGB)
bTransferCharacteristics : 0x01 (BT.709)
bMatrixCoefficients      : 0x04 (SMPTE 170M)
Data (HexDump)           : 06 24 0D 01 01 04                                 .$....

        ------- VS Uncompressed Format Type Descriptor --------
bLength                  : 0x1B (27 bytes)
bDescriptorType          : 0x24 (Video Streaming Interface)
bDescriptorSubtype       : 0x04 (Uncompressed Format Type)
bFormatIndex             : 0x02 (2)
bNumFrameDescriptors     : 0x01 (1 Frame Descriptor)
guidFormat               : {32595559-0000-0010-8000-00AA00389B71} (YUY2)
bBitsPerPixel            : 0x10 (16 bits per pixel)
bDefaultFrameIndex       : 0x01 (Index 1)
bAspectRatioX            : 0x00
bAspectRatioY            : 0x00
bmInterlaceFlags         : 0x00
 D0 IL stream or variable: 0 (no)
 D1 Fields per frame     : 0 (2 fields)
 D2 Field 1 first        : 0 (no)
 D3 Reserved             : 0
 D4..5 Field pattern     : 0 (Field 1 only)
 D6..7 Display Mode      : 0 (Bob only)
bCopyProtect             : 0x00 (No restrictions)
Data (HexDump)           : 1B 24 04 02 01 59 55 59 32 00 00 10 00 80 00 00   .$...YUY2.......
                           AA 00 38 9B 71 10 01 00 00 00 00                  ..8.q......

        -------- VS Uncompressed Frame Type Descriptor --------
---> This is the Default (optimum) Frame index
bLength                  : 0x1E (30 bytes)
bDescriptorType          : 0x24 (Video Streaming Interface)
bDescriptorSubtype       : 0x05 (Uncompressed Frame Type)
bFrameIndex              : 0x01
bmCapabilities           : 0x00
wWidth                   : 0x0140 (320)
wHeight                  : 0x00F0 (240)
dwMinBitRate             : 0x00025800 (153600 bps -> 19.125 KB/s)
dwMaxBitRate             : 0x00025800 (153600 bps -> 19.125 KB/s)
dwMaxVideoFrameBufferSize: 0x00025800 (153600 bytes)
dwDefaultFrameInterval   : 0x000A2C2A (66.6666 ms -> 15.0000 fps)
bFrameIntervalType       : 0x01 (1 discrete frame interval supported)
adwFrameInterval[1]      : 0x000A2C2A (66.6666 ms -> 15.0000 fps)
Data (HexDump)           : 1E 24 05 01 00 40 01 F0 00 00 58 02 00 00 58 02   .$...@....X...X.
                           00 00 58 02 00 2A 2C 0A 00 01 2A 2C 0A 00         ..X..*,...*,..

        ------- VS Color Matching Descriptor Descriptor -------
bLength                  : 0x06 (6 bytes)
bDescriptorType          : 0x24 (Video Streaming Interface)
bDescriptorSubtype       : 0x0D (Color Matching)
bColorPrimaries          : 0x01 (BT.709, sRGB)
bTransferCharacteristics : 0x01 (BT.709)
bMatrixCoefficients      : 0x04 (SMPTE 170M)
Data (HexDump)           : 06 24 0D 01 01 04                                 .$....

        ----------------- Endpoint Descriptor -----------------
bLength                  : 0x07 (7 bytes)
bDescriptorType          : 0x05 (Endpoint Descriptor)
bEndpointAddress         : 0x81 (Direction=IN EndpointID=1)
bmAttributes             : 0x02 (TransferType=Bulk)
wMaxPacketSize           : 0x0040 (64 bytes)
bInterval                : 0x00 (ignored)
Data (HexDump)           : 07 05 81 02 40 00 00                              ....@..

    ----------------- Device Qualifier Descriptor -----------------
Error                    : ERROR_GEN_FAILURE  (because the device is in low power state D2)

      -------------------- String Descriptors -------------------
String descriptors are not available  (because the device is in low power state D2)


        +++++++++++++++++ Device Information ++++++++++++++++++
Friendly Name            : UVC sample
Device Description       : USB Video Device
Device ID                : USB\VID_2FE3&PID_0011&MI_00\6&2D396473&0&0000
Hardware IDs             : USB\VID_2FE3&PID_0011&REV_0401&MI_00 USB\VID_2FE3&PID_0011&MI_00
Driver KeyName           : {ca3e7ab9-b4c3-4ae6-8251-579ef933890f}\0001 (GUID_DEVCLASS_CAMERA)
Driver                   : \SystemRoot\System32\Drivers\usbvideo.sys (Version: 10.0.26100.3624  Date: 2025-04-14  Company: Microsoft Corporation)
Driver Inf               : C:\WINDOWS\inf\usbvideo.inf
Legacy BusType           : PNPBus
Class                    : Camera
Class GUID               : {ca3e7ab9-b4c3-4ae6-8251-579ef933890f} (GUID_DEVCLASS_CAMERA)
Service                  : usbvideo
Enumerator               : USB
Location Info            : 0000.0014.0000.004.000.000.000.000.000
Address                  : 4
Manufacturer Info        : Microsoft
Capabilities             : 0x00 (-)
Status                   : 0x01802400 (DN_HAS_PROBLEM, DN_DISABLEABLE, DN_NT_ENUMERATOR, DN_NT_DRIVER)
Problem Code             : 10 (CM_PROB_FAILED_START)
Lower Filters            : WdmCompanionFilter
EnhancedPowerMgmtEnabled : 0
Power State              : D3 (supported: D0, D3, wake from D0)

6 replies

josuah Apr 17, 2025
Collaborator

Thank you for trying!

For this new "error 10" you had, it seems like the frame interval listed needs to be in increasing order.

intervals supported)
adwFrameInterval[1]      : 0x000A2C2A (66.6666 ms -> 15.0000 fps)
adwFrameInterval[2]      : 0x00028B0A (16.6666 ms -> 60.0000 fps)
*!*ERROR:  adwFrameInterval[2] must be greater than preceding dwFrameInterval[1]
adwFrameInterval[3]      : 0x0001312D (7.8125 ms -> 128.00 fps)
*!*ERROR:  adwFrameInterval[3] must be greater than preceding dwFrameInterval[2]

This sorting is done here which was added somewhat recently:

	/* UVC requires the frame intervals to be sorted, but not Zephyr */
	qsort(desc->dwFrameInterval, desc->bFrameIntervalType,
		sizeof(*desc->dwFrameInterval), uvc_compare_frmival_desc);

The boot banner says 9692ddabc60f, is it possible you are using a slightly older build? Possibly because you wanted to test with a virtual source, which was removed from pr-usb-uvc to facilitate review, and moved to pr-usb-uvc-virtual-source that would be merged after discussion is done.

I will test the 2nd PR again, and provide detailed instructions on this thread in at most 24h.

josuah Apr 17, 2025
Collaborator

I confirm, the 2nd PR works on Windows. Tested on FRDM-MCXN947, but I can test on an STM32 board if you have any issue reproducing it. I tested it on an STM32H743 earlier too.

samples: subsys: usb: uvc: allow a virtual video source to be used #87869

The exact commands I used:

west build --board frdm_mcxn947/mcxn947/cpu0
west flash

You might need to change the board, but not require any other flag (no need to include the app.overlay.

I get a test image like this on Linux or Android:

On Windows, I am unable to open the video stream because Windows chose not to support RGB565. Not a bad decision... just not yet supported by the VIDEO_SW_GENERATOR device. :)

You may try on an Android phone too with applications like these:

My goal is to make UVC as smooth and effortless as possible, so feedback much welcome!

Sambsc19 Apr 17, 2025
Author

Hi @josuah, I fetched and pulled(merged) latest pr-usb-uvc to my branch yesterday so it shouldnt be an old version. I pulled(merged) the virtual-source branch to my base branch just now and I have the same result. I have been using USBOTGFS, I think windows may not accept a UVC device slower than HS. I am almost finished configuring the USBOTGHS for stm32h7s78-dk. I am currently dealing with this build error in udc_stm32.c:


C:/Partition_Environments/Pythons/zephyrproject/zephyr/drivers/usb/udc/udc_stm32.c: In function 'priv_clock_enable':
C:/Partition_Environments/Pythons/zephyrproject/zephyr/drivers/usb/udc/udc_stm32.c:1163:9: warning: implicit declaration of function 'LL_AHB1_GRP1_DisableClockLowPower'; did you mean 'LL_AHB1_GRP1_DisableClockSleep'? [-Wimplicit-function-declaration]
 1163 |         LL_AHB1_GRP1_DisableClockLowPower(LL_AHB1_GRP1_PERIPH_OTGHSULPI);
      |         ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      |         LL_AHB1_GRP1_DisableClockSleep
C:/Partition_Environments/Pythons/zephyrproject/zephyr/drivers/usb/udc/udc_stm32.c:1163:43: error: 'LL_AHB1_GRP1_PERIPH_OTGHSULPI' undeclared (first use in this function); did you mean 'LL_AHB1_GRP1_PERIPH_USBOTGHS'?
 1163 |         LL_AHB1_GRP1_DisableClockLowPower(LL_AHB1_GRP1_PERIPH_OTGHSULPI);
      |                                           ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      |                                           LL_AHB1_GRP1_PERIPH_USBOTGHS
C:/Partition_Environments/Pythons/zephyrproject/zephyr/drivers/usb/udc/udc_stm32.c:1163:43: note: each undeclared identifier is reported only once for each function it appears in
[100/173] Building C object zephyr/subsys/usb/device_next/CMakeFiles/subsys__usb__device_next.dir/class/usbd_uvc.c.obj

my device tree updates:


usb2: &usbotg_hs {
	pinctrl-0 = <&usb_otg_hs_dm_pm5 &usb_otg_hs_dp_pm6>;
	pinctrl-names = "default";
	status = "okay";
};

usbotg_hs: usb@40040000 {
			compatible = "st,stm32-otghs";
			reg = <0x40040000 0x40000>;
			interrupts = <91 0>;
			interrupt-names = "otghs";
			num-bidir-endpoints = <9>;
			ram-size = <4096>;
			maximum-speed = "high-speed";
			phys = <&otgfs_phy>;
			clocks = <&rcc STM32_CLOCK(AHB1, 25U)>,
				 <&rcc STM32_SRC_HSE USBPHYC_SEL(0)>;
			status = "disabled";
		};

#define USBPHYC_SEL(val)	STM32_DT_CLOCK_SELECT((val), 3, 12, D1CCIPR_REG)

udc_stm32.zip

josuah Apr 18, 2025
Collaborator

windows may not accept a UVC device slower than HS.

UVC cannot work at LowSpeed (1.5 Mbit/s), but it was possible to get RPi Pico and nRF52840-Dongle working, both only supporting FullSpeed (12 Mbit/s) at around ~9 FPS at 640x480 using JPEG compression.

I stumbled upon this, which you might have found too:

drivers: usb: stm32: Add explicit dts clocks property for otg hsp ulpi #71248

Would it help to also try the driver with another class like CDC ACM?

Are there other devkits available? Maybe other STM32H7?
I just ordered an STM32H7S78 to reproduce this among other reasons.

Sambsc19 Apr 18, 2025
Author

STM32H7S78 has USB 2.0 HS and the mcu has 600Mhz max clock frequency. this series is targeted precisely at applications such as UVC. I hope using USBOTGHS resolves this issue. I built and tested the CDC ACM app on another h7rs board Nucleo-h7s3l8 in early stages of my project with USB FS, I dont think its necessary to work with that sample now as my udc_stm32.c build error should be common to both apps. I am happy to hear you have ordered a h7s78 board. I will continue working on this over the weekend and update this issue with progress reports

P.S. I am also updating this similar issue: #87070 (review)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Zephyr USB UVC sample video-emul Unaligned memory access error #88730

{{title}}

Replies: 1 comment 6 replies

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{title}}

{{title}}

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

Select a reply

Zephyr USB UVC sample video-emul Unaligned memory access error #88730

Sambsc19 Apr 16, 2025

Replies: 1 comment · 6 replies

Sambsc19 Apr 16, 2025 Author

josuah Apr 17, 2025 Collaborator

josuah Apr 17, 2025 Collaborator

Sambsc19 Apr 17, 2025 Author

josuah Apr 18, 2025 Collaborator

Sambsc19 Apr 18, 2025 Author

Sambsc19
Apr 16, 2025

Replies: 1 comment 6 replies

Sambsc19
Apr 16, 2025
Author

josuah Apr 17, 2025
Collaborator

josuah Apr 17, 2025
Collaborator

Sambsc19 Apr 17, 2025
Author

josuah Apr 18, 2025
Collaborator

Sambsc19 Apr 18, 2025
Author