요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Hub ports, power-state policy, and lane topology
sysfs-bus-usb:152-323Hub port의 연결 유형·위치·quirk·과전류·LPM·비활성화·상태를 제공하고 USB2 BESL·L1 timeout, RX/TX lane 및 Type-C partner link를 다룹니다.
Device descriptors, identity, speed, and runtime power
sysfs-bus-usb:325-545USB device와 interface descriptor 필드, BOS binary, vendor/product identity, speed, URB count 및 autosuspend·active·connected 시간을 노출합니다.
Endpoint descriptor and transfer attributes
sysfs-bus-usb:547-607Power level의 빈 ABI 항목과 endpoint address·interval·length·attribute·direction·type·maximum packet size를 보존합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/usb/devices/<INTERFACE>/authorized
2
Date: August 2015
3
Description:
4
This allows to authorize (1) or deauthorize (0)
5
individual interfaces instead a whole device
6
in contrast to the device authorization.
7
If a deauthorized interface will be authorized
8
so the driver probing must be triggered manually
9
by writing INTERFACE to /sys/bus/usb/drivers_probe
10
This allows to avoid side-effects with drivers
11
that need multiple interfaces.
13
A deauthorized interface cannot be probed or claimed.
15
What: /sys/bus/usb/devices/usbX/interface_authorized_default
16
Date: August 2015
17
Description:
18
This is used as value that determines if interfaces
19
would be authorized by default.
20
The value can be 1 or 0. It's by default 1.
22
What: /sys/bus/usb/device/.../authorized
23
Date: July 2008
24
KernelVersion: 2.6.26
25
Contact: David Vrabel <david.vrabel@csr.com>
26
Description:
27
Authorized devices are available for use by device
28
drivers, non-authorized one are not. By default, wired
29
USB devices are authorized.
31
What: /sys/bus/usb/drivers/.../new_id
32
Date: October 2011
33
Contact: linux-usb@vger.kernel.org
34
Description:
35
Writing a device ID to this file will attempt to
36
dynamically add a new device ID to a USB device driver.
37
This may allow the driver to support more hardware than
38
was included in the driver's static device ID support
39
table at compile time. The format for the device ID is:
40
idVendor idProduct bInterfaceClass RefIdVendor RefIdProduct
41
The vendor ID and device ID fields are required, the
42
rest is optional. The `Ref*` tuple can be used to tell the
43
driver to use the same driver_data for the new device as
44
it is used for the reference device.
45
Upon successfully adding an ID, the driver will probe
46
for the device and attempt to bind to it. For example::
48
# echo "8086 10f5" > /sys/bus/usb/drivers/foo/new_id
50
Here add a new device (0458:7045) using driver_data from
51
an already supported device (0458:704c)::
53
# echo "0458 7045 0 0458 704c" > /sys/bus/usb/drivers/foo/new_id
55
Reading from this file will list all dynamically added
56
device IDs in the same format, with one entry per
57
line. For example::
59
# cat /sys/bus/usb/drivers/foo/new_id
60
8086 10f5
61
dead beef 06
62
f00d cafe
64
The list will be truncated at PAGE_SIZE bytes due to
65
sysfs restrictions.
67
What: /sys/bus/usb-serial/drivers/.../new_id
68
Date: October 2011
69
Contact: linux-usb@vger.kernel.org
70
Description:
71
For serial USB drivers, this attribute appears under the
72
extra bus folder "usb-serial" in sysfs; apart from that
73
difference, all descriptions from the entry
74
"/sys/bus/usb/drivers/.../new_id" apply.
76
What: /sys/bus/usb/drivers/.../remove_id
77
Date: November 2009
78
Contact: CHENG Renquan <rqcheng@smu.edu.sg>
79
Description:
80
Writing a device ID to this file will remove an ID
81
that was dynamically added via the new_id sysfs entry.
82
The format for the device ID is:
83
idVendor idProduct. After successfully
84
removing an ID, the driver will no longer support the
85
device. This is useful to ensure auto probing won't
86
match the driver to the device. For example:
87
# echo "046d c315" > /sys/bus/usb/drivers/foo/remove_id
89
Reading from this file will list the dynamically added
90
device IDs, exactly like reading from the entry
91
"/sys/bus/usb/drivers/.../new_id"
93
What: /sys/bus/usb/devices/.../power/usb2_hardware_lpm
94
Date: September 2011
95
Contact: Andiry Xu <andiry.xu@amd.com>
96
Description:
97
If CONFIG_PM is set and a USB 2.0 lpm-capable device is plugged
98
in to a xHCI host which support link PM, it will perform a LPM
99
test; if the test is passed and host supports USB2 hardware LPM
100
(xHCI 1.0 feature), USB2 hardware LPM will be enabled for the
101
device and the USB device directory will contain a file named
102
power/usb2_hardware_lpm. The file holds a string value (enable
103
or disable) indicating whether or not USB2 hardware LPM is
104
enabled for the device. Developer can write y/Y/1 or n/N/0 to
105
the file to enable/disable the feature.
107
What: /sys/bus/usb/devices/.../power/usb3_hardware_lpm_u1
108
/sys/bus/usb/devices/.../power/usb3_hardware_lpm_u2
109
Date: November 2015
110
Contact: Kevin Strasser <kevin.strasser@linux.intel.com>
111
Lu Baolu <baolu.lu@linux.intel.com>
112
Description:
113
If CONFIG_PM is set and a USB 3.0 lpm-capable device is plugged
114
in to a xHCI host which supports link PM, it will check if U1
115
and U2 exit latencies have been set in the BOS descriptor; if
116
the check is passed and the host supports USB3 hardware LPM,
117
USB3 hardware LPM will be enabled for the device and the USB
118
device directory will contain two files named
119
power/usb3_hardware_lpm_u1 and power/usb3_hardware_lpm_u2. These
120
files hold a string value (enable or disable) indicating whether
121
or not USB3 hardware LPM U1 or U2 is enabled for the device.
123
What: /sys/bus/usb/devices/.../ltm_capable
124
Date: July 2012
125
Contact: Sarah Sharp <sarah.a.sharp@linux.intel.com>
126
Description:
127
USB 3.0 devices may optionally support Latency Tolerance
128
Messaging (LTM). They indicate their support by setting a bit
129
in the bmAttributes field of their SuperSpeed BOS descriptors.
130
If that bit is set for the device, ltm_capable will read "yes".
131
If the device doesn't support LTM, the file will read "no".
132
The file will be present for all speeds of USB devices, and will
133
always read "no" for USB 1.1 and USB 2.0 devices.
135
What: /sys/bus/usb/devices/<INTERFACE>/wireless_status
136
Date: February 2023
137
Contact: Bastien Nocera <hadess@hadess.net>
138
Description:
139
Some USB devices use a USB receiver dongle to communicate
140
wirelessly with their device using proprietary protocols. This
141
attribute allows user-space to know whether the device is
142
connected to its receiver dongle, and, for example, consider
143
the device to be absent when choosing whether to show the
144
device's battery, show a headset in a list of outputs, or show
145
an on-screen keyboard if the only wireless keyboard is
146
turned off.
147
This attribute is not to be used to replace protocol specific
148
statuses available in WWAN, WLAN/Wi-Fi, Bluetooth, etc.
149
If the device does not use a receiver dongle with a wireless
150
device, then this attribute will not exist.
152
What: /sys/bus/usb/devices/.../<hub_interface>/port<X>
153
Date: August 2012
154
Contact: Lan Tianyu <tianyu.lan@intel.com>
155
Description:
156
The /sys/bus/usb/devices/.../<hub_interface>/port<X>
157
is usb port device's sysfs directory.
159
What: /sys/bus/usb/devices/.../<hub_interface>/port<X>/connect_type
160
Date: January 2013
161
Contact: Lan Tianyu <tianyu.lan@intel.com>
162
Description:
163
Some platforms provide usb port connect types through ACPI.
164
This attribute is to expose these information to user space.
165
The file will read "hotplug", "hardwired" and "not used" if the
166
information is available, and "unknown" otherwise.
168
What: /sys/bus/usb/devices/.../<hub_interface>/port<X>/location
169
Date: October 2018
170
Contact: Bjørn Mork <bjorn@mork.no>
171
Description:
172
Some platforms provide usb port physical location through
173
firmware. This is used by the kernel to pair up logical ports
174
mapping to the same physical connector. The attribute exposes the
175
raw location value as a hex integer.
178
What: /sys/bus/usb/devices/.../<hub_interface>/port<X>/quirks
179
Date: May 2018
180
Contact: Nicolas Boichat <drinkcat@chromium.org>
181
Description:
182
In some cases, we care about time-to-active for devices
183
connected on a specific port (e.g. non-standard USB port like
184
pogo pins), where the device to be connected is known in
185
advance, and behaves well according to the specification.
186
This attribute is a bit-field that controls the behavior of
187
a specific port:
189
- Bit 0 of this field selects the "old" enumeration scheme,
190
as it is considerably faster (it only causes one USB reset
191
instead of 2).
193
The old enumeration scheme can also be selected globally
194
using /sys/module/usbcore/parameters/old_scheme_first, but
195
it is often not desirable as the new scheme was introduced to
196
increase compatibility with more devices.
197
- Bit 1 reduces TRSTRCY to the 10 ms that are required by the
198
USB 2.0 specification, instead of the 50 ms that are normally
199
used to help make enumeration work better on some high speed
200
devices.
202
What: /sys/bus/usb/devices/.../<hub_interface>/port<X>/over_current_count
203
Date: February 2018
204
Contact: Richard Leitner <richard.leitner@skidata.com>
205
Description:
206
Most hubs are able to detect over-current situations on their
207
ports and report them to the kernel. This attribute is to expose
208
the number of over-current situation occurred on a specific port
209
to user space. This file will contain an unsigned 32 bit value
210
which wraps to 0 after its maximum is reached. This file supports
211
poll() for monitoring changes to this value in user space.
213
Any time this value changes the corresponding hub device will send a
214
udev event with the following attributes::
216
OVER_CURRENT_PORT=/sys/bus/usb/devices/.../<hub_interface>/port<X>
217
OVER_CURRENT_COUNT=[current value of this sysfs attribute]
219
What: /sys/bus/usb/devices/.../<hub_interface>/port<X>/usb3_lpm_permit
220
Date: November 2015
221
Contact: Lu Baolu <baolu.lu@linux.intel.com>
222
Description:
223
Some USB3.0 devices are not friendly to USB3 LPM. usb3_lpm_permit
224
attribute allows enabling/disabling usb3 lpm of a port. It takes
225
effect both before and after a usb device is enumerated. Supported
226
values are "0" if both u1 and u2 are NOT permitted, "u1" if only u1
227
is permitted, "u2" if only u2 is permitted, "u1_u2" if both u1 and
228
u2 are permitted.
230
What: /sys/bus/usb/devices/.../<hub_interface>/port<X>/connector
231
Date: December 2021
232
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
233
Description:
234
Link to the USB Type-C connector when available. This link is
235
only created when USB Type-C Connector Class is enabled, and
236
only if the system firmware is capable of describing the
237
connection between a port and its connector.
239
What: /sys/bus/usb/devices/.../<hub_interface>/port<X>/disable
240
Date: June 2022
241
Contact: Michael Grzeschik <m.grzeschik@pengutronix.de>
242
Description:
243
This file controls the state of a USB port, including
244
Vbus power output (but only on hubs that support
245
power switching -- most hubs don't support it). If
246
a port is disabled, the port is unusable: Devices
247
attached to the port will not be detected, initialized,
248
or enumerated.
250
What: /sys/bus/usb/devices/.../<hub_interface>/port<X>/early_stop
251
Date: Sep 2022
252
Contact: Ray Chi <raychi@google.com>
253
Description:
254
Some USB hosts have some watchdog mechanisms so that the device
255
may enter ramdump if it takes a long time during port initialization.
256
This attribute allows each port just has two attempts so that the
257
port initialization will be failed quickly. In addition, if a port
258
which is marked with early_stop has failed to initialize, it will ignore
259
all future connections until this attribute is clear.
261
What: /sys/bus/usb/devices/.../<hub_interface>/port<X>/state
262
Date: June 2023
263
Contact: Roy Luo <royluo@google.com>
264
Description:
265
Indicates current state of the USB device attached to the port.
266
Valid states are: 'not-attached', 'attached', 'powered',
267
'reconnecting', 'unauthenticated', 'default', 'addressed',
268
'configured', and 'suspended'. This file supports poll() to
269
monitor the state change from user space.
271
What: /sys/bus/usb/devices/.../power/usb2_lpm_l1_timeout
272
Date: May 2013
273
Contact: Mathias Nyman <mathias.nyman@linux.intel.com>
274
Description:
275
USB 2.0 devices may support hardware link power management (LPM)
276
L1 sleep state. The usb2_lpm_l1_timeout attribute allows
277
tuning the timeout for L1 inactivity timer (LPM timer), e.g.
278
needed inactivity time before host requests the device to go to L1 sleep.
279
Useful for power management tuning.
280
Supported values are 0 - 65535 microseconds.
282
What: /sys/bus/usb/devices/.../power/usb2_lpm_besl
283
Date: May 2013
284
Contact: Mathias Nyman <mathias.nyman@linux.intel.com>
285
Description:
286
USB 2.0 devices that support hardware link power management (LPM)
287
L1 sleep state now use a best effort service latency value (BESL) to
288
indicate the best effort to resumption of service to the device after the
289
initiation of the resume event.
290
If the device does not have a preferred besl value then the host can select
291
one instead. This usb2_lpm_besl attribute allows to tune the host selected besl
292
value in order to tune power saving and service latency.
294
Supported values are 0 - 15.
295
More information on how besl values map to microseconds can be found in
296
USB 2.0 ECN Errata for Link Power Management, section 4.10)
298
What: /sys/bus/usb/devices/.../rx_lanes
299
Date: March 2018
300
Contact: Mathias Nyman <mathias.nyman@linux.intel.com>
301
Description:
302
Number of rx lanes the device is using.
303
USB 3.2 adds Dual-lane support, 2 rx and 2 tx lanes over Type-C.
304
Inter-Chip SSIC devices support asymmetric lanes up to 4 lanes per
305
direction. Devices before USB 3.2 are single lane (rx_lanes = 1)
307
What: /sys/bus/usb/devices/.../tx_lanes
308
Date: March 2018
309
Contact: Mathias Nyman <mathias.nyman@linux.intel.com>
310
Description:
311
Number of tx lanes the device is using.
312
USB 3.2 adds Dual-lane support, 2 rx and 2 tx -lanes over Type-C.
313
Inter-Chip SSIC devices support asymmetric lanes up to 4 lanes per
314
direction. Devices before USB 3.2 are single lane (tx_lanes = 1)
316
What: /sys/bus/usb/devices/.../typec
317
Date: November 2023
318
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
319
Description:
320
Symlink to the USB Type-C partner device. USB Type-C partner
321
represents the component that communicates over the
322
Configuration Channel (CC signal on USB Type-C connectors and
323
cables) with the local port.
325
What: /sys/bus/usb/devices/usbX/bAlternateSetting
326
Description:
327
The current interface alternate setting number, in decimal.
329
See USB specs for its meaning.
331
What: /sys/bus/usb/devices/usbX/bcdDevice
332
Description:
333
The device's release number, in hexadecimal.
335
See USB specs for its meaning.
337
What: /sys/bus/usb/devices/usbX/bConfigurationValue
338
Description:
339
While a USB device typically have just one configuration
340
setting, some devices support multiple configurations.
342
This value shows the current configuration, in decimal.
344
Changing its value will change the device's configuration
345
to another setting.
347
The number of configurations supported by a device is at:
349
/sys/bus/usb/devices/usbX/bNumConfigurations
351
See USB specs for its meaning.
353
What: /sys/bus/usb/devices/usbX/bDeviceClass
354
Description:
355
Class code of the device, in hexadecimal.
357
See USB specs for its meaning.
359
What: /sys/bus/usb/devices/usbX/bDeviceProtocol
360
Description:
361
Protocol code of the device, in hexadecimal.
363
See USB specs for its meaning.
365
What: /sys/bus/usb/devices/usbX/bDeviceSubClass
366
Description:
367
Subclass code of the device, in hexadecimal.
369
See USB specs for its meaning.
371
What: /sys/bus/usb/devices/usbX/bInterfaceClass
372
Description:
373
Class code of the interface, in hexadecimal.
375
See USB specs for its meaning.
377
What: /sys/bus/usb/devices/usbX/bInterfaceNumber
378
Description:
379
Interface number, in hexadecimal.
381
See USB specs for its meaning.
383
What: /sys/bus/usb/devices/usbX/bInterfaceProtocol
384
Description:
385
Protocol code of the interface, in hexadecimal.
387
See USB specs for its meaning.
389
What: /sys/bus/usb/devices/usbX/bInterfaceSubClass
390
Description:
391
Subclass code of the interface, in hexadecimal.
393
See USB specs for its meaning.
395
What: /sys/bus/usb/devices/usbX/bmAttributes
396
Description:
397
Attributes of the current configuration, in hexadecimal.
399
See USB specs for its meaning.
401
What: /sys/bus/usb/devices/usbX/bMaxPacketSize0
402
Description:
403
Maximum endpoint 0 packet size, in decimal.
405
See USB specs for its meaning.
407
What: /sys/bus/usb/devices/usbX/bMaxPower
408
Description:
409
Maximum power consumption of the active configuration of
410
the device, in miliamperes.
412
What: /sys/bus/usb/devices/usbX/bNumConfigurations
413
Description:
414
Number of the possible configurations of the device, in
415
decimal. The current configuration is controlled via:
417
/sys/bus/usb/devices/usbX/bConfigurationValue
419
See USB specs for its meaning.
421
What: /sys/bus/usb/devices/usbX/bNumEndpoints
422
Description:
423
Number of endpoints used on this interface, in hexadecimal.
425
See USB specs for its meaning.
427
What: /sys/bus/usb/devices/usbX/bNumInterfaces
428
Description:
429
Number of interfaces on this device, in decimal.
431
What: /sys/bus/usb/devices/usbX/busnum
432
Description:
433
Number of the bus.
435
What: /sys/bus/usb/devices/usbX/configuration
436
Description:
437
Contents of the string descriptor associated with the
438
current configuration. It may include the firmware version
439
of a device and/or its serial number.
441
What: /sys/bus/usb/devices/usbX/descriptors
442
Description:
443
Contains the interface descriptors, in binary.
445
What: /sys/bus/usb/devices/usbX/bos_descriptors
446
Date: March 2024
447
Contact: Elbert Mai <code@elbertmai.com>
448
Description:
449
Binary file containing the cached binary device object store (BOS)
450
of the device. This consists of the BOS descriptor followed by the
451
set of device capability descriptors. All descriptors read from
452
this file are in bus-endian format. Note that the kernel will not
453
request the BOS from a device if its bcdUSB is less than 0x0201.
455
What: /sys/bus/usb/devices/usbX/idProduct
456
Description:
457
Product ID, in hexadecimal.
459
What: /sys/bus/usb/devices/usbX/idVendor
460
Description:
461
Vendor ID, in hexadecimal.
463
What: /sys/bus/usb/devices/usbX/devspec
464
Description:
465
Displays the Device Tree Open Firmware node of the interface.
467
What: /sys/bus/usb/devices/usbX/avoid_reset_quirk
468
Description:
469
Most devices have this set to zero.
471
If the value is 1, enable a USB quirk that prevents this
472
device to use reset.
474
(read/write)
476
What: /sys/bus/usb/devices/usbX/devnum
477
Description:
478
USB interface device number, in decimal.
480
What: /sys/bus/usb/devices/usbX/devpath
481
Description:
482
String containing the USB interface device path.
484
What: /sys/bus/usb/devices/usbX/manufacturer
485
Description:
486
Vendor specific string containing the name of the
487
manufacturer of the device.
489
What: /sys/bus/usb/devices/usbX/maxchild
490
Description:
491
Number of ports of an USB hub
493
What: /sys/bus/usb/devices/usbX/persist
494
Description:
495
Keeps the device even if it gets disconnected.
497
What: /sys/bus/usb/devices/usbX/product
498
Description:
499
Vendor specific string containing the name of the
500
device's product.
502
What: /sys/bus/usb/devices/usbX/speed
503
Description:
504
Shows the device's max speed, according to the USB version,
505
in Mbps.
506
Can be:
508
======= ====================
509
Unknown speed unknown
510
1.5 Low speed
511
15 Full speed
512
480 High Speed
513
5000 Super Speed
514
10000 Super Speed+
515
20000 Super Speed+ Gen 2x2
516
======= ====================
518
What: /sys/bus/usb/devices/usbX/supports_autosuspend
519
Description:
520
Returns 1 if the device doesn't support autosuspend.
521
Otherwise, returns 0.
523
What: /sys/bus/usb/devices/usbX/urbnum
524
Description:
525
Number of URBs submitted for the whole device.
527
What: /sys/bus/usb/devices/usbX/version
528
Description:
529
String containing the USB device version, as encoded
530
at the BCD descriptor.
532
What: /sys/bus/usb/devices/usbX/power/autosuspend
533
Description:
534
Time in milliseconds for the device to autosuspend. If the
535
value is negative, then autosuspend is prevented.
537
(read/write)
539
What: /sys/bus/usb/devices/usbX/power/active_duration
540
Description:
541
The total time the device has not been suspended.
543
What: /sys/bus/usb/devices/usbX/power/connected_duration
544
Description:
545
The total time (in msec) that the device has been connected.
547
What: /sys/bus/usb/devices/usbX/power/level
548
Description:
550
What: /sys/bus/usb/devices/usbX/ep_<N>/bEndpointAddress
551
Description:
552
The address of the endpoint described by this descriptor,
553
in hexadecimal. The endpoint direction on this bitmapped field
554
is also shown at:
556
/sys/bus/usb/devices/usbX/ep_<N>/direction
558
See USB specs for its meaning.
560
What: /sys/bus/usb/devices/usbX/ep_<N>/bInterval
561
Description:
562
The interval of the endpoint as described on its descriptor,
563
in hexadecimal. The actual interval depends on the version
564
of the USB. Also shown in time units at
565
/sys/bus/usb/devices/usbX/ep_<N>/interval.
567
What: /sys/bus/usb/devices/usbX/ep_<N>/bLength
568
Description:
569
Number of bytes of the endpoint descriptor, in hexadecimal.
571
What: /sys/bus/usb/devices/usbX/ep_<N>/bmAttributes
572
Description:
573
Attributes which apply to the endpoint as described on its
574
descriptor, in hexadecimal. The endpoint type on this
575
bitmapped field is also shown at:
577
/sys/bus/usb/devices/usbX/ep_<N>/type
579
See USB specs for its meaning.
581
What: /sys/bus/usb/devices/usbX/ep_<N>/direction
582
Description:
583
Direction of the endpoint. Can be:
585
- both (on control endpoints)
586
- in
587
- out
589
What: /sys/bus/usb/devices/usbX/ep_<N>/interval
590
Description:
591
Interval for polling endpoint for data transfers, in
592
milisseconds or microseconds.
594
What: /sys/bus/usb/devices/usbX/ep_<N>/type
595
Description:
596
Descriptor type. Can be:
598
- Control
599
- Isoc
600
- Bulk
601
- Interrupt
602
- unknown
604
What: /sys/bus/usb/devices/usbX/ep_<N>/wMaxPacketSize
605
Description:
606
Maximum packet size this endpoint is capable of
607
sending or receiving, in hexadecimal.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
개별 USB interface authorization
1-13| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/<INTERFACE>/authorized |
| Date | 2015년 8월 |
| Description | 전체 장치를 대상으로 하는 device authorization과 달리 개별 interface를 authorize(1)하거나 deauthorize(0)할 수 있습니다. Deauthorize한 interface를 다시 authorize할 때는 INTERFACE를 /sys/bus/usb/drivers_probe에 써서 driver probing을 수동으로 시작해야 합니다. 이 방식은 여러 interface가 필요한 driver의 부작용을 피할 수 있게 합니다. Deauthorize된 interface는 probe하거나 claim할 수 없습니다. |
USB interface 기본 authorization 값
15-20| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/interface_authorized_default |
| Date | 2015년 8월 |
| Description | Interface를 기본적으로 authorize할지 결정하는 값으로 사용합니다. 값은 1 또는 0이며 기본값은 1입니다. |
USB device authorization
22-29| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/device/.../authorized |
| Date | 2008년 7월 |
| KernelVersion | 2.6.26 |
| Contact | David Vrabel <david.vrabel@csr.com> |
| Description | Authorize된 장치는 device driver가 사용할 수 있지만 authorize되지 않은 장치는 사용할 수 없습니다. 유선 USB 장치는 기본적으로 authorize됩니다. |
USB driver의 동적 device ID 추가
31-65| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/drivers/.../new_id |
| Date | 2011년 10월 |
| Contact | linux-usb@vger.kernel.org |
| Description | 이 file에 device ID를 쓰면 USB device driver에 새 device ID를 동적으로 추가하려고 시도합니다. 이를 통해 compile 시점의 driver static device ID 지원 table에 포함되지 않은 hardware도 지원할 수 있습니다. Device ID 형식은 idVendor idProduct bInterfaceClass RefIdVendor RefIdProduct입니다. Vendor ID와 device ID는 필수이고 나머지는 선택 사항입니다. Ref* tuple을 사용하면 새 장치가 reference 장치와 같은 driver_data를 사용하도록 driver에 알릴 수 있습니다. ID 추가에 성공하면 driver는 장치를 probe하고 bind하려고 시도합니다. 읽으면 동적으로 추가한 모든 device ID를 같은 형식으로 한 줄에 하나씩 나열합니다. Sysfs 제한 때문에 목록은 PAGE_SIZE byte에서 잘립니다. |
# 새 device ID 8086:10f5 추가
# echo "8086 10f5" > /sys/bus/usb/drivers/foo/new_id
# 이미 지원하는 0458:704c의 driver_data를 사용해 0458:7045 추가
# echo "0458 7045 0 0458 704c" > /sys/bus/usb/drivers/foo/new_id
# cat /sys/bus/usb/drivers/foo/new_id
8086 10f5
dead beef 06
f00d cafe순서필드필수 여부의미
1idVendor필수USB vendor ID
2idProduct필수USB product ID
3bInterfaceClass선택대상 interface class
4-5RefIdVendor RefIdProduct선택driver_data를 재사용할 reference 장치
앞의 두 필드는 필수이며 interface class와 reference tuple은 선택 사항입니다.
USB serial driver의 동적 device ID 추가
67-74| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb-serial/drivers/.../new_id |
| Date | 2011년 10월 |
| Contact | linux-usb@vger.kernel.org |
| Description | Serial USB driver에서는 이 속성이 sysfs의 추가 bus directory인 usb-serial 아래에 나타납니다. 이 차이를 제외하면 /sys/bus/usb/drivers/.../new_id 항목의 모든 설명이 그대로 적용됩니다. |
USB driver의 동적 device ID 제거
76-91| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/drivers/.../remove_id |
| Date | 2009년 11월 |
| Contact | CHENG Renquan <rqcheng@smu.edu.sg> |
| Description | 이 file에 device ID를 쓰면 new_id sysfs 항목을 통해 동적으로 추가한 ID를 제거합니다. Device ID 형식은 idVendor idProduct입니다. ID를 성공적으로 제거하면 driver는 더 이상 해당 장치를 지원하지 않으므로 automatic probing이 그 장치를 driver와 match하지 않도록 보장할 때 유용합니다. 읽으면 /sys/bus/usb/drivers/.../new_id를 읽을 때와 똑같이 동적으로 추가된 device ID를 나열합니다. |
# echo "046d c315" > /sys/bus/usb/drivers/foo/remove_idUSB 2.0 hardware LPM 제어
93-105| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../power/usb2_hardware_lpm |
| Date | 2011년 9월 |
| Contact | Andiry Xu <andiry.xu@amd.com> |
| Description | CONFIG_PM이 설정되어 있고 USB 2.0 LPM-capable 장치를 link PM을 지원하는 xHCI host에 연결하면 LPM test를 수행합니다. Test를 통과하고 host가 xHCI 1.0 기능인 USB2 hardware LPM을 지원하면 장치에 USB2 hardware LPM을 활성화하고 USB device directory에 power/usb2_hardware_lpm file을 만듭니다. File은 장치의 USB2 hardware LPM 활성 여부를 나타내는 enable 또는 disable 문자열을 담습니다. y/Y/1 또는 n/N/0을 써서 이 기능을 활성화하거나 비활성화할 수 있습니다. |
USB 3.0 hardware LPM U1·U2 상태
107-121| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../power/usb3_hardware_lpm_u1 |
| What | /sys/bus/usb/devices/.../power/usb3_hardware_lpm_u2 |
| Date | 2015년 11월 |
| Contact | Kevin Strasser <kevin.strasser@linux.intel.com>; Lu Baolu <baolu.lu@linux.intel.com> |
| Description | CONFIG_PM이 설정되어 있고 USB 3.0 LPM-capable 장치를 link PM을 지원하는 xHCI host에 연결하면 BOS descriptor에 U1·U2 exit latency가 설정되어 있는지 확인합니다. 확인을 통과하고 host가 USB3 hardware LPM을 지원하면 장치에 이를 활성화하고 USB device directory에 power/usb3_hardware_lpm_u1과 power/usb3_hardware_lpm_u2를 만듭니다. 각 file은 장치의 USB3 hardware LPM U1 또는 U2 활성 여부를 나타내는 enable 또는 disable 문자열을 담습니다. |
USB Latency Tolerance Messaging 지원
123-133| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../ltm_capable |
| Date | 2012년 7월 |
| Contact | Sarah Sharp <sarah.a.sharp@linux.intel.com> |
| Description | USB 3.0 장치는 선택적으로 Latency Tolerance Messaging(LTM)을 지원할 수 있으며 SuperSpeed BOS descriptor의 bmAttributes bit로 지원 여부를 표시합니다. 그 bit가 설정되어 있으면 ltm_capable은 "yes", 지원하지 않으면 "no"를 읽습니다. 이 file은 모든 USB 속도의 장치에 존재하며 USB 1.1·USB 2.0 장치에서는 항상 "no"를 읽습니다. |
USB receiver 기반 무선 연결 상태
135-150| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/<INTERFACE>/wireless_status |
| Date | 2023년 2월 |
| Contact | Bastien Nocera <hadess@hadess.net> |
| Description | 일부 USB 장치는 USB receiver dongle과 proprietary protocol을 사용해 무선으로 통신합니다. 이 속성으로 userspace는 장치가 receiver dongle에 연결되어 있는지 알 수 있습니다. 예를 들어 battery 표시 여부, output 목록의 headset 표시 여부, 유일한 wireless keyboard가 꺼졌을 때 on-screen keyboard 표시 여부를 결정할 수 있습니다. 이 속성은 WWAN, WLAN/Wi-Fi, Bluetooth 등에 제공되는 protocol-specific status를 대체하는 용도로 사용해서는 안 됩니다. 장치가 무선 장치용 receiver dongle을 사용하지 않으면 이 속성은 존재하지 않습니다. |
USB hub port sysfs directory
152-157| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../<hub_interface>/port<X> |
| Date | 2012년 8월 |
| Contact | Lan Tianyu <tianyu.lan@intel.com> |
| Description | /sys/bus/usb/devices/.../<hub_interface>/port<X>는 USB port device의 sysfs directory입니다. |
USB port 연결 유형
159-166| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../<hub_interface>/port<X>/connect_type |
| Date | 2013년 1월 |
| Contact | Lan Tianyu <tianyu.lan@intel.com> |
| Description | 일부 platform은 ACPI를 통해 USB port connect type을 제공합니다. 이 속성은 해당 정보를 userspace에 노출합니다. 정보를 사용할 수 있으면 "hotplug", "hardwired", "not used" 중 하나를 읽고, 그렇지 않으면 "unknown"을 읽습니다. |
USB port firmware location
168-176| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../<hub_interface>/port<X>/location |
| Date | 2018년 10월 |
| Contact | Bjørn Mork <bjorn@mork.no> |
| Description | 일부 platform은 firmware를 통해 USB port의 물리적 위치를 제공합니다. Kernel은 이를 사용해 같은 물리 connector에 mapping되는 logical port들을 짝지으며, 이 속성은 raw location 값을 16진수 정수로 노출합니다. |
USB port enumeration quirk bit-field
178-200| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../<hub_interface>/port<X>/quirks |
| Date | 2018년 5월 |
| Contact | Nicolas Boichat <drinkcat@chromium.org> |
| Description | 연결될 장치를 미리 알고 그 장치가 규격을 잘 지키는 pogo pin 같은 비표준 USB port에서는 특정 port에 연결된 장치의 활성화 시간을 중요하게 볼 수 있습니다. 이 속성은 특정 port의 동작을 제어하는 bit-field입니다. |
Bit동작효과와 주의점
0old enumeration scheme 선택USB reset을 2회가 아닌 1회만 수행해 훨씬 빠릅니다. /sys/module/usbcore/parameters/old_scheme_first로 전체 선택할 수도 있지만 새 scheme은 더 많은 장치와의 호환성을 위해 도입되었으므로 전역 적용은 대개 바람직하지 않습니다.
1TRSTRCY를 10 ms로 단축일부 high-speed 장치의 enumeration 성공률을 높이기 위해 통상 쓰는 50 ms 대신 USB 2.0 규격이 요구하는 10 ms를 사용합니다.
각 bit는 enumeration reset 횟수 또는 TRSTRCY 대기 시간을 줄입니다.
USB port over-current 누적 횟수
202-217| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../<hub_interface>/port<X>/over_current_count |
| Date | 2018년 2월 |
| Contact | Richard Leitner <richard.leitner@skidata.com> |
| Description | 대부분의 hub는 port의 over-current 상황을 감지해 kernel에 보고할 수 있습니다. 이 속성은 특정 port에서 발생한 over-current 횟수를 userspace에 노출합니다. File은 unsigned 32-bit 값을 담고 최댓값에 도달한 뒤 0으로 wrap합니다. Userspace는 poll()로 값의 변화를 감시할 수 있습니다. 값이 바뀔 때마다 해당 hub device는 아래 속성을 포함하는 udev event를 보냅니다. |
OVER_CURRENT_PORT=/sys/bus/usb/devices/.../<hub_interface>/port<X>
OVER_CURRENT_COUNT=[이 sysfs 속성의 현재 값]USB 3.0 port LPM 허용 상태
219-228| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../<hub_interface>/port<X>/usb3_lpm_permit |
| Date | 2015년 11월 |
| Contact | Lu Baolu <baolu.lu@linux.intel.com> |
| Description | 일부 USB 3.0 장치는 USB3 LPM과 잘 동작하지 않습니다. usb3_lpm_permit 속성으로 port의 USB3 LPM을 활성화하거나 비활성화할 수 있으며 USB device enumeration 전후 모두에 적용됩니다. |
값U1U2
0허용 안 함허용 안 함
u1허용허용 안 함
u2허용 안 함허용
u1_u2허용허용
U1과 U2 저전력 상태를 port 단위로 허용하는 조합입니다.
USB port와 Type-C connector 연결
230-237| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../<hub_interface>/port<X>/connector |
| Date | 2021년 12월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | 사용할 수 있을 때 USB Type-C connector로 향하는 link입니다. USB Type-C Connector Class가 활성화되어 있고 system firmware가 port와 connector 사이의 연결을 설명할 수 있을 때만 생성됩니다. |
USB port 비활성화
239-248| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../<hub_interface>/port<X>/disable |
| Date | 2022년 6월 |
| Contact | Michael Grzeschik <m.grzeschik@pengutronix.de> |
| Description | 이 file은 Vbus power 출력을 포함한 USB port 상태를 제어합니다. 단, Vbus 제어는 power switching을 지원하는 hub에서만 가능하며 대부분의 hub는 이를 지원하지 않습니다. Port를 비활성화하면 port를 사용할 수 없고 연결된 장치를 detect, initialize, enumerate하지 않습니다. |
USB port initialization 조기 중단
250-259| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../<hub_interface>/port<X>/early_stop |
| Date | 2022년 9월 |
| Contact | Ray Chi <raychi@google.com> |
| Description | 일부 USB host에는 port initialization이 오래 걸리면 장치가 ramdump에 진입할 수 있는 watchdog mechanism이 있습니다. 이 속성을 설정하면 각 port가 두 번만 시도해 port initialization을 빠르게 실패시킬 수 있습니다. early_stop으로 표시된 port의 initialization이 실패하면 이 속성을 clear할 때까지 이후의 모든 connection을 무시합니다. |
USB port 연결 장치 상태
261-269| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../<hub_interface>/port<X>/state |
| Date | 2023년 6월 |
| Contact | Roy Luo <royluo@google.com> |
| Description | Port에 연결된 USB device의 현재 상태를 나타냅니다. 이 file은 userspace에서 상태 변화를 감시할 수 있도록 poll()을 지원합니다. |
상태의미
not-attached장치가 연결되지 않음
attached장치가 연결됨
powered전원이 공급됨
reconnecting다시 연결하는 중
unauthenticated아직 authenticate되지 않음
defaultUSB default 상태
addressed주소가 할당됨
configured구성이 완료됨
suspendedSuspend 상태
Port state attribute가 반환할 수 있는 유효한 문자열입니다.
USB 2.0 LPM L1 inactivity timeout
271-280| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../power/usb2_lpm_l1_timeout |
| Date | 2013년 5월 |
| Contact | Mathias Nyman <mathias.nyman@linux.intel.com> |
| Description | USB 2.0 장치는 hardware link power management(LPM)의 L1 sleep state를 지원할 수 있습니다. usb2_lpm_l1_timeout은 L1 inactivity timer, 즉 host가 장치에 L1 sleep 진입을 요청하기 전에 필요한 비활성 시간을 조정하며 power management tuning에 유용합니다. 지원 값은 0-65535 microseconds입니다. |
USB 2.0 LPM BESL 값
282-296| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../power/usb2_lpm_besl |
| Date | 2013년 5월 |
| Contact | Mathias Nyman <mathias.nyman@linux.intel.com> |
| Description | Hardware LPM L1 sleep state를 지원하는 USB 2.0 장치는 이제 best effort service latency(BESL) 값으로 resume event 시작 뒤 장치 service 재개를 위한 best effort를 표시합니다. 장치에 선호 BESL 값이 없으면 host가 값을 선택할 수 있습니다. usb2_lpm_besl 속성은 host가 선택한 BESL 값을 조정해 power saving과 service latency를 tuning할 수 있게 합니다. 지원 값은 0-15입니다. BESL 값과 microseconds의 mapping은 USB 2.0 ECN Errata for Link Power Management의 section 4.10을 참조합니다. |
USB device RX lane 수
298-305| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../rx_lanes |
| Date | 2018년 3월 |
| Contact | Mathias Nyman <mathias.nyman@linux.intel.com> |
| Description | 장치가 사용하는 RX lane 수입니다. USB 3.2는 Type-C에서 RX 2개와 TX 2개를 사용하는 dual-lane을 추가했습니다. Inter-Chip SSIC 장치는 방향마다 최대 4개의 asymmetric lane을 지원합니다. USB 3.2 이전 장치는 single-lane이므로 rx_lanes = 1입니다. |
USB device TX lane 수
307-314| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../tx_lanes |
| Date | 2018년 3월 |
| Contact | Mathias Nyman <mathias.nyman@linux.intel.com> |
| Description | 장치가 사용하는 TX lane 수입니다. USB 3.2는 Type-C에서 RX 2개와 TX 2개를 사용하는 dual-lane을 추가했습니다. Inter-Chip SSIC 장치는 방향마다 최대 4개의 asymmetric lane을 지원합니다. USB 3.2 이전 장치는 single-lane이므로 tx_lanes = 1입니다. |
USB device의 Type-C partner link
316-323| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/.../typec |
| Date | 2023년 11월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | USB Type-C partner device로 향하는 symlink입니다. USB Type-C partner는 USB Type-C connector와 cable의 Configuration Channel(CC signal)을 통해 local port와 통신하는 component를 나타냅니다. |
USB interface alternate setting
325-329| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bAlternateSetting |
| Date | 원문에 명시되지 않음 |
| Description | 현재 interface alternate setting 번호를 10진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB device release 번호
331-335| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bcdDevice |
| Date | 원문에 명시되지 않음 |
| Description | 장치의 release 번호를 16진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB device 현재 configuration
337-351| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bConfigurationValue |
| Date | 원문에 명시되지 않음 |
| Description | USB device는 보통 configuration setting이 하나뿐이지만 여러 configuration을 지원하는 장치도 있습니다. 이 값은 현재 configuration을 10진수로 표시하며 값을 변경하면 장치 configuration이 다른 setting으로 바뀝니다. 장치가 지원하는 configuration 수는 /sys/bus/usb/devices/usbX/bNumConfigurations에서 확인합니다. 의미는 USB specification을 참조합니다. |
USB device class code
353-357| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bDeviceClass |
| Date | 원문에 명시되지 않음 |
| Description | 장치의 class code를 16진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB device protocol code
359-363| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bDeviceProtocol |
| Date | 원문에 명시되지 않음 |
| Description | 장치의 protocol code를 16진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB device subclass code
365-369| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bDeviceSubClass |
| Date | 원문에 명시되지 않음 |
| Description | 장치의 subclass code를 16진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB interface class code
371-375| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bInterfaceClass |
| Date | 원문에 명시되지 않음 |
| Description | Interface의 class code를 16진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB interface 번호
377-381| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bInterfaceNumber |
| Date | 원문에 명시되지 않음 |
| Description | Interface 번호를 16진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB interface protocol code
383-387| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bInterfaceProtocol |
| Date | 원문에 명시되지 않음 |
| Description | Interface의 protocol code를 16진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB interface subclass code
389-393| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bInterfaceSubClass |
| Date | 원문에 명시되지 않음 |
| Description | Interface의 subclass code를 16진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB configuration attribute bit-field
395-399| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bmAttributes |
| Date | 원문에 명시되지 않음 |
| Description | 현재 configuration의 attribute를 16진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB endpoint 0 최대 packet 크기
401-405| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bMaxPacketSize0 |
| Date | 원문에 명시되지 않음 |
| Description | Endpoint 0의 최대 packet 크기를 10진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB active configuration 최대 전력
407-410| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bMaxPower |
| Date | 원문에 명시되지 않음 |
| Description | 장치에서 활성 상태인 configuration의 최대 전력 소비량을 milliampere 단위로 표시합니다. |
USB device configuration 수
412-419| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bNumConfigurations |
| Date | 원문에 명시되지 않음 |
| Description | 장치가 사용할 수 있는 configuration 수를 10진수로 표시합니다. 현재 configuration은 /sys/bus/usb/devices/usbX/bConfigurationValue로 제어합니다. 의미는 USB specification을 참조합니다. |
USB interface endpoint 수
421-425| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bNumEndpoints |
| Date | 원문에 명시되지 않음 |
| Description | 이 interface에서 사용하는 endpoint 수를 16진수로 표시합니다. 의미는 USB specification을 참조합니다. |
USB device interface 수
427-429| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bNumInterfaces |
| Date | 원문에 명시되지 않음 |
| Description | 이 장치의 interface 수를 10진수로 표시합니다. |
USB bus 번호
431-433| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/busnum |
| Date | 원문에 명시되지 않음 |
| Description | Bus 번호를 표시합니다. |
USB configuration string descriptor
435-439| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/configuration |
| Date | 원문에 명시되지 않음 |
| Description | 현재 configuration과 연결된 string descriptor의 내용을 표시합니다. 장치 firmware version 또는 serial number가 포함될 수 있습니다. |
USB interface descriptor binary
441-443| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/descriptors |
| Date | 원문에 명시되지 않음 |
| Description | Interface descriptor를 binary 형식으로 담습니다. |
USB BOS descriptor binary
445-453| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/bos_descriptors |
| Date | 2024년 3월 |
| Contact | Elbert Mai <code@elbertmai.com> |
| Description | 장치에서 cache한 binary device object store(BOS)를 담는 binary file입니다. BOS descriptor 뒤에 device capability descriptor 집합이 이어집니다. 이 file에서 읽는 모든 descriptor는 bus-endian 형식입니다. 장치의 bcdUSB가 0x0201보다 작으면 kernel은 장치에 BOS를 요청하지 않습니다. |
USB product ID
455-457| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/idProduct |
| Date | 원문에 명시되지 않음 |
| Description | Product ID를 16진수로 표시합니다. |
USB vendor ID
459-461| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/idVendor |
| Date | 원문에 명시되지 않음 |
| Description | Vendor ID를 16진수로 표시합니다. |
USB interface Device Tree node
463-465| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/devspec |
| Date | 원문에 명시되지 않음 |
| Description | Interface의 Device Tree Open Firmware node를 표시합니다. |
USB device reset 방지 quirk
467-474| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/avoid_reset_quirk |
| Date | 원문에 명시되지 않음 |
| Description | 대부분의 장치는 이 값이 0입니다. 값이 1이면 이 장치가 reset을 사용하지 못하게 하는 USB quirk를 활성화합니다. 읽기와 쓰기를 모두 지원합니다. |
USB interface device 번호
476-478| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/devnum |
| Date | 원문에 명시되지 않음 |
| Description | USB interface device 번호를 10진수로 표시합니다. |
USB interface device path
480-482| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/devpath |
| Date | 원문에 명시되지 않음 |
| Description | USB interface device path를 담은 문자열입니다. |
USB manufacturer 문자열
484-487| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/manufacturer |
| Date | 원문에 명시되지 않음 |
| Description | 장치 manufacturer 이름을 담은 vendor-specific 문자열입니다. |
USB hub port 수
489-491| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/maxchild |
| Date | 원문에 명시되지 않음 |
| Description | USB hub의 port 수입니다. |
USB disconnect 시 device 유지
493-495| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/persist |
| Date | 원문에 명시되지 않음 |
| Description | 장치의 연결이 끊겨도 device를 유지합니다. |
USB product 문자열
497-500| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/product |
| Date | 원문에 명시되지 않음 |
| Description | 장치 product 이름을 담은 vendor-specific 문자열입니다. |
USB device 최대 속도
502-516| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/speed |
| Date | 원문에 명시되지 않음 |
| Description | USB version에 따른 장치 최대 속도를 Mbps 단위로 표시합니다. |
값 (Mbps)속도
Unknown속도를 알 수 없음
1.5Low speed
15Full speed
480High Speed
5000Super Speed
10000Super Speed+
20000Super Speed+ Gen 2x2
speed attribute의 값과 원문이 정의한 USB 속도 이름입니다.
USB autosuspend 지원 표시
518-521| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/supports_autosuspend |
| Date | 원문에 명시되지 않음 |
| Description | 장치가 autosuspend를 지원하지 않으면 1을 반환하고, 그 밖의 경우 0을 반환합니다. |
USB device 전체 URB 제출 수
523-525| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/urbnum |
| Date | 원문에 명시되지 않음 |
| Description | 장치 전체에 제출된 URB 수입니다. |
USB device version
527-530| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/version |
| Date | 원문에 명시되지 않음 |
| Description | BCD descriptor에 encoding된 USB device version을 담은 문자열입니다. |
USB autosuspend 지연 시간
532-537| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/power/autosuspend |
| Date | 원문에 명시되지 않음 |
| Description | 장치가 autosuspend되기까지의 시간을 millisecond 단위로 지정합니다. 값이 음수이면 autosuspend를 막습니다. 읽기와 쓰기를 모두 지원합니다. |
USB device active 누적 시간
539-541| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/power/active_duration |
| Date | 원문에 명시되지 않음 |
| Description | 장치가 suspend되지 않은 상태였던 전체 시간입니다. |
USB device connected 누적 시간
543-545| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/power/connected_duration |
| Date | 원문에 명시되지 않음 |
| Description | 장치가 연결되어 있던 전체 시간을 millisecond 단위로 표시합니다. |
USB power level
547-548| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/power/level |
| Date | 원문에 명시되지 않음 |
| Description | 원문의 Description 항목은 비어 있습니다. |
USB endpoint address
550-558| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/ep_<N>/bEndpointAddress |
| Date | 원문에 명시되지 않음 |
| Description | 이 descriptor가 설명하는 endpoint 주소를 16진수로 표시합니다. 이 bitmapped field에 포함된 endpoint 방향은 /sys/bus/usb/devices/usbX/ep_<N>/direction에도 표시됩니다. 의미는 USB specification을 참조합니다. |
USB endpoint descriptor interval
560-565| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/ep_<N>/bInterval |
| Date | 원문에 명시되지 않음 |
| Description | Descriptor에 기술된 endpoint interval을 16진수로 표시합니다. 실제 interval은 USB version에 따라 달라지며 /sys/bus/usb/devices/usbX/ep_<N>/interval에도 시간 단위로 표시됩니다. |
USB endpoint descriptor 길이
567-569| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/ep_<N>/bLength |
| Date | 원문에 명시되지 않음 |
| Description | Endpoint descriptor의 byte 수를 16진수로 표시합니다. |
USB endpoint attribute bit-field
571-579| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/ep_<N>/bmAttributes |
| Date | 원문에 명시되지 않음 |
| Description | Descriptor에 기술된 endpoint에 적용되는 attribute를 16진수로 표시합니다. 이 bitmapped field의 endpoint type은 /sys/bus/usb/devices/usbX/ep_<N>/type에도 표시됩니다. 의미는 USB specification을 참조합니다. |
USB endpoint 방향
581-587| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/ep_<N>/direction |
| Date | 원문에 명시되지 않음 |
| Description | Endpoint 방향을 표시합니다. |
값의미
both양방향(control endpoint)
in장치에서 host 방향
outhost에서 장치 방향
Control endpoint는 양방향이며 나머지는 input 또는 output 방향입니다.
USB endpoint polling interval
589-592| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/ep_<N>/interval |
| Date | 원문에 명시되지 않음 |
| Description | Data transfer를 위해 endpoint를 polling하는 interval을 millisecond 또는 microsecond 단위로 표시합니다. |
USB endpoint descriptor type
594-602| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/ep_<N>/type |
| Date | 원문에 명시되지 않음 |
| Description | Descriptor type을 표시합니다. |
값한국어 설명
ControlControl transfer
IsocIsochronous transfer
BulkBulk transfer
InterruptInterrupt transfer
unknown알 수 없는 type
Endpoint transfer type 또는 알 수 없는 값을 나타냅니다.
USB endpoint 최대 packet 크기
604-607| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/usb/devices/usbX/ep_<N>/wMaxPacketSize |
| Date | 원문에 명시되지 않음 |
| Description | 이 endpoint가 보내거나 받을 수 있는 최대 packet 크기를 16진수로 표시합니다. |
Authorization, dynamic IDs, and link power management
sysfs-bus-usb:1-150개별 interface·device authorization, driver의 new_id/remove_id, USB 2.0·3.0 LPM, LTM 및 receiver 기반 무선 연결 상태를 정의합니다.