Commit | Line | Data |
---|---|---|
3b02d332 HG |
1 | Kernel driver f71882fg |
2 | ====================== | |
3 | ||
4 | Supported chips: | |
b04f2f7d | 5 | |
5d7f77bf | 6 | * Fintek F71808E |
b04f2f7d | 7 | |
5d7f77bf | 8 | Prefix: 'f71808e' |
b04f2f7d | 9 | |
5d7f77bf | 10 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 11 | |
629c58ba | 12 | Datasheet: Not public |
b04f2f7d | 13 | |
629c58ba | 14 | * Fintek F71808A |
b04f2f7d | 15 | |
629c58ba | 16 | Prefix: 'f71808a' |
b04f2f7d | 17 | |
629c58ba | 18 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 19 | |
5d7f77bf | 20 | Datasheet: Not public |
b04f2f7d | 21 | |
09475d32 | 22 | * Fintek F71858FG |
b04f2f7d | 23 | |
09475d32 | 24 | Prefix: 'f71858fg' |
b04f2f7d | 25 | |
3b02d332 | 26 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 27 | |
3b02d332 | 28 | Datasheet: Available from the Fintek website |
b04f2f7d | 29 | |
3b02d332 | 30 | * Fintek F71862FG and F71863FG |
b04f2f7d | 31 | |
3b02d332 | 32 | Prefix: 'f71862fg' |
b04f2f7d | 33 | |
3b02d332 | 34 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 35 | |
3b02d332 | 36 | Datasheet: Available from the Fintek website |
b04f2f7d | 37 | |
c11bb993 | 38 | * Fintek F71869F and F71869E |
b04f2f7d | 39 | |
c11bb993 | 40 | Prefix: 'f71869' |
b04f2f7d | 41 | |
c11bb993 | 42 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 43 | |
c11bb993 | 44 | Datasheet: Available from the Fintek website |
b04f2f7d | 45 | |
5da556e3 | 46 | * Fintek F71869A |
b04f2f7d | 47 | |
5da556e3 | 48 | Prefix: 'f71869a' |
b04f2f7d | 49 | |
5da556e3 | 50 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 51 | |
5da556e3 | 52 | Datasheet: Not public |
b04f2f7d | 53 | |
09475d32 | 54 | * Fintek F71882FG and F71883FG |
b04f2f7d | 55 | |
09475d32 | 56 | Prefix: 'f71882fg' |
b04f2f7d | 57 | |
09475d32 | 58 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 59 | |
09475d32 | 60 | Datasheet: Available from the Fintek website |
b04f2f7d | 61 | |
7669896f | 62 | * Fintek F71889FG |
b04f2f7d | 63 | |
7669896f | 64 | Prefix: 'f71889fg' |
b04f2f7d | 65 | |
7669896f | 66 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 67 | |
3cad4022 | 68 | Datasheet: Available from the Fintek website |
b04f2f7d | 69 | |
3cad4022 | 70 | * Fintek F71889ED |
b04f2f7d | 71 | |
3cad4022 | 72 | Prefix: 'f71889ed' |
b04f2f7d | 73 | |
3cad4022 | 74 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 75 | |
7669896f | 76 | Datasheet: Should become available on the Fintek website soon |
b04f2f7d | 77 | |
a66c1088 | 78 | * Fintek F71889A |
b04f2f7d | 79 | |
a66c1088 | 80 | Prefix: 'f71889a' |
b04f2f7d | 81 | |
a66c1088 | 82 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 83 | |
a66c1088 | 84 | Datasheet: Should become available on the Fintek website soon |
b04f2f7d | 85 | |
3b02d332 | 86 | * Fintek F8000 |
b04f2f7d | 87 | |
3b02d332 | 88 | Prefix: 'f8000' |
b04f2f7d | 89 | |
3b02d332 | 90 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 91 | |
3b02d332 | 92 | Datasheet: Not public |
b04f2f7d | 93 | |
5d7f77bf | 94 | * Fintek F81801U |
b04f2f7d | 95 | |
5d7f77bf | 96 | Prefix: 'f71889fg' |
b04f2f7d | 97 | |
5d7f77bf | 98 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 99 | |
5d7f77bf | 100 | Datasheet: Not public |
b04f2f7d MCC |
101 | |
102 | Note: | |
103 | This is the 64-pin variant of the F71889FG, they have the | |
5d7f77bf JD |
104 | same device ID and are fully compatible as far as hardware |
105 | monitoring is concerned. | |
b04f2f7d | 106 | |
383586b1 | 107 | * Fintek F81865F |
b04f2f7d | 108 | |
383586b1 | 109 | Prefix: 'f81865f' |
b04f2f7d | 110 | |
383586b1 | 111 | Addresses scanned: none, address read from Super I/O config space |
b04f2f7d | 112 | |
383586b1 | 113 | Datasheet: Available from the Fintek website |
3b02d332 HG |
114 | |
115 | Author: Hans de Goede <hdegoede@redhat.com> | |
116 | ||
117 | ||
118 | Description | |
119 | ----------- | |
120 | ||
3cad4022 HG |
121 | Fintek F718xx/F8000 Super I/O chips include complete hardware monitoring |
122 | capabilities. They can monitor up to 9 voltages, 4 fans and 3 temperature | |
123 | sensors. | |
3b02d332 HG |
124 | |
125 | These chips also have fan controlling features, using either DC or PWM, in | |
126 | three different modes (one manual, two automatic). | |
127 | ||
128 | The driver assumes that no more than one chip is present, which seems | |
129 | reasonable. | |
130 | ||
131 | ||
132 | Monitoring | |
133 | ---------- | |
134 | ||
135 | The Voltage, Fan and Temperature Monitoring uses the standard sysfs | |
136 | interface as documented in sysfs-interface, without any exceptions. | |
137 | ||
138 | ||
139 | Fan Control | |
140 | ----------- | |
141 | ||
142 | Both PWM (pulse-width modulation) and DC fan speed control methods are | |
143 | supported. The right one to use depends on external circuitry on the | |
144 | motherboard, so the driver assumes that the BIOS set the method | |
145 | properly. | |
146 | ||
7669896f | 147 | Note that the lowest numbered temperature zone trip point corresponds to |
3cdeccb5 | 148 | the border between the highest and one but highest temperature zones, and |
7669896f HG |
149 | vica versa. So the temperature zone trip points 1-4 (or 1-2) go from high temp |
150 | to low temp! This is how things are implemented in the IC, and the driver | |
787d07ed | 151 | mimics this. |
7669896f | 152 | |
3b02d332 HG |
153 | There are 2 modes to specify the speed of the fan, PWM duty cycle (or DC |
154 | voltage) mode, where 0-100% duty cycle (0-100% of 12V) is specified. And RPM | |
155 | mode where the actual RPM of the fan (as measured) is controlled and the speed | |
156 | gets specified as 0-100% of the fan#_full_speed file. | |
157 | ||
158 | Since both modes work in a 0-100% (mapped to 0-255) scale, there isn't a | |
159 | whole lot of a difference when modifying fan control settings. The only | |
160 | important difference is that in RPM mode the 0-100% controls the fan speed | |
161 | between 0-100% of fan#_full_speed. It is assumed that if the BIOS programs | |
162 | RPM mode, it will also set fan#_full_speed properly, if it does not then | |
163 | fan control will not work properly, unless you set a sane fan#_full_speed | |
164 | value yourself. | |
165 | ||
166 | Switching between these modes requires re-initializing a whole bunch of | |
167 | registers, so the mode which the BIOS has set is kept. The mode is | |
168 | printed when loading the driver. | |
169 | ||
170 | Three different fan control modes are supported; the mode number is written | |
171 | to the pwm#_enable file. Note that not all modes are supported on all | |
09475d32 | 172 | chips, and some modes may only be available in RPM / PWM mode. |
3b02d332 HG |
173 | Writing an unsupported mode will result in an invalid parameter error. |
174 | ||
175 | * 1: Manual mode | |
176 | You ask for a specific PWM duty cycle / DC voltage or a specific % of | |
177 | fan#_full_speed by writing to the pwm# file. This mode is only | |
09475d32 | 178 | available on the F71858FG / F8000 if the fan channel is in RPM mode. |
3b02d332 HG |
179 | |
180 | * 2: Normal auto mode | |
181 | You can define a number of temperature/fan speed trip points, which % the | |
182 | fan should run at at this temp and which temp a fan should follow using the | |
183 | standard sysfs interface. The number and type of trip points is chip | |
184 | depended, see which files are available in sysfs. | |
185 | Fan/PWM channel 3 of the F8000 is always in this mode! | |
186 | ||
187 | * 3: Thermostat mode (Only available on the F8000 when in duty cycle mode) | |
188 | The fan speed is regulated to keep the temp the fan is mapped to between | |
189 | temp#_auto_point2_temp and temp#_auto_point3_temp. | |
190 | ||
3cad4022 | 191 | All of the automatic modes require that pwm1 corresponds to fan1, pwm2 to |
3b02d332 | 192 | fan2 and pwm3 to fan3. |