How to disable USB Attached Storage (UAS) - Revision history

Shawn: /* Finding the USB device ID */ added -tv flags as a suggeston as it helped me

2024-05-08T18:29:33Z

Finding the USB device ID: added -tv flags as a suggeston as it helped me

← Older revision		Revision as of 18:29, 8 May 2024
Line 2:		Line 2:

	===Finding the USB device ID===		===Finding the USB device ID===
	To disable UAS for a specific USB device, find the USB device associated with the drive. This can be accomplished by either reviewing the <code>dmesg</code> kernel logs or using <code>lsusb</code>. For example, this Seagate expansion drive has the device ID <code>0bc2:3343</code>:		To disable UAS for a specific USB device, find the USB device associated with the drive. This can be accomplished by either reviewing the <code>dmesg</code> kernel logs or using <code>lsusb</code>. It may also help to add -tv flags to lsusb like this <code>lsusb -tv</code> by adding those flags you can look for "Driver=uas". In the following exampe only <code>lsusb</code> was used. For example, this Seagate expansion drive has the device ID <code>0bc2:3343</code>:
	{{Highlight		{{Highlight
	\| lang = terminal		\| lang = terminal

Shawn: /* Disable permanently with kernel cmdline arguments */ add the new location on the new raspberry pi OS

2024-05-08T18:21:00Z

Disable permanently with kernel cmdline arguments: add the new location on the new raspberry pi OS

← Older revision		Revision as of 18:21, 8 May 2024
Line 49:		Line 49:
	Rebuild the grub configs with <code>grub2-mkconfig -o /boot/grub2/grub.cfg</code> and reboot.		Rebuild the grub configs with <code>grub2-mkconfig -o /boot/grub2/grub.cfg</code> and reboot.

	On other systems such as Linux on a Raspberry Pi, edit <code>/boot/cmdline.txt</code> and append <code>usb-storage.quirks=XX:YY:u</code>.		On other systems such as Linux on a Raspberry Pi, edit <code>/boot/cmdline.txt</code> or <code>/boot/firmware/cmdline.txt</code> depending on OS version and append <code>usb-storage.quirks=XX:YY:u</code>.

	== Why would you want to disable UAS? ==		== Why would you want to disable UAS? ==

84.104.31.57: Added another reason to disable UAS (SMART monitoring of USB H.D.D.)

2022-12-04T14:00:03Z

Added another reason to disable UAS (SMART monitoring of USB H.D.D.)

← Older revision		Revision as of 14:00, 4 December 2022
Line 55:		Line 55:

	* Slow transfer speeds, sometimes even stalling		* Slow transfer speeds, sometimes even stalling
			*S.M.A.R.T. information not available (e.g. in <code>smartctl</code> or <code>smartd</code> to monitor a system's disk automatically).
	* Kernel messages are full of errors similar to the ones listed below. However, the drive is still healthy.		* Kernel messages are full of errors similar to the ones listed below. However, the drive is still healthy.
	* Error messages from <code>uas_eh_abort_handler</code>.		* Error messages from <code>uas_eh_abort_handler</code>.

172.18.0.2 at 22:12, 2 January 2022

2022-01-02T22:12:37Z

← Older revision		Revision as of 22:12, 2 January 2022
Line 4:		Line 4:
	To disable UAS for a specific USB device, find the USB device associated with the drive. This can be accomplished by either reviewing the <code>dmesg</code> kernel logs or using <code>lsusb</code>. For example, this Seagate expansion drive has the device ID <code>0bc2:3343</code>:		To disable UAS for a specific USB device, find the USB device associated with the drive. This can be accomplished by either reviewing the <code>dmesg</code> kernel logs or using <code>lsusb</code>. For example, this Seagate expansion drive has the device ID <code>0bc2:3343</code>:
	{{Highlight		{{Highlight
			\| lang = terminal
	\| code = # lsusb		\| code = # lsusb
	Bus 004 Device 002: ID 0bc2:3343 Seagate RSS LLC Desktop		Bus 004 Device 002: ID 0bc2:3343 Seagate RSS LLC Desktop
	~~\| lang = terminal~~
	}}		}}

Line 31:		Line 31:
	\| code = options usb-storage quirks=0bc2:3322:u		\| code = options usb-storage quirks=0bc2:3322:u
	\| lang = text		\| lang = text
	}}Then, ~~update~~ the kernel{{Highlight		}}
	\| code = update-initramfs -u		Then, rebuild initrd so that the kernel loads the usb-storage module with this option during boot.
			{{Highlight
			\| code = # update-initramfs -u
	\| lang = text		\| lang = text
	}}		}}

172.18.0.2: Adding this step for those newer to linux development.

2022-01-02T17:46:29Z

Adding this step for those newer to linux development.

← Older revision		Revision as of 17:46, 2 January 2022
Line 30:		Line 30:
	{{Highlight		{{Highlight
	\| code = options usb-storage quirks=0bc2:3322:u		\| code = options usb-storage quirks=0bc2:3322:u
			\| lang = text
			}}Then, update the kernel{{Highlight
			\| code = update-initramfs -u
	\| lang = text		\| lang = text
	}}		}}

Leo: Added categories and navbox

2021-12-30T01:38:36Z

Added categories and navbox

← Older revision		Revision as of 01:38, 30 December 2021
Line 96:		Line 96:
	\| lang = text		\| lang = text
	}}		}}
			{{Navbox Linux}}
			[[Category:Linux]]
			[[Category:Guides]]

