~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/ABI/testing/sysfs-bus-usb

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /Documentation/ABI/testing/sysfs-bus-usb (Version linux-6.12-rc7) and /Documentation/ABI/testing/sysfs-bus-usb (Version linux-4.17.19)


  1 What:           /sys/bus/usb/devices/<INTERFAC !!   1 What:           /sys/bus/usb/devices/INTERFACE/authorized
  2 Date:           August 2015                         2 Date:           August 2015
  3 Description:                                        3 Description:
  4                 This allows to authorize (1) o      4                 This allows to authorize (1) or deauthorize (0)
  5                 individual interfaces instead       5                 individual interfaces instead a whole device
  6                 in contrast to the device auth      6                 in contrast to the device authorization.
  7                 If a deauthorized interface wi      7                 If a deauthorized interface will be authorized
  8                 so the driver probing must be       8                 so the driver probing must be triggered manually
  9                 by writing INTERFACE to /sys/b      9                 by writing INTERFACE to /sys/bus/usb/drivers_probe
 10                 This allows to avoid side-effe     10                 This allows to avoid side-effects with drivers
 11                 that need multiple interfaces.     11                 that need multiple interfaces.
 12                                                << 
 13                 A deauthorized interface canno     12                 A deauthorized interface cannot be probed or claimed.
 14                                                    13 
 15 What:           /sys/bus/usb/devices/usbX/inte     14 What:           /sys/bus/usb/devices/usbX/interface_authorized_default
 16 Date:           August 2015                        15 Date:           August 2015
 17 Description:                                       16 Description:
 18                 This is used as value that det     17                 This is used as value that determines if interfaces
 19                 would be authorized by default     18                 would be authorized by default.
 20                 The value can be 1 or 0. It's      19                 The value can be 1 or 0. It's by default 1.
 21                                                    20 
 22 What:           /sys/bus/usb/device/.../author     21 What:           /sys/bus/usb/device/.../authorized
 23 Date:           July 2008                          22 Date:           July 2008
 24 KernelVersion:  2.6.26                             23 KernelVersion:  2.6.26
 25 Contact:        David Vrabel <david.vrabel@csr.     24 Contact:        David Vrabel <david.vrabel@csr.com>
 26 Description:                                       25 Description:
 27                 Authorized devices are availab     26                 Authorized devices are available for use by device
 28                 drivers, non-authorized one ar     27                 drivers, non-authorized one are not.  By default, wired
 29                 USB devices are authorized.        28                 USB devices are authorized.
 30                                                    29 
                                                   >>  30                 Certified Wireless USB devices are not authorized
                                                   >>  31                 initially and should be (by writing 1) after the
                                                   >>  32                 device has been authenticated.
                                                   >>  33 
                                                   >>  34 What:           /sys/bus/usb/device/.../wusb_cdid
                                                   >>  35 Date:           July 2008
                                                   >>  36 KernelVersion:  2.6.27
                                                   >>  37 Contact:        David Vrabel <david.vrabel@csr.com>
                                                   >>  38 Description:
                                                   >>  39                 For Certified Wireless USB devices only.
                                                   >>  40 
                                                   >>  41                 A devices's CDID, as 16 space-separated hex octets.
                                                   >>  42 
                                                   >>  43 What:           /sys/bus/usb/device/.../wusb_ck
                                                   >>  44 Date:           July 2008
                                                   >>  45 KernelVersion:  2.6.27
                                                   >>  46 Contact:        David Vrabel <david.vrabel@csr.com>
                                                   >>  47 Description:
                                                   >>  48                 For Certified Wireless USB devices only.
                                                   >>  49 
                                                   >>  50                 Write the device's connection key (CK) to start the
                                                   >>  51                 authentication of the device.  The CK is 16
                                                   >>  52                 space-separated hex octets.
                                                   >>  53 
                                                   >>  54 What:           /sys/bus/usb/device/.../wusb_disconnect
                                                   >>  55 Date:           July 2008
                                                   >>  56 KernelVersion:  2.6.27
                                                   >>  57 Contact:        David Vrabel <david.vrabel@csr.com>
                                                   >>  58 Description:
                                                   >>  59                 For Certified Wireless USB devices only.
                                                   >>  60 
                                                   >>  61                 Write a 1 to force the device to disconnect
                                                   >>  62                 (equivalent to unplugging a wired USB device).
                                                   >>  63 
 31 What:           /sys/bus/usb/drivers/.../new_i     64 What:           /sys/bus/usb/drivers/.../new_id
 32 Date:           October 2011                       65 Date:           October 2011
 33 Contact:        linux-usb@vger.kernel.org          66 Contact:        linux-usb@vger.kernel.org
 34 Description:                                       67 Description:
 35                 Writing a device ID to this fi     68                 Writing a device ID to this file will attempt to
 36                 dynamically add a new device I     69                 dynamically add a new device ID to a USB device driver.
 37                 This may allow the driver to s     70                 This may allow the driver to support more hardware than
 38                 was included in the driver's s     71                 was included in the driver's static device ID support
 39                 table at compile time. The for     72                 table at compile time. The format for the device ID is:
 40                 idVendor idProduct bInterfaceC     73                 idVendor idProduct bInterfaceClass RefIdVendor RefIdProduct
 41                 The vendor ID and device ID fi     74                 The vendor ID and device ID fields are required, the
 42                 rest is optional. The `Ref*` t !!  75                 rest is optional. The Ref* tuple can be used to tell the
 43                 driver to use the same driver_     76                 driver to use the same driver_data for the new device as
 44                 it is used for the reference d     77                 it is used for the reference device.
 45                 Upon successfully adding an ID     78                 Upon successfully adding an ID, the driver will probe
 46                 for the device and attempt to  !!  79                 for the device and attempt to bind to it.  For example:
 47                                                !!  80                 # echo "8086 10f5" > /sys/bus/usb/drivers/foo/new_id
 48                   # echo "8086 10f5" > /sys/bu << 
 49                                                    81 
 50                 Here add a new device (0458:70     82                 Here add a new device (0458:7045) using driver_data from
 51                 an already supported device (0 !!  83                 an already supported device (0458:704c):
 52                                                !!  84                 # echo "0458 7045 0 0458 704c" > /sys/bus/usb/drivers/foo/new_id
 53                   # echo "0458 7045 0 0458 704 << 
 54                                                    85 
 55                 Reading from this file will li     86                 Reading from this file will list all dynamically added
 56                 device IDs in the same format,     87                 device IDs in the same format, with one entry per
 57                 line. For example::            !!  88                 line. For example:
 58                                                !!  89                 # cat /sys/bus/usb/drivers/foo/new_id
 59                   # cat /sys/bus/usb/drivers/f !!  90                 8086 10f5
 60                   8086 10f5                    !!  91                 dead beef 06
 61                   dead beef 06                 !!  92                 f00d cafe
 62                   f00d cafe                    << 
 63                                                    93 
 64                 The list will be truncated at      94                 The list will be truncated at PAGE_SIZE bytes due to
 65                 sysfs restrictions.                95                 sysfs restrictions.
 66                                                    96 
 67 What:           /sys/bus/usb-serial/drivers/..     97 What:           /sys/bus/usb-serial/drivers/.../new_id
 68 Date:           October 2011                       98 Date:           October 2011
 69 Contact:        linux-usb@vger.kernel.org          99 Contact:        linux-usb@vger.kernel.org
 70 Description:                                      100 Description:
 71                 For serial USB drivers, this a    101                 For serial USB drivers, this attribute appears under the
 72                 extra bus folder "usb-serial"     102                 extra bus folder "usb-serial" in sysfs; apart from that
 73                 difference, all descriptions f    103                 difference, all descriptions from the entry
 74                 "/sys/bus/usb/drivers/.../new_    104                 "/sys/bus/usb/drivers/.../new_id" apply.
 75                                                   105 
 76 What:           /sys/bus/usb/drivers/.../remov    106 What:           /sys/bus/usb/drivers/.../remove_id
 77 Date:           November 2009                     107 Date:           November 2009
 78 Contact:        CHENG Renquan <rqcheng@smu.edu.    108 Contact:        CHENG Renquan <rqcheng@smu.edu.sg>
 79 Description:                                      109 Description:
 80                 Writing a device ID to this fi    110                 Writing a device ID to this file will remove an ID
 81                 that was dynamically added via    111                 that was dynamically added via the new_id sysfs entry.
 82                 The format for the device ID i    112                 The format for the device ID is:
 83                 idVendor idProduct.     After     113                 idVendor idProduct.     After successfully
 84                 removing an ID, the driver wil    114                 removing an ID, the driver will no longer support the
 85                 device.  This is useful to ens    115                 device.  This is useful to ensure auto probing won't
 86                 match the driver to the device    116                 match the driver to the device.  For example:
 87                 # echo "046d c315" > /sys/bus/    117                 # echo "046d c315" > /sys/bus/usb/drivers/foo/remove_id
 88                                                   118 
 89                 Reading from this file will li    119                 Reading from this file will list the dynamically added
 90                 device IDs, exactly like readi    120                 device IDs, exactly like reading from the entry
 91                 "/sys/bus/usb/drivers/.../new_    121                 "/sys/bus/usb/drivers/.../new_id"
 92                                                   122 
 93 What:           /sys/bus/usb/devices/.../power    123 What:           /sys/bus/usb/devices/.../power/usb2_hardware_lpm
 94 Date:           September 2011                    124 Date:           September 2011
 95 Contact:        Andiry Xu <andiry.xu@amd.com>      125 Contact:        Andiry Xu <andiry.xu@amd.com>
 96 Description:                                      126 Description:
 97                 If CONFIG_PM is set and a USB     127                 If CONFIG_PM is set and a USB 2.0 lpm-capable device is plugged
 98                 in to a xHCI host which suppor    128                 in to a xHCI host which support link PM, it will perform a LPM
 99                 test; if the test is passed an    129                 test; if the test is passed and host supports USB2 hardware LPM
100                 (xHCI 1.0 feature), USB2 hardw    130                 (xHCI 1.0 feature), USB2 hardware LPM will be enabled for the
101                 device and the USB device dire    131                 device and the USB device directory will contain a file named
102                 power/usb2_hardware_lpm.  The     132                 power/usb2_hardware_lpm.  The file holds a string value (enable
103                 or disable) indicating whether    133                 or disable) indicating whether or not USB2 hardware LPM is
104                 enabled for the device. Develo    134                 enabled for the device. Developer can write y/Y/1 or n/N/0 to
105                 the file to enable/disable the    135                 the file to enable/disable the feature.
106                                                   136 
107 What:           /sys/bus/usb/devices/.../power    137 What:           /sys/bus/usb/devices/.../power/usb3_hardware_lpm_u1
108                 /sys/bus/usb/devices/.../power    138                 /sys/bus/usb/devices/.../power/usb3_hardware_lpm_u2
109 Date:           November 2015                     139 Date:           November 2015
110 Contact:        Kevin Strasser <kevin.strasser@    140 Contact:        Kevin Strasser <kevin.strasser@linux.intel.com>
111                 Lu Baolu <baolu.lu@linux.intel.    141                 Lu Baolu <baolu.lu@linux.intel.com>
112 Description:                                      142 Description:
113                 If CONFIG_PM is set and a USB     143                 If CONFIG_PM is set and a USB 3.0 lpm-capable device is plugged
114                 in to a xHCI host which suppor    144                 in to a xHCI host which supports link PM, it will check if U1
115                 and U2 exit latencies have bee    145                 and U2 exit latencies have been set in the BOS descriptor; if
116                 the check is passed and the ho    146                 the check is passed and the host supports USB3 hardware LPM,
117                 USB3 hardware LPM will be enab    147                 USB3 hardware LPM will be enabled for the device and the USB
118                 device directory will contain     148                 device directory will contain two files named
119                 power/usb3_hardware_lpm_u1 and    149                 power/usb3_hardware_lpm_u1 and power/usb3_hardware_lpm_u2. These
120                 files hold a string value (ena    150                 files hold a string value (enable or disable) indicating whether
121                 or not USB3 hardware LPM U1 or    151                 or not USB3 hardware LPM U1 or U2 is enabled for the device.
122                                                   152 
                                                   >> 153 What:           /sys/bus/usb/devices/.../removable
                                                   >> 154 Date:           February 2012
                                                   >> 155 Contact:        Matthew Garrett <mjg@redhat.com>
                                                   >> 156 Description:
                                                   >> 157                 Some information about whether a given USB device is
                                                   >> 158                 physically fixed to the platform can be inferred from a
                                                   >> 159                 combination of hub descriptor bits and platform-specific data
                                                   >> 160                 such as ACPI. This file will read either "removable" or
                                                   >> 161                 "fixed" if the information is available, and "unknown"
                                                   >> 162                 otherwise.
                                                   >> 163 
123 What:           /sys/bus/usb/devices/.../ltm_c    164 What:           /sys/bus/usb/devices/.../ltm_capable
124 Date:           July 2012                         165 Date:           July 2012
125 Contact:        Sarah Sharp <sarah.a.sharp@linu    166 Contact:        Sarah Sharp <sarah.a.sharp@linux.intel.com>
126 Description:                                      167 Description:
127                 USB 3.0 devices may optionally    168                 USB 3.0 devices may optionally support Latency Tolerance
128                 Messaging (LTM).  They indicat    169                 Messaging (LTM).  They indicate their support by setting a bit
129                 in the bmAttributes field of t    170                 in the bmAttributes field of their SuperSpeed BOS descriptors.
130                 If that bit is set for the dev    171                 If that bit is set for the device, ltm_capable will read "yes".
131                 If the device doesn't support     172                 If the device doesn't support LTM, the file will read "no".
132                 The file will be present for a    173                 The file will be present for all speeds of USB devices, and will
133                 always read "no" for USB 1.1 a    174                 always read "no" for USB 1.1 and USB 2.0 devices.
134                                                   175 
135 What:           /sys/bus/usb/devices/<INTERFAC !! 176 What:           /sys/bus/usb/devices/.../(hub interface)/portX
136 Date:           February 2023                  << 
137 Contact:        Bastien Nocera <hadess@hadess.n << 
138 Description:                                   << 
139                 Some USB devices use a USB rec << 
140                 wirelessly with their device u << 
141                 attribute allows user-space to << 
142                 connected to its receiver dong << 
143                 the device to be absent when c << 
144                 device's battery, show a heads << 
145                 an on-screen keyboard if the o << 
146                 turned off.                    << 
147                 This attribute is not to be us << 
148                 statuses available in WWAN, WL << 
149                 If the device does not use a r << 
150                 device, then this attribute wi << 
151                                                << 
152 What:           /sys/bus/usb/devices/.../<hub_ << 
153 Date:           August 2012                       177 Date:           August 2012
154 Contact:        Lan Tianyu <tianyu.lan@intel.co    178 Contact:        Lan Tianyu <tianyu.lan@intel.com>
155 Description:                                      179 Description:
156                 The /sys/bus/usb/devices/.../< !! 180                 The /sys/bus/usb/devices/.../(hub interface)/portX
157                 is usb port device's sysfs dir    181                 is usb port device's sysfs directory.
158                                                   182 
159 What:           /sys/bus/usb/devices/.../<hub_ !! 183 What:           /sys/bus/usb/devices/.../(hub interface)/portX/connect_type
160 Date:           January 2013                      184 Date:           January 2013
161 Contact:        Lan Tianyu <tianyu.lan@intel.co    185 Contact:        Lan Tianyu <tianyu.lan@intel.com>
162 Description:                                      186 Description:
163                 Some platforms provide usb por    187                 Some platforms provide usb port connect types through ACPI.
164                 This attribute is to expose th    188                 This attribute is to expose these information to user space.
165                 The file will read "hotplug",  !! 189                 The file will read "hotplug", "wired" and "not used" if the
166                 information is available, and     190                 information is available, and "unknown" otherwise.
167                                                   191 
168 What:           /sys/bus/usb/devices/.../<hub_ !! 192 What:           /sys/bus/usb/devices/.../(hub interface)/portX/over_current_count
169 Date:           October 2018                   << 
170 Contact:        Bjørn Mork <bjorn@mork.no>     << 
171 Description:                                   << 
172                 Some platforms provide usb por << 
173                 firmware. This is used by the  << 
174                 mapping to the same physical c << 
175                 raw location value as a hex in << 
176                                                << 
177                                                << 
178 What:           /sys/bus/usb/devices/.../<hub_ << 
179 Date:           May 2018                       << 
180 Contact:        Nicolas Boichat <drinkcat@chrom << 
181 Description:                                   << 
182                 In some cases, we care about t << 
183                 connected on a specific port ( << 
184                 pogo pins), where the device t << 
185                 advance, and behaves well acco << 
186                 This attribute is a bit-field  << 
187                 a specific port:               << 
188                                                << 
189                  - Bit 0 of this field selects << 
190                    as it is considerably faste << 
191                    instead of 2).              << 
192                                                << 
193                    The old enumeration scheme  << 
194                    using /sys/module/usbcore/p << 
195                    it is often not desirable a << 
196                    increase compatibility with << 
197                  - Bit 1 reduces TRSTRCY to th << 
198                    USB 2.0 specification, inst << 
199                    used to help make enumerati << 
200                    devices.                    << 
201                                                << 
202 What:           /sys/bus/usb/devices/.../<hub_ << 
203 Date:           February 2018                     193 Date:           February 2018
204 Contact:        Richard Leitner <richard.leitne    194 Contact:        Richard Leitner <richard.leitner@skidata.com>
205 Description:                                      195 Description:
206                 Most hubs are able to detect o    196                 Most hubs are able to detect over-current situations on their
207                 ports and report them to the k    197                 ports and report them to the kernel. This attribute is to expose
208                 the number of over-current sit    198                 the number of over-current situation occurred on a specific port
209                 to user space. This file will     199                 to user space. This file will contain an unsigned 32 bit value
210                 which wraps to 0 after its max !! 200                 which wraps to 0 after its maximum is reached.
211                 poll() for monitoring changes  << 
212                                                << 
213                 Any time this value changes th << 
214                 udev event with the following  << 
215                                                << 
216                   OVER_CURRENT_PORT=/sys/bus/u << 
217                   OVER_CURRENT_COUNT=[current  << 
218                                                   201 
219 What:           /sys/bus/usb/devices/.../<hub_ !! 202 What:           /sys/bus/usb/devices/.../(hub interface)/portX/usb3_lpm_permit
220 Date:           November 2015                     203 Date:           November 2015
221 Contact:        Lu Baolu <baolu.lu@linux.intel.    204 Contact:        Lu Baolu <baolu.lu@linux.intel.com>
222 Description:                                      205 Description:
223                 Some USB3.0 devices are not fr    206                 Some USB3.0 devices are not friendly to USB3 LPM.  usb3_lpm_permit
224                 attribute allows enabling/disa    207                 attribute allows enabling/disabling usb3 lpm of a port. It takes
225                 effect both before and after a    208                 effect both before and after a usb device is enumerated. Supported
226                 values are "0" if both u1 and     209                 values are "0" if both u1 and u2 are NOT permitted, "u1" if only u1
227                 is permitted, "u2" if only u2     210                 is permitted, "u2" if only u2 is permitted, "u1_u2" if both u1 and
228                 u2 are permitted.                 211                 u2 are permitted.
229                                                   212 
230 What:           /sys/bus/usb/devices/.../<hub_ << 
231 Date:           December 2021                  << 
232 Contact:        Heikki Krogerus <heikki.krogeru << 
233 Description:                                   << 
234                 Link to the USB Type-C connect << 
235                 only created when USB Type-C C << 
236                 only if the system firmware is << 
237                 connection between a port and  << 
238                                                << 
239 What:           /sys/bus/usb/devices/.../<hub_ << 
240 Date:           June 2022                      << 
241 Contact:        Michael Grzeschik <m.grzeschik@ << 
242 Description:                                   << 
243                 This file controls the state o << 
244                 Vbus power output (but only on << 
245                 power switching -- most hubs d << 
246                 a port is disabled, the port i << 
247                 attached to the port will not  << 
248                 or enumerated.                 << 
249                                                << 
250 What:           /sys/bus/usb/devices/.../<hub_ << 
251 Date:           Sep 2022                       << 
252 Contact:        Ray Chi <raychi@google.com>     << 
253 Description:                                   << 
254                 Some USB hosts have some watch << 
255                 may enter ramdump if it takes  << 
256                 This attribute allows each por << 
257                 port initialization will be fa << 
258                 which is marked with early_sto << 
259                 all future connections until t << 
260                                                << 
261 What:           /sys/bus/usb/devices/.../<hub_ << 
262 Date:           June 2023                      << 
263 Contact:        Roy Luo <royluo@google.com>     << 
264 Description:                                   << 
265                 Indicates current state of the << 
266                 Valid states are: 'not-attache << 
267                 'reconnecting', 'unauthenticat << 
268                 'configured', and 'suspended'. << 
269                 monitor the state change from  << 
270                                                << 
271 What:           /sys/bus/usb/devices/.../power    213 What:           /sys/bus/usb/devices/.../power/usb2_lpm_l1_timeout
272 Date:           May 2013                          214 Date:           May 2013
273 Contact:        Mathias Nyman <mathias.nyman@li    215 Contact:        Mathias Nyman <mathias.nyman@linux.intel.com>
274 Description:                                      216 Description:
275                 USB 2.0 devices may support ha    217                 USB 2.0 devices may support hardware link power management (LPM)
276                 L1 sleep state. The usb2_lpm_l    218                 L1 sleep state. The usb2_lpm_l1_timeout attribute allows
277                 tuning the timeout for L1 inac    219                 tuning the timeout for L1 inactivity timer (LPM timer), e.g.
278                 needed inactivity time before     220                 needed inactivity time before host requests the device to go to L1 sleep.
279                 Useful for power management tu    221                 Useful for power management tuning.
280                 Supported values are 0 - 65535    222                 Supported values are 0 - 65535 microseconds.
281                                                   223 
282 What:           /sys/bus/usb/devices/.../power    224 What:           /sys/bus/usb/devices/.../power/usb2_lpm_besl
283 Date:           May 2013                          225 Date:           May 2013
284 Contact:        Mathias Nyman <mathias.nyman@li    226 Contact:        Mathias Nyman <mathias.nyman@linux.intel.com>
285 Description:                                      227 Description:
286                 USB 2.0 devices that support h    228                 USB 2.0 devices that support hardware link power management (LPM)
287                 L1 sleep state now use a best     229                 L1 sleep state now use a best effort service latency value (BESL) to
288                 indicate the best effort to re    230                 indicate the best effort to resumption of service to the device after the
289                 initiation of the resume event    231                 initiation of the resume event.
290                 If the device does not have a     232                 If the device does not have a preferred besl value then the host can select
291                 one instead. This usb2_lpm_bes    233                 one instead. This usb2_lpm_besl attribute allows to tune the host selected besl
292                 value in order to tune power s    234                 value in order to tune power saving and service latency.
293                                                   235 
294                 Supported values are 0 - 15.      236                 Supported values are 0 - 15.
295                 More information on how besl v    237                 More information on how besl values map to microseconds can be found in
296                 USB 2.0 ECN Errata for Link Po    238                 USB 2.0 ECN Errata for Link Power Management, section 4.10)
297                                                << 
298 What:           /sys/bus/usb/devices/.../rx_la << 
299 Date:           March 2018                     << 
300 Contact:        Mathias Nyman <mathias.nyman@li << 
301 Description:                                   << 
302                 Number of rx lanes the device  << 
303                 USB 3.2 adds Dual-lane support << 
304                 Inter-Chip SSIC devices suppor << 
305                 direction. Devices before USB  << 
306                                                << 
307 What:           /sys/bus/usb/devices/.../tx_la << 
308 Date:           March 2018                     << 
309 Contact:        Mathias Nyman <mathias.nyman@li << 
310 Description:                                   << 
311                 Number of tx lanes the device  << 
312                 USB 3.2 adds Dual-lane support << 
313                 Inter-Chip SSIC devices suppor << 
314                 direction. Devices before USB  << 
315                                                << 
316 What:           /sys/bus/usb/devices/.../typec << 
317 Date:           November 2023                  << 
318 Contact:        Heikki Krogerus <heikki.krogeru << 
319 Description:                                   << 
320                 Symlink to the USB Type-C part << 
321                 represents the component that  << 
322                 Configuration Channel (CC sign << 
323                 cables) with the local port.   << 
324                                                << 
325 What:           /sys/bus/usb/devices/usbX/bAlt << 
326 Description:                                   << 
327                 The current interface alternat << 
328                                                << 
329                 See USB specs for its meaning. << 
330                                                << 
331 What:           /sys/bus/usb/devices/usbX/bcdD << 
332 Description:                                   << 
333                 The device's release number, i << 
334                                                << 
335                 See USB specs for its meaning. << 
336                                                << 
337 What:           /sys/bus/usb/devices/usbX/bCon << 
338 Description:                                   << 
339                 While a USB device typically h << 
340                 setting, some devices support  << 
341                                                << 
342                 This value shows the current c << 
343                                                << 
344                 Changing its value will change << 
345                 to another setting.            << 
346                                                << 
347                 The number of configurations s << 
348                                                << 
349                         /sys/bus/usb/devices/u << 
350                                                << 
351                 See USB specs for its meaning. << 
352                                                << 
353 What:           /sys/bus/usb/devices/usbX/bDev << 
354 Description:                                   << 
355                 Class code of the device, in h << 
356                                                << 
357                 See USB specs for its meaning. << 
358                                                << 
359 What:           /sys/bus/usb/devices/usbX/bDev << 
360 Description:                                   << 
361                 Protocol code of the device, i << 
362                                                << 
363                 See USB specs for its meaning. << 
364                                                << 
365 What:           /sys/bus/usb/devices/usbX/bDev << 
366 Description:                                   << 
367                 Subclass code of the device, i << 
368                                                << 
369                 See USB specs for its meaning. << 
370                                                << 
371 What:           /sys/bus/usb/devices/usbX/bInt << 
372 Description:                                   << 
373                 Class code of the interface, i << 
374                                                << 
375                 See USB specs for its meaning. << 
376                                                << 
377 What:           /sys/bus/usb/devices/usbX/bInt << 
378 Description:                                   << 
379                 Interface number, in hexadecim << 
380                                                << 
381                 See USB specs for its meaning. << 
382                                                << 
383 What:           /sys/bus/usb/devices/usbX/bInt << 
384 Description:                                   << 
385                 Protocol code of the interface << 
386                                                << 
387                 See USB specs for its meaning. << 
388                                                << 
389 What:           /sys/bus/usb/devices/usbX/bInt << 
390 Description:                                   << 
391                 Subclass code of the interface << 
392                                                << 
393                 See USB specs for its meaning. << 
394                                                << 
395 What:           /sys/bus/usb/devices/usbX/bmAt << 
396 Description:                                   << 
397                 Attributes of the current conf << 
398                                                << 
399                 See USB specs for its meaning. << 
400                                                << 
401 What:           /sys/bus/usb/devices/usbX/bMax << 
402 Description:                                   << 
403                 Maximum endpoint 0 packet size << 
404                                                << 
405                 See USB specs for its meaning. << 
406                                                << 
407 What:           /sys/bus/usb/devices/usbX/bMax << 
408 Description:                                   << 
409                 Maximum power consumption of t << 
410                 the device, in miliamperes.    << 
411                                                << 
412 What:           /sys/bus/usb/devices/usbX/bNum << 
413 Description:                                   << 
414                 Number of the possible configu << 
415                 decimal. The current configura << 
416                                                << 
417                         /sys/bus/usb/devices/u << 
418                                                << 
419                 See USB specs for its meaning. << 
420                                                << 
421 What:           /sys/bus/usb/devices/usbX/bNum << 
422 Description:                                   << 
423                 Number of endpoints used on th << 
424                                                << 
425                 See USB specs for its meaning. << 
426                                                << 
427 What:           /sys/bus/usb/devices/usbX/bNum << 
428 Description:                                   << 
429                 Number of interfaces on this d << 
430                                                << 
431 What:           /sys/bus/usb/devices/usbX/busn << 
432 Description:                                   << 
433                 Number of the bus.             << 
434                                                << 
435 What:           /sys/bus/usb/devices/usbX/conf << 
436 Description:                                   << 
437                 Contents of the string descrip << 
438                 current configuration. It may  << 
439                 of a device and/or its serial  << 
440                                                << 
441 What:           /sys/bus/usb/devices/usbX/desc << 
442 Description:                                   << 
443                 Contains the interface descrip << 
444                                                << 
445 What:           /sys/bus/usb/devices/usbX/bos_ << 
446 Date:           March 2024                     << 
447 Contact:        Elbert Mai <code@elbertmai.com> << 
448 Description:                                   << 
449                 Binary file containing the cac << 
450                 of the device. This consists o << 
451                 set of device capability descr << 
452                 this file are in bus-endian fo << 
453                 request the BOS from a device  << 
454                                                << 
455 What:           /sys/bus/usb/devices/usbX/idPr << 
456 Description:                                   << 
457                 Product ID, in hexadecimal.    << 
458                                                << 
459 What:           /sys/bus/usb/devices/usbX/idVe << 
460 Description:                                   << 
461                 Vendor ID, in hexadecimal.     << 
462                                                << 
463 What:           /sys/bus/usb/devices/usbX/devs << 
464 Description:                                   << 
465                 Displays the Device Tree Open  << 
466                                                << 
467 What:           /sys/bus/usb/devices/usbX/avoi << 
468 Description:                                   << 
469                 Most devices have this set to  << 
470                                                << 
471                 If the value is 1, enable a US << 
472                 device to use reset.           << 
473                                                << 
474                 (read/write)                   << 
475                                                << 
476 What:           /sys/bus/usb/devices/usbX/devn << 
477 Description:                                   << 
478                 USB interface device number, i << 
479                                                << 
480 What:           /sys/bus/usb/devices/usbX/devp << 
481 Description:                                   << 
482                 String containing the USB inte << 
483                                                << 
484 What:           /sys/bus/usb/devices/usbX/manu << 
485 Description:                                   << 
486                 Vendor specific string contain << 
487                 manufacturer of the device.    << 
488                                                << 
489 What:           /sys/bus/usb/devices/usbX/maxc << 
490 Description:                                   << 
491                 Number of ports of an USB hub  << 
492                                                << 
493 What:           /sys/bus/usb/devices/usbX/pers << 
494 Description:                                   << 
495                 Keeps the device even if it ge << 
496                                                << 
497 What:           /sys/bus/usb/devices/usbX/prod << 
498 Description:                                   << 
499                 Vendor specific string contain << 
500                 device's product.              << 
501                                                << 
502 What:           /sys/bus/usb/devices/usbX/spee << 
503 Description:                                   << 
504                 Shows the device's max speed,  << 
505                 in Mbps.                       << 
506                 Can be:                        << 
507                                                << 
508                         =======         ====== << 
509                         Unknown         speed  << 
510                         1.5             Low sp << 
511                         15              Full s << 
512                         480             High S << 
513                         5000            Super  << 
514                         10000           Super  << 
515                         20000           Super  << 
516                         =======         ====== << 
517                                                << 
518 What:           /sys/bus/usb/devices/usbX/supp << 
519 Description:                                   << 
520                 Returns 1 if the device doesn' << 
521                 Otherwise, returns 0.          << 
522                                                << 
523 What:           /sys/bus/usb/devices/usbX/urbn << 
524 Description:                                   << 
525                 Number of URBs submitted for t << 
526                                                << 
527 What:           /sys/bus/usb/devices/usbX/vers << 
528 Description:                                   << 
529                 String containing the USB devi << 
530                 at the BCD descriptor.         << 
531                                                << 
532 What:           /sys/bus/usb/devices/usbX/powe << 
533 Description:                                   << 
534                 Time in milliseconds for the d << 
535                 value is negative, then autosu << 
536                                                << 
537                 (read/write)                   << 
538                                                << 
539 What:           /sys/bus/usb/devices/usbX/powe << 
540 Description:                                   << 
541                 The total time the device has  << 
542                                                << 
543 What:           /sys/bus/usb/devices/usbX/powe << 
544 Description:                                   << 
545                 The total time (in msec) that  << 
546                                                << 
547 What:           /sys/bus/usb/devices/usbX/powe << 
548 Description:                                   << 
549                                                << 
550 What:           /sys/bus/usb/devices/usbX/ep_< << 
551 Description:                                   << 
552                 The address of the endpoint de << 
553                 in hexadecimal. The endpoint d << 
554                 is also shown at:              << 
555                                                << 
556                         /sys/bus/usb/devices/u << 
557                                                << 
558                 See USB specs for its meaning. << 
559                                                << 
560 What:           /sys/bus/usb/devices/usbX/ep_< << 
561 Description:                                   << 
562                 The interval of the endpoint a << 
563                 in hexadecimal. The actual int << 
564                 of the USB. Also shown in time << 
565                 /sys/bus/usb/devices/usbX/ep_< << 
566                                                << 
567 What:           /sys/bus/usb/devices/usbX/ep_< << 
568 Description:                                   << 
569                 Number of bytes of the endpoin << 
570                                                << 
571 What:           /sys/bus/usb/devices/usbX/ep_< << 
572 Description:                                   << 
573                 Attributes which apply to the  << 
574                 descriptor, in hexadecimal. Th << 
575                 bitmapped field is also shown  << 
576                                                << 
577                         /sys/bus/usb/devices/u << 
578                                                << 
579                 See USB specs for its meaning. << 
580                                                << 
581 What:           /sys/bus/usb/devices/usbX/ep_< << 
582 Description:                                   << 
583                 Direction of the endpoint. Can << 
584                                                << 
585                     - both (on control endpoin << 
586                     - in                       << 
587                     - out                      << 
588                                                << 
589 What:           /sys/bus/usb/devices/usbX/ep_< << 
590 Description:                                   << 
591                 Interval for polling endpoint  << 
592                 milisseconds or microseconds.  << 
593                                                << 
594 What:           /sys/bus/usb/devices/usbX/ep_< << 
595 Description:                                   << 
596                 Descriptor type. Can be:       << 
597                                                << 
598                     - Control                  << 
599                     - Isoc                     << 
600                     - Bulk                     << 
601                     - Interrupt                << 
602                     - unknown                  << 
603                                                << 
604 What:           /sys/bus/usb/devices/usbX/ep_< << 
605 Description:                                   << 
606                 Maximum packet size this endpo << 
607                 sending or receiving, in hexad << 
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php