[GitHub/mt8127/android_kernel_alcatel_ttab.git] / Documentation / hwmon / coretemp

Kernel driver coretemp
======================

Supported chips:
  * All Intel Core family
    Prefix: 'coretemp'
    CPUID: family 0x6, models 0xe (Pentium M DC), 0xf (Core 2 DC 65nm),
                              0x16 (Core 2 SC 65nm), 0x17 (Penryn 45nm),
                              0x1a (Nehalem), 0x1c (Atom), 0x1e (Lynnfield)
    Datasheet: Intel 64 and IA-32 Architectures Software Developer's Manual
               Volume 3A: System Programming Guide
               http://softwarecommunity.intel.com/Wiki/Mobility/720.htm

Author: Rudolf Marek

Description
-----------

This driver permits reading temperature sensor embedded inside Intel Core CPU.
Temperature is measured in degrees Celsius and measurement resolution is
1 degree C. Valid temperatures are from 0 to TjMax degrees C, because
the actual value of temperature register is in fact a delta from TjMax.

Temperature known as TjMax is the maximum junction temperature of processor.
Intel defines this temperature as 85C or 100C. At this temperature, protection
mechanism will perform actions to forcibly cool down the processor. Alarm
may be raised, if the temperature grows enough (more than TjMax) to trigger
the Out-Of-Spec bit. Following table summarizes the exported sysfs files:

temp1_input	 - Core temperature (in millidegrees Celsius).
temp1_max	 - All cooling devices should be turned on (on Core2).
temp1_crit	 - Maximum junction temperature (in millidegrees Celsius).
temp1_crit_alarm - Set when Out-of-spec bit is set, never clears.
		   Correct CPU operation is no longer guaranteed.
temp1_label	 - Contains string "Core X", where X is processor
		   number.

The TjMax temperature is set to 85 degrees C if undocumented model specific
register (UMSR) 0xee has bit 30 set. If not the TjMax is 100 degrees C as
(sometimes) documented in processor datasheet.
Commit	Line	Data
d58ee056 RM	1	Kernel driver coretemp
	2	======================
	3
	4	Supported chips:
	5	* All Intel Core family
	6	Prefix: 'coretemp'
eccfed42 RM	7	CPUID: family 0x6, models 0xe (Pentium M DC), 0xf (Core 2 DC 65nm),
eccfed42 RM	8	0x16 (Core 2 SC 65nm), 0x17 (Penryn 45nm),
fa08acd7	9	0x1a (Nehalem), 0x1c (Atom), 0x1e (Lynnfield)
d58ee056 RM	10	Datasheet: Intel 64 and IA-32 Architectures Software Developer's Manual
d58ee056 RM	11	Volume 3A: System Programming Guide
ae770152	12	http://softwarecommunity.intel.com/Wiki/Mobility/720.htm
d58ee056 RM	13
	14	Author: Rudolf Marek
	15
	16	Description
	17	-----------
	18
	19	This driver permits reading temperature sensor embedded inside Intel Core CPU.
	20	Temperature is measured in degrees Celsius and measurement resolution is
	21	1 degree C. Valid temperatures are from 0 to TjMax degrees C, because
	22	the actual value of temperature register is in fact a delta from TjMax.
	23
	24	Temperature known as TjMax is the maximum junction temperature of processor.
	25	Intel defines this temperature as 85C or 100C. At this temperature, protection
	26	mechanism will perform actions to forcibly cool down the processor. Alarm
	27	may be raised, if the temperature grows enough (more than TjMax) to trigger
	28	the Out-Of-Spec bit. Following table summarizes the exported sysfs files:
	29
	30	temp1_input - Core temperature (in millidegrees Celsius).
6369a288 RM	31	temp1_max - All cooling devices should be turned on (on Core2).
6369a288 RM	32	temp1_crit - Maximum junction temperature (in millidegrees Celsius).
d58ee056 RM	33	temp1_crit_alarm - Set when Out-of-spec bit is set, never clears.
	34	Correct CPU operation is no longer guaranteed.
	35	temp1_label - Contains string "Core X", where X is processor
	36	number.
	37
	38	The TjMax temperature is set to 85 degrees C if undocumented model specific
	39	register (UMSR) 0xee has bit 30 set. If not the TjMax is 100 degrees C as
	40	(sometimes) documented in processor datasheet.