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

Linux 6.18.37 · ABI / testing

Intel DPTF platform sysfs ABI

Intel Dynamic Platform and Thermal Framework의 charger·battery power, PCH FIVR switching과 SSC EMI-control bitmask를 정의합니다.

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

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

1. 요약·해설

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

Adapter·battery·platform power

sysfs-platform-dptf:1-90

Charger type과 source bitfield, adapter·battery·SoC 외부 power limits 및 fuel-gauge electrical values를 제공합니다.

PCH FIVR switching frequency

sysfs-platform-dptf:91-128

Input clock별 writable frequency와 current frequency·fault status를 구분합니다.

Spread-spectrum EMI control

sysfs-platform-dptf:129-157

Spread percentage, enable, triangle·random walk, white noise와 write lock을 하나의 SSC bitmask로 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/bus/platform/devices/INT3407:00/dptf_power/charger_type
2 Date: Jul, 2016
3 KernelVersion: v4.10
5 Description:
6 (RO) The charger type - Traditional, Hybrid or NVDC.
7
8 What: /sys/bus/platform/devices/INT3407:00/dptf_power/adapter_rating_mw
9 Date: Jul, 2016
10 KernelVersion: v4.10
12 Description:
13 (RO) Adapter rating in milliwatts (the maximum Adapter power).
14 Must be 0 if no AC Adaptor is plugged in.
15
16 What: /sys/bus/platform/devices/INT3407:00/dptf_power/max_platform_power_mw
17 Date: Jul, 2016
18 KernelVersion: v4.10
20 Description:
21 (RO) Maximum platform power that can be supported by the battery
22 in milliwatts.
23
24 What: /sys/bus/platform/devices/INT3407:00/dptf_power/platform_power_source
25 Date: Jul, 2016
26 KernelVersion: v4.10
28 Description:
29 (RO) Display the platform power source
30
31 ========= ============================
32 bits[3:0] Current power source
33 - 0x00 = DC
34 - 0x01 = AC
35 - 0x02 = USB
36 - 0x03 = Wireless Charger
37 bits[7:4] Power source sequence number
38 ========= ============================
39
40 What: /sys/bus/platform/devices/INT3407:00/dptf_power/battery_steady_power
41 Date: Jul, 2016
42 KernelVersion: v4.10
44 Description:
45 (RO) The maximum sustained power for battery in milliwatts.
46
47 What: /sys/bus/platform/devices/INT3407:00/dptf_power/rest_of_platform_power_mw
48 Date: June, 2020
49 KernelVersion: v5.8
51 Description:
52 (RO) Shows the rest (outside of SoC) of worst-case platform power.
53
54 What: /sys/bus/platform/devices/INT3407:00/dptf_power/prochot_confirm
55 Date: June, 2020
56 KernelVersion: v5.8
58 Description:
59 (WO) Confirm embedded controller about a prochot notification.
60
61 What: /sys/bus/platform/devices/INT3532:00/dptf_battery/max_platform_power_mw
62 Date: June, 2020
63 KernelVersion: v5.8
65 Description:
66 (RO) The maximum platform power that can be supported by the battery in milli watts.
67
68 What: /sys/bus/platform/devices/INT3532:00/dptf_battery/max_steady_state_power_mw
69 Date: June, 2020
70 KernelVersion: v5.8
72 Description:
73 (RO) The maximum sustained power for battery in milli watts.
74
75 What: /sys/bus/platform/devices/INT3532:00/dptf_battery/high_freq_impedance_mohm
76 Date: June, 2020
77 KernelVersion: v5.8
79 Description:
80 (RO) The high frequency impedance value that can be obtained from battery
81 fuel gauge in milli Ohms.
82
83 What: /sys/bus/platform/devices/INT3532:00/dptf_battery/no_load_voltage_mv
84 Date: June, 2020
85 KernelVersion: v5.8
87 Description:
88 (RO) The no-load voltage that can be obtained from battery fuel gauge in
89 milli volts.
90
91 What: /sys/bus/platform/devices/INT3532:00/dptf_battery/current_discharge_capbility_ma
92 Date: June, 2020
93 KernelVersion: v5.8
95 Description:
96 (RO) The battery discharge current capability obtained from battery fuel gauge in
97 milli Amps.
98
99 What: /sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/freq_mhz_low_clock
100 Date: November, 2020
101 KernelVersion: v5.10
103 Description:
104 (RW) The PCH FIVR (Fully Integrated Voltage Regulator) switching frequency in MHz,
105 when FIVR clock is 19.2MHz or 24MHz.
106
107 What: /sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/freq_mhz_high_clock
108 Date: November, 2020
109 KernelVersion: v5.10
111 Description:
112 (RW) The PCH FIVR (Fully Integrated Voltage Regulator) switching frequency in MHz,
113 when FIVR clock is 38.4MHz.
114
115 What: /sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/fivr_switching_freq_mhz
116 Date: September, 2021
117 KernelVersion: v5.15
119 Description:
120 (RO) Get the FIVR switching control frequency in MHz.
121
122 What: /sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/fivr_switching_fault_status
123 Date: September, 2021
124 KernelVersion: v5.15
126 Description:
127 (RO) Read the FIVR switching frequency control fault status.
128
129 What: /sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/ssc_clock_info
130 Date: September, 2021
131 KernelVersion: v5.15
133 Description:
134 (RO) Presents SSC (spread spectrum clock) information for EMI
135 (Electro magnetic interference) control. This is a bit mask.
136
137 ======= ==========================================
138 Bits Description
139 ======= ==========================================
140 [7:0] Sets clock spectrum spread percentage:
141 0x00=0.2% , 0x3F=10%
142 1 LSB = 0.1% increase in spread (for
143 settings 0x01 thru 0x1C)
144 1 LSB = 0.2% increase in spread (for
145 settings 0x1E thru 0x3F)
146 [8] When set to 1, enables spread
147 spectrum clock
148 [9] 0: Triangle mode. FFC frequency
149 walks around the Fcenter in a linear
150 fashion
151 1: Random walk mode. FFC frequency
152 changes randomly within the SSC
153 (Spread spectrum clock) range
154 [10] 0: No white noise. 1: Add white noise
155 to spread waveform
156 [11] When 1, future writes are ignored.
157 ======= ==========================================
158

