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