]>
Commit | Line | Data |
---|---|---|
1ff4e306 RM |
1 | Kernel driver w83792d |
2 | ===================== | |
3 | ||
4 | Supported chips: | |
5 | * Winbond W83792D | |
6 | Prefix: 'w83792d' | |
7 | Addresses scanned: I2C 0x2c - 0x2f | |
0ea6e611 | 8 | Datasheet: http://www.winbond.com.tw |
1ff4e306 | 9 | |
f85b5205 | 10 | Author: Shane Huang (Winbond) |
f617f731 | 11 | Updated: Roger Lucas |
1ff4e306 RM |
12 | |
13 | ||
14 | Module Parameters | |
15 | ----------------- | |
16 | ||
17 | * init int | |
18 | (default 1) | |
19 | Use 'init=0' to bypass initializing the chip. | |
20 | Try this if your computer crashes when you load the module. | |
21 | ||
22 | * force_subclients=bus,caddr,saddr,saddr | |
23 | This is used to force the i2c addresses for subclients of | |
24 | a certain chip. Example usage is `force_subclients=0,0x2f,0x4a,0x4b' | |
25 | to force the subclients of chip 0x2f on bus 0 to i2c addresses | |
26 | 0x4a and 0x4b. | |
27 | ||
28 | ||
29 | Description | |
30 | ----------- | |
31 | ||
32 | This driver implements support for the Winbond W83792AD/D. | |
33 | ||
34 | Detection of the chip can sometimes be foiled because it can be in an | |
35 | internal state that allows no clean access (Bank with ID register is not | |
36 | currently selected). If you know the address of the chip, use a 'force' | |
37 | parameter; this will put it into a more well-behaved state first. | |
38 | ||
39 | The driver implements three temperature sensors, seven fan rotation speed | |
40 | sensors, nine voltage sensors, and two automatic fan regulation | |
41 | strategies called: Smart Fan I (Thermal Cruise mode) and Smart Fan II. | |
f617f731 RL |
42 | |
43 | The driver also implements up to seven fan control outputs: pwm1-7. Pwm1-7 | |
44 | can be configured to PWM output or Analogue DC output via their associated | |
45 | pwmX_mode. Outputs pwm4 through pwm7 may or may not be present depending on | |
46 | how the W83792AD/D was configured by the BIOS. | |
47 | ||
48 | Automatic fan control mode is possible only for fan1-fan3. | |
49 | ||
50 | For all pwmX outputs, a value of 0 means minimum fan speed and a value of | |
51 | 255 means maximum fan speed. | |
1ff4e306 RM |
52 | |
53 | Temperatures are measured in degrees Celsius and measurement resolution is 1 | |
54 | degC for temp1 and 0.5 degC for temp2 and temp3. An alarm is triggered when | |
55 | the temperature gets higher than the Overtemperature Shutdown value; it stays | |
56 | on until the temperature falls below the Hysteresis value. | |
57 | ||
58 | Fan rotation speeds are reported in RPM (rotations per minute). An alarm is | |
59 | triggered if the rotation speed has dropped below a programmable limit. Fan | |
60 | readings can be divided by a programmable divider (1, 2, 4, 8, 16, 32, 64 or | |
61 | 128) to give the readings more range or accuracy. | |
62 | ||
63 | Voltage sensors (also known as IN sensors) report their values in millivolts. | |
64 | An alarm is triggered if the voltage has crossed a programmable minimum | |
65 | or maximum limit. | |
66 | ||
67 | Alarms are provided as output from "realtime status register". Following bits | |
68 | are defined: | |
69 | ||
70 | bit - alarm on: | |
71 | 0 - in0 | |
72 | 1 - in1 | |
73 | 2 - temp1 | |
74 | 3 - temp2 | |
75 | 4 - temp3 | |
76 | 5 - fan1 | |
77 | 6 - fan2 | |
78 | 7 - fan3 | |
79 | 8 - in2 | |
80 | 9 - in3 | |
81 | 10 - in4 | |
82 | 11 - in5 | |
83 | 12 - in6 | |
84 | 13 - VID change | |
85 | 14 - chassis | |
86 | 15 - fan7 | |
87 | 16 - tart1 | |
88 | 17 - tart2 | |
89 | 18 - tart3 | |
90 | 19 - in7 | |
91 | 20 - in8 | |
92 | 21 - fan4 | |
93 | 22 - fan5 | |
94 | 23 - fan6 | |
95 | ||
96 | Tart will be asserted while target temperature cannot be achieved after 3 minutes | |
97 | of full speed rotation of corresponding fan. | |
98 | ||
99 | In addition to the alarms described above, there is a CHAS alarm on the chips | |
100 | which triggers if your computer case is open (This one is latched, contrary | |
101 | to realtime alarms). | |
102 | ||
103 | The chips only update values each 3 seconds; reading them more often will | |
104 | do no harm, but will return 'old' values. | |
105 | ||
106 | ||
107 | W83792D PROBLEMS | |
108 | ---------------- | |
109 | Known problems: | |
110 | - This driver is only for Winbond W83792D C version device, there | |
111 | are also some motherboards with B version W83792D device. The | |
112 | calculation method to in6-in7(measured value, limits) is a little | |
113 | different between C and B version. C or B version can be identified | |
114 | by CR[0x49h]. | |
115 | - The function of vid and vrm has not been finished, because I'm NOT | |
116 | very familiar with them. Adding support is welcome. | |
be2a608b | 117 | - The function of chassis open detection needs more tests. |
1ff4e306 RM |
118 | - If you have ASUS server board and chip was not found: Then you will |
119 | need to upgrade to latest (or beta) BIOS. If it does not help please | |
120 | contact us. | |
121 | ||
122 | Fan control | |
123 | ----------- | |
124 | ||
125 | Manual mode | |
126 | ----------- | |
127 | ||
128 | Works as expected. You just need to specify desired PWM/DC value (fan speed) | |
129 | in appropriate pwm# file. | |
130 | ||
131 | Thermal cruise | |
132 | -------------- | |
133 | ||
134 | In this mode, W83792D provides the Smart Fan system to automatically control | |
135 | fan speed to keep the temperatures of CPU and the system within specific | |
136 | range. At first a wanted temperature and interval must be set. This is done | |
137 | via thermal_cruise# file. The tolerance# file serves to create T +- tolerance | |
138 | interval. The fan speed will be lowered as long as the current temperature | |
139 | remains below the thermal_cruise# +- tolerance# value. Once the temperature | |
140 | exceeds the high limit (T+tolerance), the fan will be turned on with a | |
141 | specific speed set by pwm# and automatically controlled its PWM duty cycle | |
142 | with the temperature varying. Three conditions may occur: | |
143 | ||
144 | (1) If the temperature still exceeds the high limit, PWM duty | |
145 | cycle will increase slowly. | |
146 | ||
147 | (2) If the temperature goes below the high limit, but still above the low | |
148 | limit (T-tolerance), the fan speed will be fixed at the current speed because | |
149 | the temperature is in the target range. | |
150 | ||
151 | (3) If the temperature goes below the low limit, PWM duty cycle will decrease | |
152 | slowly to 0 or a preset stop value until the temperature exceeds the low | |
153 | limit. (The preset stop value handling is not yet implemented in driver) | |
154 | ||
155 | Smart Fan II | |
156 | ------------ | |
157 | ||
158 | W83792D also provides a special mode for fan. Four temperature points are | |
159 | available. When related temperature sensors detects the temperature in preset | |
160 | temperature region (sf2_point@_fan# +- tolerance#) it will cause fans to run | |
161 | on programmed value from sf2_level@_fan#. You need to set four temperatures | |
162 | for each fan. | |
163 | ||
164 | ||
165 | /sys files | |
166 | ---------- | |
167 | ||
f617f731 | 168 | pwm[1-7] - this file stores PWM duty cycle or DC value (fan speed) in range: |
1ff4e306 RM |
169 | 0 (stop) to 255 (full) |
170 | pwm[1-3]_enable - this file controls mode of fan/temperature control: | |
171 | * 0 Disabled | |
172 | * 1 Manual mode | |
173 | * 2 Smart Fan II | |
174 | * 3 Thermal Cruise | |
f617f731 | 175 | pwm[1-7]_mode - Select PWM or DC mode |
1ff4e306 RM |
176 | * 0 DC |
177 | * 1 PWM | |
178 | thermal_cruise[1-3] - Selects the desired temperature for cruise (degC) | |
179 | tolerance[1-3] - Value in degrees of Celsius (degC) for +- T | |
180 | sf2_point[1-4]_fan[1-3] - four temperature points for each fan for Smart Fan II | |
181 | sf2_level[1-3]_fan[1-3] - three PWM/DC levels for each fan for Smart Fan II |