[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.

On CPU models which support it, TjMax is read from a model-specific register.
On other models, it is set to an arbitrary value based on weak heuristics.
If these heuristics don't work for you, you can pass the correct TjMax value
as a module parameter (tjmax).

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