Merge branch 'next/pm' of git://git.linaro.org/people/arnd/arm-soc
[pandora-kernel.git] / Documentation / hwmon / coretemp
1 Kernel driver coretemp
2 ======================
3
4 Supported chips:
5   * All Intel Core family
6     Prefix: 'coretemp'
7     CPUID: family 0x6, models 0xe (Pentium M DC), 0xf (Core 2 DC 65nm),
8                               0x16 (Core 2 SC 65nm), 0x17 (Penryn 45nm),
9                               0x1a (Nehalem), 0x1c (Atom), 0x1e (Lynnfield)
10     Datasheet: Intel 64 and IA-32 Architectures Software Developer's Manual
11                Volume 3A: System Programming Guide
12                http://softwarecommunity.intel.com/Wiki/Mobility/720.htm
13
14 Author: Rudolf Marek
15
16 Description
17 -----------
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.
24
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
29 Temperature known as TjMax is the maximum junction temperature of processor,
30 which depends on the CPU model. See table below. At this temperature, protection
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
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.
40                    Correct CPU operation is no longer guaranteed.
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.
44
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).
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