blob: a10f73624ad3d8f65dd365ba1ca225dcf64c9b01 [file] [log] [blame]
Clemens Ladisch3c57e892009-12-16 21:38:25 +01001Kernel driver k10temp
2=====================
3
4Supported chips:
5* AMD Family 10h processors:
Clemens Ladischc5114a12010-01-10 20:52:34 +01006 Socket F: Quad-Core/Six-Core/Embedded Opteron (but see below)
7 Socket AM2+: Quad-Core Opteron, Phenom (II) X3/X4, Athlon X2 (but see below)
Clemens Ladisch3c57e892009-12-16 21:38:25 +01008 Socket AM3: Quad-Core Opteron, Athlon/Phenom II X2/X3/X4, Sempron II
9 Socket S1G3: Athlon II, Sempron, Turion II
10* AMD Family 11h processors:
11 Socket S1G2: Athlon (X2), Sempron (X2), Turion X2 (Ultra)
Clemens Ladischaf75d5b2011-07-03 13:32:54 +020012* AMD Family 12h processors: "Llano" (E2/A4/A6/A8-Series)
13* AMD Family 14h processors: "Brazos" (C/E/G/Z-Series)
Andre Przywara9e581312011-05-25 20:43:31 +020014* AMD Family 15h processors: "Bulldozer"
Clemens Ladisch3c57e892009-12-16 21:38:25 +010015
16 Prefix: 'k10temp'
17 Addresses scanned: PCI space
18 Datasheets:
19 BIOS and Kernel Developer's Guide (BKDG) For AMD Family 10h Processors:
20 http://support.amd.com/us/Processor_TechDocs/31116.pdf
21 BIOS and Kernel Developer's Guide (BKDG) for AMD Family 11h Processors:
22 http://support.amd.com/us/Processor_TechDocs/41256.pdf
Clemens Ladischaf75d5b2011-07-03 13:32:54 +020023 BIOS and Kernel Developer's Guide (BKDG) for AMD Family 12h Processors:
24 http://support.amd.com/us/Processor_TechDocs/41131.pdf
Clemens Ladischaa4790a2011-02-17 03:22:40 -050025 BIOS and Kernel Developer's Guide (BKDG) for AMD Family 14h Models 00h-0Fh Processors:
26 http://support.amd.com/us/Processor_TechDocs/43170.pdf
Clemens Ladisch3c57e892009-12-16 21:38:25 +010027 Revision Guide for AMD Family 10h Processors:
28 http://support.amd.com/us/Processor_TechDocs/41322.pdf
29 Revision Guide for AMD Family 11h Processors:
30 http://support.amd.com/us/Processor_TechDocs/41788.pdf
Clemens Ladischaf75d5b2011-07-03 13:32:54 +020031 Revision Guide for AMD Family 12h Processors:
32 http://support.amd.com/us/Processor_TechDocs/44739.pdf
Clemens Ladischaa4790a2011-02-17 03:22:40 -050033 Revision Guide for AMD Family 14h Models 00h-0Fh Processors:
34 http://support.amd.com/us/Processor_TechDocs/47534.pdf
Clemens Ladisch3c57e892009-12-16 21:38:25 +010035 AMD Family 11h Processor Power and Thermal Data Sheet for Notebooks:
36 http://support.amd.com/us/Processor_TechDocs/43373.pdf
37 AMD Family 10h Server and Workstation Processor Power and Thermal Data Sheet:
38 http://support.amd.com/us/Processor_TechDocs/43374.pdf
39 AMD Family 10h Desktop Processor Power and Thermal Data Sheet:
40 http://support.amd.com/us/Processor_TechDocs/43375.pdf
41
42Author: Clemens Ladisch <clemens@ladisch.de>
43
44Description
45-----------
46
47This driver permits reading of the internal temperature sensor of AMD
Andre Przywara9e581312011-05-25 20:43:31 +020048Family 10h/11h/12h/14h/15h processors.
Clemens Ladisch3c57e892009-12-16 21:38:25 +010049
Clemens Ladischc5114a12010-01-10 20:52:34 +010050All these processors have a sensor, but on those for Socket F or AM2+,
51the sensor may return inconsistent values (erratum 319). The driver
52will refuse to load on these revisions unless you specify the "force=1"
53module parameter.
54
55Due to technical reasons, the driver can detect only the mainboard's
56socket type, not the processor's actual capabilities. Therefore, if you
57are using an AM3 processor on an AM2+ mainboard, you can safely use the
58"force=1" parameter.
Clemens Ladisch3c57e892009-12-16 21:38:25 +010059
60There is one temperature measurement value, available as temp1_input in
61sysfs. It is measured in degrees Celsius with a resolution of 1/8th degree.
62Please note that it is defined as a relative value; to quote the AMD manual:
63
64 Tctl is the processor temperature control value, used by the platform to
65 control cooling systems. Tctl is a non-physical temperature on an
66 arbitrary scale measured in degrees. It does _not_ represent an actual
67 physical temperature like die or case temperature. Instead, it specifies
68 the processor temperature relative to the point at which the system must
69 supply the maximum cooling for the processor's specified maximum case
70 temperature and maximum thermal power dissipation.
71
72The maximum value for Tctl is available in the file temp1_max.
73
74If the BIOS has enabled hardware temperature control, the threshold at
75which the processor will throttle itself to avoid damage is available in
76temp1_crit and temp1_crit_hyst.