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