xref: /linux/Documentation/hwmon/k10temp.rst (revision 44f57d78)
1Kernel driver k10temp
2=====================
3
4Supported chips:
5
6* AMD Family 10h processors:
7
8  Socket F: Quad-Core/Six-Core/Embedded Opteron (but see below)
9
10  Socket AM2+: Quad-Core Opteron, Phenom (II) X3/X4, Athlon X2 (but see below)
11
12  Socket AM3: Quad-Core Opteron, Athlon/Phenom II X2/X3/X4, Sempron II
13
14  Socket S1G3: Athlon II, Sempron, Turion II
15
16* AMD Family 11h processors:
17
18  Socket S1G2: Athlon (X2), Sempron (X2), Turion X2 (Ultra)
19
20* AMD Family 12h processors: "Llano" (E2/A4/A6/A8-Series)
21
22* AMD Family 14h processors: "Brazos" (C/E/G/Z-Series)
23
24* AMD Family 15h processors: "Bulldozer" (FX-Series), "Trinity", "Kaveri", "Carrizo"
25
26* AMD Family 16h processors: "Kabini", "Mullins"
27
28  Prefix: 'k10temp'
29
30  Addresses scanned: PCI space
31
32  Datasheets:
33
34  BIOS and Kernel Developer's Guide (BKDG) For AMD Family 10h Processors:
35
36    http://support.amd.com/us/Processor_TechDocs/31116.pdf
37
38  BIOS and Kernel Developer's Guide (BKDG) for AMD Family 11h Processors:
39
40    http://support.amd.com/us/Processor_TechDocs/41256.pdf
41
42  BIOS and Kernel Developer's Guide (BKDG) for AMD Family 12h Processors:
43
44    http://support.amd.com/us/Processor_TechDocs/41131.pdf
45
46  BIOS and Kernel Developer's Guide (BKDG) for AMD Family 14h Models 00h-0Fh Processors:
47
48    http://support.amd.com/us/Processor_TechDocs/43170.pdf
49
50  Revision Guide for AMD Family 10h Processors:
51
52    http://support.amd.com/us/Processor_TechDocs/41322.pdf
53
54  Revision Guide for AMD Family 11h Processors:
55
56    http://support.amd.com/us/Processor_TechDocs/41788.pdf
57
58  Revision Guide for AMD Family 12h Processors:
59
60    http://support.amd.com/us/Processor_TechDocs/44739.pdf
61
62  Revision Guide for AMD Family 14h Models 00h-0Fh Processors:
63
64    http://support.amd.com/us/Processor_TechDocs/47534.pdf
65
66  AMD Family 11h Processor Power and Thermal Data Sheet for Notebooks:
67
68    http://support.amd.com/us/Processor_TechDocs/43373.pdf
69
70  AMD Family 10h Server and Workstation Processor Power and Thermal Data Sheet:
71
72    http://support.amd.com/us/Processor_TechDocs/43374.pdf
73
74  AMD Family 10h Desktop Processor Power and Thermal Data Sheet:
75
76    http://support.amd.com/us/Processor_TechDocs/43375.pdf
77
78Author: Clemens Ladisch <clemens@ladisch.de>
79
80Description
81-----------
82
83This driver permits reading of the internal temperature sensor of AMD
84Family 10h/11h/12h/14h/15h/16h processors.
85
86All these processors have a sensor, but on those for Socket F or AM2+,
87the sensor may return inconsistent values (erratum 319).  The driver
88will refuse to load on these revisions unless you specify the "force=1"
89module parameter.
90
91Due to technical reasons, the driver can detect only the mainboard's
92socket type, not the processor's actual capabilities.  Therefore, if you
93are using an AM3 processor on an AM2+ mainboard, you can safely use the
94"force=1" parameter.
95
96There is one temperature measurement value, available as temp1_input in
97sysfs. It is measured in degrees Celsius with a resolution of 1/8th degree.
98Please note that it is defined as a relative value; to quote the AMD manual::
99
100  Tctl is the processor temperature control value, used by the platform to
101  control cooling systems. Tctl is a non-physical temperature on an
102  arbitrary scale measured in degrees. It does _not_ represent an actual
103  physical temperature like die or case temperature. Instead, it specifies
104  the processor temperature relative to the point at which the system must
105  supply the maximum cooling for the processor's specified maximum case
106  temperature and maximum thermal power dissipation.
107
108The maximum value for Tctl is available in the file temp1_max.
109
110If the BIOS has enabled hardware temperature control, the threshold at
111which the processor will throttle itself to avoid damage is available in
112temp1_crit and temp1_crit_hyst.
113