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