17ebd8b66SMauro Carvalho ChehabKernel driver k10temp 27ebd8b66SMauro Carvalho Chehab===================== 37ebd8b66SMauro Carvalho Chehab 47ebd8b66SMauro Carvalho ChehabSupported chips: 57ebd8b66SMauro Carvalho Chehab 67ebd8b66SMauro Carvalho Chehab* AMD Family 10h processors: 77ebd8b66SMauro Carvalho Chehab 87ebd8b66SMauro Carvalho Chehab Socket F: Quad-Core/Six-Core/Embedded Opteron (but see below) 97ebd8b66SMauro Carvalho Chehab 107ebd8b66SMauro Carvalho Chehab Socket AM2+: Quad-Core Opteron, Phenom (II) X3/X4, Athlon X2 (but see below) 117ebd8b66SMauro Carvalho Chehab 127ebd8b66SMauro Carvalho Chehab Socket AM3: Quad-Core Opteron, Athlon/Phenom II X2/X3/X4, Sempron II 137ebd8b66SMauro Carvalho Chehab 147ebd8b66SMauro Carvalho Chehab Socket S1G3: Athlon II, Sempron, Turion II 157ebd8b66SMauro Carvalho Chehab 167ebd8b66SMauro Carvalho Chehab* AMD Family 11h processors: 177ebd8b66SMauro Carvalho Chehab 187ebd8b66SMauro Carvalho Chehab Socket S1G2: Athlon (X2), Sempron (X2), Turion X2 (Ultra) 197ebd8b66SMauro Carvalho Chehab 207ebd8b66SMauro Carvalho Chehab* AMD Family 12h processors: "Llano" (E2/A4/A6/A8-Series) 217ebd8b66SMauro Carvalho Chehab 227ebd8b66SMauro Carvalho Chehab* AMD Family 14h processors: "Brazos" (C/E/G/Z-Series) 237ebd8b66SMauro Carvalho Chehab 2443fd0cf4SLukas Zapletal* AMD Family 15h processors: "Bulldozer" (FX-Series), "Trinity", "Kaveri", 2543fd0cf4SLukas Zapletal "Carrizo", "Stoney Ridge", "Bristol Ridge" 267ebd8b66SMauro Carvalho Chehab 277ebd8b66SMauro Carvalho Chehab* AMD Family 16h processors: "Kabini", "Mullins" 287ebd8b66SMauro Carvalho Chehab 2943fd0cf4SLukas Zapletal* AMD Family 17h processors: "Zen", "Zen 2" 3043fd0cf4SLukas Zapletal 3143fd0cf4SLukas Zapletal* AMD Family 18h processors: "Hygon Dhyana" 3243fd0cf4SLukas Zapletal 3343fd0cf4SLukas Zapletal* AMD Family 19h processors: "Zen 3" 3443fd0cf4SLukas Zapletal 357ebd8b66SMauro Carvalho Chehab Prefix: 'k10temp' 367ebd8b66SMauro Carvalho Chehab 377ebd8b66SMauro Carvalho Chehab Addresses scanned: PCI space 387ebd8b66SMauro Carvalho Chehab 397ebd8b66SMauro Carvalho Chehab Datasheets: 407ebd8b66SMauro Carvalho Chehab 417ebd8b66SMauro Carvalho Chehab BIOS and Kernel Developer's Guide (BKDG) For AMD Family 10h Processors: 427ebd8b66SMauro Carvalho Chehab 437ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/31116.pdf 447ebd8b66SMauro Carvalho Chehab 457ebd8b66SMauro Carvalho Chehab BIOS and Kernel Developer's Guide (BKDG) for AMD Family 11h Processors: 467ebd8b66SMauro Carvalho Chehab 477ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/41256.pdf 487ebd8b66SMauro Carvalho Chehab 497ebd8b66SMauro Carvalho Chehab BIOS and Kernel Developer's Guide (BKDG) for AMD Family 12h Processors: 507ebd8b66SMauro Carvalho Chehab 517ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/41131.pdf 527ebd8b66SMauro Carvalho Chehab 537ebd8b66SMauro Carvalho Chehab BIOS and Kernel Developer's Guide (BKDG) for AMD Family 14h Models 00h-0Fh Processors: 547ebd8b66SMauro Carvalho Chehab 557ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/43170.pdf 567ebd8b66SMauro Carvalho Chehab 577ebd8b66SMauro Carvalho Chehab Revision Guide for AMD Family 10h Processors: 587ebd8b66SMauro Carvalho Chehab 597ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/41322.pdf 607ebd8b66SMauro Carvalho Chehab 617ebd8b66SMauro Carvalho Chehab Revision Guide for AMD Family 11h Processors: 627ebd8b66SMauro Carvalho Chehab 637ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/41788.pdf 647ebd8b66SMauro Carvalho Chehab 657ebd8b66SMauro Carvalho Chehab Revision Guide for AMD Family 12h Processors: 667ebd8b66SMauro Carvalho Chehab 677ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/44739.pdf 687ebd8b66SMauro Carvalho Chehab 697ebd8b66SMauro Carvalho Chehab Revision Guide for AMD Family 14h Models 00h-0Fh Processors: 707ebd8b66SMauro Carvalho Chehab 717ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/47534.pdf 727ebd8b66SMauro Carvalho Chehab 737ebd8b66SMauro Carvalho Chehab AMD Family 11h Processor Power and Thermal Data Sheet for Notebooks: 747ebd8b66SMauro Carvalho Chehab 757ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/43373.pdf 767ebd8b66SMauro Carvalho Chehab 777ebd8b66SMauro Carvalho Chehab AMD Family 10h Server and Workstation Processor Power and Thermal Data Sheet: 787ebd8b66SMauro Carvalho Chehab 797ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/43374.pdf 807ebd8b66SMauro Carvalho Chehab 817ebd8b66SMauro Carvalho Chehab AMD Family 10h Desktop Processor Power and Thermal Data Sheet: 827ebd8b66SMauro Carvalho Chehab 837ebd8b66SMauro Carvalho Chehab http://support.amd.com/us/Processor_TechDocs/43375.pdf 847ebd8b66SMauro Carvalho Chehab 857ebd8b66SMauro Carvalho ChehabAuthor: Clemens Ladisch <clemens@ladisch.de> 867ebd8b66SMauro Carvalho Chehab 877ebd8b66SMauro Carvalho ChehabDescription 887ebd8b66SMauro Carvalho Chehab----------- 897ebd8b66SMauro Carvalho Chehab 907ebd8b66SMauro Carvalho ChehabThis driver permits reading of the internal temperature sensor of AMD 917ebd8b66SMauro Carvalho ChehabFamily 10h/11h/12h/14h/15h/16h processors. 927ebd8b66SMauro Carvalho Chehab 937ebd8b66SMauro Carvalho ChehabAll these processors have a sensor, but on those for Socket F or AM2+, 947ebd8b66SMauro Carvalho Chehabthe sensor may return inconsistent values (erratum 319). The driver 957ebd8b66SMauro Carvalho Chehabwill refuse to load on these revisions unless you specify the "force=1" 967ebd8b66SMauro Carvalho Chehabmodule parameter. 977ebd8b66SMauro Carvalho Chehab 987ebd8b66SMauro Carvalho ChehabDue to technical reasons, the driver can detect only the mainboard's 997ebd8b66SMauro Carvalho Chehabsocket type, not the processor's actual capabilities. Therefore, if you 1007ebd8b66SMauro Carvalho Chehabare using an AM3 processor on an AM2+ mainboard, you can safely use the 1017ebd8b66SMauro Carvalho Chehab"force=1" parameter. 1027ebd8b66SMauro Carvalho Chehab 1034d52b28dSGuenter RoeckFor CPUs older than Family 17h, there is one temperature measurement value, 1044d52b28dSGuenter Roeckavailable as temp1_input in sysfs. It is measured in degrees Celsius with a 1054d52b28dSGuenter Roeckresolution of 1/8th degree. Please note that it is defined as a relative 1064d52b28dSGuenter Roeckvalue; to quote the AMD manual:: 1077ebd8b66SMauro Carvalho Chehab 1087ebd8b66SMauro Carvalho Chehab Tctl is the processor temperature control value, used by the platform to 1097ebd8b66SMauro Carvalho Chehab control cooling systems. Tctl is a non-physical temperature on an 1107ebd8b66SMauro Carvalho Chehab arbitrary scale measured in degrees. It does _not_ represent an actual 1117ebd8b66SMauro Carvalho Chehab physical temperature like die or case temperature. Instead, it specifies 1127ebd8b66SMauro Carvalho Chehab the processor temperature relative to the point at which the system must 1137ebd8b66SMauro Carvalho Chehab supply the maximum cooling for the processor's specified maximum case 1147ebd8b66SMauro Carvalho Chehab temperature and maximum thermal power dissipation. 1157ebd8b66SMauro Carvalho Chehab 1167ebd8b66SMauro Carvalho ChehabThe maximum value for Tctl is available in the file temp1_max. 1177ebd8b66SMauro Carvalho Chehab 1187ebd8b66SMauro Carvalho ChehabIf the BIOS has enabled hardware temperature control, the threshold at 1197ebd8b66SMauro Carvalho Chehabwhich the processor will throttle itself to avoid damage is available in 1207ebd8b66SMauro Carvalho Chehabtemp1_crit and temp1_crit_hyst. 12143fd0cf4SLukas Zapletal 12243fd0cf4SLukas ZapletalOn some AMD CPUs, there is a difference between the die temperature (Tdie) and 12343fd0cf4SLukas Zapletalthe reported temperature (Tctl). Tdie is the real measured temperature, and 12443fd0cf4SLukas ZapletalTctl is used for fan control. While Tctl is always available as temp1_input, 12543fd0cf4SLukas Zapletalthe driver exports Tdie temperature as temp2_input for those CPUs which support 12643fd0cf4SLukas Zapletalit. 12743fd0cf4SLukas Zapletal 12843fd0cf4SLukas ZapletalModels from 17h family report relative temperature, the driver aims to 12943fd0cf4SLukas Zapletalcompensate and report the real temperature. 1304d52b28dSGuenter Roeck 1314d52b28dSGuenter RoeckOn Family 17h and Family 18h CPUs, additional temperature sensors may report 1324d52b28dSGuenter RoeckCore Complex Die (CCD) temperatures. Up to 8 such temperatures are reported 1334d52b28dSGuenter Roeckas temp{3..10}_input, labeled Tccd{1..8}. Actual support depends on the CPU 1344d52b28dSGuenter Roeckvariant. 135