Site Tools


nas-usb

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
nas-usb [2024/10/16 19:38] – [Attached Devices] hogwildnas-usb [2024/11/27 18:41] (current) – [USB Support Notes] -condense hogwild
Line 1: Line 1:
 ====== USB Support ====== ====== 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.+The USB Support menu includes sections for 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 ===== ===== 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.+**Core USB Support *:** enables the USB driver/services for USB-equipped hardware. 
 + 
 +When enabled, specific options appear for configuration, depending on your hardware.
  
  \\  \\
  
-  * USB 3.0 Support - Enables USB 3.x (xHCI) operation \\ on USB 3.0 (or higher) ports. (Default: enabled) +  * USB 3.0 Support enables USB 3.x (xHCI) operation \\ on USB 3.0 (or higher) ports. 
-  * USB 2.0 Support - Enables USB 2.0 (EHCI) operation. (Default: enabled) +  * USB 2.0 Support enables USB 2.0 (EHCI) operation. 
-  * USB 1.1 Support - Each option enables support for that mode of USB 1.1. +  * USB 1.1 Support - an option enables support for that mode of USB 1.1. 
-    * (OHCI) - enables OHCI support on USB 1.x (or higherUSB ports. +    * (OHCI) - enables OHCI support on USB 1.x higher USB ports. 
-    * (UHCI) - enables UHCI support on USB 2.x (higherUSB ports. \\ (Default: Disabled)+    * (UHCI) - enables UHCI support on USB 2.x higher USB ports.
  
- \\ {{::usb_support-main-2024.1.png?832}}+ \\   \\  {{::usb_support-main-2024.1.png?832}}
  
- \\   \\ **USB Printer Support**: Checking this loads the driver for USB printing support. (Default: ).+ \\   \\ **USB Printer Support ***: loads the driver for USB printing support.
  
-  * 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).+ \\ 
 + 
 +  * Bidirectional copying: enables bidirectional communications on the \\ printer connection. \\ \\ Modern USB printers can communicate in two directions: \\ The printer receives data from the client and the printer transmits\\ status messages back to the driver. Disabling this may help some \\ router-connected printers work better.
  
  \\  \\
  
-**USB Storage Support:**  Checking this enables driver/service support for USB storage. (Default: ).+**USB Storage Support *:** 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: ). \\ \\  +  * File Systems Support: a checked option loads support for that filesystem: \\ \\  
-    * 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 TTBIt shouldn't be your first choice. (Default: ). \\ \\  +    * Ext2 / Ext3 - loads support for accessing Ext2and Ext3-formatted  \\ media. Usually, such partitions are created in Linux/Unix. \\ \\  
-    * 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). \\ \\  +    * NTFS - loads support for NTFS-formatted media. \\ Mostly, this provides support for media formatted in Windows.\\ \\  
-    * Run after mounting - Here, enter a script/shell command series to run when USB \\ storage  is mounted. \\ \\  +    * FAT - enables support for the FAT filesystem. \\ Mostlythis is for compatibility with USB flashSD cards\\ and other flash media. FAT doesn't support symbolic links, \\ so your ability to use programs like Entware or TTB \\ is limitedOther options are preferred.\\ \\  
-    * Run before unmounting - Here, enter a script/series of commands to run before \\ USB storage is unmounted. \\ \\+    * Automount - FreshTomato will 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/series of commands\\ to run when USB storage  is mounted. \\ \\  
 +    * Run before unmounting - 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.+**Hotplug script:**  these shell commands will execute when a USB device is attached/removed.
  
  \\  \\
  
-**HDD Spindown:**  Checking this makes FreshTomato spin down idle mechanical drives.+**HDD Spindown:** 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. This is not needed on solid state drives, like SSDs or flash drives, as they have no motors.
Line 47: Line 54:
  \\  \\
  
-**3G/4G/(5G) Modem Support:  **Enables support for 3G/4G/(5G) USB modem dongles.+**3G/4G/(5G) Modem Support: **enables support for 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 [[basic-network|Network]] page. Supported USB modems \\ are listed on the [[https://wiki.freshtomato.org/doku.php/dongle_compatibility|3G/4G/5G compatibility]] page.+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 [[basic-network|Network]] page. Supported USB modems are listed on the [[https://wiki.freshtomato.org/doku.php/dongle_compatibility|3G/4G/5G compatibility]] page.
  
  
Line 64: Line 71:
  \\  \\
  
-If a drive isn't mounted, clicking the [Mount] option beside it mounts the drive to a mount point.+If a drive isn't mounted, clicking [Mount] beside it mounts the drive to a mount point.
  
-If a drive is mounted, clicking [Unmount] unmounts the drive, so it's ready to remove/disconnect.+If a drive is mounted, [Unmount] unmounts the drive, so it's ready to remove/disconnect.
  
  
 ===== USB Support Notes ===== ===== 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.+Some USB storage settings require the USB storage drivers to be unloaded/reloaded. Changing these 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 or 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.+Before changing USB filesystem settings, 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.+**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" problems caused by USB filesystem issues. When troubleshooting, you should include USB filesystem checks in your troubleshooting checklist.
  
- \\+ \\  \\
  
  \\  \\
  
  
nas-usb.1729103916.txt.gz · Last modified: 2024/10/16 19:38 by hogwild