blob: 94e0d2cbd3d2368996deef0f0e06691bc358ccb4 [file] [log] [blame]
Jean Delvare5db3d3d2006-01-09 23:32:57 +01001Kernel driver f71805f
2=====================
3
4Supported chips:
5 * Fintek F71805F/FG
6 Prefix: 'f71805f'
7 Addresses scanned: none, address read from Super I/O config space
Phil Endecottaba50732007-06-29 09:19:14 +02008 Datasheet: Available from the Fintek website
Jean Delvare51c997d2006-12-12 18:18:29 +01009 * Fintek F71872F/FG
10 Prefix: 'f71872f'
11 Addresses scanned: none, address read from Super I/O config space
Phil Endecottaba50732007-06-29 09:19:14 +020012 Datasheet: Available from the Fintek website
Jean Delvare5db3d3d2006-01-09 23:32:57 +010013
14Author: Jean Delvare <khali@linux-fr.org>
15
16Thanks to Denis Kieft from Barracuda Networks for the donation of a
17test system (custom Jetway K8M8MS motherboard, with CPU and RAM) and
18for providing initial documentation.
19
Jean Delvaree9cea642006-12-12 18:18:27 +010020Thanks to Kris Chen and Aaron Huang from Fintek for answering technical
21questions and providing additional documentation.
Jean Delvare5db3d3d2006-01-09 23:32:57 +010022
23Thanks to Chris Lin from Jetway for providing wiring schematics and
Jean Delvare15fe25c2006-10-08 21:59:54 +020024answering technical questions.
Jean Delvare5db3d3d2006-01-09 23:32:57 +010025
26
27Description
28-----------
29
30The Fintek F71805F/FG Super I/O chip includes complete hardware monitoring
31capabilities. It can monitor up to 9 voltages (counting its own power
32source), 3 fans and 3 temperature sensors.
33
34This chip also has fan controlling features, using either DC or PWM, in
Jean Delvaree9cea642006-12-12 18:18:27 +010035three different modes (one manual, two automatic).
Jean Delvare5db3d3d2006-01-09 23:32:57 +010036
Jean Delvare51c997d2006-12-12 18:18:29 +010037The Fintek F71872F/FG Super I/O chip is almost the same, with two
38additional internal voltages monitored (VSB and battery). It also features
396 VID inputs. The VID inputs are not yet supported by this driver.
40
Jean Delvare5db3d3d2006-01-09 23:32:57 +010041The driver assumes that no more than one chip is present, which seems
42reasonable.
43
44
45Voltage Monitoring
46------------------
47
48Voltages are sampled by an 8-bit ADC with a LSB of 8 mV. The supported
49range is thus from 0 to 2.040 V. Voltage values outside of this range
50need external resistors. An exception is in0, which is used to monitor
51the chip's own power source (+3.3V), and is divided internally by a
Jean Delvare51c997d2006-12-12 18:18:29 +010052factor 2. For the F71872F/FG, in9 (VSB) and in10 (battery) are also
53divided internally by a factor 2.
Jean Delvare5db3d3d2006-01-09 23:32:57 +010054
55The two LSB of the voltage limit registers are not used (always 0), so
56you can only set the limits in steps of 32 mV (before scaling).
57
58The wirings and resistor values suggested by Fintek are as follow:
59
60 pin expected
61 name use R1 R2 divider raw val.
62
63in0 VCC VCC3.3V int. int. 2.00 1.65 V
64in1 VIN1 VTT1.2V 10K - 1.00 1.20 V
65in2 VIN2 VRAM 100K 100K 2.00 ~1.25 V (1)
66in3 VIN3 VCHIPSET 47K 100K 1.47 2.24 V (2)
67in4 VIN4 VCC5V 200K 47K 5.25 0.95 V
68in5 VIN5 +12V 200K 20K 11.00 1.05 V
69in6 VIN6 VCC1.5V 10K - 1.00 1.50 V
70in7 VIN7 VCORE 10K - 1.00 ~1.40 V (1)
71in8 VIN8 VSB5V 200K 47K 1.00 0.95 V
Jean Delvare51c997d2006-12-12 18:18:29 +010072in10 VSB VSB3.3V int. int. 2.00 1.65 V (3)
73in9 VBAT VBATTERY int. int. 2.00 1.50 V (3)
Jean Delvare5db3d3d2006-01-09 23:32:57 +010074
75(1) Depends on your hardware setup.
76(2) Obviously not correct, swapping R1 and R2 would make more sense.
Jean Delvare51c997d2006-12-12 18:18:29 +010077(3) F71872F/FG only.
Jean Delvare5db3d3d2006-01-09 23:32:57 +010078
79These values can be used as hints at best, as motherboard manufacturers
80are free to use a completely different setup. As a matter of fact, the
81Jetway K8M8MS uses a significantly different setup. You will have to
82find out documentation about your own motherboard, and edit sensors.conf
83accordingly.
84
85Each voltage measured has associated low and high limits, each of which
86triggers an alarm when crossed.
87
88
89Fan Monitoring
90--------------
91
92Fan rotation speeds are reported as 12-bit values from a gated clock
93signal. Speeds down to 366 RPM can be measured. There is no theoretical
94high limit, but values over 6000 RPM seem to cause problem. The effective
95resolution is much lower than you would expect, the step between different
96register values being 10 rather than 1.
97
98The chip assumes 2 pulse-per-revolution fans.
99
100An alarm is triggered if the rotation speed drops below a programmable
101limit or is too low to be measured.
102
103
104Temperature Monitoring
105----------------------
106
107Temperatures are reported in degrees Celsius. Each temperature measured
108has a high limit, those crossing triggers an alarm. There is an associated
109hysteresis value, below which the temperature has to drop before the
110alarm is cleared.
111
112All temperature channels are external, there is no embedded temperature
113sensor. Each channel can be used for connecting either a thermal diode
114or a thermistor. The driver reports the currently selected mode, but
115doesn't allow changing it. In theory, the BIOS should have configured
116everything properly.
Jean Delvaree9cea642006-12-12 18:18:27 +0100117
118
119Fan Control
120-----------
121
122Both PWM (pulse-width modulation) and DC fan speed control methods are
123supported. The right one to use depends on external circuitry on the
124motherboard, so the driver assumes that the BIOS set the method
125properly. The driver will report the method, but won't let you change
126it.
127
128When the PWM method is used, you can select the operating frequency,
129from 187.5 kHz (default) to 31 Hz. The best frequency depends on the
130fan model. As a rule of thumb, lower frequencies seem to give better
Phil Endecottaba50732007-06-29 09:19:14 +0200131control, but may generate annoying high-pitch noise. So a frequency just
132above the audible range, such as 25 kHz, may be a good choice; if this
133doesn't give you good linear control, try reducing it. Fintek recommends
Jean Delvaree9cea642006-12-12 18:18:27 +0100134not going below 1 kHz, as the fan tachometers get confused by lower
135frequencies as well.
136
137When the DC method is used, Fintek recommends not going below 5 V, which
138corresponds to a pwm value of 106 for the driver. The driver doesn't
139enforce this limit though.
140
Phil Endecottaba50732007-06-29 09:19:14 +0200141Three different fan control modes are supported; the mode number is written
142to the pwm<n>_enable file.
Jean Delvaree9cea642006-12-12 18:18:27 +0100143
Phil Endecottaba50732007-06-29 09:19:14 +0200144* 1: Manual mode
145 You ask for a specific PWM duty cycle or DC voltage by writing to the
146 pwm<n> file.
Jean Delvaree9cea642006-12-12 18:18:27 +0100147
Phil Endecottaba50732007-06-29 09:19:14 +0200148* 2: Temperature mode
149 You define 3 temperature/fan speed trip points using the
150 pwm<n>_auto_point<m>_temp and _fan files. These define a staircase
151 relationship between temperature and fan speed with two additional points
152 interpolated between the values that you define. When the temperature
153 is below auto_point1_temp the fan is switched off.
Jean Delvaree9cea642006-12-12 18:18:27 +0100154
Phil Endecottaba50732007-06-29 09:19:14 +0200155* 3: Fan speed mode
156 You ask for a specific fan speed by writing to the fan<n>_target file.
157
158Both of the automatic modes require that pwm1 corresponds to fan1, pwm2 to
159fan2 and pwm3 to fan3. Temperature mode also requires that temp1 corresponds
160to pwm1 and fan1, etc.