← Documents Documentation/ABI/testing/sysfs-bus-typec GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

USB Type-C alternate mode attributes

Type-C alternate mode의 동기식 enter/exit 상태, 선택적 description, USB PD mode index, USB-IF SVID와 Discover Modes VDO를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-bus-typec
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

Synchronous mode entry and exit

sysfs-bus-typec:1-21

active write는 enter/exit 완료까지 block하며 상태 변경은 poll notification과 KOBJ_CHANGE를 생성하고 description은 선택 사항입니다.

Mode index, SVID, and VDO

sysfs-bus-typec:22-51

규격이 mode index를 할당하지 않은 alternate mode는 VDO 또는 description으로 식별하며 SVID는 USB-IF가 할당합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/bus/typec/devices/.../active
2 Date: July 2018
3 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
4 Description:
5 Shows if the mode is active or not. The attribute can be used
6 for entering/exiting the mode. Entering/exiting modes is
7 supported as synchronous operation so write(2) to the attribute
8 does not return until the enter/exit mode operation has
9 finished. The attribute is notified when the mode is
10 entered/exited so poll(2) on the attribute wakes up.
11 Entering/exiting a mode will also generate uevent KOBJ_CHANGE.
12
13 Valid values are boolean.
14
15 What: /sys/bus/typec/devices/.../description
16 Date: July 2018
17 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
18 Description:
19 Shows description of the mode. The description is optional for
20 the drivers, just like with the Billboard Devices.
21
22 What: /sys/bus/typec/devices/.../mode
23 Date: July 2018
24 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
25 Description:
26 The index number of the mode returned by Discover Modes USB
27 Power Delivery command. Depending on the alternate mode, the
28 mode index may be significant.
29
30 With some alternate modes (SVIDs), the mode index is assigned
31 for specific functionality in the specification for that
32 alternate mode.
33
34 With other alternate modes, the mode index values are not
35 assigned, and can not be therefore used for identification. When
36 the mode index is not assigned, identifying the alternate mode
37 must be done with either mode VDO or the description.
38
39 What: /sys/bus/typec/devices/.../svid
40 Date: July 2018
41 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
42 Description:
43 The Standard or Vendor ID (SVID) assigned by USB-IF for this
44 alternate mode.
45
46 What: /sys/bus/typec/devices/.../vdo
47 Date: July 2018
48 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
49 Description:
50 Shows the VDO in hexadecimal returned by Discover Modes command
51 for this mode.
52

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Type-C alternate mode 활성 상태

1-14
항목한국어 전문 번역
What/sys/bus/typec/devices/.../active
Date2018년 7월
ContactHeikki Krogerus <heikki.krogerus@linux.intel.com>
DescriptionMode가 active인지 표시하며 mode 진입·종료에도 사용할 수 있습니다. Mode enter/exit는 synchronous operation이므로 속성에 대한 write(2)는 해당 동작이 끝날 때까지 반환하지 않습니다. Mode에 진입하거나 종료하면 이 속성에 notification이 발생해 poll(2)이 깨어나며 uevent KOBJ_CHANGE도 생성됩니다. 유효한 값은 boolean입니다.

Type-C alternate mode 설명

15-21
항목한국어 전문 번역
What/sys/bus/typec/devices/.../description
Date2018년 7월
ContactHeikki Krogerus <heikki.krogerus@linux.intel.com>
DescriptionMode 설명을 표시합니다. Billboard Device와 마찬가지로 driver에서 description은 선택 사항입니다.

USB PD Discover Modes index

22-38
항목한국어 전문 번역
What/sys/bus/typec/devices/.../mode
Date2018년 7월
ContactHeikki Krogerus <heikki.krogerus@linux.intel.com>
DescriptionUSB Power Delivery의 Discover Modes command가 반환한 mode index 번호입니다. Alternate mode에 따라 이 index가 의미를 가질 수 있습니다. 일부 alternate mode(SVID)에서는 해당 alternate mode 규격이 특정 기능에 mode index를 할당합니다. 다른 alternate mode에서는 index 값이 할당되지 않아 식별에 사용할 수 없습니다. Mode index가 할당되지 않았으면 mode VDO 또는 description으로 alternate mode를 식별해야 합니다.

Type-C alternate mode SVID

39-45
항목한국어 전문 번역
What/sys/bus/typec/devices/.../svid
Date2018년 7월
ContactHeikki Krogerus <heikki.krogerus@linux.intel.com>
DescriptionUSB-IF가 이 alternate mode에 할당한 Standard 또는 Vendor ID(SVID)입니다.

Type-C alternate mode VDO

46-51
항목한국어 전문 번역
What/sys/bus/typec/devices/.../vdo
Date2018년 7월
ContactHeikki Krogerus <heikki.krogerus@linux.intel.com>
Description이 mode의 Discover Modes command가 반환한 VDO를 16진수로 표시합니다.