Leo: Leo moved page Disable UAS to How to disable USB Attached Storage (UAS)

2021-07-17T00:05:48Z

Leo moved page Disable UAS to How to disable USB Attached Storage (UAS)

← Older revision		Revision as of 00:05, 17 July 2021
(No difference)

Leo at 06:32, 7 July 2021

2021-07-07T06:32:33Z

@@ Line 1: / Line 1: @@
-USB Attached Storage (UAS) is now commonly found for USB 3.0 storage devices. However, this sometimes causes issues with non-compliant adapters requiring it to be disabled. Issues with having UAS enabled include slow write performance, or having the device randomly drop off until the USB connection is reset.
+USB Attached Storage (UAS) is now commonly found for USB 3.0 storage devices. However, this sometimes causes issues with non-compliant adapters requiring it to be disabled. Issues with having UAS enabled include slow write performance, or having the device randomly drop off until the USB connection is reset. More on the issues below.
 ===Finding the USB device ID===
@@ Line 32: / Line 32: @@
 | lang = text
 }}
-Reboot the machine. When the kernel module is loaded again, it should be aware of the quirk.
+Reboot the machine. When the kernel module is loaded again, it should be aware of the quirk. If this isn't taking effect, try the cmdline argument option below.
 ====Disable permanently with kernel cmdline arguments====
 Change your bootloader so that the quirk values are passed to the kernel.
-Edit <code>/etc/default/grub</code> and add the following to <code>GRUB_CMDLINE_LINUX</code>:
+For CentOS/Fedora/Red Hat based systems, edit <code>/etc/default/grub</code> and add the following to <code>GRUB_CMDLINE_LINUX</code>:
 {{Highlight
 | code = usb-storage.quirks=0bc2:3322:u
@@ Line 43: / Line 43: @@
 }}
 Rebuild the grub configs with <code>grub2-mkconfig -o /boot/grub2/grub.cfg</code> and reboot.

Leo: /* Disable permanently with kernel cmdline arguments */

2020-12-02T03:54:50Z

Disable permanently with kernel cmdline arguments

← Older revision		Revision as of 03:54, 2 December 2020
Line 1:		Line 1:
	USB Attached Storage (UAS) is now commonly found for USB 3.0 storage devices. However, this sometimes causes issues with non-compliant adapters requiring it to be disabled. Issues with having UAS enabled include slow write performance, or having the device randomly drop off until the USB connection is reset.		USB Attached Storage (UAS) is now commonly found for USB 3.0 storage devices. However, this sometimes causes issues with non-compliant adapters requiring it to be disabled. Issues with having UAS enabled include slow write performance, or having the device randomly drop off until the USB connection is reset.

	=== Finding the USB device ID ===		===Finding the USB device ID===
	To disable UAS for a specific USB device, find the USB device associated with the drive. This can be accomplished by either reviewing the <code>dmesg</code> kernel logs or using <code>lsusb</code>. For example, this Seagate expansion drive has the device ID <code>0bc2:3343</code>:		To disable UAS for a specific USB device, find the USB device associated with the drive. This can be accomplished by either reviewing the <code>dmesg</code> kernel logs or using <code>lsusb</code>. For example, this Seagate expansion drive has the device ID <code>0bc2:3343</code>:
	{{Highlight		{{Highlight
Line 9:		Line 9:
	}}		}}

	=== Disabling UAS ===		===Disabling UAS===
	After knowing the device ID, there are three ways to disable UAS.		After knowing the device ID, there are three ways to disable UAS. In all three ways, the idea is to pass in a <code>quirk</code> parameter to the <code>usb_storage</code> kernel module, telling the module to not use UAS for a specific device. This is done by passing in the USB device ID followed by the <code>u</code> flag.. Other flags that you can use can be found by looking at the kernel source code at https://github.com/torvalds/linux/blob/master/drivers/usb/storage/usb.c#L568.

	==== Manually reload the kernel module (temporary) ====		====Manually reload the kernel module (temporary)====
	'''A temporary solution''': Temporarily reload the usb-storage kernel module with the quirks.		'''A temporary solution''': Temporarily reload the usb-storage kernel module with the quirks.

