doc: usb: include new MSC device API

Add doxygen group with MSC device API and document macro to create
mapping between disk access and MSC LUN.

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

Author: tmon-nordic

doc/connectivity/usb/device_next/api/index.rst

@@ -10,3 +10,4 @@ New USB device support APIs
    usbd.rst
    usbd_hid_device.rst
    uac2_device.rst
+   usbd_msc_device.rst

doc/connectivity/usb/device_next/api/usbd_msc_device.rst

@@ -0,0 +1,12 @@
+.. _usbd_msc_device:
+
+USB Mass Storage Class device API
+#################################
+
+USB Mass Storage Class device API defined in
+:zephyr_file:`include/zephyr/usb/class/usbd_msc.h`.
+
+API Reference
+*************
+
+.. doxygengroup:: usbd_msc_device

doc/connectivity/usb/device_next/usb_device.rst

@@ -41,7 +41,7 @@ instance (`n`) and is used as an argument to the :c:func:`usbd_register_class`.
 +-----------------------------------+-------------------------+-------------------------+
 | USB CDC ECM class                 | Ethernet device         | :samp:`cdc_ecm_{n}`     |
 +-----------------------------------+-------------------------+-------------------------+
-| USB Mass Storage Class (MSC)      | :ref:`disk_access_api`  | :samp:`msc_{n}`         |
+| USB Mass Storage Class (MSC)      | :ref:`usbd_msc_device`  | :samp:`msc_{n}`         |
 +-----------------------------------+-------------------------+-------------------------+
 | USB Human Interface Devices (HID) | :ref:`usbd_hid_device`  | :samp:`hid_{n}`         |
 +-----------------------------------+-------------------------+-------------------------+

include/zephyr/usb/class/usbd_msc.h

@@ -23,6 +23,25 @@ struct usbd_msc_lun {
 	const char *revision;
 };
 
+/**
+ * @brief USB Mass Storage Class device API
+ * @defgroup usbd_msc_device USB Mass Storage Class device API
+ * @ingroup usb
+ * @{
+ */
+
+/**
+ * @brief Define USB Mass Storage Class logical unit
+ *
+ * Use this macro to create Logical Unit mapping in USB MSC for selected disk.
+ * Up to `CONFIG_USBD_MSC_LUNS_PER_INSTANCE` disks can be registered on single
+ * USB MSC instance. Currently only one USB MSC instance is supported.
+ *
+ * @param disk_name Disk name as used in @ref disk_access_interface
+ * @param t10_vendor T10 Vendor Indetification
+ * @param t10_product T10 Product Identification
+ * @param t10_revision T10 Product Revision Level
+ */
 #define USBD_DEFINE_MSC_LUN(disk_name, t10_vendor, t10_product, t10_revision)	\
 	STRUCT_SECTION_ITERABLE(usbd_msc_lun, usbd_msc_lun_##disk_name) = {	\
 		.disk = STRINGIFY(disk_name),					\
@@ -31,4 +50,8 @@ struct usbd_msc_lun {
 		.revision = t10_revision,					\
 	}
 
+/**
+ * @}
+ */
+
 #endif /* ZEPHYR_INCLUDE_USB_CLASS_USBD_MSC_H_ */