usb: mark new stack as unstable and set it as the default

jfischer-no · cfriedt · commit efaaad0a095a · 2025-08-06T11:57:39.000-04:00
Document that the legacy stack is now deprecated.

Signed-off-by: Johann Fischer &lt;johann.fischer@nordicsemi.no&gt;
diff --git a/doc/connectivity/usb/device/api/index.rst b/doc/connectivity/usb/device/api/index.rst
@@ -1,7 +1,7 @@
 .. _usb_api:
 
-USB device support APIs
-#######################
+USB device support APIs (deprecated)
+####################################
 
 .. toctree::
    :maxdepth: 1
diff --git a/doc/connectivity/usb/device/api/usb_dc.rst b/doc/connectivity/usb/device/api/usb_dc.rst
@@ -1,7 +1,7 @@
 .. _usb_dc_api:
 
-USB device controller driver API
-################################
+USB device controller driver API (deprecated)
+#############################################
 
 The USB device controller driver API is described in
 :zephyr_file:`include/zephyr/drivers/usb/usb_dc.h` and sometimes referred to
diff --git a/doc/connectivity/usb/device/api/usb_device.rst b/doc/connectivity/usb/device/api/usb_device.rst
@@ -1,7 +1,7 @@
 .. _usb_device_stack_api:
 
-USB device stack API
-####################
+USB device stack API (deprecated)
+#################################
 
 API reference
 *************
diff --git a/doc/connectivity/usb/device/api/usb_device_bos.rst b/doc/connectivity/usb/device/api/usb_device_bos.rst
@@ -1,7 +1,7 @@
 .. _usb_bos_api:
 
-Binary Device Object Store (BOS) support API
-############################################
+Binary Device Object Store (BOS) support API (deprecated)
+#########################################################
 
 API reference
 *************
diff --git a/doc/connectivity/usb/device/api/usb_device_hid.rst b/doc/connectivity/usb/device/api/usb_device_hid.rst
@@ -1,7 +1,7 @@
 .. _usb_hid_device:
 
-USB HID Class API
-#################
+USB HID Class API (deprecated)
+##############################
 
 USB device specific part for HID support defined in
 :zephyr_file:`include/zephyr/usb/class/usb_hid.h`.
diff --git a/doc/connectivity/usb/device/usb_device.rst b/doc/connectivity/usb/device/usb_device.rst
@@ -1,7 +1,7 @@
 .. _usb_device_stack:
 
-USB device support
-##################
+USB device support (deprecated)
+###############################
 
 .. contents::
     :local:
@@ -26,10 +26,9 @@ over time. It provides the following functionalities:
   :zephyr_file:`include/zephyr/usb/usb_device.h`
 
 .. note::
-   It is planned to deprecate all APIs listed in :ref:`usb_api` and the
-   functions that depend on them between Zephyr v4.1.0 and v4.2.0, and remove
-   them in v4.4.0. The new USB device support, represented by the APIs in
-   :ref:`usb_device_next_api`, will become the default in Zephyr v4.2.0.
+   All APIs listed in :ref:`usb_api` and the functions that depend on them are
+   deprecated and will be remove in v4.4.0. Please use the new USB device
+   support represented by the APIs in :ref:`usb_device_next_api`.
 
 Supported USB classes
 *********************
diff --git a/doc/connectivity/usb/device_next/api/index.rst b/doc/connectivity/usb/device_next/api/index.rst
@@ -1,7 +1,7 @@
 .. _usb_device_next_api:
 
-New USB device support APIs
-###########################
+USB device support APIs
+#######################
 
 .. toctree::
    :maxdepth: 1
diff --git a/doc/connectivity/usb/device_next/api/udc.rst b/doc/connectivity/usb/device_next/api/udc.rst
@@ -7,7 +7,7 @@ The USB device controller driver API is described in
 :zephyr_file:`include/zephyr/drivers/usb/udc.h` and referred to
 as the ``UDC driver`` API.
 
-UDC driver API is experimental and is subject to change without notice.
+UDC driver API is unstable and is subject to change without notice.
 It is a replacement for :ref:`usb_dc_api`. If you wish to port an existing
 driver to UDC driver API, or add a new driver, please use
 :zephyr_file:`drivers/usb/udc/udc_skeleton.c` as a starting point.
diff --git a/doc/connectivity/usb/device_next/api/usbd.rst b/doc/connectivity/usb/device_next/api/usbd.rst
@@ -1,9 +1,9 @@
 .. _usbd_api:
 
