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 [2023/06/04 22:18] – [USB Support] -formatting hogwildnas-usb [2023/08/09 15:45] (current) – [USB Support] -fix broken Network link hogwild
Line 5: Line 5:
 ===== USB Support ===== ===== USB Support =====
  
-**Core USB Support:** Checking this enables the USB driver/services for USB-equipped hardware. When enabled, a series of specific options appear for configuration. These will depend on your router hardware.+**Core USB Support:** Checking this enables the USB driver/services for USB-equipped hardware. When enabled, \\ a series of specific options appear for configuration. These will depend on your router hardware.
  
-  * USB 3.0 Support - Checking this enables support for USB 3.x (xHCI) operation on USB 3.0 (or higher) ports. (Default: ) +  * USB 3.0 Support - Checking this enables 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. (Default: ) +  * USB 2.0 Support - Checking this enables USB 2.0 (EHCI) operation. (Default: ) 
-  * USB 1.1 Support: Checking either option enables support for the that mode of USB 1.1 operation. (Default: Disabled). +  * USB 1.1 Support: Checking an option enables support for that mode of USB 1.1 operation. (Default: Disabled). 
-    * (OHCI) -enables operation on USB 1.x (or higher) USB ports.+    * (OHCI) - enables operation on USB 1.x (or higher) USB ports.
     * (UHCI) - enables operation on USB 2.x (or higher) USB ports.     * (UHCI) - enables operation on USB 2.x (or higher) USB ports.
  
Line 19: Line 19:
  \\   \\ **USB Printer Support**: Checking this loads the driver for USB printing support. (Default: ).  \\   \\ **USB Printer Support**: Checking this loads the driver for USB printing support. (Default: ).
  
-  * Bidirectional copying:  This enables bidirectional communications on the USB printer connection. \\ Modern USB printers can communicate in two directions: The printer receives the print job/metadata from the PC/client \\ and the printer transmits status messages back to the print driver about job status, ink or toner levels.\\ Disabling Bidirectional copying may make some printers work better when connected to a FreshTomato device.  \\ (Default: Enabled).+  * Bidirectional copying:  This enables bidirectional communications on the USB printer connection. \\ \\ Modern USB printers can communicate in two directions: The printer receives print job/metadata from the PC/client \\ and the printer transmits status messages back to the print driver about job status, ink or toner levels.\\ Disabling Bidirectional copying may make some printers work better when connected to a FreshTomato device.  \\ (Default: Enabled).
  
 **USB Storage Support:**  Checking this enables driver/service support for USB storage. (Default: ). **USB Storage Support:**  Checking this enables driver/service support for USB storage. (Default: ).
  
-  * File Systems Support: Checking any option loads drivers/support for the corresponding filesystem: +  * File Systems Support: Checking any option loads drivers/support for the corresponding filesystem: \\ \\  
-    * Ext2 / Ext3 - Enabling this loads support for accessing media with Ext2 and Ext3 filesystems.  \\ These partitions are usually created in Linux/Unix/BSD and similar operating systems. (Default: ). +    * Ext2 / Ext3 - Enabling this loads support for accessing media with Ext2 and Ext3 filesystems.  \\ These partitions are usually created in Linux/Unix/BSD and similar operating systems. (Default: ). \\ \\  
-    * NTFS - Enabling this loads support for media formatted with Microsoft's NTFS filesystem. \\ Generally, this provides compatibility with media formatted within Windows (since NT/2000).  (Default: ). +    * NTFS - Enabling this loads support for media formatted with Microsoft's NTFS filesystem. \\ Generally, this provides compatibility with media formatted within Windows (since NT/2000).  (Default: ). \\ \\  
-    * FAT - Checking this enables support for the FAT filesystem, mostly for compatibility with flash drives. \\ This filesystem is also used on SD, CompactFlash, MMC and other flash memory cards.  FAT doesn't support symbolic links and will limit your ability to use programs such as Entware or TTB. \\ It should not not be your first choice. (Default: ). +    * FAT - Checking this enables support for the FAT filesystem, mostly for compatibility with flash drives. \\ This filesystem is also used on SD, CompactFlash, MMC and other flash memory cards.   \\ FAT doesn't support symbolic links and limits your ability to use programs like Entware or TTB. \\ It should not not be your first choice. (Default: ). \\ \\  
-    * Automount - This makes FreshTomato automatically mount partitions detected when a USB drive is inserted \\ or during bootup to mount points in subdirectories of "/mnt" (Default: Enabled). +    * Automount - This makes FreshTomato automatically mount partitions detected when a USB drive is inserted \\ or during bootup to mount points in subdirectories of "/mnt" (Default: Enabled). \\ \\  
-    * Run after mounting - Here, enter a script or series of shell commands to run when a USB storage device is mounted. +    * Run after mounting - Here, enter a script/series of shell commands to run when a USB storage device is mounted. \\ \\  
-    * Run before unmounting - Here, enter a script or series of commands to run before a USB storage device is unmounted/removed.+    * Run before unmounting - Here, enter a script/series of commands to run before a USB storage device is unmounted. \\ \\
  
 **Hotplug script:**  Here, enter shell commands to execute when a USB device is attached or removed. **Hotplug script:**  Here, enter shell commands to execute when a USB device is attached or removed.
  
