k10temp.rst 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151
  1. Kernel driver k10temp
  2. =====================
  3. Supported chips:
  4. * AMD Family 10h processors:
  5. Socket F: Quad-Core/Six-Core/Embedded Opteron (but see below)
  6. Socket AM2+: Quad-Core Opteron, Phenom (II) X3/X4, Athlon X2 (but see below)
  7. Socket AM3: Quad-Core Opteron, Athlon/Phenom II X2/X3/X4, Sempron II
  8. Socket S1G3: Athlon II, Sempron, Turion II
  9. * AMD Family 11h processors:
  10. Socket S1G2: Athlon (X2), Sempron (X2), Turion X2 (Ultra)
  11. * AMD Family 12h processors: "Llano" (E2/A4/A6/A8-Series)
  12. * AMD Family 14h processors: "Brazos" (C/E/G/Z-Series)
  13. * AMD Family 15h processors: "Bulldozer" (FX-Series), "Trinity", "Kaveri",
  14. "Carrizo", "Stoney Ridge", "Bristol Ridge"
  15. * AMD Family 16h processors: "Kabini", "Mullins"
  16. * AMD Family 17h processors: "Zen", "Zen 2"
  17. * AMD Family 18h processors: "Hygon Dhyana"
  18. * AMD Family 19h processors: "Zen 3"
  19. Prefix: 'k10temp'
  20. Addresses scanned: PCI space
  21. Datasheets:
  22. BIOS and Kernel Developer's Guide (BKDG) For AMD Family 10h Processors:
  23. http://support.amd.com/us/Processor_TechDocs/31116.pdf
  24. BIOS and Kernel Developer's Guide (BKDG) for AMD Family 11h Processors:
  25. http://support.amd.com/us/Processor_TechDocs/41256.pdf
  26. BIOS and Kernel Developer's Guide (BKDG) for AMD Family 12h Processors:
  27. http://support.amd.com/us/Processor_TechDocs/41131.pdf
  28. BIOS and Kernel Developer's Guide (BKDG) for AMD Family 14h Models 00h-0Fh Processors:
  29. http://support.amd.com/us/Processor_TechDocs/43170.pdf
  30. Revision Guide for AMD Family 10h Processors:
  31. http://support.amd.com/us/Processor_TechDocs/41322.pdf
  32. Revision Guide for AMD Family 11h Processors:
  33. http://support.amd.com/us/Processor_TechDocs/41788.pdf
  34. Revision Guide for AMD Family 12h Processors:
  35. http://support.amd.com/us/Processor_TechDocs/44739.pdf
  36. Revision Guide for AMD Family 14h Models 00h-0Fh Processors:
  37. http://support.amd.com/us/Processor_TechDocs/47534.pdf
  38. AMD Family 11h Processor Power and Thermal Data Sheet for Notebooks:
  39. http://support.amd.com/us/Processor_TechDocs/43373.pdf
  40. AMD Family 10h Server and Workstation Processor Power and Thermal Data Sheet:
  41. http://support.amd.com/us/Processor_TechDocs/43374.pdf
  42. AMD Family 10h Desktop Processor Power and Thermal Data Sheet:
  43. http://support.amd.com/us/Processor_TechDocs/43375.pdf
  44. Author: Clemens Ladisch <clemens@ladisch.de>
  45. Description
  46. -----------
  47. This driver permits reading of the internal temperature sensor of AMD
  48. Family 10h/11h/12h/14h/15h/16h processors.
  49. All these processors have a sensor, but on those for Socket F or AM2+,
  50. the sensor may return inconsistent values (erratum 319). The driver
  51. will refuse to load on these revisions unless you specify the "force=1"
  52. module parameter.
  53. Due to technical reasons, the driver can detect only the mainboard's
  54. socket type, not the processor's actual capabilities. Therefore, if you
  55. are using an AM3 processor on an AM2+ mainboard, you can safely use the
  56. "force=1" parameter.
  57. For CPUs older than Family 17h, there is one temperature measurement value,
  58. available as temp1_input in sysfs. It is measured in degrees Celsius with a
  59. resolution of 1/8th degree. Please note that it is defined as a relative
  60. value; to quote the AMD manual::
  61. Tctl is the processor temperature control value, used by the platform to
  62. control cooling systems. Tctl is a non-physical temperature on an
  63. arbitrary scale measured in degrees. It does _not_ represent an actual
  64. physical temperature like die or case temperature. Instead, it specifies
  65. the processor temperature relative to the point at which the system must
  66. supply the maximum cooling for the processor's specified maximum case
  67. temperature and maximum thermal power dissipation.
  68. The maximum value for Tctl is available in the file temp1_max.
  69. If the BIOS has enabled hardware temperature control, the threshold at
  70. which the processor will throttle itself to avoid damage is available in
  71. temp1_crit and temp1_crit_hyst.
  72. On some AMD CPUs, there is a difference between the die temperature (Tdie) and
  73. the reported temperature (Tctl). Tdie is the real measured temperature, and
  74. Tctl is used for fan control. While Tctl is always available as temp1_input,
  75. the driver exports Tdie temperature as temp2_input for those CPUs which support
  76. it.
  77. Models from 17h family report relative temperature, the driver aims to
  78. compensate and report the real temperature.
  79. On Family 17h and Family 18h CPUs, additional temperature sensors may report
  80. Core Complex Die (CCD) temperatures. Up to 8 such temperatures are reported
  81. as temp{3..10}_input, labeled Tccd{1..8}. Actual support depends on the CPU
  82. variant.
  83. Various Family 17h and 18h CPUs report voltage and current telemetry
  84. information. The following attributes may be reported.
  85. Attribute Label Description
  86. =============== ======= ================
  87. in0_input Vcore Core voltage
  88. in1_input Vsoc SoC voltage
  89. curr1_input Icore Core current
  90. curr2_input Isoc SoC current
  91. =============== ======= ================
  92. Current values are raw (unscaled) as reported by the CPU. Core current is
  93. reported as multiples of 1A / LSB. SoC is reported as multiples of 0.25A
  94. / LSB. The real current is board specific. Reported currents should be seen
  95. as rough guidance, and should be scaled using sensors3.conf as appropriate
  96. for a given board.