blob: 8fdd08c9e48b5ceac48b100ee4cedbdf78fcc242 [file] [log] [blame]
Jean Delvareba224e22006-12-12 18:18:29 +01001Kernel driver pc87427
2=====================
3
4Supported chips:
5 * National Semiconductor PC87427
6 Prefix: 'pc87427'
7 Addresses scanned: none, address read from Super I/O config space
Jean Delvare6aa693b2008-10-17 17:51:17 +02008 Datasheet: No longer available
Jean Delvareba224e22006-12-12 18:18:29 +01009
10Author: Jean Delvare <khali@linux-fr.org>
11
12Thanks to Amir Habibi at Candelis for setting up a test system, and to
13Michael Kress for testing several iterations of this driver.
14
15
16Description
17-----------
18
19The National Semiconductor Super I/O chip includes complete hardware
20monitoring capabilities. It can monitor up to 18 voltages, 8 fans and
Jean Delvare008e5f32010-08-14 21:08:59 +0200216 temperature sensors. Only the fans and temperatures are supported at
22the moment, voltages aren't.
Jean Delvareba224e22006-12-12 18:18:29 +010023
Jean Delvare328716b2010-08-14 21:08:58 +020024This chip also has fan controlling features (up to 4 PWM outputs),
25which are partly supported by this driver.
Jean Delvareba224e22006-12-12 18:18:29 +010026
27The driver assumes that no more than one chip is present, which seems
28reasonable.
29
30
31Fan Monitoring
32--------------
33
34Fan rotation speeds are reported as 14-bit values from a gated clock
35signal. Speeds down to 83 RPM can be measured.
36
37An alarm is triggered if the rotation speed drops below a programmable
Anand Gadiyarfd589a82009-07-16 17:13:03 +020038limit. Another alarm is triggered if the speed is too low to be measured
Jean Delvareba224e22006-12-12 18:18:29 +010039(including stalled or missing fan).
Jean Delvare328716b2010-08-14 21:08:58 +020040
41
42Fan Speed Control
43-----------------
44
45Fan speed can be controlled by PWM outputs. There are 4 possible modes:
46always off, always on, manual and automatic. The latter isn't supported
47by the driver: you can only return to that mode if it was the original
48setting, and the configuration interface is missing.
Jean Delvare008e5f32010-08-14 21:08:59 +020049
50
51Temperature Monitoring
52----------------------
53
54The PC87427 relies on external sensors (following the SensorPath
55standard), so the resolution and range depend on the type of sensor
56connected. The integer part can be 8-bit or 9-bit, and can be signed or
57not. I couldn't find a way to figure out the external sensor data
58temperature format, so user-space adjustment (typically by a factor 2)
59may be required.