Site Tools


nas-usb

This is an old revision of the document!


USB Support

The USB Support menu is divided into sections, including USB Support and Attached Devices. These sections include settings to enable or disable USB port support, configure USB-related printers and configure settings for USB-attached storage. There are also settings to support 3G/4G/5G USB modems.

USB Support

Core USB Support: Checking this enables the USB driver/services for USB-equipped hardware. When enabled, specific options appear for configuration. These depend on your router hardware.


  • USB 3.0 Support - Enables USB 3.x (xHCI) operation
    on USB 3.0 (or higher) ports. (Default: enabled)
  • USB 2.0 Support - Enables USB 2.0 (EHCI) operation. (Default: enabled)
  • USB 1.1 Support - Each option enables support for that mode of USB 1.1.
    • (OHCI) - enables OHCI support on USB 1.x (or higher) USB ports.
    • (UHCI) - enables UHCI support on USB 2.x (higher) USB ports.
      (Default: Disabled)




USB Printer Support: Checking this loads the driver for USB printing support. (Default: ).

  • Bidirectional copying: Enables bidirectional communications on the USB
    printer connection. Modern USB printers can communicate in two directions:
    The printer receives a print job/metadata from the PC or client and the printer
    transmits status messages back to the driver about job status, ink or toner levels.
    Disabling this may help some printers work better when connected to FreshTomato.
    (Default: Enabled).


USB Storage Support: Checking this enables driver/service support for USB storage. (Default: ).

  • File Systems Support: Checking an option loads drivers/support for that filesystem:

    • Ext2 / Ext3 - Loads support for accessing media with Ext2 and Ext3 filesystems.
      Such partitions are usually created in Linux/Unix/BSD and similar systems. (Default: ).

    • NTFS - Enabling this loads support for media formatted with Microsoft's NTFS filesystem.
      Mostly, this provides compatibility with media formatted in Windows (since NT). (Default: ).

    • FAT - Enables support for the FAT filesystem, mostly for compatibility with flash drives.
      FAT is also used on SD, CompactFlash, MMC and other flash memory cards.
      FAT doesn't support symbolic links, thus limits your ability to use programs like Entware
      or TTB. It shouldn't be your first choice. (Default: ).

    • Automount - Makes FreshTomato automatically mount partitions detected when
      a USB drive is inserted or during boot to mount points in subdirectories of “/mnt”.
      (Default: Enabled).

    • Run after mounting - Here, enter a script/shell command series to run when USB
      storage is mounted.

    • Run before unmounting - Here, enter a script/series of commands to run before
      USB storage is unmounted.


Hotplug script: Here, enter shell commands to execute when a USB device is attached/removed.


HDD Spindown: Checking this makes FreshTomato spin down idle mechanical drives.

This is not needed on solid state drives, like SSDs or flash drives, as they have no motors.

(Default: Enabled).


3G/4G/(5G) Modem Support: Enables support for 3G/4G/(5G) USB modem dongles.

This lets you use a cellular carrier as an Internet provider. For details on 3G/4G modem
settings, see the WAN Settings
section on the Network page. Supported USB modems
are listed on the 3G/4G/5G compatibility page.

Attached Devices

The Attached Devices section contains a table of devices FreshTomato detects are attached to its USB ports.

The table has columns describing the device Type and the Host controller on which the device was detected. There is also a column containing a plain English Description of the media found and its status of mounted/unmounted.




If a drive isn't mounted, clicking the [Mount] option beside it mounts the drive to a mount point.

If a drive is mounted, clicking [Unmount] will unmount the drive, so it's ready to remove/disconnect.

USB Support Notes

Some USB storage settings require the unloading/reloading of USB storage drivers. Changing those settings can affect the contents of your system log (syslog) file. For example, enabling or disabling filesystems, or unmounting the drive where the system log is stored may cause storage errors and possibly loss of log content.

Before changing any USB filesystem settings, you should first reconfigure syslog to be stored (temporarily) in RAM. Only then should you adjust filesystem settings or unmount the drive. Then you can configure syslog to again store log files on USB storage, where it shouldn't be interrupted.

USB filesystem corruption is a very common cause of system instability. You could experience a VPN connectivity issue, WiFi instability or any other seemingly “random” problem directly or indirectly caused by USB filesystem issues. When troubleshooting, you are advised to add USB filesystem checks to your troubleshooting checklist.



nas-usb.1729103870.txt.gz · Last modified: 2024/10/16 19:37 by hogwild