[net-next-2.6.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,
which depends on the CPU model. See table below. 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.

Appendix A. Known TjMax lists (TBD):
Some information comes from ark.intel.com

Process		Processor					TjMax(C)

32nm		Core i3/i5/i7 Processors
		i7 660UM/640/620, 640LM/620, 620M, 610E		105
		i5 540UM/520/430, 540M/520/450/430		105
		i3 330E, 370M/350/330				90 rPGA, 105 BGA
		i3 330UM					105

32nm		Core i7 Extreme Processors
		980X						100

32nm		Celeron Processors
		U3400						105
		P4505/P4500 					90

45nm		Xeon Processors 5400 Quad-Core
		X5492, X5482, X5472, X5470, X5460, X5450	85
		E5472, E5462, E5450/40/30/20/10/05		85
		L5408						95
		L5430, L5420, L5410				70

45nm		Xeon Processors 5200 Dual-Core
		X5282, X5272, X5270, X5260			90
		E5240						90
		E5205, E5220					70, 90
		L5240						70
		L5238, L5215					95

45nm		Atom Processors
		D525/510/425/410				100
		Z560/550/540/530P/530/520PT/520/515/510PT/510P	90
		Z510/500					90
		N475/470/455/450				100
		N280/270					90
		330/230						125

45nm		Core2 Processors
		Solo ULV SU3500/3300				100
		T9900/9800/9600/9550/9500/9400/9300/8300/8100	105
		T6670/6500/6400					105
		T6600						90
		SU9600/9400/9300				105
		SP9600/9400					105
		SL9600/9400/9380/9300				105
		P9700/9600/9500/8800/8700/8600/8400/7570	105
		P7550/7450					90

45nm		Core2 Quad Processors
		Q9100/9000					100

45nm		Core2 Extreme Processors
		X9100/9000					105
		QX9300						100

45nm		Core i3/i5/i7 Processors
		i7 940XM/920					100
		i7 840QM/820/740/720				100

45nm		Celeron Processors
		SU2300						100
		900 						105

65nm		Core2 Duo Processors
		Solo U2200, U2100				100
		U7700/7600/7500					100
		T7800/7700/7600/7500/7400/7300/7250/7200/7100	100
		T5870/5670/5600/5550/5500/5470/5450/5300/5270	100
		T5250						100
		T5800/5750/5200					85
		L7700/7500/7400/7300/7200			100

65nm		Core2 Extreme Processors
		X7900/7800					100

65nm		Core Duo Processors
		U2500/2400					100
		T2700/2600/2450/2400/2350/2300E/2300/2250/2050	100
		L2500/2400/2300					100

65nm		Core Solo Processors
		U1500/1400/1300					100
		T1400/1350/1300/1250				100

65nm		Xeon Processors 5000 Quad-Core
		X5000						90-95
		E5000						80
		L5000						70
		L5318						95

65nm		Xeon Processors 5000 Dual-Core
		5080, 5063, 5060, 5050, 5030			80-90
		5160, 5150, 5148, 5140, 5130, 5120, 5110	80
		L5138						100

65nm		Celeron Processors
		T1700/1600					100
		560/550/540/530					100
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
f3cffe4d CG	24	Temperature known as TjMax is the maximum junction temperature of processor,
f3cffe4d CG	25	which depends on the CPU model. See table below. At this temperature, protection
d58ee056 RM	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.
f3cffe4d CG	41
	42	Appendix A. Known TjMax lists (TBD):
	43	Some information comes from ark.intel.com
	44
	45	Process Processor TjMax(C)
	46
	47	32nm Core i3/i5/i7 Processors
	48	i7 660UM/640/620, 640LM/620, 620M, 610E 105
	49	i5 540UM/520/430, 540M/520/450/430 105
	50	i3 330E, 370M/350/330 90 rPGA, 105 BGA
	51	i3 330UM 105
	52
	53	32nm Core i7 Extreme Processors
	54	980X 100
	55
	56	32nm Celeron Processors
	57	U3400 105
	58	P4505/P4500 90
	59
	60	45nm Xeon Processors 5400 Quad-Core
	61	X5492, X5482, X5472, X5470, X5460, X5450 85
	62	E5472, E5462, E5450/40/30/20/10/05 85
	63	L5408 95
	64	L5430, L5420, L5410 70
	65
	66	45nm Xeon Processors 5200 Dual-Core
	67	X5282, X5272, X5270, X5260 90
	68	E5240 90
	69	E5205, E5220 70, 90
	70	L5240 70
	71	L5238, L5215 95
	72
	73	45nm Atom Processors
	74	D525/510/425/410 100
	75	Z560/550/540/530P/530/520PT/520/515/510PT/510P 90
	76	Z510/500 90
	77	N475/470/455/450 100
	78	N280/270 90
	79	330/230 125
	80
	81	45nm Core2 Processors
	82	Solo ULV SU3500/3300 100
	83	T9900/9800/9600/9550/9500/9400/9300/8300/8100 105
	84	T6670/6500/6400 105
	85	T6600 90
	86	SU9600/9400/9300 105
	87	SP9600/9400 105
	88	SL9600/9400/9380/9300 105
	89	P9700/9600/9500/8800/8700/8600/8400/7570 105
	90	P7550/7450 90
	91
	92	45nm Core2 Quad Processors
	93	Q9100/9000 100
	94
	95	45nm Core2 Extreme Processors
	96	X9100/9000 105
	97	QX9300 100
	98
	99	45nm Core i3/i5/i7 Processors
	100	i7 940XM/920 100
	101	i7 840QM/820/740/720 100
	102
	103	45nm Celeron Processors
	104	SU2300 100
105	900 105
106
107	65nm Core2 Duo Processors
108	Solo U2200, U2100 100
109	U7700/7600/7500 100
110	T7800/7700/7600/7500/7400/7300/7250/7200/7100 100
111	T5870/5670/5600/5550/5500/5470/5450/5300/5270 100
112	T5250 100
113	T5800/5750/5200 85
114	L7700/7500/7400/7300/7200 100
115
116	65nm Core2 Extreme Processors
117	X7900/7800 100
118
119	65nm Core Duo Processors
120	U2500/2400 100
121	T2700/2600/2450/2400/2350/2300E/2300/2250/2050 100
122	L2500/2400/2300 100
123
124	65nm Core Solo Processors
125	U1500/1400/1300 100
126	T1400/1350/1300/1250 100
127
128	65nm Xeon Processors 5000 Quad-Core
129	X5000 90-95
130	E5000 80
131	L5000 70
132	L5318 95
133
134	65nm Xeon Processors 5000 Dual-Core
135	5080, 5063, 5060, 5050, 5030 80-90
136	5160, 5150, 5148, 5140, 5130, 5120, 5110 80
137	L5138 100
138
139	65nm Celeron Processors
140	T1700/1600 100
141	560/550/540/530 100