3. 한국어 전문 번역

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

Intel DPTF platform sysfs ABI: charger type

1-7
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3407:00/dptf_power/charger_type
Date2016년 7월
KernelVersionv4.10
Contact[email protected]
Description`/sys/bus/platform/devices/INT3407:00/dptf_power/charger_type`은 read-only이며 charger type인 `Traditional`, `Hybrid`, `NVDC` 중 하나를 반환합니다.
DPTF power attributes
AttributeMeaningUnit or values
charger_typeCharger architectureTraditional / Hybrid / NVDC
adapter_rating_mwMaximum adapter powermW; 0 when unplugged
max_platform_power_mwBattery-supported platform maximummW
battery_steady_powerBattery sustained maximummW
rest_of_platform_power_mwWorst case outside SoCmW by interface name
prochot_confirmConfirm PROCHOT to ECWrite-only

Adapter, platform과 battery telemetry의 units와 access를 비교합니다.

Intel DPTF platform sysfs ABI: adapter rating mw

8-15
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3407:00/dptf_power/adapter_rating_mw
Date2016년 7월
KernelVersionv4.10
Contact[email protected]
Description`adapter_rating_mw`는 read-only이며 adapter의 maximum power rating을 milliwatts 단위로 반환합니다. AC adapter가 연결되지 않았으면 반드시 `0`이어야 합니다.

Intel DPTF platform sysfs ABI: max platform power mw

16-23
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3407:00/dptf_power/max_platform_power_mw
Date2016년 7월
KernelVersionv4.10
Contact[email protected]
Description`max_platform_power_mw`는 read-only이며 battery가 지원할 수 있는 maximum platform power를 milliwatts 단위로 반환합니다.

Intel DPTF platform sysfs ABI: platform power source

24-39
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3407:00/dptf_power/platform_power_source
Date2016년 7월
KernelVersionv4.10
Contact[email protected]
Description`platform_power_source`는 read-only이며 platform power source를 bitfield로 표시합니다. `bits[3:0]`은 current source로 `0x00`은 DC, `0x01`은 AC, `0x02`는 USB, `0x03`은 Wireless Charger입니다. `bits[7:4]`는 power-source sequence number입니다.
Platform power-source bitfield
BitsValueMeaning
3:00x00DC
3:00x01AC
3:00x02USB
3:00x03Wireless Charger
7:4SequencePower-source sequence number

Low nibble identifies the source and high nibble carries its sequence number.

Intel DPTF platform sysfs ABI: battery steady power

40-46
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3407:00/dptf_power/battery_steady_power
Date2016년 7월
KernelVersionv4.10
Contact[email protected]
Description`battery_steady_power`는 read-only이며 battery의 maximum sustained power를 milliwatts 단위로 반환합니다.

Intel DPTF platform sysfs ABI: rest of platform power mw

47-53
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3407:00/dptf_power/rest_of_platform_power_mw
Date2020년 6월
KernelVersionv5.8
Contact[email protected]
Description`rest_of_platform_power_mw`는 read-only이며 SoC 밖에 있는 나머지 platform의 worst-case power를 표시합니다.

Intel DPTF platform sysfs ABI: prochot confirm

54-60
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3407:00/dptf_power/prochot_confirm
Date2020년 6월
KernelVersionv5.8
Contact[email protected]
Description`prochot_confirm`은 write-only이며 PROCHOT notification을 embedded controller에 confirm합니다.

Intel DPTF platform sysfs ABI: max platform power mw

61-67
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3532:00/dptf_battery/max_platform_power_mw
Date2020년 6월
KernelVersionv5.8
Contact[email protected]
Description`/sys/bus/platform/devices/INT3532:00/dptf_battery/max_platform_power_mw`는 read-only이며 battery가 지원할 수 있는 maximum platform power를 milliwatts 단위로 반환합니다.

