feat(docs): Add description and references to new usbsdmux storage driver

Signed-off-by: Jan Kiszka <[email protected]>

Author: jan-kiszka

Kconfig

@@ -135,8 +135,8 @@ config CONSOLE_VARIANT
     string "Console variant"
     default "qemu"
     help
-      Select a shared storage variant from 'docker', 'qemu', 'samsung'
-      and 'usbf'.
+      Select a shared storage variant from 'docker', 'qemu', 'samsung',
+      'usbsdmux' and 'usbf'.
 endmenu
 
 menu "Video Settings"

docs/config.rst

@@ -128,8 +128,8 @@ General settings
     selected with ``variant``.
 
   * ``variant``: string [required]
-      Select a shared storage variant from ``docker``, ``qemu``, ``samsung``
-      and ``usbf``.
+      Select a shared storage variant from ``docker``, ``qemu``, ``samsung``,
+      ``usbsdmux`` and ``usbf``.
 
 * ``usb``: section [optional]
     Specify how many USB ports may be controlled from this agent.
@@ -388,6 +388,21 @@ a SD card between the DUT and host. The following settings are supported:
   Identifier of the sdmux/sdwire device to use. Use ``sd-mux-ctrl`` to list
   available devices. When not specified, the first device is auto-detected.
 
+``usbsdmux`` driver settings
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The ``usbsdmux`` driver supports SD card switcher based on the Microchip
+USB2642 card reader chip. A tool with this name is available for several
+distributions and via pip. The following settings are supported:
+
+* ``device``: string [optional]
+  Block device for the shared storage as seen on the host (defaults to
+  ``/dev/sda``)
+
+* ``control-device``: string [optional]
+  Control device used for talking to the switcher on the host (defaults to
+  ``/dev/sg0``)
+
 ``usbf`` driver settings
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

mtda.ini

@@ -159,6 +159,7 @@ variant=aviosys_8800
 #    - docker 
 #    - qemu
 #    - samsung
+#    - usbsdmux
 #    - usbf
 # ---------------------------------------------------------------------------
 # Note: this section is ignored when connecting to a remote agent