0001 .. SPDX-License-Identifier: GPL-2.0-only
0002
0003 Kernel driver peci-cputemp
0004 ==========================
0005
0006 Supported chips:
0007 One of Intel server CPUs listed below which is connected to a PECI bus.
0008 * Intel Xeon E5/E7 v3 server processors
0009 Intel Xeon E5-14xx v3 family
0010 Intel Xeon E5-24xx v3 family
0011 Intel Xeon E5-16xx v3 family
0012 Intel Xeon E5-26xx v3 family
0013 Intel Xeon E5-46xx v3 family
0014 Intel Xeon E7-48xx v3 family
0015 Intel Xeon E7-88xx v3 family
0016 * Intel Xeon E5/E7 v4 server processors
0017 Intel Xeon E5-16xx v4 family
0018 Intel Xeon E5-26xx v4 family
0019 Intel Xeon E5-46xx v4 family
0020 Intel Xeon E7-48xx v4 family
0021 Intel Xeon E7-88xx v4 family
0022 * Intel Xeon Scalable server processors
0023 Intel Xeon D family
0024 Intel Xeon Bronze family
0025 Intel Xeon Silver family
0026 Intel Xeon Gold family
0027 Intel Xeon Platinum family
0028
0029 Datasheet: Available from http://www.intel.com/design/literature.htm
0030
0031 Author: Jae Hyun Yoo <jae.hyun.yoo@linux.intel.com>
0032
0033 Description
0034 -----------
0035
0036 This driver implements a generic PECI hwmon feature which provides Digital
0037 Thermal Sensor (DTS) thermal readings of the CPU package and CPU cores that are
0038 accessible via the processor PECI interface.
0039
0040 All temperature values are given in millidegree Celsius and will be measurable
0041 only when the target CPU is powered on.
0042
0043 Sysfs interface
0044 -------------------
0045
0046 ======================= =======================================================
0047 temp1_label "Die"
0048 temp1_input Provides current die temperature of the CPU package.
0049 temp1_max Provides thermal control temperature of the CPU package
0050 which is also known as Tcontrol.
0051 temp1_crit Provides shutdown temperature of the CPU package which
0052 is also known as the maximum processor junction
0053 temperature, Tjmax or Tprochot.
0054 temp1_crit_hyst Provides the hysteresis value from Tcontrol to Tjmax of
0055 the CPU package.
0056
0057 temp2_label "DTS"
0058 temp2_input Provides current temperature of the CPU package scaled
0059 to match DTS thermal profile.
0060 temp2_max Provides thermal control temperature of the CPU package
0061 which is also known as Tcontrol.
0062 temp2_crit Provides shutdown temperature of the CPU package which
0063 is also known as the maximum processor junction
0064 temperature, Tjmax or Tprochot.
0065 temp2_crit_hyst Provides the hysteresis value from Tcontrol to Tjmax of
0066 the CPU package.
0067
0068 temp3_label "Tcontrol"
0069 temp3_input Provides current Tcontrol temperature of the CPU
0070 package which is also known as Fan Temperature target.
0071 Indicates the relative value from thermal monitor trip
0072 temperature at which fans should be engaged.
0073 temp3_crit Provides Tcontrol critical value of the CPU package
0074 which is same to Tjmax.
0075
0076 temp4_label "Tthrottle"
0077 temp4_input Provides current Tthrottle temperature of the CPU
0078 package. Used for throttling temperature. If this value
0079 is allowed and lower than Tjmax - the throttle will
0080 occur and reported at lower than Tjmax.
0081
0082 temp5_label "Tjmax"
0083 temp5_input Provides the maximum junction temperature, Tjmax of the
0084 CPU package.
0085
0086 temp[6-N]_label Provides string "Core X", where X is resolved core
0087 number.
0088 temp[6-N]_input Provides current temperature of each core.
0089
0090 ======================= =======================================================