Site Tools


USB Support

The USB Support menu is divided into sections, including USB Support and Attached Devices. The sections includes settings to enable or disable USB port support, configure USB-related printers and configure USB-attached storage settings.

USB Support

Core USB Support: Checking this enables the FreshTomato USB driver/services for hardware equipped with USB ports. When Core USB Support is enabled, a series of more specific options become available for configuration. These options will depend on your router's specifications.

USB 3.0 Support: Checking this enables support for USB 3.x (xHCI) operation on USB 3.0 (or higher) ports. (Default: )

USB 2.0 Support: Checking this enables support for USB 2.0 (EHCI) operation on USB 2.0 (or higher) ports. (Default: )

USB 1.1 Support: Checking this enables support for:

  • USB 1.1 (OHCI) operation on USB 1.x (or higher) USB ports.
  • USB 1.1 (UHCI) operation on USB 1.x (or higher) USB ports.

(Default: Disabled).

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

  • Bidirectional copying: Checking this enables bidirectional communications on your USB printer connection. Modern USB printers can communicate in two directions: receiving the print job and related data from the PC/network client and; transmitting status messages back to the printer driver about job status, ink or toner levels, etcetera. Disabling Bidirectional copying may make some printers work better when connected to a FreshTomato router. (Default: Enabled).

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

  • Ext2 / Ext3 File System Support: Enabling this loads the filesystem drivers to access media formatted with the Ext2 and Ext3 filesystems. These partitions are usually created in Linux/Unix/BSD and similar operating systems. (Default: ).
  • NTFS Support: Enabling this loads the filesystem drivers to access media formatted with Microsoft's NTFS filesystem. Generally, this provides compatiblity with partitions formatted within Windows (since Windows NT/2000). (Default: ).
  • FAT File System Support: Checking this enables filesystem drivers for the FAT filesystem. This is largely for providing compatiblity with USB flash drives. This filesystem is also used on many SD/CompactFlash/MMC flash memory cards, and other older storage media. (Default: ).
  • Automount: Enabling this makes FreshTomato automatically mount all partitions detected when a USB drive is inserted or during bootup to mount points in subdirectories in /mnt. (Default: ).
  • Run after mounting: Here, you can enter a script or series of shell commands to be executed when a USB storage device is mounted.
  • Run before unmounting: Here you can enter a script of series of shell commands to be executed just before a USB storage device is unmounted/removed.
  • Hotplug script: Here, you can specify Linux shell commands that will be executed when a USB device is attached or removed.
  • HDD Spindown: Checking this box makes FreshTomato spin down mechanical hard drives when they are idle. There is no need to use this on solid state drives, such as SSDs or USB flash drives, as they have no motor/moving parts. (Default: Enabled).

3G/4G Modem Support: Checking this enables FreshTomato's support for 3G/4G USB modem dongles. This allows you to use a cellular provider as an Internet source. For more details on 3G/4G modem settings, see the WAN Settings section on the Network page.

Attached Devices

The Attached Devices section includes a table listing devices FreshTomato detects as attached to its USB ports. The table includes columns describing the device's Type, and the Host controller number on which the device was detected. The column headings also include a plain English Description of the media found and the media's status as mounted or unmounted.

If a drive is not mounted, clicking on the [Mount] option beside it will mount the drive, to a mountpoint as described earlier.

If a drive is mounted, clicking on the [Unmount] button will unmount the drive, leaving it ready to remove/disconnect.


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

For this reason, it is recommended that if you want to change any USB filesystem settings, you first reconfigure syslog to be stored in RAM. Only then should you adjust filesystem settings and/or unmount the drive. After that, you can safely configure syslog to be safely stored on USB storage once again, where it should not be interrupted.

USB filesystem corruption is one of the most common causes of system instability. Keep this in mind when troubleshooting router issues. You could experience a VPN connectivity issue, WiFi instability or any other sort of random problem which might be directly or indirectly caused by USB filesystem issues. Make sure to add USB filesystem checks to your troubleshooting checklist.

usb_support.txt · Last modified: 2022/01/03 20:32 by hogwild