Documentation/hwmon/peci-cputemp.rst

   1 .. SPDX-License-Identifier: GPL-2.0-only
   2
   3 Kernel driver peci-cputemp
   4 ==========================
   5
   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
  28
  29         Datasheet: Available from http://www.intel.com/design/literature.htm
  30
  31 Author: Jae Hyun Yoo <jae.hyun.yoo@linux.intel.com>
  32
  33 Description
  34 -----------
  35
  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.
  39
  40 All temperature values are given in millidegree Celsius and will be measurable
  41 only when the target CPU is powered on.
  42
  43 Sysfs interface
  44 -------------------
  45
  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 value from Tcontrol to Tjmax of
  55                         the CPU package.
  56
  57 temp2_label             "DTS"
  58 temp2_input             Provides current temperature of the CPU package scaled
  59                         to match DTS thermal profile.
  60 temp2_max               Provides thermal control temperature of the CPU package
  61                         which is also known as Tcontrol.
  62 temp2_crit              Provides shutdown temperature of the CPU package which
  63                         is also known as the maximum processor junction
  64                         temperature, Tjmax or Tprochot.
  65 temp2_crit_hyst         Provides the hysteresis value from Tcontrol to Tjmax of
  66                         the CPU package.
  67
  68 temp3_label             "Tcontrol"
  69 temp3_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.
  73 temp3_crit              Provides Tcontrol critical value of the CPU package
  74                         which is same to Tjmax.
  75
  76 temp4_label             "Tthrottle"
  77 temp4_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
  82 temp5_label             "Tjmax"
  83 temp5_input             Provides the maximum junction temperature, Tjmax of the
  84                         CPU package.
  85
  86 temp[6-N]_label         Provides string "Core X", where X is resolved core
  87                         number.
  88 temp[6-N]_input         Provides current temperature of each core.
  89
  90 ======================= =======================================================