← Documents Documentation/ABI/testing/sysfs-platform-wilco-ec GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Wilco Embedded Controller sysfs ABI

Wilco EC의 AC-connect boot, firmware identity/version과 S0·S0ix·S5 USB PowerShare charging policy를 정의합니다.

Source pathDocumentation/ABI/testing/sysfs-platform-wilco-ec
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

AC-connect boot

sysfs-platform-wilco-ec:1-10

0/1 policy로 AC 연결 시 S5 device를 자동 boot해 headless·dock 운용을 지원합니다.

Firmware build identity

sysfs-platform-wilco-ec:11-33

Build date, revision과 EC model number를 고정된 예시 format으로 제공합니다.

USB PowerShare state policy

sysfs-platform-wilco-ec:34-51

S0은 항상 공급하고 S0ix·S5는 enable, AC와 battery threshold 조건에 따라 special USB port 전원을 결정합니다.

Firmware semantic fields

sysfs-platform-wilco-ec:52-58

x.y.z를 major, minor와 build number로 나눠 firmware version을 표시합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/bus/platform/devices/GOOG000C\:00/boot_on_ac
2 Date: April 2019
3 KernelVersion: 5.3
4 Description:
5 Boot on AC is a policy which makes the device boot from S5
6 when AC power is connected. This is useful for users who
7 want to run their device headless or with a dock.
8
9 Input should be parseable by kstrtou8() to 0 or 1.
10
11 What: /sys/bus/platform/devices/GOOG000C\:00/build_date
12 Date: May 2019
13 KernelVersion: 5.3
14 Description:
15 Display Wilco Embedded Controller firmware build date.
16 Output will a MM/DD/YY string.
17
18 What: /sys/bus/platform/devices/GOOG000C\:00/build_revision
19 Date: May 2019
20 KernelVersion: 5.3
21 Description:
22 Display Wilco Embedded Controller build revision.
23 Output will a version string be similar to the example below:
24 d2592cae0
25
26 What: /sys/bus/platform/devices/GOOG000C\:00/model_number
27 Date: May 2019
28 KernelVersion: 5.3
29 Description:
30 Display Wilco Embedded Controller model number.
31 Output will a version string be similar to the example below:
32 08B6
33
34 What: /sys/bus/platform/devices/GOOG000C\:00/usb_charge
35 Date: October 2019
36 KernelVersion: 5.5
37 Description:
38 Control the USB PowerShare Policy. USB PowerShare is a policy
39 which affects charging via the special USB PowerShare port
40 (marked with a small lightning bolt or battery icon) when in
41 low power states:
42
43 - In S0, the port will always provide power.
44 - In S0ix, if usb_charge is enabled, then power will be
45 supplied to the port when on AC or if battery is > 50%.
46 Else no power is supplied.
47 - In S5, if usb_charge is enabled, then power will be supplied
48 to the port when on AC. Else no power is supplied.
49
50 Input should be either "0" or "1".
51
52 What: /sys/bus/platform/devices/GOOG000C\:00/version
53 Date: May 2019
54 KernelVersion: 5.3
55 Description:
56 Display Wilco Embedded Controller firmware version.
57 The format of the string is x.y.z. Where x is major, y is minor
58 and z is the build number. For example: 95.00.06
59

3. 한국어 전문 번역

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

Wilco Embedded Controller sysfs ABI: boot on ac

1-10
항목한국어 전문 번역
What/sys/bus/platform/devices/GOOG000C\:00/boot_on_ac
Date2019년 4월
KernelVersion5.3
Contact
Description`/sys/bus/platform/devices/GOOG000C\:00/boot_on_ac`는 AC power가 연결될 때 device를 S5에서 boot하는 policy입니다. Headless 또는 dock 사용에 유용합니다. Input은 `kstrtou8()`가 `0` 또는 `1`로 parse할 수 있어야 합니다.
Wilco boot-on-AC policy
Device in S5AC power connectedboot_on_ac = 1Boot device

S5에서 AC connection event가 enabled policy를 거쳐 boot로 이어집니다.

Wilco Embedded Controller sysfs ABI: build date

11-17
항목한국어 전문 번역
What/sys/bus/platform/devices/GOOG000C\:00/build_date
Date2019년 5월
KernelVersion5.3
Contact
Description`/sys/bus/platform/devices/GOOG000C\:00/build_date`는 Wilco Embedded Controller firmware build date를 표시하며 output은 `MM/DD/YY` string입니다.
Wilco EC identity attributes
AttributeFormat or example
build_dateMM/DD/YY
build_revisiond2592cae0
model_number08B6
versionx.y.z, e.g. 95.00.06

Build and model outputs의 formats와 examples입니다.

Wilco Embedded Controller sysfs ABI: build revision

18-25
항목한국어 전문 번역
What/sys/bus/platform/devices/GOOG000C\:00/build_revision
Date2019년 5월
KernelVersion5.3
Contact
Description`/sys/bus/platform/devices/GOOG000C\:00/build_revision`은 Wilco Embedded Controller build revision을 표시합니다. Output은 예시 `d2592cae0`과 비슷한 version string입니다.

Wilco Embedded Controller sysfs ABI: model number

26-33
항목한국어 전문 번역
What/sys/bus/platform/devices/GOOG000C\:00/model_number
Date2019년 5월
KernelVersion5.3
Contact
Description`/sys/bus/platform/devices/GOOG000C\:00/model_number`는 Wilco Embedded Controller model number를 표시합니다. Output은 예시 `08B6`과 비슷한 version string입니다.

Wilco Embedded Controller sysfs ABI: usb charge

34-51
항목한국어 전문 번역
What/sys/bus/platform/devices/GOOG000C\:00/usb_charge
Date2019년 10월
KernelVersion5.5
Contact
Description`/sys/bus/platform/devices/GOOG000C\:00/usb_charge`는 low-power states에서 special USB PowerShare port의 charging에 영향을 주는 policy를 제어합니다. Port는 lightning bolt 또는 battery icon으로 표시됩니다. S0에서는 항상 power를 공급합니다. S0ix에서는 usb_charge가 enabled이고 AC power를 사용 중이거나 battery가 50%보다 높을 때 공급하며, 그렇지 않으면 공급하지 않습니다. S5에서는 usb_charge가 enabled이고 AC power를 사용할 때 공급하며, 그렇지 않으면 공급하지 않습니다. Input은 `0` 또는 `1`이어야 합니다.
Wilco USB PowerShare policy
StatePower supplied when
S0Always
S0ixEnabled and (on AC or battery > 50%)
S5Enabled and on AC
Disabled or unmet conditionNo power is supplied in S0ix or S5.

System power state별 special USB port의 power condition을 정리합니다.

Wilco Embedded Controller sysfs ABI: version

52-58
항목한국어 전문 번역
What/sys/bus/platform/devices/GOOG000C\:00/version
Date2019년 5월
KernelVersion5.3
Contact
Description`/sys/bus/platform/devices/GOOG000C\:00/version`은 Wilco Embedded Controller firmware version을 `x.y.z` format으로 표시합니다. `x`는 major, `y`는 minor, `z`는 build number입니다. 예시는 `95.00.06`입니다.
Wilco firmware version fields
FieldMeaningExample
xMajor95
yMinor00
zBuild number06

x.y.z format을 세 numeric roles로 분해합니다.