Merge tag 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/rdma/rdma
[linux-2.6-microblaze.git] / Documentation / hwmon / dme1737
1 Kernel driver dme1737
2 =====================
3
4 Supported chips:
5   * SMSC DME1737 and compatibles (like Asus A8000)
6     Prefix: 'dme1737'
7     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
8     Datasheet: Provided by SMSC upon request and under NDA
9   * SMSC SCH3112, SCH3114, SCH3116
10     Prefix: 'sch311x'
11     Addresses scanned: none, address read from Super-I/O config space
12     Datasheet: Available on the Internet
13   * SMSC SCH5027
14     Prefix: 'sch5027'
15     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
16     Datasheet: Provided by SMSC upon request and under NDA
17   * SMSC SCH5127
18     Prefix: 'sch5127'
19     Addresses scanned: none, address read from Super-I/O config space
20     Datasheet: Provided by SMSC upon request and under NDA
21
22 Authors:
23     Juerg Haefliger <juergh@gmail.com>
24
25
26 Module Parameters
27 -----------------
28
29 * force_start: bool     Enables the monitoring of voltage, fan and temp inputs
30                         and PWM output control functions. Using this parameter
31                         shouldn't be required since the BIOS usually takes care
32                         of this.
33 * probe_all_addr: bool  Include non-standard LPC addresses 0x162e and 0x164e
34                         when probing for ISA devices. This is required for the
35                         following boards:
36                         - VIA EPIA SN18000
37
38
39 Description
40 -----------
41
42 This driver implements support for the hardware monitoring capabilities of the
43 SMSC DME1737 and Asus A8000 (which are the same), SMSC SCH5027, SCH311x,
44 and SCH5127 Super-I/O chips. These chips feature monitoring of 3 temp sensors
45 temp[1-3] (2 remote diodes and 1 internal), 8 voltages in[0-7] (7 external and
46 1 internal) and up to 6 fan speeds fan[1-6]. Additionally, the chips implement
47 up to 5 PWM outputs pwm[1-3,5-6] for controlling fan speeds both manually and
48 automatically.
49
50 For the DME1737, A8000 and SCH5027, fan[1-2] and pwm[1-2] are always present.
51 Fan[3-6] and pwm[3,5-6] are optional features and their availability depends on
52 the configuration of the chip. The driver will detect which features are
53 present during initialization and create the sysfs attributes accordingly.
54
55 For the SCH311x and SCH5127, fan[1-3] and pwm[1-3] are always present and
56 fan[4-6] and pwm[5-6] don't exist.
57
58 The hardware monitoring features of the DME1737, A8000, and SCH5027 are only
59 accessible via SMBus, while the SCH311x and SCH5127 only provide access via
60 the ISA bus. The driver will therefore register itself as an I2C client driver
61 if it detects a DME1737, A8000, or SCH5027 and as a platform driver if it
62 detects a SCH311x or SCH5127 chip.
63
64
65 Voltage Monitoring
66 ------------------
67
68 The voltage inputs are sampled with 12-bit resolution and have internal
69 scaling resistors. The values returned by the driver therefore reflect true
70 millivolts and don't need scaling. The voltage inputs are mapped as follows
71 (the last column indicates the input ranges):
72
73 DME1737, A8000:
74         in0: +5VTR      (+5V standby)           0V - 6.64V
75         in1: Vccp       (processor core)        0V - 3V
76         in2: VCC        (internal +3.3V)        0V - 4.38V
77         in3: +5V                                0V - 6.64V
78         in4: +12V                               0V - 16V
79         in5: VTR        (+3.3V standby)         0V - 4.38V
80         in6: Vbat       (+3.0V)                 0V - 4.38V
81
82 SCH311x:
83         in0: +2.5V                              0V - 3.32V
84         in1: Vccp       (processor core)        0V - 2V
85         in2: VCC        (internal +3.3V)        0V - 4.38V
86         in3: +5V                                0V - 6.64V
87         in4: +12V                               0V - 16V
88         in5: VTR        (+3.3V standby)         0V - 4.38V
89         in6: Vbat       (+3.0V)                 0V - 4.38V
90
91 SCH5027:
92         in0: +5VTR      (+5V standby)           0V - 6.64V
93         in1: Vccp       (processor core)        0V - 3V
94         in2: VCC        (internal +3.3V)        0V - 4.38V
95         in3: V2_IN                              0V - 1.5V
96         in4: V1_IN                              0V - 1.5V
97         in5: VTR        (+3.3V standby)         0V - 4.38V
98         in6: Vbat       (+3.0V)                 0V - 4.38V
99
100 SCH5127:
101         in0: +2.5                               0V - 3.32V
102         in1: Vccp       (processor core)        0V - 3V
103         in2: VCC        (internal +3.3V)        0V - 4.38V
104         in3: V2_IN                              0V - 1.5V
105         in4: V1_IN                              0V - 1.5V
106         in5: VTR        (+3.3V standby)         0V - 4.38V
107         in6: Vbat       (+3.0V)                 0V - 4.38V
108         in7: Vtrip      (+1.5V)                 0V - 1.99V
109
110 Each voltage input has associated min and max limits which trigger an alarm
111 when crossed.
112
113
114 Temperature Monitoring
115 ----------------------
116
117 Temperatures are measured with 12-bit resolution and reported in millidegree
118 Celsius. The chip also features offsets for all 3 temperature inputs which -
119 when programmed - get added to the input readings. The chip does all the
120 scaling by itself and the driver therefore reports true temperatures that don't
121 need any user-space adjustments. The temperature inputs are mapped as follows
122 (the last column indicates the input ranges):
123
124         temp1: Remote diode 1 (3904 type) temperature   -127C - +127C
125         temp2: DME1737 internal temperature             -127C - +127C
126         temp3: Remote diode 2 (3904 type) temperature   -127C - +127C
127
128 Each temperature input has associated min and max limits which trigger an alarm
129 when crossed. Additionally, each temperature input has a fault attribute that
130 returns 1 when a faulty diode or an unconnected input is detected and 0
131 otherwise.
132
133
134 Fan Monitoring
135 --------------
136
137 Fan RPMs are measured with 16-bit resolution. The chip provides inputs for 6
138 fan tachometers. All 6 inputs have an associated min limit which triggers an
139 alarm when crossed. Fan inputs 1-4 provide type attributes that need to be set
140 to the number of pulses per fan revolution that the connected tachometer
141 generates. Supported values are 1, 2, and 4. Fan inputs 5-6 only support fans
142 that generate 2 pulses per revolution. Fan inputs 5-6 also provide a max
143 attribute that needs to be set to the maximum attainable RPM (fan at 100% duty-
144 cycle) of the input. The chip adjusts the sampling rate based on this value.
145
146
147 PWM Output Control
148 ------------------
149
150 This chip features 5 PWM outputs. PWM outputs 1-3 are associated with fan
151 inputs 1-3 and PWM outputs 5-6 are associated with fan inputs 5-6. PWM outputs
152 1-3 can be configured to operate either in manual or automatic mode by setting
153 the appropriate enable attribute accordingly. PWM outputs 5-6 can only operate
154 in manual mode, their enable attributes are therefore read-only. When set to
155 manual mode, the fan speed is set by writing the duty-cycle value to the
156 appropriate PWM attribute. In automatic mode, the PWM attribute returns the
157 current duty-cycle as set by the fan controller in the chip. All PWM outputs
158 support the setting of the output frequency via the freq attribute.
159
160 In automatic mode, the chip supports the setting of the PWM ramp rate which
161 defines how fast the PWM output is adjusting to changes of the associated
162 temperature input. Associating PWM outputs to temperature inputs is done via
163 temperature zones. The chip features 3 zones whose assignments to temperature
164 inputs is static and determined during initialization. These assignments can
165 be retrieved via the zone[1-3]_auto_channels_temp attributes. Each PWM output
166 is assigned to one (or hottest of multiple) temperature zone(s) through the
167 pwm[1-3]_auto_channels_zone attributes. Each PWM output has 3 distinct output
168 duty-cycles: full, low, and min. Full is internally hard-wired to 255 (100%)
169 and low and min can be programmed via pwm[1-3]_auto_point1_pwm and
170 pwm[1-3]_auto_pwm_min, respectively. The thermal thresholds of the zones are
171 programmed via zone[1-3]_auto_point[1-3]_temp and
172 zone[1-3]_auto_point1_temp_hyst:
173
174         pwm[1-3]_auto_point2_pwm        full-speed duty-cycle (255, i.e., 100%)
175         pwm[1-3]_auto_point1_pwm        low-speed duty-cycle
176         pwm[1-3]_auto_pwm_min           min-speed duty-cycle
177
178         zone[1-3]_auto_point3_temp      full-speed temp (all outputs)
179         zone[1-3]_auto_point2_temp      full-speed temp
180         zone[1-3]_auto_point1_temp      low-speed temp
181         zone[1-3]_auto_point1_temp_hyst min-speed temp
182
183 The chip adjusts the output duty-cycle linearly in the range of auto_point1_pwm
184 to auto_point2_pwm if the temperature of the associated zone is between
185 auto_point1_temp and auto_point2_temp. If the temperature drops below the
186 auto_point1_temp_hyst value, the output duty-cycle is set to the auto_pwm_min
187 value which only supports two values: 0 or auto_point1_pwm. That means that the
188 fan either turns completely off or keeps spinning with the low-speed
189 duty-cycle. If any of the temperatures rise above the auto_point3_temp value,
190 all PWM outputs are set to 100% duty-cycle.
191
192 Following is another representation of how the chip sets the output duty-cycle
193 based on the temperature of the associated thermal zone:
194
195                         Duty-Cycle      Duty-Cycle
196         Temperature     Rising Temp     Falling Temp
197         -----------     -----------     ------------
198         full-speed      full-speed      full-speed
199
200                         < linearly adjusted duty-cycle >
201
202         low-speed       low-speed       low-speed
203                         min-speed       low-speed
204         min-speed       min-speed       min-speed
205                         min-speed       min-speed
206
207
208 Sysfs Attributes
209 ----------------
210
211 Following is a list of all sysfs attributes that the driver provides, their
212 permissions and a short description:
213
214 Name                            Perm    Description
215 ----                            ----    -----------
216 cpu0_vid                        RO      CPU core reference voltage in
217                                         millivolts.
218 vrm                             RW      Voltage regulator module version
219                                         number.
220
221 in[0-7]_input                   RO      Measured voltage in millivolts.
222 in[0-7]_min                     RW      Low limit for voltage input.
223 in[0-7]_max                     RW      High limit for voltage input.
224 in[0-7]_alarm                   RO      Voltage input alarm. Returns 1 if
225                                         voltage input is or went outside the
226                                         associated min-max range, 0 otherwise.
227
228 temp[1-3]_input                 RO      Measured temperature in millidegree
229                                         Celsius.
230 temp[1-3]_min                   RW      Low limit for temp input.
231 temp[1-3]_max                   RW      High limit for temp input.
232 temp[1-3]_offset                RW      Offset for temp input. This value will
233                                         be added by the chip to the measured
234                                         temperature.
235 temp[1-3]_alarm                 RO      Alarm for temp input. Returns 1 if temp
236                                         input is or went outside the associated
237                                         min-max range, 0 otherwise.
238 temp[1-3]_fault                 RO      Temp input fault. Returns 1 if the chip
239                                         detects a faulty thermal diode or an
240                                         unconnected temp input, 0 otherwise.
241
242 zone[1-3]_auto_channels_temp    RO      Temperature zone to temperature input
243                                         mapping. This attribute is a bitfield
244                                         and supports the following values:
245                                                 1: temp1
246                                                 2: temp2
247                                                 4: temp3
248 zone[1-3]_auto_point1_temp_hyst RW      Auto PWM temp point1 hysteresis. The
249                                         output of the corresponding PWM is set
250                                         to the pwm_auto_min value if the temp
251                                         falls below the auto_point1_temp_hyst
252                                         value.
253 zone[1-3]_auto_point[1-3]_temp  RW      Auto PWM temp points. Auto_point1 is
254                                         the low-speed temp, auto_point2 is the
255                                         full-speed temp, and auto_point3 is the
256                                         temp at which all PWM outputs are set
257                                         to full-speed (100% duty-cycle).
258
259 fan[1-6]_input                  RO      Measured fan speed in RPM.
260 fan[1-6]_min                    RW      Low limit for fan input.
261 fan[1-6]_alarm                  RO      Alarm for fan input. Returns 1 if fan
262                                         input is or went below the associated
263                                         min value, 0 otherwise.
264 fan[1-4]_type                   RW      Type of attached fan. Expressed in
265                                         number of pulses per revolution that
266                                         the fan generates. Supported values are
267                                         1, 2, and 4.
268 fan[5-6]_max                    RW      Max attainable RPM at 100% duty-cycle.
269                                         Required for chip to adjust the
270                                         sampling rate accordingly.
271
272 pmw[1-3,5-6]                    RO/RW   Duty-cycle of PWM output. Supported
273                                         values are 0-255 (0%-100%). Only
274                                         writeable if the associated PWM is in
275                                         manual mode.
276 pwm[1-3]_enable                 RW      Enable of PWM outputs 1-3. Supported
277                                         values are:
278                                                  0: turned off (output @ 100%)
279                                                  1: manual mode
280                                                  2: automatic mode
281 pwm[5-6]_enable                 RO      Enable of PWM outputs 5-6. Always
282                                         returns 1 since these 2 outputs are
283                                         hard-wired to manual mode.
284 pmw[1-3,5-6]_freq               RW      Frequency of PWM output. Supported
285                                         values are in the range 11Hz-30000Hz
286                                         (default is 25000Hz).
287 pmw[1-3]_ramp_rate              RW      Ramp rate of PWM output. Determines how
288                                         fast the PWM duty-cycle will change
289                                         when the PWM is in automatic mode.
290                                         Expressed in ms per PWM step. Supported
291                                         values are in the range 0ms-206ms
292                                         (default is 0, which means the duty-
293                                         cycle changes instantly).
294 pwm[1-3]_auto_channels_zone     RW      PWM output to temperature zone mapping.
295                                         This attribute is a bitfield and
296                                         supports the following values:
297                                                 1: zone1
298                                                 2: zone2
299                                                 4: zone3
300                                                 6: highest of zone[2-3]
301                                                 7: highest of zone[1-3]
302 pwm[1-3]_auto_pwm_min           RW      Auto PWM min pwm. Minimum PWM duty-
303                                         cycle. Supported values are 0 or
304                                         auto_point1_pwm.
305 pwm[1-3]_auto_point1_pwm        RW      Auto PWM pwm point. Auto_point1 is the
306                                         low-speed duty-cycle.
307 pwm[1-3]_auto_point2_pwm        RO      Auto PWM pwm point. Auto_point2 is the
308                                         full-speed duty-cycle which is hard-
309                                         wired to 255 (100% duty-cycle).
310
311 Chip Differences
312 ----------------
313
314 Feature                 dme1737 sch311x sch5027 sch5127
315 -------------------------------------------------------
316 temp[1-3]_offset        yes     yes
317 vid                     yes
318 zone3                   yes     yes     yes
319 zone[1-3]_hyst          yes     yes
320 pwm min/off             yes     yes
321 fan3                    opt     yes     opt     yes
322 pwm3                    opt     yes     opt     yes
323 fan4                    opt             opt
324 fan5                    opt             opt
325 pwm5                    opt             opt
326 fan6                    opt             opt
327 pwm6                    opt             opt
328 in7                                             yes