Intel DPTF platform sysfs ABI: max steady state power mw

68-74
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3532:00/dptf_battery/max_steady_state_power_mw
Date2020년 6월
KernelVersionv5.8
Contact[email protected]
Description`max_steady_state_power_mw`는 read-only이며 battery의 maximum sustained power를 milliwatts 단위로 반환합니다.

Intel DPTF platform sysfs ABI: high freq impedance mohm

75-82
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3532:00/dptf_battery/high_freq_impedance_mohm
Date2020년 6월
KernelVersionv5.8
Contact[email protected]
Description`high_freq_impedance_mohm`은 read-only이며 battery fuel gauge에서 얻은 high-frequency impedance를 milli Ohms 단위로 반환합니다.

Intel DPTF platform sysfs ABI: no load voltage mv

83-90
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3532:00/dptf_battery/no_load_voltage_mv
Date2020년 6월
KernelVersionv5.8
Contact[email protected]
Description`no_load_voltage_mv`는 read-only이며 battery fuel gauge에서 얻은 no-load voltage를 milli volts 단위로 반환합니다.

Intel DPTF platform sysfs ABI: current discharge capbility ma

91-98
항목한국어 전문 번역
What/sys/bus/platform/devices/INT3532:00/dptf_battery/current_discharge_capbility_ma
Date2020년 6월
KernelVersionv5.8
Contact[email protected]
Description`current_discharge_capbility_ma`는 read-only이며 battery fuel gauge에서 얻은 discharge-current capability를 milli Amps 단위로 반환합니다.

Intel DPTF platform sysfs ABI: freq mhz low clock

99-106
항목한국어 전문 번역
What/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/freq_mhz_low_clock
Date2020년 11월
KernelVersionv5.10
Contact[email protected]
Description`freq_mhz_low_clock`은 read/write이며 FIVR clock이 `19.2MHz` 또는 `24MHz`일 때 PCH FIVR(Fully Integrated Voltage Regulator) switching frequency를 MHz 단위로 설정하거나 읽습니다.
PCH FIVR clock-specific controls
FIVR input clockWritable attribute
19.2 MHz or 24 MHzfreq_mhz_low_clock
38.4 MHzfreq_mhz_high_clock

Input FIVR clock에 따라 writable frequency attribute가 달라집니다.

Intel DPTF platform sysfs ABI: freq mhz high clock

107-114
항목한국어 전문 번역
What/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/freq_mhz_high_clock
Date2020년 11월
KernelVersionv5.10
Contact[email protected]
Description`freq_mhz_high_clock`은 read/write이며 FIVR clock이 `38.4MHz`일 때 PCH FIVR switching frequency를 MHz 단위로 설정하거나 읽습니다.

Intel DPTF platform sysfs ABI: fivr switching freq mhz

115-121
항목한국어 전문 번역
What/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/fivr_switching_freq_mhz
Date2021년 9월
KernelVersionv5.15
Contact[email protected]
Description`fivr_switching_freq_mhz`는 read-only이며 FIVR switching-control frequency를 MHz 단위로 반환합니다.

Intel DPTF platform sysfs ABI: fivr switching fault status

122-128
항목한국어 전문 번역
What/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/fivr_switching_fault_status
Date2021년 9월
KernelVersionv5.15
Contact[email protected]
Description`fivr_switching_fault_status`는 read-only이며 FIVR switching-frequency control fault status를 반환합니다.

Intel DPTF platform sysfs ABI: ssc clock info

129-157
항목한국어 전문 번역
What/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/ssc_clock_info
Date2021년 9월
KernelVersionv5.15
Contact[email protected]
Description`ssc_clock_info`는 read-only이며 EMI(Electromagnetic interference) 제어를 위한 SSC(spread spectrum clock) 정보를 bitmask로 표시합니다. `bits[7:0]`은 clock spectrum spread percentage로 `0x00=0.2%`, `0x3F=10%`입니다. Settings `0x01`~`0x1C`에서는 1 LSB가 spread를 `0.1%` 늘리고, `0x1E`~`0x3F`에서는 `0.2%` 늘립니다. Bit `8`이 `1`이면 spread-spectrum clock을 enable합니다. Bit `9`가 `0`이면 triangle mode로 FFC frequency가 Fcenter 주위를 선형으로 이동하고, `1`이면 random-walk mode로 SSC range 안에서 무작위로 변합니다. Bit `10`이 `0`이면 white noise가 없고 `1`이면 spread waveform에 white noise를 더합니다. Bit `11`이 `1`이면 이후 writes는 무시됩니다.
SSC clock-info bitmask
BitsControlValues
7:0Spread percentage0x00=0.2%, 0x3F=10%
8SSC enable1 enables
9Walk mode0 triangle, 1 random walk
10White noise0 none, 1 add noise
11Write lock1 ignores future writes
LSB scaling0x01..0x1C: +0.1%; 0x1E..0x3F: +0.2%

원문의 RST bit table을 spread, mode, noise와 write lock fields로 다시 그렸습니다.