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