usb: device_next: new USB Video Class implementation

Introduce a new USB Video Class (UVC) implementation from scratch.
It exposes a native Zephyr Video driver interface, allowing to call the
video_enqueue()/video_dequeue() interface. It will query the attached
video device to learn about the pipeline capabilities, and use this to
configure the USB descriptors. At runtime, this UVC implementation will
send this device all the control requests, which it can then dispatch to
the rest of the pipeline. The application can poll the format currently
selected by the host, but will not be alerted when the host configures
a new format, as there is no video.h API for it yet.

Signed-off-by: Josuah Demangeon <[email protected]>

Author: josuah

dts/bindings/usb/zephyr,uvc-device.yaml

@@ -0,0 +1,12 @@
+# Copyright (c) 2025 tinyVision.ai Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+description: |
+  Declare an USB Video Class (UVC) device instance.
+
+  Each UVC instance added to the USB Device Controller (UDC) node will be visible
+  as a new camera from the host point of view.
+
+compatible: "zephyr,uvc-device"
+
+include: base.yaml

include/zephyr/usb/class/usbd_uvc.h

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2025 tinyVision.ai Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @file
+ * @brief USB Device Firmware Upgrade (DFU) public header
+ *
+ * Header exposes API for registering DFU images.
+ */
+
+#ifndef ZEPHYR_INCLUDE_USB_CLASS_USBD_UVC_H
+#define ZEPHYR_INCLUDE_USB_CLASS_USBD_UVC_H
+
+#include <zephyr/kernel.h>
+
+void uvc_set_video_dev(const struct device *const dev, const struct device *const video_dev);
+
+#endif /* ZEPHYR_INCLUDE_USB_CLASS_USBD_UVC_H */

subsys/usb/device_next/CMakeLists.txt

@@ -78,6 +78,11 @@ zephyr_library_sources_ifdef(
   class/usbd_midi2.c
 )
 
+zephyr_library_sources_ifdef(
+	CONFIG_USBD_VIDEO_CLASS
+	class/usbd_uvc.c
+)
+
 zephyr_library_sources_ifdef(
 	CONFIG_USBD_HID_SUPPORT
 	class/usbd_hid.c

subsys/usb/device_next/class/Kconfig

@@ -12,3 +12,4 @@ rsource "Kconfig.uac2"
 rsource "Kconfig.hid"
 rsource "Kconfig.midi2"
 rsource "Kconfig.dfu"
+rsource "Kconfig.uvc"

subsys/usb/device_next/class/Kconfig.uvc

@@ -0,0 +1,56 @@
+# Copyright (c) 2025 tinyVision.ai Inc.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+config USBD_VIDEO_CLASS
+	bool "USB Video Class implementation [EXPERIMENTAL]"
+	depends on DT_HAS_ZEPHYR_UVC_DEVICE_ENABLED
+	select EXPERIMENTAL
+	help
+	  USB Device Video Class (UVC) implementation.
+
+if USBD_VIDEO_CLASS
+
+config USBD_VIDEO_HEADER_SIZE
+	int "USB Video payload header size"
+	range 2 255
+	default 8
+	help
+	  Sets the size of the video payload header to allow custom data to be
+	  added after the mandatory fields.
+	  The default value is arbitrary, made to fit situations, preserving a
+	  64-bit alignment of the payload data for ease of debugging.
+
+config USBD_VIDEO_MAX_FORMATS
+	int "Max number of format descriptors"
+	range 1 254
+	default 32
+	help
+	  The table of format descriptors are generated at runtime. This options plans the
+	  storage at build time to allow enough descriptors to be generated. The default value
+	  aims a compromise between enough descriptors for most devices, but not too much memory
+	  being used.
+
+config USBD_VIDEO_MAX_FRMIVAL
+	int "Max number of video output stream per USB Video interface"
+	range 1 255
+	default 8
+	help
+	  Max number of Frame Interval listed on a frame descriptor. The
+	  default value is selected arbitrarily to fit most situations without
+	  requiring too much RAM.
+
+config USBD_VIDEO_NUM_BUFS
+	int "Max number of buffers the UVC class can allocate"
+	default 16
+	help
+	  Control the number of buffer UVC can allocate in parallel.
+	  The default is a compromise to allow enough concurrent buffers but not too much
+	  memory usage.
+
+module = USBD_VIDEO
+module-str = usbd uvc
+default-count = 1
+source "subsys/logging/Kconfig.template.log_config"
+
+endif # USBD_VIDEO_CLASS