Merge tag 'driver-core-6.2-rc1' of git://git.kernel.org/pub/scm/linux/kernel/git...
[linux-block.git] / Documentation / hwmon / pc87427.rst
CommitLineData
ba224e2c
JD
1Kernel driver pc87427
2=====================
3
4Supported chips:
b04f2f7d 5
ba224e2c 6 * National Semiconductor PC87427
b04f2f7d 7
ba224e2c 8 Prefix: 'pc87427'
b04f2f7d 9
ba224e2c 10 Addresses scanned: none, address read from Super I/O config space
b04f2f7d 11
6aa693b8 12 Datasheet: No longer available
ba224e2c 13
7c81c60f 14Author: Jean Delvare <jdelvare@suse.de>
ba224e2c
JD
15
16Thanks to Amir Habibi at Candelis for setting up a test system, and to
17Michael Kress for testing several iterations of this driver.
18
19
20Description
21-----------
22
23The National Semiconductor Super I/O chip includes complete hardware
24monitoring capabilities. It can monitor up to 18 voltages, 8 fans and
008e5f33
JD
256 temperature sensors. Only the fans and temperatures are supported at
26the moment, voltages aren't.
ba224e2c 27
328716bc
JD
28This chip also has fan controlling features (up to 4 PWM outputs),
29which are partly supported by this driver.
ba224e2c
JD
30
31The driver assumes that no more than one chip is present, which seems
32reasonable.
33
34
35Fan Monitoring
36--------------
37
38Fan rotation speeds are reported as 14-bit values from a gated clock
39signal. Speeds down to 83 RPM can be measured.
40
41An alarm is triggered if the rotation speed drops below a programmable
fd589a8f 42limit. Another alarm is triggered if the speed is too low to be measured
ba224e2c 43(including stalled or missing fan).
328716bc
JD
44
45
46Fan Speed Control
47-----------------
48
49Fan speed can be controlled by PWM outputs. There are 4 possible modes:
50always off, always on, manual and automatic. The latter isn't supported
51by the driver: you can only return to that mode if it was the original
52setting, and the configuration interface is missing.
008e5f33
JD
53
54
55Temperature Monitoring
56----------------------
57
58The PC87427 relies on external sensors (following the SensorPath
59standard), so the resolution and range depend on the type of sensor
60connected. The integer part can be 8-bit or 9-bit, and can be signed or
61not. I couldn't find a way to figure out the external sensor data
62temperature format, so user-space adjustment (typically by a factor 2)
63may be required.