About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Documentation / hwmon / f71882fg


Based on kernel version 4.16.1. Page generated on 2018-04-09 11:53 EST.

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


About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog