Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/shaggy...
[linux-2.6] / Documentation / hwmon / smsc47m1
1 Kernel driver smsc47m1
2 ======================
3
4 Supported chips:
5   * SMSC LPC47B27x, LPC47M112, LPC47M10x, LPC47M13x, LPC47M14x,
6     LPC47M15x and LPC47M192
7     Addresses scanned: none, address read from Super I/O config space
8     Prefix: 'smsc47m1'
9     Datasheets:
10         http://www.smsc.com/main/datasheets/47b27x.pdf
11         http://www.smsc.com/main/datasheets/47m10x.pdf
12         http://www.smsc.com/main/datasheets/47m112.pdf
13         http://www.smsc.com/main/tools/discontinued/47m13x.pdf
14         http://www.smsc.com/main/datasheets/47m14x.pdf
15         http://www.smsc.com/main/tools/discontinued/47m15x.pdf
16         http://www.smsc.com/main/datasheets/47m192.pdf
17   * SMSC LPC47M997
18     Addresses scanned: none, address read from Super I/O config space
19     Prefix: 'smsc47m1'
20     Datasheet: none
21
22 Authors:
23         Mark D. Studebaker <mdsxyz123@yahoo.com>,
24         With assistance from Bruce Allen <ballen@uwm.edu>, and his
25         fan.c program: http://www.lsc-group.phys.uwm.edu/%7Eballen/driver/
26         Gabriele Gorla <gorlik@yahoo.com>,
27         Jean Delvare <khali@linux-fr.org>
28
29 Description
30 -----------
31
32 The Standard Microsystems Corporation (SMSC) 47M1xx Super I/O chips
33 contain monitoring and PWM control circuitry for two fans.
34
35 The 47M15x and 47M192 chips contain a full 'hardware monitoring block'
36 in addition to the fan monitoring and control. The hardware monitoring
37 block is not supported by the driver.
38
39 No documentation is available for the 47M997, but it has the same device
40 ID as the 47M15x and 47M192 chips and seems to be compatible.
41
42 Fan rotation speeds are reported in RPM (rotations per minute). An alarm is
43 triggered if the rotation speed has dropped below a programmable limit. Fan
44 readings can be divided by a programmable divider (1, 2, 4 or 8) to give
45 the readings more range or accuracy. Not all RPM values can accurately be
46 represented, so some rounding is done. With a divider of 2, the lowest
47 representable value is around 2600 RPM.
48
49 PWM values are from 0 to 255.
50
51 If an alarm triggers, it will remain triggered until the hardware register
52 is read at least once. This means that the cause for the alarm may
53 already have disappeared! Note that in the current implementation, all
54 hardware registers are read whenever any data is read (unless it is less
55 than 1.5 seconds since the last update). This means that you can easily
56 miss once-only alarms.
57
58
59 **********************
60 The lm_sensors project gratefully acknowledges the support of
61 Intel in the development of this driver.