요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0-only
3
Kernel driver peci-cputemp
4
==========================
6
Supported chips:
7
One of Intel server CPUs listed below which is connected to a PECI bus.
8
* Intel Xeon E5/E7 v3 server processors
9
Intel Xeon E5-14xx v3 family
10
Intel Xeon E5-24xx v3 family
11
Intel Xeon E5-16xx v3 family
12
Intel Xeon E5-26xx v3 family
13
Intel Xeon E5-46xx v3 family
14
Intel Xeon E7-48xx v3 family
15
Intel Xeon E7-88xx v3 family
16
* Intel Xeon E5/E7 v4 server processors
17
Intel Xeon E5-16xx v4 family
18
Intel Xeon E5-26xx v4 family
19
Intel Xeon E5-46xx v4 family
20
Intel Xeon E7-48xx v4 family
21
Intel Xeon E7-88xx v4 family
22
* Intel Xeon Scalable server processors
23
Intel Xeon D family
24
Intel Xeon Bronze family
25
Intel Xeon Silver family
26
Intel Xeon Gold family
27
Intel Xeon Platinum family
29
Datasheet: Available from http://www.intel.com/design/literature.htm
31
Author: Jae Hyun Yoo <jae.hyun.yoo@linux.intel.com>
33
Description
34
-----------
36
This driver implements a generic PECI hwmon feature which provides Digital
37
Thermal Sensor (DTS) thermal readings of the CPU package and CPU cores that are
38
accessible via the processor PECI interface.
40
All temperature values are given in millidegree Celsius and will be measurable
41
only when the target CPU is powered on.
43
Sysfs interface
44
-------------------
46
======================= =======================================================
47
temp1_label "Die"
48
temp1_input Provides current die temperature of the CPU package.
49
temp1_max Provides thermal control temperature of the CPU package
50
which is also known as Tcontrol.
51
temp1_crit Provides shutdown temperature of the CPU package which
52
is also known as the maximum processor junction
53
temperature, Tjmax or Tprochot.
54
temp1_crit_hyst Provides the hysteresis temperature of the CPU
55
package. Returns Tcontrol, the temperature at which
56
the critical condition clears.
58
temp2_label "DTS"
59
temp2_input Provides current temperature of the CPU package scaled
60
to match DTS thermal profile.
61
temp2_max Provides thermal control temperature of the CPU package
62
which is also known as Tcontrol.
63
temp2_crit Provides shutdown temperature of the CPU package which
64
is also known as the maximum processor junction
65
temperature, Tjmax or Tprochot.
66
temp2_crit_hyst Provides the hysteresis temperature of the CPU
67
package. Returns Tcontrol, the temperature at which
68
the critical condition clears.
70
temp3_label "Tcontrol"
71
temp3_input Provides current Tcontrol temperature of the CPU
72
package which is also known as Fan Temperature target.
73
Indicates the relative value from thermal monitor trip
74
temperature at which fans should be engaged.
75
temp3_crit Provides Tcontrol critical value of the CPU package
76
which is same to Tjmax.
78
temp4_label "Tthrottle"
79
temp4_input Provides current Tthrottle temperature of the CPU
80
package. Used for throttling temperature. If this value
81
is allowed and lower than Tjmax - the throttle will
82
occur and reported at lower than Tjmax.
84
temp5_label "Tjmax"
85
temp5_input Provides the maximum junction temperature, Tjmax of the
86
CPU package.
88
temp[6-N]_label Provides string "Core X", where X is resolved core
89
number.
90
temp[6-N]_input Provides current temperature of each core.
92
======================= =======================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원 Intel Xeon 서버 프로세서
1-32GPL-2.0-only `peci-cputemp` 드라이버는 PECI 버스에 연결된 Intel 서버 CPU의 온도를 지원합니다. 지원 범위는 Xeon E5/E7 v3·v4와 Xeon Scalable 계열입니다.
v3 계열에는 E5-14xx, E5-24xx, E5-16xx, E5-26xx, E5-46xx, E7-48xx, E7-88xx가 포함됩니다. v4 계열에는 E5-16xx, E5-26xx, E5-46xx, E7-48xx, E7-88xx가 포함됩니다.
Xeon Scalable 서버 프로세서에는 Xeon D, Bronze, Silver, Gold, Platinum 계열이 포함됩니다. 데이터시트는 Intel 설계 문서 사이트에서 구할 수 있으며 작성자는 Jae Hyun Yoo입니다.
세대지원 제품군
Xeon E5/E7 v3E5-14xx, E5-24xx, E5-16xx, E5-26xx, E5-46xx, E7-48xx, E7-88xx
Xeon E5/E7 v4E5-16xx, E5-26xx, E5-46xx, E7-48xx, E7-88xx
Xeon ScalableXeon D, Bronze, Silver, Gold, Platinum
원문의 세대별 제품군을 빠짐없이 정리합니다.
프로세서가 PECI 버스에 연결됐는지 확인→Xeon v3·v4 또는 Scalable 세대 판별→세부 제품군 대조→PECI 클라이언트 생성→cputemp hwmon 등록
PECI 연결과 제품군을 모두 확인합니다.
.. SPDX-License-Identifier: GPL-2.0-only
Kernel driver peci-cputemp
==========================
Supported chips:
One of Intel server CPUs listed below which is connected to a PECI bus.
* Intel Xeon E5/E7 v3 server processors
Intel Xeon E5-14xx v3 family
Intel Xeon E5-24xx v3 family
Intel Xeon E5-16xx v3 family
Intel Xeon E5-26xx v3 family
Intel Xeon E5-46xx v3 family
Intel Xeon E7-48xx v3 family
Intel Xeon E7-88xx v3 family
* Intel Xeon E5/E7 v4 server processors
Intel Xeon E5-16xx v4 family
Intel Xeon E5-26xx v4 family
Intel Xeon E5-46xx v4 family
Intel Xeon E7-48xx v4 family
Intel Xeon E7-88xx v4 family
* Intel Xeon Scalable server processors
Intel Xeon D family
Intel Xeon Bronze family
Intel Xeon Silver family
Intel Xeon Gold family
Intel Xeon Platinum family
Datasheet: Available from http://www.intel.com/design/literature.htm
Author: Jae Hyun Yoo <jae.hyun.yoo@linux.intel.com>
패키지·코어 DTS 판독 조건
33-42이 드라이버는 프로세서 PECI 인터페이스로 접근할 수 있는 CPU 패키지와 각 CPU 코어의 DTS(Digital Thermal Sensor) 값을 제공하는 일반 PECI hwmon 기능을 구현합니다.
모든 온도 값의 단위는 밀리도 섭씨입니다.
대상 CPU에 전원이 켜져 있을 때만 온도를 측정할 수 있습니다. 전원이 꺼진 프로세서의 PECI 온도 채널을 유효한 측정값으로 취급해서는 안 됩니다.
항목내용
전송 경로프로세서 PECI 인터페이스
센서CPU 패키지 DTS와 개별 코어
단위밀리°C
필수 조건대상 CPU 전원 켜짐
측정 대상·단위·전원 조건을 구분합니다.
대상 CPU 전원 상태 확인→PECI 요청 전송→패키지 DTS 읽기→해결된 코어별 DTS 읽기→밀리°C hwmon 값으로 공개
CPU 전원 상태를 확인한 뒤 PECI 값을 읽습니다.
Description
-----------
This driver implements a generic PECI hwmon feature which provides Digital
Thermal Sensor (DTS) thermal readings of the CPU package and CPU cores that are
accessible via the processor PECI interface.
All temperature values are given in millidegree Celsius and will be measurable
only when the target CPU is powered on.
Die와 DTS 온도 속성
43-68`temp1_label`은 `Die`입니다. `temp1_input`은 현재 CPU 패키지 다이 온도, `temp1_max`는 열 제어 온도인 Tcontrol, `temp1_crit`은 종료 온도인 최대 접합 온도 Tjmax 또는 Tprochot을 제공합니다.
`temp1_crit_hyst`는 패키지 임계 상태가 해제되는 온도인 Tcontrol을 반환합니다.
`temp2_label`은 `DTS`입니다. `temp2_input`은 DTS 열 프로필에 맞게 스케일된 현재 CPU 패키지 온도를 제공합니다.
`temp2_max`도 Tcontrol, `temp2_crit`도 Tjmax 또는 Tprochot, `temp2_crit_hyst`도 임계 상태 해제점인 Tcontrol을 제공합니다.
채널labelinputmaxcritcrit_hyst
temp1Die현재 다이 온도TcontrolTjmax/TprochotTcontrol
temp2DTSDTS 프로필 패키지 온도TcontrolTjmax/TprochotTcontrol
두 표현 방식의 패키지 온도와 한계값을 대응시킵니다.
Die 또는 DTS input 읽기→Tcontrol max 확인→Tjmax/Tprochot crit 확인→crit 도달 여부 판단→Tcontrol 아래에서 임계 상태 해제
현재값을 제어·종료 온도와 비교합니다.
Sysfs interface
-------------------
======================= =======================================================
temp1_label "Die"
temp1_input Provides current die temperature of the CPU package.
temp1_max Provides thermal control temperature of the CPU package
which is also known as Tcontrol.
temp1_crit Provides shutdown temperature of the CPU package which
is also known as the maximum processor junction
temperature, Tjmax or Tprochot.
temp1_crit_hyst Provides the hysteresis temperature of the CPU
package. Returns Tcontrol, the temperature at which
the critical condition clears.
temp2_label "DTS"
temp2_input Provides current temperature of the CPU package scaled
to match DTS thermal profile.
temp2_max Provides thermal control temperature of the CPU package
which is also known as Tcontrol.
temp2_crit Provides shutdown temperature of the CPU package which
is also known as the maximum processor junction
temperature, Tjmax or Tprochot.
temp2_crit_hyst Provides the hysteresis temperature of the CPU
package. Returns Tcontrol, the temperature at which
the critical condition clears.Tcontrol·Tthrottle·Tjmax와 코어 채널
69-92`temp3_label`은 `Tcontrol`입니다. `temp3_input`은 Fan Temperature target이라고도 하는 현재 패키지 Tcontrol 온도를 제공합니다. 열 모니터 트립 온도를 기준으로 팬을 작동해야 하는 상대 지점을 나타냅니다. `temp3_crit`은 Tjmax와 같은 Tcontrol 임계값입니다.
`temp4_label`은 `Tthrottle`입니다. `temp4_input`은 스로틀링에 사용하는 현재 패키지 온도를 제공합니다. 이 값이 허용되고 `Tjmax`보다 낮으면 스로틀링도 Tjmax보다 낮은 온도에서 발생하고 보고됩니다.
`temp5_label`은 `Tjmax`이고 `temp5_input`은 CPU 패키지의 최대 접합 온도를 제공합니다.
`temp[6-N]_label`은 해결된 코어 번호 X를 넣은 `Core X` 문자열이며, 대응하는 `temp[6-N]_input`은 각 코어의 현재 온도를 제공합니다.
채널label의미
temp3_inputTcontrol팬 작동 목표가 되는 상대 온도
temp3_critTcontrol critTjmax와 동일
temp4_inputTthrottle스로틀 시작 온도
temp5_inputTjmax최대 접합 온도
temp[6-N]_inputCore X각 해결된 코어의 현재 온도
팬 제어·스로틀·종료 기준과 개별 코어 채널입니다.
Core X와 패키지 현재 온도 수집→Tcontrol에서 팬 대응→Tthrottle에서 성능 제한→Tjmax 접근 감시→임계 조건 해제는 Tcontrol 기준
팬 제어에서 스로틀과 임계 종료까지 기준을 구분합니다.
temp3_label "Tcontrol"
temp3_input Provides current Tcontrol temperature of the CPU
package which is also known as Fan Temperature target.
Indicates the relative value from thermal monitor trip
temperature at which fans should be engaged.
temp3_crit Provides Tcontrol critical value of the CPU package
which is same to Tjmax.
temp4_label "Tthrottle"
temp4_input Provides current Tthrottle temperature of the CPU
package. Used for throttling temperature. If this value
is allowed and lower than Tjmax - the throttle will
occur and reported at lower than Tjmax.
temp5_label "Tjmax"
temp5_input Provides the maximum junction temperature, Tjmax of the
CPU package.
temp[6-N]_label Provides string "Core X", where X is resolved core
number.
temp[6-N]_input Provides current temperature of each core.
======================= =======================================================
요약·해설
peci-cputemp.rst:1-92전원이 켜진 Xeon v3·v4·Scalable CPU에서 패키지와 코어 온도, 팬 제어·스로틀·종료 기준을 밀리도 섭씨로 읽습니다.
원문 분량과 핵심 장치 구성을 정리합니다.
장치 인식부터 측정·제어까지의 핵심 순서입니다.