1e06ab8d5SMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/<INTERFACE>/authorized
27f59c150SStefan KochDate:		August 2015
37f59c150SStefan KochDescription:
47f59c150SStefan Koch		This allows to authorize (1) or deauthorize (0)
57f59c150SStefan Koch		individual interfaces instead a whole device
67f59c150SStefan Koch		in contrast to the device authorization.
77f59c150SStefan Koch		If a deauthorized interface will be authorized
87f59c150SStefan Koch		so the driver probing must be triggered manually
97f59c150SStefan Koch		by writing INTERFACE to /sys/bus/usb/drivers_probe
107f59c150SStefan Koch		This allows to avoid side-effects with drivers
117f59c150SStefan Koch		that need multiple interfaces.
1254a19b4dSMauro Carvalho Chehab
137f59c150SStefan Koch		A deauthorized interface cannot be probed or claimed.
147f59c150SStefan Koch
157f59c150SStefan KochWhat:		/sys/bus/usb/devices/usbX/interface_authorized_default
167f59c150SStefan KochDate:		August 2015
177f59c150SStefan KochDescription:
187f59c150SStefan Koch		This is used as value that determines if interfaces
197f59c150SStefan Koch		would be authorized by default.
207f59c150SStefan Koch		The value can be 1 or 0. It's by default 1.
217f59c150SStefan Koch
22c8cf2465SDavid VrabelWhat:		/sys/bus/usb/device/.../authorized
23c8cf2465SDavid VrabelDate:		July 2008
24c8cf2465SDavid VrabelKernelVersion:	2.6.26
25c8cf2465SDavid VrabelContact:	David Vrabel <david.vrabel@csr.com>
26c8cf2465SDavid VrabelDescription:
27c8cf2465SDavid Vrabel		Authorized devices are available for use by device
28c8cf2465SDavid Vrabel		drivers, non-authorized one are not.  By default, wired
29c8cf2465SDavid Vrabel		USB devices are authorized.
30c8cf2465SDavid Vrabel
31c8cf2465SDavid Vrabel		Certified Wireless USB devices are not authorized
32c8cf2465SDavid Vrabel		initially and should be (by writing 1) after the
33c8cf2465SDavid Vrabel		device has been authenticated.
34c8cf2465SDavid Vrabel
35c8cf2465SDavid VrabelWhat:		/sys/bus/usb/device/.../wusb_cdid
36c8cf2465SDavid VrabelDate:		July 2008
37c8cf2465SDavid VrabelKernelVersion:	2.6.27
38c8cf2465SDavid VrabelContact:	David Vrabel <david.vrabel@csr.com>
39c8cf2465SDavid VrabelDescription:
40c8cf2465SDavid Vrabel		For Certified Wireless USB devices only.
41c8cf2465SDavid Vrabel
42c8cf2465SDavid Vrabel		A devices's CDID, as 16 space-separated hex octets.
43c8cf2465SDavid Vrabel
44c8cf2465SDavid VrabelWhat:		/sys/bus/usb/device/.../wusb_ck
45c8cf2465SDavid VrabelDate:		July 2008
46c8cf2465SDavid VrabelKernelVersion:	2.6.27
47c8cf2465SDavid VrabelContact:	David Vrabel <david.vrabel@csr.com>
48c8cf2465SDavid VrabelDescription:
49c8cf2465SDavid Vrabel		For Certified Wireless USB devices only.
50c8cf2465SDavid Vrabel
51c8cf2465SDavid Vrabel		Write the device's connection key (CK) to start the
52c8cf2465SDavid Vrabel		authentication of the device.  The CK is 16
53c8cf2465SDavid Vrabel		space-separated hex octets.
54c8cf2465SDavid Vrabel
55c8cf2465SDavid VrabelWhat:		/sys/bus/usb/device/.../wusb_disconnect
56c8cf2465SDavid VrabelDate:		July 2008
57c8cf2465SDavid VrabelKernelVersion:	2.6.27
58c8cf2465SDavid VrabelContact:	David Vrabel <david.vrabel@csr.com>
59c8cf2465SDavid VrabelDescription:
60c8cf2465SDavid Vrabel		For Certified Wireless USB devices only.
61c8cf2465SDavid Vrabel
62c8cf2465SDavid Vrabel		Write a 1 to force the device to disconnect
63c8cf2465SDavid Vrabel		(equivalent to unplugging a wired USB device).
640c7a2b72SCHENG Renquan
65ff231db8SJosua DietzeWhat:		/sys/bus/usb/drivers/.../new_id
66ff231db8SJosua DietzeDate:		October 2011
67ff231db8SJosua DietzeContact:	linux-usb@vger.kernel.org
68ff231db8SJosua DietzeDescription:
69ff231db8SJosua Dietze		Writing a device ID to this file will attempt to
70ff231db8SJosua Dietze		dynamically add a new device ID to a USB device driver.
71ff231db8SJosua Dietze		This may allow the driver to support more hardware than
72ff231db8SJosua Dietze		was included in the driver's static device ID support
73ff231db8SJosua Dietze		table at compile time. The format for the device ID is:
742fc82c2dSWolfram Sang		idVendor idProduct bInterfaceClass RefIdVendor RefIdProduct
75ff231db8SJosua Dietze		The vendor ID and device ID fields are required, the
7634433332SMauro Carvalho Chehab		rest is optional. The `Ref*` tuple can be used to tell the
772fc82c2dSWolfram Sang		driver to use the same driver_data for the new device as
782fc82c2dSWolfram Sang		it is used for the reference device.
79ff231db8SJosua Dietze		Upon successfully adding an ID, the driver will probe
8034433332SMauro Carvalho Chehab		for the device and attempt to bind to it.  For example::
8134433332SMauro Carvalho Chehab
82ff231db8SJosua Dietze		  # echo "8086 10f5" > /sys/bus/usb/drivers/foo/new_id
83ff231db8SJosua Dietze
842fc82c2dSWolfram Sang		Here add a new device (0458:7045) using driver_data from
8534433332SMauro Carvalho Chehab		an already supported device (0458:704c)::
8634433332SMauro Carvalho Chehab
872fc82c2dSWolfram Sang		  # echo "0458 7045 0 0458 704c" > /sys/bus/usb/drivers/foo/new_id
882fc82c2dSWolfram Sang
89e6bbcef0SBjørn Mork		Reading from this file will list all dynamically added
90e6bbcef0SBjørn Mork		device IDs in the same format, with one entry per
9134433332SMauro Carvalho Chehab		line. For example::
9234433332SMauro Carvalho Chehab
93e6bbcef0SBjørn Mork		  # cat /sys/bus/usb/drivers/foo/new_id
94e6bbcef0SBjørn Mork		  8086 10f5
95e6bbcef0SBjørn Mork		  dead beef 06
96e6bbcef0SBjørn Mork		  f00d cafe
97e6bbcef0SBjørn Mork
98e6bbcef0SBjørn Mork		The list will be truncated at PAGE_SIZE bytes due to
99e6bbcef0SBjørn Mork		sysfs restrictions.
100e6bbcef0SBjørn Mork
101ff231db8SJosua DietzeWhat:		/sys/bus/usb-serial/drivers/.../new_id
102ff231db8SJosua DietzeDate:		October 2011
103ff231db8SJosua DietzeContact:	linux-usb@vger.kernel.org
104ff231db8SJosua DietzeDescription:
105ff231db8SJosua Dietze		For serial USB drivers, this attribute appears under the
106ff231db8SJosua Dietze		extra bus folder "usb-serial" in sysfs; apart from that
107ff231db8SJosua Dietze		difference, all descriptions from the entry
108ff231db8SJosua Dietze		"/sys/bus/usb/drivers/.../new_id" apply.
109ff231db8SJosua Dietze
1100c7a2b72SCHENG RenquanWhat:		/sys/bus/usb/drivers/.../remove_id
1110c7a2b72SCHENG RenquanDate:		November 2009
1120c7a2b72SCHENG RenquanContact:	CHENG Renquan <rqcheng@smu.edu.sg>
1130c7a2b72SCHENG RenquanDescription:
1140c7a2b72SCHENG Renquan		Writing a device ID to this file will remove an ID
1150c7a2b72SCHENG Renquan		that was dynamically added via the new_id sysfs entry.
1160c7a2b72SCHENG Renquan		The format for the device ID is:
1170c7a2b72SCHENG Renquan		idVendor idProduct.	After successfully
1180c7a2b72SCHENG Renquan		removing an ID, the driver will no longer support the
1190c7a2b72SCHENG Renquan		device.  This is useful to ensure auto probing won't
1200c7a2b72SCHENG Renquan		match the driver to the device.  For example:
1210c7a2b72SCHENG Renquan		# echo "046d c315" > /sys/bus/usb/drivers/foo/remove_id
122ef955341SOliver Neukum
123e6bbcef0SBjørn Mork		Reading from this file will list the dynamically added
124e6bbcef0SBjørn Mork		device IDs, exactly like reading from the entry
125e6bbcef0SBjørn Mork		"/sys/bus/usb/drivers/.../new_id"
126e6bbcef0SBjørn Mork
127c1045e87SAndiry XuWhat:		/sys/bus/usb/devices/.../power/usb2_hardware_lpm
128c1045e87SAndiry XuDate:		September 2011
129c1045e87SAndiry XuContact:	Andiry Xu <andiry.xu@amd.com>
130c1045e87SAndiry XuDescription:
131ceb6c9c8SRafael J. Wysocki		If CONFIG_PM is set and a USB 2.0 lpm-capable device is plugged
132ceb6c9c8SRafael J. Wysocki		in to a xHCI host which support link PM, it will perform a LPM
133ceb6c9c8SRafael J. Wysocki		test; if the test is passed and host supports USB2 hardware LPM
134ceb6c9c8SRafael J. Wysocki		(xHCI 1.0 feature), USB2 hardware LPM will be enabled for the
135ceb6c9c8SRafael J. Wysocki		device and the USB device directory will contain a file named
136ceb6c9c8SRafael J. Wysocki		power/usb2_hardware_lpm.  The file holds a string value (enable
137ceb6c9c8SRafael J. Wysocki		or disable) indicating whether or not USB2 hardware LPM is
138ceb6c9c8SRafael J. Wysocki		enabled for the device. Developer can write y/Y/1 or n/N/0 to
139ceb6c9c8SRafael J. Wysocki		the file to enable/disable the feature.
1400846e7e9SMatthew Garrett
141bf5ce5bfSLu BaoluWhat:		/sys/bus/usb/devices/.../power/usb3_hardware_lpm_u1
142bf5ce5bfSLu Baolu		/sys/bus/usb/devices/.../power/usb3_hardware_lpm_u2
143bf5ce5bfSLu BaoluDate:		November 2015
144655fe4efSKevin StrasserContact:	Kevin Strasser <kevin.strasser@linux.intel.com>
145bf5ce5bfSLu Baolu		Lu Baolu <baolu.lu@linux.intel.com>
146655fe4efSKevin StrasserDescription:
147a2e66ad3SValentin Rothberg		If CONFIG_PM is set and a USB 3.0 lpm-capable device is plugged
148a2e66ad3SValentin Rothberg		in to a xHCI host which supports link PM, it will check if U1
149a2e66ad3SValentin Rothberg		and U2 exit latencies have been set in the BOS descriptor; if
150bf5ce5bfSLu Baolu		the check is passed and the host supports USB3 hardware LPM,
151a2e66ad3SValentin Rothberg		USB3 hardware LPM will be enabled for the device and the USB
152bf5ce5bfSLu Baolu		device directory will contain two files named
153bf5ce5bfSLu Baolu		power/usb3_hardware_lpm_u1 and power/usb3_hardware_lpm_u2. These
154bf5ce5bfSLu Baolu		files hold a string value (enable or disable) indicating whether
155bf5ce5bfSLu Baolu		or not USB3 hardware LPM U1 or U2 is enabled for the device.
156655fe4efSKevin Strasser
157024f117cSSarah SharpWhat:		/sys/bus/usb/devices/.../ltm_capable
158024f117cSSarah SharpDate:		July 2012
159024f117cSSarah SharpContact:	Sarah Sharp <sarah.a.sharp@linux.intel.com>
160024f117cSSarah SharpDescription:
161024f117cSSarah Sharp		USB 3.0 devices may optionally support Latency Tolerance
162024f117cSSarah Sharp		Messaging (LTM).  They indicate their support by setting a bit
163024f117cSSarah Sharp		in the bmAttributes field of their SuperSpeed BOS descriptors.
164024f117cSSarah Sharp		If that bit is set for the device, ltm_capable will read "yes".
165024f117cSSarah Sharp		If the device doesn't support LTM, the file will read "no".
166024f117cSSarah Sharp		The file will be present for all speeds of USB devices, and will
167024f117cSSarah Sharp		always read "no" for USB 1.1 and USB 2.0 devices.
168fa2a9566SLan Tianyu
1693628f573SMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/.../<hub_interface>/port<X>
170fa2a9566SLan TianyuDate:		August 2012
171fa2a9566SLan TianyuContact:	Lan Tianyu <tianyu.lan@intel.com>
172fa2a9566SLan TianyuDescription:
1733628f573SMauro Carvalho Chehab		The /sys/bus/usb/devices/.../<hub_interface>/port<X>
174fa2a9566SLan Tianyu		is usb port device's sysfs directory.
175cef7468cSLan Tianyu
1763628f573SMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/.../<hub_interface>/port<X>/connect_type
177cef7468cSLan TianyuDate:		January 2013
178cef7468cSLan TianyuContact:	Lan Tianyu <tianyu.lan@intel.com>
179cef7468cSLan TianyuDescription:
180cef7468cSLan Tianyu		Some platforms provide usb port connect types through ACPI.
181cef7468cSLan Tianyu		This attribute is to expose these information to user space.
18268f1ec8eSJon Flatley		The file will read "hotplug", "hardwired" and "not used" if the
183cef7468cSLan Tianyu		information is available, and "unknown" otherwise.
18417f34867SMathias Nyman
1853628f573SMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/.../<hub_interface>/port<X>/location
186355c74e5SBjørn MorkDate:		October 2018
187355c74e5SBjørn MorkContact:	Bjørn Mork <bjorn@mork.no>
188355c74e5SBjørn MorkDescription:
189355c74e5SBjørn Mork		Some platforms provide usb port physical location through
190355c74e5SBjørn Mork		firmware. This is used by the kernel to pair up logical ports
191355c74e5SBjørn Mork		mapping to the same physical connector. The attribute exposes the
192355c74e5SBjørn Mork		raw location value as a hex integer.
193355c74e5SBjørn Mork
194355c74e5SBjørn Mork
1953628f573SMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/.../<hub_interface>/port<X>/quirks
19625244227SNicolas BoichatDate:		May 2018
19725244227SNicolas BoichatContact:	Nicolas Boichat <drinkcat@chromium.org>
19825244227SNicolas BoichatDescription:
19925244227SNicolas Boichat		In some cases, we care about time-to-active for devices
20025244227SNicolas Boichat		connected on a specific port (e.g. non-standard USB port like
20125244227SNicolas Boichat		pogo pins), where the device to be connected is known in
20225244227SNicolas Boichat		advance, and behaves well according to the specification.
20325244227SNicolas Boichat		This attribute is a bit-field that controls the behavior of
20425244227SNicolas Boichat		a specific port:
20534433332SMauro Carvalho Chehab
20625244227SNicolas Boichat		 - Bit 0 of this field selects the "old" enumeration scheme,
20725244227SNicolas Boichat		   as it is considerably faster (it only causes one USB reset
20825244227SNicolas Boichat		   instead of 2).
20954a19b4dSMauro Carvalho Chehab
21025244227SNicolas Boichat		   The old enumeration scheme can also be selected globally
21125244227SNicolas Boichat		   using /sys/module/usbcore/parameters/old_scheme_first, but
21225244227SNicolas Boichat		   it is often not desirable as the new scheme was introduced to
21325244227SNicolas Boichat		   increase compatibility with more devices.
214aa071a92SNicolas Boichat		 - Bit 1 reduces TRSTRCY to the 10 ms that are required by the
215aa071a92SNicolas Boichat		   USB 2.0 specification, instead of the 50 ms that are normally
216aa071a92SNicolas Boichat		   used to help make enumeration work better on some high speed
217aa071a92SNicolas Boichat		   devices.
21825244227SNicolas Boichat
2193628f573SMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/.../<hub_interface>/port<X>/over_current_count
2201cbd53c8SRichard LeitnerDate:		February 2018
2211cbd53c8SRichard LeitnerContact:	Richard Leitner <richard.leitner@skidata.com>
2221cbd53c8SRichard LeitnerDescription:
2231cbd53c8SRichard Leitner		Most hubs are able to detect over-current situations on their
2241cbd53c8SRichard Leitner		ports and report them to the kernel. This attribute is to expose
2251cbd53c8SRichard Leitner		the number of over-current situation occurred on a specific port
2261cbd53c8SRichard Leitner		to user space. This file will contain an unsigned 32 bit value
227201af55dSJon Flatley		which wraps to 0 after its maximum is reached. This file supports
228201af55dSJon Flatley		poll() for monitoring changes to this value in user space.
229201af55dSJon Flatley
230201af55dSJon Flatley		Any time this value changes the corresponding hub device will send a
23134433332SMauro Carvalho Chehab		udev event with the following attributes::
232201af55dSJon Flatley
2333628f573SMauro Carvalho Chehab		  OVER_CURRENT_PORT=/sys/bus/usb/devices/.../<hub_interface>/port<X>
234201af55dSJon Flatley		  OVER_CURRENT_COUNT=[current value of this sysfs attribute]
2351cbd53c8SRichard Leitner
2363628f573SMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/.../<hub_interface>/port<X>/usb3_lpm_permit
237513072d9SLu BaoluDate:		November 2015
238513072d9SLu BaoluContact:	Lu Baolu <baolu.lu@linux.intel.com>
239513072d9SLu BaoluDescription:
240513072d9SLu Baolu		Some USB3.0 devices are not friendly to USB3 LPM.  usb3_lpm_permit
241513072d9SLu Baolu		attribute allows enabling/disabling usb3 lpm of a port. It takes
242513072d9SLu Baolu		effect both before and after a usb device is enumerated. Supported
243513072d9SLu Baolu		values are "0" if both u1 and u2 are NOT permitted, "u1" if only u1
244513072d9SLu Baolu		is permitted, "u2" if only u2 is permitted, "u1_u2" if both u1 and
245513072d9SLu Baolu		u2 are permitted.
246513072d9SLu Baolu
2478c67d06fSHeikki KrogerusWhat:		/sys/bus/usb/devices/.../<hub_interface>/port<X>/connector
2488c67d06fSHeikki KrogerusDate:		December 2021
2498c67d06fSHeikki KrogerusContact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
2508c67d06fSHeikki KrogerusDescription:
2518c67d06fSHeikki Krogerus		Link to the USB Type-C connector when available. This link is
2528c67d06fSHeikki Krogerus		only created when USB Type-C Connector Class is enabled, and
2538c67d06fSHeikki Krogerus		only if the system firmware is capable of describing the
2548c67d06fSHeikki Krogerus		connection between a port and its connector.
2558c67d06fSHeikki Krogerus
256*f061f43dSMichael GrzeschikWhat:		/sys/bus/usb/devices/.../<hub_interface>/port<X>/disable
257*f061f43dSMichael GrzeschikDate:		June 2022
258*f061f43dSMichael GrzeschikContact:	Michael Grzeschik <m.grzeschik@pengutronix.de>
259*f061f43dSMichael GrzeschikDescription:
260*f061f43dSMichael Grzeschik		This file controls the state of a USB port, including
261*f061f43dSMichael Grzeschik		Vbus power output (but only on hubs that support
262*f061f43dSMichael Grzeschik		power switching -- most hubs don't support it). If
263*f061f43dSMichael Grzeschik		a port is disabled, the port is unusable: Devices
264*f061f43dSMichael Grzeschik		attached to the port will not be detected, initialized,
265*f061f43dSMichael Grzeschik		or enumerated.
266*f061f43dSMichael Grzeschik
26717f34867SMathias NymanWhat:		/sys/bus/usb/devices/.../power/usb2_lpm_l1_timeout
26817f34867SMathias NymanDate:		May 2013
26917f34867SMathias NymanContact:	Mathias Nyman <mathias.nyman@linux.intel.com>
27017f34867SMathias NymanDescription:
27117f34867SMathias Nyman		USB 2.0 devices may support hardware link power management (LPM)
27217f34867SMathias Nyman		L1 sleep state. The usb2_lpm_l1_timeout attribute allows
27317f34867SMathias Nyman		tuning the timeout for L1 inactivity timer (LPM timer), e.g.
27417f34867SMathias Nyman		needed inactivity time before host requests the device to go to L1 sleep.
27517f34867SMathias Nyman		Useful for power management tuning.
27617f34867SMathias Nyman		Supported values are 0 - 65535 microseconds.
27717f34867SMathias Nyman
27817f34867SMathias NymanWhat:		/sys/bus/usb/devices/.../power/usb2_lpm_besl
27917f34867SMathias NymanDate:		May 2013
28017f34867SMathias NymanContact:	Mathias Nyman <mathias.nyman@linux.intel.com>
28117f34867SMathias NymanDescription:
28217f34867SMathias Nyman		USB 2.0 devices that support hardware link power management (LPM)
28317f34867SMathias Nyman		L1 sleep state now use a best effort service latency value (BESL) to
28417f34867SMathias Nyman		indicate the best effort to resumption of service to the device after the
28517f34867SMathias Nyman		initiation of the resume event.
28617f34867SMathias Nyman		If the device does not have a preferred besl value then the host can select
28717f34867SMathias Nyman		one instead. This usb2_lpm_besl attribute allows to tune the host selected besl
28817f34867SMathias Nyman		value in order to tune power saving and service latency.
28917f34867SMathias Nyman
29017f34867SMathias Nyman		Supported values are 0 - 15.
29117f34867SMathias Nyman		More information on how besl values map to microseconds can be found in
29217f34867SMathias Nyman		USB 2.0 ECN Errata for Link Power Management, section 4.10)
293b462e2e0SMathias Nyman
294b462e2e0SMathias NymanWhat:		/sys/bus/usb/devices/.../rx_lanes
295b462e2e0SMathias NymanDate:		March 2018
296b462e2e0SMathias NymanContact:	Mathias Nyman <mathias.nyman@linux.intel.com>
297b462e2e0SMathias NymanDescription:
298b462e2e0SMathias Nyman		Number of rx lanes the device is using.
299b462e2e0SMathias Nyman		USB 3.2 adds Dual-lane support, 2 rx and 2 tx lanes over Type-C.
300b462e2e0SMathias Nyman		Inter-Chip SSIC devices support asymmetric lanes up to 4 lanes per
301b462e2e0SMathias Nyman		direction. Devices before USB 3.2 are single lane (rx_lanes = 1)
302b462e2e0SMathias Nyman
303b462e2e0SMathias NymanWhat:		/sys/bus/usb/devices/.../tx_lanes
304b462e2e0SMathias NymanDate:		March 2018
305b462e2e0SMathias NymanContact:	Mathias Nyman <mathias.nyman@linux.intel.com>
306b462e2e0SMathias NymanDescription:
307b462e2e0SMathias Nyman		Number of tx lanes the device is using.
308b462e2e0SMathias Nyman		USB 3.2 adds Dual-lane support, 2 rx and 2 tx -lanes over Type-C.
309b462e2e0SMathias Nyman		Inter-Chip SSIC devices support asymmetric lanes up to 4 lanes per
310b462e2e0SMathias Nyman		direction. Devices before USB 3.2 are single lane (tx_lanes = 1)
311989eff9cSMauro Carvalho Chehab
312989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bAlternateSetting
313989eff9cSMauro Carvalho ChehabDescription:
314989eff9cSMauro Carvalho Chehab		The current interface alternate setting number, in decimal.
315989eff9cSMauro Carvalho Chehab
316989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
317989eff9cSMauro Carvalho Chehab
318989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bcdDevice
319989eff9cSMauro Carvalho ChehabDescription:
320989eff9cSMauro Carvalho Chehab		The device's release number, in hexadecimal.
321989eff9cSMauro Carvalho Chehab
322989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
323989eff9cSMauro Carvalho Chehab
324989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bConfigurationValue
325989eff9cSMauro Carvalho ChehabDescription:
326989eff9cSMauro Carvalho Chehab		While a USB device typically have just one configuration
327989eff9cSMauro Carvalho Chehab		setting, some devices support multiple configurations.
328989eff9cSMauro Carvalho Chehab
329989eff9cSMauro Carvalho Chehab		This value shows the current configuration, in decimal.
330989eff9cSMauro Carvalho Chehab
331989eff9cSMauro Carvalho Chehab		Changing its value will change the device's configuration
332989eff9cSMauro Carvalho Chehab		to another setting.
333989eff9cSMauro Carvalho Chehab
334989eff9cSMauro Carvalho Chehab		The number of configurations supported by a device is at:
335989eff9cSMauro Carvalho Chehab
336989eff9cSMauro Carvalho Chehab			/sys/bus/usb/devices/usbX/bNumConfigurations
337989eff9cSMauro Carvalho Chehab
338989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
339989eff9cSMauro Carvalho Chehab
340989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bDeviceClass
341989eff9cSMauro Carvalho ChehabDescription:
342989eff9cSMauro Carvalho Chehab		Class code of the device, in hexadecimal.
343989eff9cSMauro Carvalho Chehab
344989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
345989eff9cSMauro Carvalho Chehab
346989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bDeviceProtocol
347989eff9cSMauro Carvalho ChehabDescription:
348989eff9cSMauro Carvalho Chehab		Protocol code of the device, in hexadecimal.
349989eff9cSMauro Carvalho Chehab
350989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
351989eff9cSMauro Carvalho Chehab
352989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bDeviceSubClass
353989eff9cSMauro Carvalho ChehabDescription:
354989eff9cSMauro Carvalho Chehab		Subclass code of the device, in hexadecimal.
355989eff9cSMauro Carvalho Chehab
356989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
357989eff9cSMauro Carvalho Chehab
358989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bInterfaceClass
359989eff9cSMauro Carvalho ChehabDescription:
360989eff9cSMauro Carvalho Chehab		Class code of the interface, in hexadecimal.
361989eff9cSMauro Carvalho Chehab
362989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
363989eff9cSMauro Carvalho Chehab
364989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bInterfaceNumber
365989eff9cSMauro Carvalho ChehabDescription:
366989eff9cSMauro Carvalho Chehab		Interface number, in hexadecimal.
367989eff9cSMauro Carvalho Chehab
368989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
369989eff9cSMauro Carvalho Chehab
370989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bInterfaceProtocol
371989eff9cSMauro Carvalho ChehabDescription:
372989eff9cSMauro Carvalho Chehab		Protocol code of the interface, in hexadecimal.
373989eff9cSMauro Carvalho Chehab
374989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
375989eff9cSMauro Carvalho Chehab
376989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bInterfaceSubClass
377989eff9cSMauro Carvalho ChehabDescription:
378989eff9cSMauro Carvalho Chehab		Subclass code of the interface, in hexadecimal.
379989eff9cSMauro Carvalho Chehab
380989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
381989eff9cSMauro Carvalho Chehab
382989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bmAttributes
383989eff9cSMauro Carvalho ChehabDescription:
384989eff9cSMauro Carvalho Chehab		Attributes of the current configuration, in hexadecimal.
385989eff9cSMauro Carvalho Chehab
386989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
387989eff9cSMauro Carvalho Chehab
388989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bMaxPacketSize0
389989eff9cSMauro Carvalho ChehabDescription:
390989eff9cSMauro Carvalho Chehab		Maximum endpoint 0 packet size, in decimal.
391989eff9cSMauro Carvalho Chehab
392989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
393989eff9cSMauro Carvalho Chehab
394989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bMaxPower
395989eff9cSMauro Carvalho ChehabDescription:
396989eff9cSMauro Carvalho Chehab		Maximum power consumption of the active configuration of
397989eff9cSMauro Carvalho Chehab		the device, in miliamperes.
398989eff9cSMauro Carvalho Chehab
399989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bNumConfigurations
400989eff9cSMauro Carvalho ChehabDescription:
401989eff9cSMauro Carvalho Chehab		Number of the possible configurations of the device, in
402989eff9cSMauro Carvalho Chehab		decimal. The current configuration is controlled via:
403989eff9cSMauro Carvalho Chehab
404989eff9cSMauro Carvalho Chehab			/sys/bus/usb/devices/usbX/bConfigurationValue
405989eff9cSMauro Carvalho Chehab
406989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
407989eff9cSMauro Carvalho Chehab
408989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bNumEndpoints
409989eff9cSMauro Carvalho ChehabDescription:
410989eff9cSMauro Carvalho Chehab		Number of endpoints used on this interface, in hexadecimal.
411989eff9cSMauro Carvalho Chehab
412989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
413989eff9cSMauro Carvalho Chehab
414989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/bNumInterfaces
415989eff9cSMauro Carvalho ChehabDescription:
416989eff9cSMauro Carvalho Chehab		Number of interfaces on this device, in decimal.
417989eff9cSMauro Carvalho Chehab
418989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/busnum
419989eff9cSMauro Carvalho ChehabDescription:
420989eff9cSMauro Carvalho Chehab		Number of the bus.
421989eff9cSMauro Carvalho Chehab
422989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/configuration
423989eff9cSMauro Carvalho ChehabDescription:
424989eff9cSMauro Carvalho Chehab		Contents of the string descriptor associated with the
425989eff9cSMauro Carvalho Chehab		current configuration. It may include the firmware version
426989eff9cSMauro Carvalho Chehab		of a device and/or its serial number.
427989eff9cSMauro Carvalho Chehab
428989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/descriptors
429989eff9cSMauro Carvalho ChehabDescription:
430989eff9cSMauro Carvalho Chehab		Contains the interface descriptors, in binary.
431989eff9cSMauro Carvalho Chehab
432989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/idProduct
433989eff9cSMauro Carvalho ChehabDescription:
434989eff9cSMauro Carvalho Chehab		Product ID, in hexadecimal.
435989eff9cSMauro Carvalho Chehab
436989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/idVendor
437989eff9cSMauro Carvalho ChehabDescription:
438989eff9cSMauro Carvalho Chehab		Vendor ID, in hexadecimal.
439989eff9cSMauro Carvalho Chehab
440989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/devspec
441989eff9cSMauro Carvalho ChehabDescription:
442989eff9cSMauro Carvalho Chehab		Displays the Device Tree Open Firmware node of the interface.
443989eff9cSMauro Carvalho Chehab
444989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/avoid_reset_quirk
445989eff9cSMauro Carvalho ChehabDescription:
446989eff9cSMauro Carvalho Chehab		Most devices have this set to zero.
447989eff9cSMauro Carvalho Chehab
448989eff9cSMauro Carvalho Chehab		If the value is 1, enable a USB quirk that prevents this
449989eff9cSMauro Carvalho Chehab		device to use reset.
450989eff9cSMauro Carvalho Chehab
451989eff9cSMauro Carvalho Chehab		(read/write)
452989eff9cSMauro Carvalho Chehab
453989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/devnum
454989eff9cSMauro Carvalho ChehabDescription:
455989eff9cSMauro Carvalho Chehab		USB interface device number, in decimal.
456989eff9cSMauro Carvalho Chehab
457989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/devpath
458989eff9cSMauro Carvalho ChehabDescription:
459989eff9cSMauro Carvalho Chehab		String containing the USB interface device path.
460989eff9cSMauro Carvalho Chehab
461989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/manufacturer
462989eff9cSMauro Carvalho ChehabDescription:
463989eff9cSMauro Carvalho Chehab		Vendor specific string containing the name of the
464989eff9cSMauro Carvalho Chehab		manufacturer of the device.
465989eff9cSMauro Carvalho Chehab
466989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/maxchild
467989eff9cSMauro Carvalho ChehabDescription:
468989eff9cSMauro Carvalho Chehab		Number of ports of an USB hub
469989eff9cSMauro Carvalho Chehab
470989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/persist
471989eff9cSMauro Carvalho ChehabDescription:
472989eff9cSMauro Carvalho Chehab		Keeps the device even if it gets disconnected.
473989eff9cSMauro Carvalho Chehab
474989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/product
475989eff9cSMauro Carvalho ChehabDescription:
476989eff9cSMauro Carvalho Chehab		Vendor specific string containing the name of the
477989eff9cSMauro Carvalho Chehab		device's product.
478989eff9cSMauro Carvalho Chehab
479989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/speed
480989eff9cSMauro Carvalho ChehabDescription:
481989eff9cSMauro Carvalho Chehab		Shows the device's max speed, according to the USB version,
482989eff9cSMauro Carvalho Chehab		in Mbps.
483989eff9cSMauro Carvalho Chehab		Can be:
484989eff9cSMauro Carvalho Chehab
485989eff9cSMauro Carvalho Chehab			=======		====================
486989eff9cSMauro Carvalho Chehab			Unknown		speed unknown
487989eff9cSMauro Carvalho Chehab			1.5		Low speed
488989eff9cSMauro Carvalho Chehab			15		Full speed
489989eff9cSMauro Carvalho Chehab			480		High Speed
490989eff9cSMauro Carvalho Chehab			5000		Super Speed
491989eff9cSMauro Carvalho Chehab			10000		Super Speed+
492989eff9cSMauro Carvalho Chehab			20000		Super Speed+ Gen 2x2
493989eff9cSMauro Carvalho Chehab			=======		====================
494989eff9cSMauro Carvalho Chehab
495989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/supports_autosuspend
496989eff9cSMauro Carvalho ChehabDescription:
497989eff9cSMauro Carvalho Chehab		Returns 1 if the device doesn't support autosuspend.
498989eff9cSMauro Carvalho Chehab		Otherwise, returns 0.
499989eff9cSMauro Carvalho Chehab
500989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/urbnum
501989eff9cSMauro Carvalho ChehabDescription:
502989eff9cSMauro Carvalho Chehab		Number of URBs submitted for the whole device.
503989eff9cSMauro Carvalho Chehab
504989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/version
505989eff9cSMauro Carvalho ChehabDescription:
506989eff9cSMauro Carvalho Chehab		String containing the USB device version, as encoded
507989eff9cSMauro Carvalho Chehab		at the BCD descriptor.
508989eff9cSMauro Carvalho Chehab
509989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/power/autosuspend
510989eff9cSMauro Carvalho ChehabDescription:
511989eff9cSMauro Carvalho Chehab		Time in milliseconds for the device to autosuspend. If the
512989eff9cSMauro Carvalho Chehab		value is negative, then autosuspend is prevented.
513989eff9cSMauro Carvalho Chehab
514989eff9cSMauro Carvalho Chehab		(read/write)
515989eff9cSMauro Carvalho Chehab
516989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/power/active_duration
517989eff9cSMauro Carvalho ChehabDescription:
518989eff9cSMauro Carvalho Chehab		The total time the device has not been suspended.
519989eff9cSMauro Carvalho Chehab
520989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/power/connected_duration
521989eff9cSMauro Carvalho ChehabDescription:
522989eff9cSMauro Carvalho Chehab		The total time (in msec) that the device has been connected.
523989eff9cSMauro Carvalho Chehab
524989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/power/level
525989eff9cSMauro Carvalho ChehabDescription:
526989eff9cSMauro Carvalho Chehab
527989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/ep_<N>/bEndpointAddress
528989eff9cSMauro Carvalho ChehabDescription:
529989eff9cSMauro Carvalho Chehab		The address of the endpoint described by this descriptor,
530989eff9cSMauro Carvalho Chehab		in hexadecimal. The endpoint direction on this bitmapped field
531989eff9cSMauro Carvalho Chehab		is also shown at:
532989eff9cSMauro Carvalho Chehab
533989eff9cSMauro Carvalho Chehab			/sys/bus/usb/devices/usbX/ep_<N>/direction
534989eff9cSMauro Carvalho Chehab
535989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
536989eff9cSMauro Carvalho Chehab
537989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/ep_<N>/bInterval
538989eff9cSMauro Carvalho ChehabDescription:
539989eff9cSMauro Carvalho Chehab		The interval of the endpoint as described on its descriptor,
540989eff9cSMauro Carvalho Chehab		in hexadecimal. The actual interval depends on the version
541989eff9cSMauro Carvalho Chehab		of the USB. Also shown in time units at
542989eff9cSMauro Carvalho Chehab		/sys/bus/usb/devices/usbX/ep_<N>/interval.
543989eff9cSMauro Carvalho Chehab
544989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/ep_<N>/bLength
545989eff9cSMauro Carvalho ChehabDescription:
546989eff9cSMauro Carvalho Chehab		Number of bytes of the endpoint descriptor, in hexadecimal.
547989eff9cSMauro Carvalho Chehab
548989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/ep_<N>/bmAttributes
549989eff9cSMauro Carvalho ChehabDescription:
550989eff9cSMauro Carvalho Chehab		Attributes which apply to the endpoint as described on its
551989eff9cSMauro Carvalho Chehab		descriptor, in hexadecimal. The endpoint type on this
552989eff9cSMauro Carvalho Chehab		bitmapped field is also shown at:
553989eff9cSMauro Carvalho Chehab
554989eff9cSMauro Carvalho Chehab			/sys/bus/usb/devices/usbX/ep_<N>/type
555989eff9cSMauro Carvalho Chehab
556989eff9cSMauro Carvalho Chehab		See USB specs for its meaning.
557989eff9cSMauro Carvalho Chehab
558989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/ep_<N>/direction
559989eff9cSMauro Carvalho ChehabDescription:
560989eff9cSMauro Carvalho Chehab		Direction of the endpoint. Can be:
561989eff9cSMauro Carvalho Chehab
562989eff9cSMauro Carvalho Chehab		    - both (on control endpoints)
563989eff9cSMauro Carvalho Chehab		    - in
564989eff9cSMauro Carvalho Chehab		    - out
565989eff9cSMauro Carvalho Chehab
566989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/ep_<N>/interval
567989eff9cSMauro Carvalho ChehabDescription:
568989eff9cSMauro Carvalho Chehab		Interval for polling endpoint for data transfers, in
569989eff9cSMauro Carvalho Chehab		milisseconds or microseconds.
570989eff9cSMauro Carvalho Chehab
571989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/ep_<N>/type
572989eff9cSMauro Carvalho ChehabDescription:
573989eff9cSMauro Carvalho Chehab		Descriptor type. Can be:
574989eff9cSMauro Carvalho Chehab
575989eff9cSMauro Carvalho Chehab		    - Control
576989eff9cSMauro Carvalho Chehab		    - Isoc
577989eff9cSMauro Carvalho Chehab		    - Bulk
578989eff9cSMauro Carvalho Chehab		    - Interrupt
579989eff9cSMauro Carvalho Chehab		    - unknown
580989eff9cSMauro Carvalho Chehab
581989eff9cSMauro Carvalho ChehabWhat:		/sys/bus/usb/devices/usbX/ep_<N>/wMaxPacketSize
582989eff9cSMauro Carvalho ChehabDescription:
583989eff9cSMauro Carvalho Chehab		Maximum packet size this endpoint is capable of
584989eff9cSMauro Carvalho Chehab		sending or receiving, in hexadecimal.
585