-**HDD Spindown:**  Enabling this makes FreshTomato spin down mechanical drives when idle. There is no need for this \\ on solid state drives, such as SSDs or USB flash drives. They have no moving parts. (Default: Enabled).+**HDD Spindown:**  Enabling this makes FreshTomato spin down mechanical drives when idle. There'no need for this \\ on solid state drives, such as SSDs or flash drives, as they have no moving parts. (Default: Enabled).
  
-**3G/4G/(5G) Modem Support:  **Checking this enables FreshTomato'support for 3G/4G/(5G) 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|Network]] page.+**3G/4G/(5G) Modem Support:  **Checking this enables support for 3G/4G/(5G) USB modem dongles. \\ This allows you to use a cellular carrier as an Internet provider. For more details on 3G/4G modem settings, see the WAN Settings \\ section on the [[basic-network|Network]] page. Supported USB modems are listed in the [[https://wiki.freshtomato.org/doku.php/dongle_compatibility|4G/5G compatibility]] page.
  
- \\ 
  
- \\+===== Attached Devices =====
  
 +The Attached Devices section contains a table of devices FreshTomato detects are attached to its USB ports.
  
-===== Attached Devices =====+The table has columns describing the device //Type// and the //Host// controller number where the device was detected.  There is also a column heading with a plain English //Description// of the media found and its status of mounted or unmounted.
  
-The Attached Devices section includes a table listing devices FreshTomato detects as attached to its USB portsThe table includes columns describing the device's Type, and the Host controller number on which the device was detectedThe column headings also include a plain English Description of the media found and the media's status as mounted or unmounted.+ \\ [[https://wiki.freshtomato.org/lib/exe/detail.php?id=usb_support&media=fb88c16672392011a95d1f46fa6bdffe.png|{{:fb88c16672392011a95d1f46fa6bdffe.png?771}}]]
  
-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.+If a drive is not mounted, clicking the [Mount] option beside it mounts the drive to a mount point. 
 + 
 +If a drive is mounted, clicking the [Unmount] button will unmount the drive, so it'ready to remove/disconnect.
  
-[[https://wiki.freshtomato.org/lib/exe/detail.php?id=usb_support&media=fb88c16672392011a95d1f46fa6bdffe.png|{{:fb88c16672392011a95d1f46fa6bdffe.png}}]] 
  
 ===== USB Support Notes ===== ===== USB Support Notes =====
  
-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.+Some USB storage settings require unloading/reloading of the USB storage drivers. Changing those settings may 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.
  
-For this reasonit 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.+Thereforebefore 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. Afterwards, you can configure syslog to again be permanently stored on USB storage, where it shouldn'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 filesystem corruption is a very common cause of system instability.** You could experience a VPN connectivity issue, WiFi instability or any other seemingly "randomproblem directly or indirectly caused by USB filesystem issues. When troubleshooting, you are advised to add USB filesystem checks to your troubleshooting checklist. 
 + 
 + \\ 
 + 
 + \\
  
  
nas-usb.1685913539.txt.gz · Last modified: 2023/06/04 22:18 by hogwild