-USB device stack (next) API
-###########################
+USB device stack API
+####################
 
-New USB device stack API is experimental and is subject to change without notice.
+USB device stack API is unstable and is subject to change without notice.
 
 API reference
 *************
diff --git a/doc/connectivity/usb/device_next/usb_device.rst b/doc/connectivity/usb/device_next/usb_device.rst
@@ -1,7 +1,7 @@
 .. _usb_device_stack_next:
 
-New USB device support
-######################
+USB device support
+##################
 
 Overview
 ********
@@ -10,19 +10,16 @@ USB device support consists of the USB device controller (UDC) drivers
 , :ref:`udc_api`, and USB device stack, :ref:`usbd_api`.
 The :ref:`udc_api` provides a generic and vendor independent interface to USB
 device controllers, and although, there a is clear separation between these
-layers, the purpose of :ref:`udc_api` is to serve new Zephyr's USB device stack
+layers, the purpose of :ref:`udc_api` is to serve Zephyr's USB device stack
 exclusively.
 
-The new device stack supports multiple device controllers, meaning that if a
+The device stack supports multiple device controllers, meaning that if a
 SoC has multiple controllers, they can be used simultaneously. Full and
 high-speed device controllers are supported. It also provides support for
 registering multiple function or class instances to a configuration at runtime,
 or changing the configuration later. It has built-in support for several USB
 classes and provides an API to implement custom USB functions.
 
-The new USB device support is considered experimental and will replace
-:ref:`usb_device_stack`.
-
 Samples
 =======
 
@@ -34,13 +31,6 @@ Samples
 
 * :zephyr:code-sample:`uvc`
 
-Samples ported to new USB device support
-----------------------------------------
-
-To build a sample that supports both the old and new USB device stack, set the
-configuration ``-DCONF_FILE=usbd_next_prj.conf`` either directly or via
-``west``.
-
 * :zephyr:code-sample:`bluetooth_hci_usb`
 
 * :zephyr:code-sample:`usb-cdc-acm`
@@ -51,7 +41,7 @@ configuration ``-DCONF_FILE=usbd_next_prj.conf`` either directly or via
 
 * :zephyr:code-sample:`usb-hid-mouse`
 
-* :zephyr:code-sample:`zperf` To build the sample for the new device support,
+* :zephyr:code-sample:`zperf` To build the sample for the device support,
   set the configuration overlay file
   ``-DDEXTRA_CONF_FILE=overlay-usbd_next_ecm.conf`` and devicetree overlay file
   ``-DDTC_OVERLAY_FILE="usbd_next_ecm.overlay`` either directly or via ``west``.
diff --git a/doc/connectivity/usb/index.rst b/doc/connectivity/usb/index.rst
@@ -3,15 +3,15 @@
 USB
 ###
 
-**USB device support**
+**Legacy USB device support**
 
 .. toctree::
    :maxdepth: 1
 
    device/usb_device.rst
    device/api/index.rst
 
-**New experimental USB support**
+**USB support**
 
 .. toctree::
    :maxdepth: 1
diff --git a/drivers/usb/udc/Kconfig b/drivers/usb/udc/Kconfig
@@ -3,8 +3,7 @@
 
 
 menuconfig UDC_DRIVER
-	bool "USB device controller drivers [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "USB device controller drivers"
 	select NET_BUF
 	help
 	  USB device controller driver.
