xref: /linux/Documentation/hwmon/peci-cputemp.rst (revision e7d759f31ca295d589f7420719c311870bb3166f)
1.. SPDX-License-Identifier: GPL-2.0-only
2
3Kernel driver peci-cputemp
4==========================
5
6Supported 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
28
29	Datasheet: Available from http://www.intel.com/design/literature.htm
30
31Author: Jae Hyun Yoo <jae.hyun.yoo@linux.intel.com>
32
33Description
34-----------
35
36This driver implements a generic PECI hwmon feature which provides Digital
37Thermal Sensor (DTS) thermal readings of the CPU package and CPU cores that are
38accessible via the processor PECI interface.
39
40All temperature values are given in millidegree Celsius and will be measurable
41only when the target CPU is powered on.
42
43Sysfs interface
44-------------------
45
46======================= =======================================================
47temp1_label		"Die"
48temp1_input		Provides current die temperature of the CPU package.
49temp1_max		Provides thermal control temperature of the CPU package
50			which is also known as Tcontrol.
51temp1_crit		Provides shutdown temperature of the CPU package which
52			is also known as the maximum processor junction
53			temperature, Tjmax or Tprochot.
54temp1_crit_hyst		Provides the hysteresis value from Tcontrol to Tjmax of
55			the CPU package.
56
57temp2_label		"DTS"
58temp2_input		Provides current temperature of the CPU package scaled
59			to match DTS thermal profile.
60temp2_max		Provides thermal control temperature of the CPU package
61			which is also known as Tcontrol.
62temp2_crit		Provides shutdown temperature of the CPU package which
63			is also known as the maximum processor junction
64			temperature, Tjmax or Tprochot.
65temp2_crit_hyst		Provides the hysteresis value from Tcontrol to Tjmax of
66			the CPU package.
67
68temp3_label		"Tcontrol"
69temp3_input		Provides current Tcontrol temperature of the CPU
70			package which is also known as Fan Temperature target.
71			Indicates the relative value from thermal monitor trip
72			temperature at which fans should be engaged.
73temp3_crit		Provides Tcontrol critical value of the CPU package
74			which is same to Tjmax.
75
76temp4_label		"Tthrottle"
77temp4_input		Provides current Tthrottle temperature of the CPU
78			package. Used for throttling temperature. If this value
79			is allowed and lower than Tjmax - the throttle will
80			occur and reported at lower than Tjmax.
81
82temp5_label		"Tjmax"
83temp5_input		Provides the maximum junction temperature, Tjmax of the
84			CPU package.
85
86temp[6-N]_label		Provides string "Core X", where X is resolved core
87			number.
88temp[6-N]_input		Provides current temperature of each core.
89
90======================= =======================================================
91