Line 26:		Line 26:
	}}		}}

	==== Disable permanently with modprobe.d ====		====Disable permanently with modprobe.d====
	Create a new file in <code>/etc/modprobe.d/disable-uas.conf</code> with the following contents:		Create a new file in <code>/etc/modprobe.d/disable-uas.conf</code> with the following contents:
	{{Highlight		{{Highlight
	\| code = usb-storage quirks=0bc2:3322:u		\| code = options usb-storage quirks=0bc2:3322:u
	\| lang = text		\| lang = text
	}}		}}
	Reboot the machine. When the kernel module is loaded again, it should be aware of the quirk.		Reboot the machine. When the kernel module is loaded again, it should be aware of the quirk.

	==== Disable permanently with kernel cmdline arguments ====		====Disable permanently with kernel cmdline arguments====
	Change your bootloader so that the quirk values are passed to the kernel.		Change your bootloader so that the quirk values are passed to the kernel.

Leo: Created page with "USB Attached Storage (UAS) is now commonly found for USB 3.0 storage devices. However, this sometimes causes issues with non-compliant adapters requiring it to be disabled. Is..."

2020-12-02T03:44:41Z

Created page with "USB Attached Storage (UAS) is now commonly found for USB 3.0 storage devices. However, this sometimes causes issues with non-compliant adapters requiring it to be disabled. Is..."

New page

USB Attached Storage (UAS) is now commonly found for USB 3.0 storage devices. However, this sometimes causes issues with non-compliant adapters requiring it to be disabled. Issues with having UAS enabled include slow write performance, or having the device randomly drop off until the USB connection is reset.

=== Finding the USB device ID ===
To disable UAS for a specific USB device, find the USB device associated with the drive. This can be accomplished by either reviewing the <code>dmesg</code> kernel logs or using <code>lsusb</code>. For example, this Seagate expansion drive has the device ID <code>0bc2:3343</code>:
{{Highlight
| code = # lsusb
Bus 004 Device 002: ID 0bc2:3343 Seagate RSS LLC Desktop
| lang = terminal
}}

=== Disabling UAS ===
After knowing the device ID, there are three ways to disable UAS.

==== Manually reload the kernel module (temporary) ====
'''A temporary solution''': Temporarily reload the usb-storage kernel module with the quirks.

Unload the {{code|usb-storage}} kernel module and re-load it with a quirk parameter specifying which device to not enable UAS on.{{highlight|lang=terminal|code=
# lsusb
Bus 002 Device 005: ID 0bc2:3343 Seagate RSS LLC

# rmmod usb-storage
# modprobe usb-storage quirks=0bc2:3343:u
}}Re-attach the USB device again. This time, {{code|dmesg}} should say that a quirk was detected for this device:{{highlight|lang=text|code=
[947347.271519] usb 2-3.2: New USB device found, idVendor=0bc2, idProduct=3343, bcdDevice= 1.00
[947955.635329] usb-storage 2-3.2:1.0: Quirks match for vid 0bc2 pid 3343: 800000
}}

==== Disable permanently with modprobe.d ====
Create a new file in <code>/etc/modprobe.d/disable-uas.conf</code> with the following contents:
{{Highlight
| code = usb-storage quirks=0bc2:3322:u
| lang = text
}}
Reboot the machine. When the kernel module is loaded again, it should be aware of the quirk.

==== Disable permanently with kernel cmdline arguments ====
Change your bootloader so that the quirk values are passed to the kernel.

Edit <code>/etc/default/grub</code> and add the following to <code>GRUB_CMDLINE_LINUX</code>:
{{Highlight
| code = usb-storage.quirks=0bc2:3322:u
| lang = text
}}
Rebuild the grub configs with <code>grub2-mkconfig -o /boot/grub2/grub.cfg</code> and reboot.