doc: connectivity: move USB-C device stack to USB chapter

This looks a bit lost in its own USB-C chapter,
move it to USB under the Power Delivery heading.

Signed-off-by: Johann Fischer <[email protected]>

Author: jfischer-no

MAINTAINERS.yml

@@ -2636,7 +2636,7 @@ USB-C:
     - include/zephyr/usb_c/
     - samples/subsys/usb_c/
     - subsys/usb/usb_c/
-    - doc/connectivity/usb_c/
+    - doc/connectivity/usb/pd/
   labels:
     - "area: USB-C"
 

doc/connectivity/index.rst

@@ -10,4 +10,3 @@ Connectivity
    networking/index.rst
    lora_lorawan/index.rst
    usb/index.rst
-   usb_c/index.rst

doc/connectivity/usb/index.rst

@@ -20,6 +20,13 @@ USB
    device_next/api/index.rst
    host/api/index.rst
 
+**USB Power Delivery support**
+
+.. toctree::
+   :maxdepth: 1
+
+   pd/ucds.rst
+
 **Common sections related to USB support**
 
 .. toctree::

doc/connectivity/usb_c/ucds.rst renamed to doc/connectivity/usb/pd/ucds.rst

@@ -1,4 +1,4 @@
-.. _usbc_device_stack:
+.. _usbc_api:
 
 USB-C device stack
 ##################
@@ -36,7 +36,7 @@ For example, for the Sample USB-C Sink application:
 Each Physical Type-C port is represented in the devicetree by a usb-c-connector
 compatible node:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/sink/boards/b_g474e_dpow1.overlay
+.. literalinclude:: ../../../../samples/subsys/usb_c/sink/boards/b_g474e_dpow1.overlay
    :language: dts
    :start-after: usbc.rst usbc-port start
    :end-before: usbc.rst usbc-port end
@@ -45,7 +45,7 @@ compatible node:
 VBUS is measured by a device that's referenced in the devicetree by a
 usb-c-vbus-adc compatible node:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/sink/boards/b_g474e_dpow1.overlay
+.. literalinclude:: ../../../../samples/subsys/usb_c/sink/boards/b_g474e_dpow1.overlay
    :language: dts
    :start-after: usbc.rst vbus-voltage-divider-adc start
    :end-before: usbc.rst vbus-voltage-divider-adc end
@@ -55,55 +55,55 @@ usb-c-vbus-adc compatible node:
 A user defined structure is defined and later registered with the subsystem and can
 be accessed from callback through an API:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/sink/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/sink/src/main.c
    :language: c
    :start-after: usbc.rst port data object start
    :end-before: usbc.rst port data object end
    :linenos:
 
 These callbacks are used by the subsystem to set or get application specific data:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/sink/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/sink/src/main.c
    :language: c
    :start-after: usbc.rst callbacks start
    :end-before: usbc.rst callbacks end
    :linenos:
 
 This callback is used by the subsystem to query if a certain action can be taken:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/sink/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/sink/src/main.c
    :language: c
    :start-after: usbc.rst check start
    :end-before: usbc.rst check end
    :linenos:
 
 This callback is used by the subsystem to notify the application of an event:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/sink/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/sink/src/main.c
    :language: c
    :start-after: usbc.rst notify start
    :end-before: usbc.rst notify end
    :linenos:
 
 Registering the callbacks:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/sink/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/sink/src/main.c
    :language: c
    :start-after: usbc.rst register start
    :end-before: usbc.rst register end
    :linenos:
 
 Register the user defined structure:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/sink/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/sink/src/main.c
    :language: c
    :start-after: usbc.rst user data start
    :end-before: usbc.rst user data end
    :linenos:
 
 Start the USB-C subsystem:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/sink/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/sink/src/main.c
    :language: c
    :start-after: usbc.rst usbc start
    :end-before: usbc.rst usbc end
@@ -126,7 +126,7 @@ For example, for the Sample USB-C Source application:
 Each Physical Type-C port is represented in the devicetree by a ``usb-c-connector``
 compatible node:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/source/boards/stm32g081b_eval.overlay
+.. literalinclude:: ../../../../samples/subsys/usb_c/source/boards/stm32g081b_eval.overlay
    :language: dts
    :start-after: usbc.rst usbc-port start
    :end-before: usbc.rst usbc-port end
@@ -135,7 +135,7 @@ compatible node:
 VBUS is measured by a device that's referenced in the devicetree by a
 ``usb-c-vbus-adc`` compatible node:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/source/boards/stm32g081b_eval.overlay
+.. literalinclude:: ../../../../samples/subsys/usb_c/source/boards/stm32g081b_eval.overlay
    :language: dts
    :start-after: usbc.rst vbus-voltage-divider-adc start
    :end-before: usbc.rst vbus-voltage-divider-adc end
@@ -145,55 +145,55 @@ VBUS is measured by a device that's referenced in the devicetree by a
 A user defined structure is defined and later registered with the subsystem and can
 be accessed from callback through an API:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/source/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/source/src/main.c
    :language: c
    :start-after: usbc.rst port data object start
    :end-before: usbc.rst port data object end
    :linenos:
 
 These callbacks are used by the subsystem to set or get application specific data:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/source/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/source/src/main.c
    :language: c
    :start-after: usbc.rst callbacks start
    :end-before: usbc.rst callbacks end
    :linenos:
 
 This callback is used by the subsystem to query if a certain action can be taken:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/source/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/source/src/main.c
    :language: c
    :start-after: usbc.rst check start
    :end-before: usbc.rst check end
    :linenos:
 
 This callback is used by the subsystem to notify the application of an event:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/source/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/source/src/main.c
    :language: c
    :start-after: usbc.rst notify start
    :end-before: usbc.rst notify end
    :linenos:
 
 Registering the callbacks:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/source/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/source/src/main.c
    :language: c
    :start-after: usbc.rst register start
    :end-before: usbc.rst register end
    :linenos:
 
 Register the user defined structure:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/source/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/source/src/main.c
    :language: c
    :start-after: usbc.rst user data start
    :end-before: usbc.rst user data end
    :linenos:
 
 Start the USB-C subsystem:
 
-.. literalinclude:: ../../../samples/subsys/usb_c/source/src/main.c
+.. literalinclude:: ../../../../samples/subsys/usb_c/source/src/main.c
    :language: c
    :start-after: usbc.rst usbc start
    :end-before: usbc.rst usbc end