diff --git a/include/zephyr/usb/class/usbd_dfu.h b/include/zephyr/usb/class/usbd_dfu.h
@@ -111,6 +111,8 @@ struct usbd_dfu_image {
  * @brief USB DFU device update API
  * @defgroup usbd_dfu USB DFU device update API
  * @ingroup usb
+ * @since 4.1
+ * @version 0.1.0
  * @{
  */
 
diff --git a/include/zephyr/usb/class/usbd_hid.h b/include/zephyr/usb/class/usbd_hid.h
@@ -25,7 +25,7 @@ extern "C" {
  * @defgroup usbd_hid_device USBD HID device API
  * @ingroup usb
  * @since 3.7
- * @version 0.1.1
+ * @version 0.2.0
  * @{
  */
 
diff --git a/include/zephyr/usb/class/usbd_msc.h b/include/zephyr/usb/class/usbd_msc.h
@@ -28,7 +28,7 @@ struct usbd_msc_lun {
  * @defgroup usbd_msc_device USB Mass Storage Class device API
  * @ingroup usb
  * @since 3.4
- * @version 0.1.0
+ * @version 0.2.0
  * @{
  */
 
diff --git a/include/zephyr/usb/class/usbd_uac2.h b/include/zephyr/usb/class/usbd_uac2.h
@@ -24,7 +24,7 @@
  * @defgroup uac2_device USB Audio Class 2 device API
  * @ingroup usb
  * @since 3.6
- * @version 0.1.0
+ * @version 0.2.0
  * @{
  */
 
diff --git a/include/zephyr/usb/usbd.h b/include/zephyr/usb/usbd.h
@@ -6,7 +6,7 @@
 
 /**
  * @file
- * @brief New experimental USB device stack APIs and structures
+ * @brief New USB device stack APIs and structures
  *
  * This file contains the USB device stack APIs and structures.
  */
@@ -33,7 +33,7 @@ extern "C" {
  * @defgroup usbd_api USB device core API
  * @ingroup usb
  * @since 3.3
- * @version 0.1.0
+ * @version 0.2.0
  * @{
  */
 
diff --git a/include/zephyr/usb/usbd_msg.h b/include/zephyr/usb/usbd_msg.h
@@ -22,7 +22,7 @@ extern "C" {
  * @defgroup usbd_msg_api USB device core API
  * @ingroup usb
  * @since 3.7
- * @version 0.1.0
+ * @version 0.2.0
  * @{
  */
 
diff --git a/subsys/usb/device_next/Kconfig b/subsys/usb/device_next/Kconfig
@@ -3,12 +3,11 @@
 # SPDX-License-Identifier: Apache-2.0
 
 menuconfig USB_DEVICE_STACK_NEXT
-	bool "New USB device stack [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "New USB device stack"
 	select UDC_DRIVER
 	imply HWINFO
 	help
-	  New experimental USB device stack.
+	  New USB device stack.
 
 if USB_DEVICE_STACK_NEXT
 
diff --git a/subsys/usb/device_next/class/Kconfig.cdc_acm b/subsys/usb/device_next/class/Kconfig.cdc_acm
@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: Apache-2.0
 
 config USBD_CDC_ACM_CLASS
-	bool "USB CDC ACM implementation [EXPERIMENTAL]"
+	bool "USB CDC ACM implementation"
 	depends on SERIAL
 	depends on DT_HAS_ZEPHYR_CDC_ACM_UART_ENABLED
 	select SERIAL_HAS_DRIVER
diff --git a/subsys/usb/device_next/class/Kconfig.cdc_ecm b/subsys/usb/device_next/class/Kconfig.cdc_ecm
@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: Apache-2.0
 
 config USBD_CDC_ECM_CLASS
-	bool "USB CDC ECM implementation [EXPERIMENTAL]"
+	bool "USB CDC ECM implementation"
 	default y
 	depends on NET_L2_ETHERNET
 	depends on DT_HAS_ZEPHYR_CDC_ECM_ETHERNET_ENABLED
diff --git a/subsys/usb/device_next/class/Kconfig.cdc_ncm b/subsys/usb/device_next/class/Kconfig.cdc_ncm
@@ -3,11 +3,10 @@
 # SPDX-License-Identifier: Apache-2.0
 
 config USBD_CDC_NCM_CLASS
-	bool "USB CDC NCM implementation [EXPERIMENTAL]"
+	bool "USB CDC NCM implementation"
 	default y
 	depends on NET_L2_ETHERNET
 	depends on DT_HAS_ZEPHYR_CDC_NCM_ETHERNET_ENABLED
-	select EXPERIMENTAL
 	help
 	  USB CDC Network Control Model (NCM) implementation
 
diff --git a/subsys/usb/device_next/class/Kconfig.msc b/subsys/usb/device_next/class/Kconfig.msc
@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: Apache-2.0
 
 config USBD_MSC_CLASS
-	bool "USB Mass Storage Device class support [EXPERIMENTAL]"
+	bool "USB Mass Storage Device class support"
 	select DISK_ACCESS
 	help
 	  USB Mass Storage device class support.
diff --git a/subsys/usb/device_next/class/Kconfig.uac2 b/subsys/usb/device_next/class/Kconfig.uac2
@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: Apache-2.0
 
 config USBD_AUDIO2_CLASS
-	bool "USB Audio 2 class support [EXPERIMENTAL]"
+	bool "USB Audio 2 class support"
 	select UDC_ENABLE_SOF
 	help
 	  USB Audio 2 device class support.
