요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Port power and USB capabilities
sysfs-class-typec:69-164Port는 VBUS current mode, preferred role, accessory mode, PD/Type-C revision, orientation, selectable PD capability와 USB2·USB3·USB4 capability를 노출합니다.
Partner capability and product type
sysfs-class-typec:165-223Partner device는 accessory mode, PD support, advertised alternate-mode 수와 current UFP/DFP role에 맞는 product type을 제공합니다.
Partner identity and USB mode
sysfs-class-typec:224-248Driver가 Discover Identity 결과를 볼 수 있을 때 partner identity directory가 나타나며 active USB mode는 bracket으로 표시되고 조건이 맞으면 변경할 수 있습니다.
Cable and plug properties
sysfs-class-typec:250-295Cable은 active/passive product type과 Type-A/B/C 또는 captive plug type을 제공하며 electronically marked cable plug는 advertised alternate-mode 수를 노출할 수 있습니다.
Shared partner and cable identity VDOs
sysfs-class-typec:298-364Partner와 cable identity directory는 Discover Identity의 ID Header, Cert Stat, Product와 최대 세 Product Type VDO를 제공하며 결과 전에는 0을 표시합니다.
Alternate-mode supported roles
sysfs-class-typec:367-375Port alternate-mode device는 source와 sink 중 지원하는 role을 space-separated list로 표시합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
USB Type-C port devices (eg. /sys/class/typec/port0/)
3
What: /sys/class/typec/<port>/data_role
4
Date: April 2017
5
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
6
Description:
7
The supported USB data roles. This attribute can be used for
8
requesting data role swapping on the port. Swapping is supported
9
as synchronous operation, so write(2) to the attribute will not
10
return until the operation has finished. The attribute is
11
notified about role changes so that poll(2) on the attribute
12
wakes up. Change on the role will also generate uevent
13
KOBJ_CHANGE on the port. The current role is show in brackets,
14
for example "[host] device" when DRP port is in host mode.
16
Valid values: host, device
18
What: /sys/class/typec/<port>/power_role
19
Date: April 2017
20
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
21
Description:
22
The supported power roles. This attribute can be used to request
23
power role swap on the port. Swapping is supported as
24
synchronous operation, so write(2) to the attribute will not
25
return until the operation has finished. The attribute is
26
notified about role changes so that poll(2) on the attribute
27
wakes up. Change on the role will also generate uevent
28
KOBJ_CHANGE. The current role is show in brackets, for example
29
"[source] sink" when in source mode.
31
Valid values: source, sink
33
What: /sys/class/typec/<port>/port_type
34
Date: May 2017
35
Contact: Badhri Jagan Sridharan <Badhri@google.com>
36
Description:
37
Indicates the type of the port. This attribute can be used for
38
requesting a change in the port type. Port type change is
39
supported as a synchronous operation, so write(2) to the
40
attribute will not return until the operation has finished.
42
Valid values:
44
====== ==============================================
45
source (The port will behave as source only DFP port)
46
sink (The port will behave as sink only UFP port)
47
dual (The port will behave as dual-role-data and
48
dual-role-power port)
49
====== ==============================================
51
What: /sys/class/typec/<port>/vconn_source
52
Date: April 2017
53
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
54
Description:
55
Shows is the port VCONN Source. This attribute can be used to
56
request VCONN swap to change the VCONN Source during connection
57
when both the port and the partner support USB Power Delivery.
58
Swapping is supported as synchronous operation, so write(2) to
59
the attribute will not return until the operation has finished.
60
The attribute is notified about VCONN source changes so that
61
poll(2) on the attribute wakes up. Change on VCONN source also
62
generates uevent KOBJ_CHANGE.
64
Valid values:
66
- "no" when the port is not the VCONN Source
67
- "yes" when the port is the VCONN Source
69
What: /sys/class/typec/<port>/power_operation_mode
70
Date: April 2017
71
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
72
Description:
73
Shows the current power operational mode the port is in. The
74
power operation mode means current level for VBUS. In case USB
75
Power Delivery communication is used for negotiating the levels,
76
power operation mode should show "usb_power_delivery".
78
Valid values:
80
- default
81
- 1.5A
82
- 3.0A
83
- usb_power_delivery
85
What: /sys/class/typec/<port>/preferred_role
86
Date: April 2017
87
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
88
Description:
89
The user space can notify the driver about the preferred role.
90
It should be handled as enabling of Try.SRC or Try.SNK, as
91
defined in USB Type-C specification, in the port drivers. By
92
default the preferred role should come from the platform.
94
Valid values: source, sink, none (to remove preference)
96
What: /sys/class/typec/<port>/supported_accessory_modes
97
Date: April 2017
98
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
99
Description:
100
Space separated list of accessory modes, defined in the USB
101
Type-C specification, the port supports.
103
What: /sys/class/typec/<port>/usb_power_delivery_revision
104
Date: April 2017
105
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
106
Description:
107
Revision number of the supported USB Power Delivery
108
specification, or 0.0 when USB Power Delivery is not supported.
110
Example values:
111
- "2.0": USB Power Delivery Release 2.0
112
- "3.0": USB Power Delivery Release 3.0
113
- "3.1": USB Power Delivery Release 3.1
115
What: /sys/class/typec/<port>-{partner|cable}/usb_power_delivery_revision
116
Date: January 2021
117
Contact: Benson Leung <bleung@chromium.org>
118
Description:
119
Revision number of the supported USB Power Delivery
120
specification of the port partner or cable, or 0.0 when USB
121
Power Delivery is not supported.
123
Example values:
124
- "2.0": USB Power Delivery Release 2.0
125
- "3.0": USB Power Delivery Release 3.0
126
- "3.1": USB Power Delivery Release 3.1
128
What: /sys/class/typec/<port>/usb_typec_revision
129
Date: April 2017
130
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
131
Description:
132
Revision number of the supported USB Type-C specification.
134
What: /sys/class/typec/<port>/orientation
135
Date: February 2020
136
Contact: Badhri Jagan Sridharan <badhri@google.com>
137
Description:
138
Indicates the active orientation of the Type-C connector.
139
Valid values:
140
- "normal": CC1 orientation
141
- "reverse": CC2 orientation
142
- "unknown": Orientation cannot be determined.
144
What: /sys/class/typec/<port>/select_usb_power_delivery
145
Date: May 2022
146
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
147
Description:
148
Lists the USB Power Delivery Capabilities that the port can
149
advertise to the partner. The currently used capabilities are in
150
brackets. Selection happens by writing to the file.
152
What: /sys/class/typec/<port>/usb_capability
153
Date: November 2024
154
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
155
Description: Lists the supported USB Modes. The default USB mode that is used
156
next time with the Enter_USB Message is in brackets. The default
157
mode can be changed by writing to the file when supported by the
158
driver.
160
Valid values:
161
- usb2 (USB 2.0)
162
- usb3 (USB 3.2)
163
- usb4 (USB4)
165
USB Type-C partner devices (eg. /sys/class/typec/port0-partner/)
167
What: /sys/class/typec/<port>-partner/accessory_mode
168
Date: April 2017
169
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
170
Description:
171
Shows the Accessory Mode name when the partner is an Accessory.
172
The Accessory Modes are defined in USB Type-C Specification.
174
What: /sys/class/typec/<port>-partner/supports_usb_power_delivery
175
Date: April 2017
176
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
177
Description:
178
Shows if the partner supports USB Power Delivery communication:
179
Valid values: yes, no
181
What: /sys/class/typec/<port>-partner/number_of_alternate_modes
182
Date: November 2020
183
Contact: Prashant Malani <pmalani@chromium.org>
184
Description:
185
Shows the number of alternate modes which are advertised by the partner
186
during Power Delivery discovery. This file remains hidden until a value
187
greater than or equal to 0 is set by Type C port driver.
189
What: /sys/class/typec/<port>-partner/type
190
Date: December 2020
191
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
192
Description: USB Power Delivery Specification defines a set of product types
193
for the partner devices. This file will show the product type of
194
the partner if it is known. Dual-role capable partners will have
195
both UFP and DFP product types defined, but only one that
196
matches the current role will be active at the time. If the
197
product type of the partner is not visible to the device driver,
198
this file will not exist.
200
When the partner product type is detected, or changed with role
201
swap, uvevent is also raised that contains PRODUCT_TYPE=<product
202
type> (for example PRODUCT_TYPE=hub).
204
Valid values:
206
UFP / device role
207
====================== ==========================
208
undefined -
209
hub PDUSB Hub
210
peripheral PDUSB Peripheral
211
psd Power Bank
212
ama Alternate Mode Adapter
213
====================== ==========================
215
DFP / host role
216
====================== ==========================
217
undefined -
218
hub PDUSB Hub
219
host PDUSB Host
220
power_brick Power Brick
221
amc Alternate Mode Controller
222
====================== ==========================
224
What: /sys/class/typec/<port>-partner/identity/
225
Date: April 2017
226
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
227
Description:
228
This directory appears only if the port device driver is capable
229
of showing the result of Discover Identity USB power delivery
230
command. That will not always be possible even when USB power
231
delivery is supported, for example when USB power delivery
232
communication for the port is mostly handled in firmware. If the
233
directory exists, it will have an attribute file for every VDO
234
in Discover Identity command result.
236
What: /sys/class/typec/<port>-partner/usb_mode
237
Date: November 2024
238
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
239
Description: The USB Modes that the partner device supports. The active mode
240
is displayed in brackets. The active USB mode can be changed by
241
writing to this file when the port driver is able to send Data
242
Reset Message to the partner. That requires USB Power Delivery
243
contract between the partner and the port.
245
Valid values:
246
- usb2 (USB 2.0)
247
- usb3 (USB 3.2)
248
- usb4 (USB4)
250
USB Type-C cable devices (eg. /sys/class/typec/port0-cable/)
252
Note: Electronically Marked Cables will have a device also for one cable plug
253
(eg. /sys/class/typec/port0-plug0). If the cable is active and has also SOP
254
Double Prime controller (USB Power Deliver specification ch. 2.4) it will have
255
second device also for the other plug. Both plugs may have alternate modes as
256
described in USB Type-C and USB Power Delivery specifications.
258
What: /sys/class/typec/<port>-cable/type
259
Date: April 2017
260
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
261
Description: USB Power Delivery Specification defines a set of product types
262
for the cables. This file will show the product type of the
263
cable if it is known. If the product type of the cable is not
264
visible to the device driver, this file will not exist.
266
When the cable product type is detected, uvevent is also raised
267
with PRODUCT_TYPE showing the product type of the cable.
269
Valid values:
271
====================== ==========================
272
undefined -
273
active Active Cable
274
passive Passive Cable
275
====================== ==========================
277
What: /sys/class/typec/<port>-cable/plug_type
278
Date: April 2017
279
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
280
Description:
281
Shows type of the plug on the cable:
283
- type-a - Standard A
284
- type-b - Standard B
285
- type-c
286
- captive
288
What: /sys/class/typec/<port>-<plug>/number_of_alternate_modes
289
Date: November 2020
290
Contact: Prashant Malani <pmalani@chromium.org>
291
Description:
292
Shows the number of alternate modes which are advertised by the plug
293
associated with a particular cable during Power Delivery discovery.
294
This file remains hidden until a value greater than or equal to 0
295
is set by Type C port driver.
298
USB Type-C partner/cable Power Delivery Identity objects
300
NOTE: The following attributes will be applicable to both
301
partner (e.g /sys/class/typec/port0-partner/) and
302
cable (e.g /sys/class/typec/port0-cable/) devices. Consequently, the example file
303
paths below are prefixed with "/sys/class/typec/<port>-{partner|cable}/" to
304
reflect this.
306
What: /sys/class/typec/<port>-{partner|cable}/identity/
307
Date: April 2017
308
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
309
Description:
310
This directory appears only if the port device driver is capable
311
of showing the result of Discover Identity USB power delivery
312
command. That will not always be possible even when USB power
313
delivery is supported, for example when USB power delivery
314
communication for the port is mostly handled in firmware. If the
315
directory exists, it will have an attribute file for every VDO
316
in Discover Identity command result.
318
What: /sys/class/typec/<port>-{partner|cable}/identity/id_header
319
Date: April 2017
320
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
321
Description:
322
ID Header VDO part of Discover Identity command result. The
323
value will show 0 until Discover Identity command result becomes
324
available. The value can be polled.
326
What: /sys/class/typec/<port>-{partner|cable}/identity/cert_stat
327
Date: April 2017
328
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
329
Description:
330
Cert Stat VDO part of Discover Identity command result. The
331
value will show 0 until Discover Identity command result becomes
332
available. The value can be polled.
334
What: /sys/class/typec/<port>-{partner|cable}/identity/product
335
Date: April 2017
336
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
337
Description:
338
Product VDO part of Discover Identity command result. The value
339
will show 0 until Discover Identity command result becomes
340
available. The value can be polled.
342
What: /sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo1
343
Date: October 2020
344
Contact: Prashant Malani <pmalani@chromium.org>
345
Description:
346
1st Product Type VDO of Discover Identity command result.
347
The value will show 0 until Discover Identity command result becomes
348
available and a valid Product Type VDO is returned.
350
What: /sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo2
351
Date: October 2020
352
Contact: Prashant Malani <pmalani@chromium.org>
353
Description:
354
2nd Product Type VDO of Discover Identity command result.
355
The value will show 0 until Discover Identity command result becomes
356
available and a valid Product Type VDO is returned.
358
What: /sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo3
359
Date: October 2020
360
Contact: Prashant Malani <pmalani@chromium.org>
361
Description:
362
3rd Product Type VDO of Discover Identity command result.
363
The value will show 0 until Discover Identity command result becomes
364
available and a valid Product Type VDO is returned.
367
USB Type-C port alternate mode devices.
369
What: /sys/class/typec/<port>/<alt mode>/supported_roles
370
Date: April 2017
371
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
372
Description:
373
Space separated list of the supported roles.
375
Valid values: source, sink
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Supported and current USB data role
1-17USB Type-C port device의 예는 /sys/class/typec/port0/입니다.
| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/data_role |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | 지원하는 USB data role입니다. Port의 data role swap을 요청하는 데 사용할 수 있습니다. Swap은 synchronous operation이므로 attribute에 대한 write(2)는 operation이 끝날 때까지 반환하지 않습니다. Role change가 attribute에 notify되어 poll(2)이 wake up하며 port에 uevent KOBJ_CHANGE도 생성합니다. Current role은 bracket 안에 표시합니다. 예를 들어 DRP port가 host mode이면 "[host] device"입니다. |
| Valid values | host, device |
Supported and current power role
18-32| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/power_role |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | 지원하는 power role입니다. Port의 power role swap을 요청하는 데 사용할 수 있습니다. Swap은 synchronous operation이므로 attribute에 대한 write(2)는 operation이 끝날 때까지 반환하지 않습니다. Role change가 attribute에 notify되어 poll(2)이 wake up하며 uevent KOBJ_CHANGE도 생성합니다. Current role은 bracket 안에 표시합니다. Source mode이면 예를 들어 "[source] sink"입니다. |
| Valid values | source, sink |
Configured Type-C port type
33-50| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/port_type |
| Date | 2017년 5월 |
| Contact | Badhri Jagan Sridharan <Badhri@google.com> |
| Description | Port type을 나타내며 port type change를 요청하는 데 사용할 수 있습니다. Change는 synchronous operation이므로 attribute에 대한 write(2)는 operation이 끝날 때까지 반환하지 않습니다. |
| Valid values | source, sink, dual |
값Port behavior
sourceSource-only DFP port
sinkSink-only UFP port
dualDual-role-data and dual-role-power port
Port type이 data와 power role capability를 제한하는 방식입니다.
VCONN source and swap
51-68| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/vconn_source |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Port가 VCONN Source인지 표시합니다. Port와 partner가 모두 USB Power Delivery를 지원할 때 connection 중 VCONN Source를 바꾸는 VCONN swap을 요청하는 데 사용할 수 있습니다. Swap은 synchronous operation이므로 write(2)는 완료될 때까지 반환하지 않습니다. VCONN source change가 attribute에 notify되어 poll(2)이 wake up하며 uevent KOBJ_CHANGE도 생성합니다. |
| Valid values | "no": port가 VCONN Source가 아님, "yes": port가 VCONN Source |
AttributeValues
data_rolehost, device
power_rolesource, sink
port_typesource, sink, dual
vconn_sourceyes, no
Data, power, port type과 VCONN source의 value space입니다.
Current VBUS power operation mode
69-84| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/power_operation_mode |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Port의 current power operational mode를 표시합니다. Power operation mode는 VBUS의 current level을 뜻합니다. USB Power Delivery communication으로 level을 negotiate하는 경우 "usb_power_delivery"를 표시해야 합니다. |
| Valid values | default, 1.5A, 3.0A, usb_power_delivery |
값의미
defaultDefault USB current
1.5A1.5 ampere current level
3.0A3.0 ampere current level
usb_power_deliveryUSB PD communication으로 level 협상
VBUS current advertisement 또는 negotiated PD mode입니다.
Userspace preferred power role
85-95| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/preferred_role |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Userspace가 preferred role을 driver에 알릴 수 있습니다. Port driver는 USB Type-C specification의 Try.SRC 또는 Try.SNK를 enable하는 것으로 처리해야 합니다. 기본 preferred role은 platform에서 와야 합니다. |
| Valid values | source, sink, none(preference 제거) |
Supported accessory modes
96-102| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/supported_accessory_modes |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | USB Type-C specification에 정의되어 있으며 port가 지원하는 accessory mode의 space-separated list입니다. |
Port USB Power Delivery revision
103-114| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/usb_power_delivery_revision |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | 지원하는 USB Power Delivery specification revision number입니다. USB Power Delivery를 지원하지 않으면 0.0입니다. |
| Example values | 2.0: Release 2.0, 3.0: Release 3.0, 3.1: Release 3.1 |
Partner or cable USB PD revision
115-127| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-{partner|cable}/usb_power_delivery_revision |
| Date | 2021년 1월 |
| Contact | Benson Leung <bleung@chromium.org> |
| Description | Port partner 또는 cable이 지원하는 USB Power Delivery specification revision number입니다. USB Power Delivery를 지원하지 않으면 0.0입니다. |
| Example values | 2.0: Release 2.0, 3.0: Release 3.0, 3.1: Release 3.1 |
Supported USB Type-C revision
128-133| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/usb_typec_revision |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | 지원하는 USB Type-C specification revision number입니다. |
Active connector orientation
134-143| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/orientation |
| Date | 2020년 2월 |
| Contact | Badhri Jagan Sridharan <badhri@google.com> |
| Description | Type-C connector의 active orientation을 나타냅니다. |
| Valid values | "normal": CC1, "reverse": CC2, "unknown": orientation을 결정할 수 없음 |
값Orientation
normalCC1
reverseCC2
unknown결정할 수 없음
Active configuration-channel side를 normal/reverse로 표시합니다.
Select advertised USB PD capabilities
144-151| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/select_usb_power_delivery |
| Date | 2022년 5월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Port가 partner에 advertise할 수 있는 USB Power Delivery Capability를 나열합니다. 현재 사용하는 capability는 bracket 안에 표시합니다. File에 write하여 선택합니다. |
Supported and default USB mode
152-164| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/usb_capability |
| Date | 2024년 11월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | 지원하는 USB Mode를 나열합니다. 다음 Enter_USB Message에서 사용할 default USB mode는 bracket 안에 표시합니다. Driver가 지원하면 file에 write하여 default mode를 바꿀 수 있습니다. |
| Valid values | usb2(USB 2.0), usb3(USB 3.2), usb4(USB4) |
Supported PD capability 또는 USB mode 목록 read→Bracket 안의 current/default 항목 확인→지원되는 target value write→다음 advertisement 또는 Enter_USB Message에 적용
Bracket이 current/default selection을 나타내고 supported write가 다음 negotiation을 바꿉니다.
Partner accessory mode
165-173USB Type-C partner device의 예는 /sys/class/typec/port0-partner/입니다.
| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-partner/accessory_mode |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Partner가 Accessory일 때 Accessory Mode name을 표시합니다. Accessory Mode는 USB Type-C Specification에 정의됩니다. |
Partner USB PD support
174-180| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-partner/supports_usb_power_delivery |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Partner가 USB Power Delivery communication을 지원하는지 표시합니다. |
| Valid values | yes, no |
Partner advertised alternate-mode count
181-188| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-partner/number_of_alternate_modes |
| Date | 2020년 11월 |
| Contact | Prashant Malani <pmalani@chromium.org> |
| Description | Power Delivery discovery 중 partner가 advertise한 alternate mode 수를 표시합니다. Type-C port driver가 0 이상의 값을 설정할 때까지 file은 hidden 상태입니다. |
Role-specific partner product type
189-223| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-partner/type |
| Date | 2020년 12월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | USB Power Delivery Specification이 정의하는 partner device product type을 알고 있으면 표시합니다. Dual-role capable partner에는 UFP와 DFP product type이 모두 정의되지만 current role에 맞는 하나만 active입니다. Driver가 partner product type을 볼 수 없으면 file이 존재하지 않습니다. Product type을 detect하거나 role swap으로 변경하면 PRODUCT_TYPE=<product type>을 담은 uevent도 발생합니다. 예: PRODUCT_TYPE=hub. |
| UFP / device values | undefined, hub(PDUSB Hub), peripheral(PDUSB Peripheral), psd(Power Bank), ama(Alternate Mode Adapter) |
| DFP / host values | undefined, hub(PDUSB Hub), host(PDUSB Host), power_brick(Power Brick), amc(Alternate Mode Controller) |
RoleValueProduct type
UFPhubPDUSB Hub
UFPperipheralPDUSB Peripheral
UFPpsdPower Bank
UFPamaAlternate Mode Adapter
DFPhubPDUSB Hub
DFPhostPDUSB Host
DFPpower_brickPower Brick
DFPamcAlternate Mode Controller
Dual-role partner에서는 current UFP 또는 DFP role에 해당하는 product type만 active입니다.
Partner Discover Identity directory
224-235| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-partner/identity/ |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Port device driver가 Discover Identity USB Power Delivery command 결과를 표시할 수 있을 때만 나타나는 directory입니다. USB Power Delivery를 지원해도 communication을 주로 firmware가 처리하는 경우처럼 항상 가능한 것은 아닙니다. Directory가 존재하면 Discover Identity command result의 모든 VDO마다 attribute file이 있습니다. |
Partner supported and active USB mode
236-249| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-partner/usb_mode |
| Date | 2024년 11월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Partner device가 지원하는 USB Mode입니다. Active mode는 bracket 안에 표시합니다. Port driver가 partner에 Data Reset Message를 보낼 수 있을 때 file에 write하여 active USB mode를 바꿀 수 있습니다. 이를 위해 partner와 port 사이에 USB Power Delivery contract가 필요합니다. |
| Valid values | usb2(USB 2.0), usb3(USB 3.2), usb4(USB4) |
Port와 partner 사이 USB PD contract→Port driver가 Data Reset Message 전송 가능→usb_mode에서 active bracket 확인→지원되는 target mode write→Partner active USB mode 변경
Active USB mode 변경에는 negotiated PD contract와 Data Reset capability가 모두 필요합니다.
Cable product type
250-276USB Type-C cable device의 예는 /sys/class/typec/port0-cable/입니다. Electronically Marked Cable에는 한 cable plug용 device도 있습니다(예: /sys/class/typec/port0-plug0). Cable이 active이고 SOP Double Prime controller(USB Power Delivery specification 2.4장)도 있으면 다른 plug를 위한 두 번째 device도 있습니다. 두 plug 모두 USB Type-C와 USB Power Delivery specification에 정의된 alternate mode를 가질 수 있습니다.
| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-cable/type |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | USB Power Delivery Specification이 정의하는 cable product type을 알고 있으면 표시합니다. Driver가 cable product type을 볼 수 없으면 file이 존재하지 않습니다. Product type을 detect하면 cable product type을 표시하는 PRODUCT_TYPE uevent도 발생합니다. |
| Valid values | undefined, active(Active Cable), passive(Passive Cable) |
값Product type
undefined-
activeActive Cable
passivePassive Cable
Cable identity가 driver에 보일 때 노출되는 product category입니다.
Cable plug type
277-287| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-cable/plug_type |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Cable의 plug type을 표시합니다. |
| Valid values | type-a(Standard A), type-b(Standard B), type-c, captive |
Cable-plug advertised alternate-mode count
288-295| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-<plug>/number_of_alternate_modes |
| Date | 2020년 11월 |
| Contact | Prashant Malani <pmalani@chromium.org> |
| Description | Power Delivery discovery 중 특정 cable과 연결된 plug가 advertise한 alternate mode 수를 표시합니다. Type-C port driver가 0 이상의 값을 설정할 때까지 file은 hidden 상태입니다. |
<port>-cable device→Electronically Marked Cable이면 plug0 device→Active + SOP Double Prime이면 second plug device→각 plug의 number_of_alternate_modes
Cable capability에 따라 한 개 또는 두 개의 plug device가 생기고 각 plug가 alternate mode를 advertise할 수 있습니다.
Discover Identity ID Header VDO
318-325| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-{partner|cable}/identity/id_header |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Discover Identity command result의 ID Header VDO입니다. Result를 사용할 수 있게 될 때까지 0을 표시합니다. Value를 poll할 수 있습니다. |
Discover Identity Cert Stat VDO
326-333| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-{partner|cable}/identity/cert_stat |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Discover Identity command result의 Cert Stat VDO입니다. Result를 사용할 수 있게 될 때까지 0을 표시합니다. Value를 poll할 수 있습니다. |
Discover Identity Product VDO
334-341| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-{partner|cable}/identity/product |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | Discover Identity command result의 Product VDO입니다. Result를 사용할 수 있게 될 때까지 0을 표시합니다. Value를 poll할 수 있습니다. |
First Product Type VDO
342-349| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo1 |
| Date | 2020년 10월 |
| Contact | Prashant Malani <pmalani@chromium.org> |
| Description | Discover Identity command result의 첫 번째 Product Type VDO입니다. Result를 사용할 수 있고 valid Product Type VDO가 반환될 때까지 0을 표시합니다. |
Second Product Type VDO
350-357| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo2 |
| Date | 2020년 10월 |
| Contact | Prashant Malani <pmalani@chromium.org> |
| Description | Discover Identity command result의 두 번째 Product Type VDO입니다. Result를 사용할 수 있고 valid Product Type VDO가 반환될 때까지 0을 표시합니다. |
Third Product Type VDO
358-365| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo3 |
| Date | 2020년 10월 |
| Contact | Prashant Malani <pmalani@chromium.org> |
| Description | Discover Identity command result의 세 번째 Product Type VDO입니다. Result를 사용할 수 있고 valid Product Type VDO가 반환될 때까지 0을 표시합니다. |
AttributeDiscover Identity objectBefore available
id_headerID Header VDO0, pollable
cert_statCert Stat VDO0, pollable
productProduct VDO0, pollable
product_type_vdo11st Product Type VDO0
product_type_vdo22nd Product Type VDO0
product_type_vdo33rd Product Type VDO0
Partner와 cable이 공유하는 identity result surface입니다.
Alternate-mode supported roles
367-375USB Type-C port alternate-mode device에 적용됩니다.
| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/typec/<port>/<alt mode>/supported_roles |
| Date | 2017년 4월 |
| Contact | Heikki Krogerus <heikki.krogerus@linux.intel.com> |
| Description | 지원하는 role의 space-separated list입니다. |
| Valid values | source, sink |
Port data, power and VCONN roles
sysfs-class-typec:1-68Type-C port는 data_role, power_role, port_type과 VCONN source state를 제공하며 swap write는 synchronous하게 완료되고 role change는 poll wakeup과 KOBJ_CHANGE를 발생시킵니다.