nuttx-apps/system/usbmsc
xuxin19 c230321cae fix progname do not match issue
Signed-off-by: xuxin19 <xuxin19@xiaomi.com>
2023-09-11 16:37:05 +08:00
..
CMakeLists.txt add initial cmake build system 2023-07-08 13:52:02 +08:00
Kconfig system/usbmsc: set stack size to DEFAULT_TASK_STACKSIZE 2023-04-07 13:45:07 +03:00
Make.defs Makefiles: Gregory Nutt: update licenses to Apache 2021-06-07 21:35:33 -05:00
Makefile fix progname do not match issue 2023-09-11 16:37:05 +08:00
README.md Fix boarctl typos 2022-01-16 08:07:47 +01:00
usbmsc_main.c Indent the define statement by two spaces 2023-05-21 07:39:53 +03:00
usbmsc.h system: nxstyle fixes 2021-06-11 02:42:05 -05:00

System / usbmsc USB storage driver

This add-on registers a block device driver, then exports the block the device using the USB storage class driver. In order to use this add-on, your board-specific logic must provide the function:

void board_usbmsc_initialize(void);

This function will be called by the system/usbmsc indirectly via the boardctl BOARDIOC_USBDEV_CONTROL command in order to do the actual registration of the block device drivers. For examples of the implementation of board_usbmsc_initialize() see boards/arm/lpc214x/mcu123-lpc214x/src/up_usbmsc.c or boards/arm/stm32/stm3210e-eval/src/usbmsc.c.

Configuration options:

  • CONFIG_NSH_BUILTIN_APPS This add-on can be built as two NSH built-in commands if this option is selected: msconn will connect the USB mass storage device; msdis will disconnect the USB storage device.

  • CONFIG_BOARDCTL Enables the boardctl() interfaces.

  • CONFIG_BOARDCTL_USBDEVCTRL Enables the BOARDIOC_USBDEV_CONTROL boardctl() command.

  • CONFIG_SYSTEM_USBMSC_NLUNS Defines the number of logical units (LUNs) exported by the USB storage driver. Each LUN corresponds to one exported block driver (or partition of a block driver). May be 1, 2, or 3. Default is 1.

  • CONFIG_SYSTEM_USBMSC_DEVMINOR1 The minor device number of the block driver for the first LUN. For example, N in /dev/mmcsdN. Used for registering the block driver. Default is zero.

  • CONFIG_SYSTEM_USBMSC_DEVPATH1 The full path to the registered block driver. Default is /dev/mmcsd0

  • CONFIG_SYSTEM_USBMSC_DEVMINOR2 and CONFIG_SYSTEM_USBMSC_DEVPATH2 Similar parameters that would have to be provided if CONFIG_SYSTEM_USBMSC_NLUNS is 2 or 3. No defaults.

  • CONFIG_SYSTEM_USBMSC_DEVMINOR3 and CONFIG_SYSTEM_USBMSC_DEVPATH3 Similar parameters that would have to be provided if CONFIG_SYSTEM_USBMSC_NLUNS is 3. No defaults.

  • CONFIG_SYSTEM_USBMSC_DEBUGMM Enables some debug tests to check for memory usage and memory leaks.

If CONFIG_USBDEV_TRACE is enabled (or CONFIG_DEBUG_FEATURES and CONFIG_DEBUG_USB), then the code will also manage the USB trace output. The amount of trace output can be controlled using:

  • CONFIG_SYSTEM_USBMSC_TRACEINIT Show initialization events.
  • CONFIG_SYSTEM_USBMSC_TRACECLASS Show class driver events.
  • CONFIG_SYSTEM_USBMSC_TRACETRANSFERS Show data transfer events.
  • CONFIG_SYSTEM_USBMSC_TRACECONTROLLER Show controller events.
  • CONFIG_SYSTEM_USBMSC_TRACEINTERRUPTS Show interrupt-related events.

Error results are always shown in the trace output

Note 1: When built as an NSH add-on command (CONFIG_NSH_BUILTIN_APPS=y), Caution should be used to assure that the SD drive (or other storage device) is not in use when the USB storage device is configured. Specifically, the SD driver should be unmounted like:

nsh> mount -t vfat /dev/mmcsd0 /mnt/sdcard  # Card is mounted in NSH
...
nsh> umount /mnd/sdcard                     # Unmount before connecting USB!!!
nsh> msconn                                 # Connect the USB storage device
...
nsh> msdis                                  # Disconnect USB storate device
nsh> mount -t vfat /dev/mmcsd0 /mnt/sdcard  # Restore the mount

Failure to do this could result in corruption of the SD card format.

Note 2: This add-on used internal USB device driver interfaces. As such, it relies on internal OS interfaces that are not normally available to a user-space program. As a result, this add-on cannot be used if a NuttX is built as a protected, supervisor kernel (CONFIG_BUILD_PROTECTED or CONFIG_BUILD_KERNEL).