blob: bee4c30bc1e2a82caa2421c9504e031ff1658c73 [file] [log] [blame]
Hans de Goede3b02d332009-01-07 16:37:31 +01001Kernel driver f71882fg
2======================
3
4Supported chips:
Hans de Goede09475d32009-06-15 18:39:52 +02005 * Fintek F71858FG
6 Prefix: 'f71858fg'
Hans de Goede3b02d332009-01-07 16:37:31 +01007 Addresses scanned: none, address read from Super I/O config space
8 Datasheet: Available from the Fintek website
9 * Fintek F71862FG and F71863FG
10 Prefix: 'f71862fg'
11 Addresses scanned: none, address read from Super I/O config space
12 Datasheet: Available from the Fintek website
Hans de Goede09475d32009-06-15 18:39:52 +020013 * Fintek F71882FG and F71883FG
14 Prefix: 'f71882fg'
15 Addresses scanned: none, address read from Super I/O config space
16 Datasheet: Available from the Fintek website
Hans de Goede3b02d332009-01-07 16:37:31 +010017 * Fintek F8000
18 Prefix: 'f8000'
19 Addresses scanned: none, address read from Super I/O config space
20 Datasheet: Not public
21
22Author: Hans de Goede <hdegoede@redhat.com>
23
24
25Description
26-----------
27
28Fintek F718xxFG/F8000 Super I/O chips include complete hardware monitoring
29capabilities. They can monitor up to 9 voltages (3 for the F8000), 4 fans and
303 temperature sensors.
31
32These chips also have fan controlling features, using either DC or PWM, in
33three different modes (one manual, two automatic).
34
35The driver assumes that no more than one chip is present, which seems
36reasonable.
37
38
39Monitoring
40----------
41
42The Voltage, Fan and Temperature Monitoring uses the standard sysfs
43interface as documented in sysfs-interface, without any exceptions.
44
45
46Fan Control
47-----------
48
49Both PWM (pulse-width modulation) and DC fan speed control methods are
50supported. The right one to use depends on external circuitry on the
51motherboard, so the driver assumes that the BIOS set the method
52properly.
53
54There are 2 modes to specify the speed of the fan, PWM duty cycle (or DC
55voltage) mode, where 0-100% duty cycle (0-100% of 12V) is specified. And RPM
56mode where the actual RPM of the fan (as measured) is controlled and the speed
57gets specified as 0-100% of the fan#_full_speed file.
58
59Since both modes work in a 0-100% (mapped to 0-255) scale, there isn't a
60whole lot of a difference when modifying fan control settings. The only
61important difference is that in RPM mode the 0-100% controls the fan speed
62between 0-100% of fan#_full_speed. It is assumed that if the BIOS programs
63RPM mode, it will also set fan#_full_speed properly, if it does not then
64fan control will not work properly, unless you set a sane fan#_full_speed
65value yourself.
66
67Switching between these modes requires re-initializing a whole bunch of
68registers, so the mode which the BIOS has set is kept. The mode is
69printed when loading the driver.
70
71Three different fan control modes are supported; the mode number is written
72to the pwm#_enable file. Note that not all modes are supported on all
Hans de Goede09475d32009-06-15 18:39:52 +020073chips, and some modes may only be available in RPM / PWM mode.
Hans de Goede3b02d332009-01-07 16:37:31 +010074Writing an unsupported mode will result in an invalid parameter error.
75
76* 1: Manual mode
77 You ask for a specific PWM duty cycle / DC voltage or a specific % of
78 fan#_full_speed by writing to the pwm# file. This mode is only
Hans de Goede09475d32009-06-15 18:39:52 +020079 available on the F71858FG / F8000 if the fan channel is in RPM mode.
Hans de Goede3b02d332009-01-07 16:37:31 +010080
81* 2: Normal auto mode
82 You can define a number of temperature/fan speed trip points, which % the
83 fan should run at at this temp and which temp a fan should follow using the
84 standard sysfs interface. The number and type of trip points is chip
85 depended, see which files are available in sysfs.
86 Fan/PWM channel 3 of the F8000 is always in this mode!
87
88* 3: Thermostat mode (Only available on the F8000 when in duty cycle mode)
89 The fan speed is regulated to keep the temp the fan is mapped to between
90 temp#_auto_point2_temp and temp#_auto_point3_temp.
91
92Both of the automatic modes require that pwm1 corresponds to fan1, pwm2 to
93fan2 and pwm3 to fan3.