0001 Kernel driver k10temp
0002 =====================
0003
0004 Supported chips:
0005
0006 * AMD Family 10h processors:
0007
0008 Socket F: Quad-Core/Six-Core/Embedded Opteron (but see below)
0009
0010 Socket AM2+: Quad-Core Opteron, Phenom (II) X3/X4, Athlon X2 (but see below)
0011
0012 Socket AM3: Quad-Core Opteron, Athlon/Phenom II X2/X3/X4, Sempron II
0013
0014 Socket S1G3: Athlon II, Sempron, Turion II
0015
0016 * AMD Family 11h processors:
0017
0018 Socket S1G2: Athlon (X2), Sempron (X2), Turion X2 (Ultra)
0019
0020 * AMD Family 12h processors: "Llano" (E2/A4/A6/A8-Series)
0021
0022 * AMD Family 14h processors: "Brazos" (C/E/G/Z-Series)
0023
0024 * AMD Family 15h processors: "Bulldozer" (FX-Series), "Trinity", "Kaveri",
0025 "Carrizo", "Stoney Ridge", "Bristol Ridge"
0026
0027 * AMD Family 16h processors: "Kabini", "Mullins"
0028
0029 * AMD Family 17h processors: "Zen", "Zen 2"
0030
0031 * AMD Family 18h processors: "Hygon Dhyana"
0032
0033 * AMD Family 19h processors: "Zen 3"
0034
0035 Prefix: 'k10temp'
0036
0037 Addresses scanned: PCI space
0038
0039 Datasheets:
0040
0041 BIOS and Kernel Developer's Guide (BKDG) For AMD Family 10h Processors:
0042
0043 http://support.amd.com/us/Processor_TechDocs/31116.pdf
0044
0045 BIOS and Kernel Developer's Guide (BKDG) for AMD Family 11h Processors:
0046
0047 http://support.amd.com/us/Processor_TechDocs/41256.pdf
0048
0049 BIOS and Kernel Developer's Guide (BKDG) for AMD Family 12h Processors:
0050
0051 http://support.amd.com/us/Processor_TechDocs/41131.pdf
0052
0053 BIOS and Kernel Developer's Guide (BKDG) for AMD Family 14h Models 00h-0Fh Processors:
0054
0055 http://support.amd.com/us/Processor_TechDocs/43170.pdf
0056
0057 Revision Guide for AMD Family 10h Processors:
0058
0059 http://support.amd.com/us/Processor_TechDocs/41322.pdf
0060
0061 Revision Guide for AMD Family 11h Processors:
0062
0063 http://support.amd.com/us/Processor_TechDocs/41788.pdf
0064
0065 Revision Guide for AMD Family 12h Processors:
0066
0067 http://support.amd.com/us/Processor_TechDocs/44739.pdf
0068
0069 Revision Guide for AMD Family 14h Models 00h-0Fh Processors:
0070
0071 http://support.amd.com/us/Processor_TechDocs/47534.pdf
0072
0073 AMD Family 11h Processor Power and Thermal Data Sheet for Notebooks:
0074
0075 http://support.amd.com/us/Processor_TechDocs/43373.pdf
0076
0077 AMD Family 10h Server and Workstation Processor Power and Thermal Data Sheet:
0078
0079 http://support.amd.com/us/Processor_TechDocs/43374.pdf
0080
0081 AMD Family 10h Desktop Processor Power and Thermal Data Sheet:
0082
0083 http://support.amd.com/us/Processor_TechDocs/43375.pdf
0084
0085 Author: Clemens Ladisch <clemens@ladisch.de>
0086
0087 Description
0088 -----------
0089
0090 This driver permits reading of the internal temperature sensor of AMD
0091 Family 10h/11h/12h/14h/15h/16h processors.
0092
0093 All these processors have a sensor, but on those for Socket F or AM2+,
0094 the sensor may return inconsistent values (erratum 319). The driver
0095 will refuse to load on these revisions unless you specify the "force=1"
0096 module parameter.
0097
0098 Due to technical reasons, the driver can detect only the mainboard's
0099 socket type, not the processor's actual capabilities. Therefore, if you
0100 are using an AM3 processor on an AM2+ mainboard, you can safely use the
0101 "force=1" parameter.
0102
0103 For CPUs older than Family 17h, there is one temperature measurement value,
0104 available as temp1_input in sysfs. It is measured in degrees Celsius with a
0105 resolution of 1/8th degree. Please note that it is defined as a relative
0106 value; to quote the AMD manual::
0107
0108 Tctl is the processor temperature control value, used by the platform to
0109 control cooling systems. Tctl is a non-physical temperature on an
0110 arbitrary scale measured in degrees. It does _not_ represent an actual
0111 physical temperature like die or case temperature. Instead, it specifies
0112 the processor temperature relative to the point at which the system must
0113 supply the maximum cooling for the processor's specified maximum case
0114 temperature and maximum thermal power dissipation.
0115
0116 The maximum value for Tctl is available in the file temp1_max.
0117
0118 If the BIOS has enabled hardware temperature control, the threshold at
0119 which the processor will throttle itself to avoid damage is available in
0120 temp1_crit and temp1_crit_hyst.
0121
0122 On some AMD CPUs, there is a difference between the die temperature (Tdie) and
0123 the reported temperature (Tctl). Tdie is the real measured temperature, and
0124 Tctl is used for fan control. While Tctl is always available as temp1_input,
0125 the driver exports Tdie temperature as temp2_input for those CPUs which support
0126 it.
0127
0128 Models from 17h family report relative temperature, the driver aims to
0129 compensate and report the real temperature.
0130
0131 On Family 17h and Family 18h CPUs, additional temperature sensors may report
0132 Core Complex Die (CCD) temperatures. Up to 8 such temperatures are reported
0133 as temp{3..10}_input, labeled Tccd{1..8}. Actual support depends on the CPU
0134 variant.
