[deliverable/linux.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 the DTS (Digital Temperature Sensor) embedded
inside Intel CPUs. This driver can read both the per-core and per-package
temperature using the appropriate sensors. The per-package sensor is new;
as of now, it is present only in the SandyBridge platform. The driver will
show the temperature of all cores inside a package under a single device
directory inside hwmon.

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:

All Sysfs entries are named with their core_id (represented here by 'X').
tempX_input	 - Core temperature (in millidegrees Celsius).
tempX_max	 - All cooling devices should be turned on (on Core2).
tempX_crit	 - Maximum junction temperature (in millidegrees Celsius).
tempX_crit_alarm - Set when Out-of-spec bit is set, never clears.
		   Correct CPU operation is no longer guaranteed.
tempX_label	 - Contains string "Core X", where X is processor
		   number. For Package temp, this will be "Physical id Y",
		   where Y is the package 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	-----------
199e0de7 D	18	This driver permits reading the DTS (Digital Temperature Sensor) embedded
	19	inside Intel CPUs. This driver can read both the per-core and per-package
	20	temperature using the appropriate sensors. The per-package sensor is new;
	21	as of now, it is present only in the SandyBridge platform. The driver will
	22	show the temperature of all cores inside a package under a single device
	23	directory inside hwmon.
d58ee056	24
d58ee056 RM	25	Temperature is measured in degrees Celsius and measurement resolution is
	26	1 degree C. Valid temperatures are from 0 to TjMax degrees C, because
	27	the actual value of temperature register is in fact a delta from TjMax.
	28
f3cffe4d CG	29	Temperature known as TjMax is the maximum junction temperature of processor,
f3cffe4d CG	30	which depends on the CPU model. See table below. At this temperature, protection
d58ee056 RM	31	mechanism will perform actions to forcibly cool down the processor. Alarm
	32	may be raised, if the temperature grows enough (more than TjMax) to trigger
	33	the Out-Of-Spec bit. Following table summarizes the exported sysfs files:
	34
199e0de7 D	35	All Sysfs entries are named with their core_id (represented here by 'X').
	36	tempX_input - Core temperature (in millidegrees Celsius).
	37	tempX_max - All cooling devices should be turned on (on Core2).
	38	tempX_crit - Maximum junction temperature (in millidegrees Celsius).
	39	tempX_crit_alarm - Set when Out-of-spec bit is set, never clears.
d58ee056	40	Correct CPU operation is no longer guaranteed.
199e0de7 D	41	tempX_label - Contains string "Core X", where X is processor
	42	number. For Package temp, this will be "Physical id Y",
	43	where Y is the package number.
d58ee056 RM	44
	45	The TjMax temperature is set to 85 degrees C if undocumented model specific
	46	register (UMSR) 0xee has bit 30 set. If not the TjMax is 100 degrees C as
	47	(sometimes) documented in processor datasheet.
f3cffe4d CG	48
	49	Appendix A. Known TjMax lists (TBD):
	50	Some information comes from ark.intel.com
	51
	52	Process Processor TjMax(C)
	53
	54	32nm Core i3/i5/i7 Processors
	55	i7 660UM/640/620, 640LM/620, 620M, 610E 105
	56	i5 540UM/520/430, 540M/520/450/430 105
	57	i3 330E, 370M/350/330 90 rPGA, 105 BGA
	58	i3 330UM 105
	59
	60	32nm Core i7 Extreme Processors
	61	980X 100
	62
	63	32nm Celeron Processors
	64	U3400 105
	65	P4505/P4500 90
	66
	67	45nm Xeon Processors 5400 Quad-Core
	68	X5492, X5482, X5472, X5470, X5460, X5450 85
	69	E5472, E5462, E5450/40/30/20/10/05 85
	70	L5408 95
	71	L5430, L5420, L5410 70
	72
	73	45nm Xeon Processors 5200 Dual-Core
	74	X5282, X5272, X5270, X5260 90
	75	E5240 90
	76	E5205, E5220 70, 90
	77	L5240 70
	78	L5238, L5215 95
	79
	80	45nm Atom Processors
	81	D525/510/425/410 100
	82	Z560/550/540/530P/530/520PT/520/515/510PT/510P 90
	83	Z510/500 90
	84	N475/470/455/450 100
	85	N280/270 90
	86	330/230 125
	87
	88	45nm Core2 Processors
	89	Solo ULV SU3500/3300 100
	90	T9900/9800/9600/9550/9500/9400/9300/8300/8100 105
	91	T6670/6500/6400 105
	92	T6600 90
	93	SU9600/9400/9300 105
	94	SP9600/9400 105
	95	SL9600/9400/9380/9300 105
	96	P9700/9600/9500/8800/8700/8600/8400/7570 105
	97	P7550/7450 90
	98
	99	45nm Core2 Quad Processors
	100	Q9100/9000 100
	101
	102	45nm Core2 Extreme Processors
	103	X9100/9000 105
	104	QX9300 100
	105
	106	45nm Core i3/i5/i7 Processors
	107	i7 940XM/920 100
	108	i7 840QM/820/740/720 100
	109
	110	45nm Celeron Processors
	111	SU2300 100
112	900 105
113
114	65nm Core2 Duo Processors
115	Solo U2200, U2100 100
116	U7700/7600/7500 100
117	T7800/7700/7600/7500/7400/7300/7250/7200/7100 100
118	T5870/5670/5600/5550/5500/5470/5450/5300/5270 100
119	T5250 100
120	T5800/5750/5200 85
121	L7700/7500/7400/7300/7200 100
122
123	65nm Core2 Extreme Processors
124	X7900/7800 100
125
126	65nm Core Duo Processors
127	U2500/2400 100
128	T2700/2600/2450/2400/2350/2300E/2300/2250/2050 100
129	L2500/2400/2300 100
130
131	65nm Core Solo Processors
132	U1500/1400/1300 100
133	T1400/1350/1300/1250 100
134
135	65nm Xeon Processors 5000 Quad-Core
136	X5000 90-95
137	E5000 80
138	L5000 70
139	L5318 95
140
141	65nm Xeon Processors 5000 Dual-Core
142	5080, 5063, 5060, 5050, 5030 80-90
143	5160, 5150, 5148, 5140, 5130, 5120, 5110 80
144	L5138 100
145
146	65nm Celeron Processors
147	T1700/1600 100
148	560/550/540/530 100