| 1 | Kernel driver `w83792d.o' |
|---|
| 2 | ========================= |
|---|
| 3 | |
|---|
| 4 | Status: W83792D support is complete and well-tested. |
|---|
| 5 | |
|---|
| 6 | |
|---|
| 7 | Supported chips: |
|---|
| 8 | * Winbond W83792D |
|---|
| 9 | Prefix: 'w83792d' |
|---|
| 10 | Addresses scanned: I2C 0x2c - 0x2f |
|---|
| 11 | Datasheet: Available to LM_Sensors group, sent by Chunhao Huang |
|---|
| 12 | |
|---|
| 13 | |
|---|
| 14 | Author: Chunhao Huang @ Winbond <huang0@winbond.com.tw> |
|---|
| 15 | |
|---|
| 16 | |
|---|
| 17 | Module Parameters |
|---|
| 18 | ----------------- |
|---|
| 19 | |
|---|
| 20 | <TODO: fill in here> |
|---|
| 21 | |
|---|
| 22 | |
|---|
| 23 | Description |
|---|
| 24 | ----------- |
|---|
| 25 | |
|---|
| 26 | This driver implements support for the Winbond W83792AD/D. |
|---|
| 27 | |
|---|
| 28 | Detection of the chip can sometimes be foiled because it can be in |
|---|
| 29 | an internal state that allows no clean access. If you know the address |
|---|
| 30 | of the chip, use a 'force' parameter; this will put it into a more |
|---|
| 31 | well-behaved state first. |
|---|
| 32 | |
|---|
| 33 | The driver implements three temperature sensors, seven fan rotation speed |
|---|
| 34 | sensors, nine voltage sensors, and the Smart Fan I(Thermal Cruise mode) |
|---|
| 35 | and Smart Fan II sensors. |
|---|
| 36 | |
|---|
| 37 | Temperatures are measured in degrees Celsius. There is one main temperature |
|---|
| 38 | sensor, and two other sensors. A alarm is triggered when the measured |
|---|
| 39 | temperture is higher than the Overtemperature or below the Hysteresis value. |
|---|
| 40 | This is NOT correct, I misunderstand the Hysteresis value when I implement |
|---|
| 41 | this driver. It will be fixed later: An alarm is triggered when the |
|---|
| 42 | Overtemperature Shutdown limit is crossed; it is triggered again as soon as |
|---|
| 43 | it drops below the Hysteresis value. |
|---|
| 44 | |
|---|
| 45 | Fan rotation speeds are reported in RPM (rotations per minute). An alarm is |
|---|
| 46 | triggered if the rotation speed has dropped below a programmable limit. Fan |
|---|
| 47 | readings can be divided by a programmable divider(1, 2, 4, 8, 16, 32, 64 or |
|---|
| 48 | 128) to give the readings more range or accuracy. This driver modify the |
|---|
| 49 | fan divisor automatically to get the reasonable RPM rotation range. |
|---|
| 50 | |
|---|
| 51 | Voltage sensors (also known as IN sensors) report their values in volts. |
|---|
| 52 | An alarm is triggered if the voltage has crossed a programmable minimum |
|---|
| 53 | or maximum limit. |
|---|
| 54 | |
|---|
| 55 | All the alarm triggers is "software-level" instead of "hardware-level", |
|---|
| 56 | which means the alarm is triggered when "sensors" program find the measured |
|---|
| 57 | value exceed the limits, while in traditional chip drivers of lm_sensors, |
|---|
| 58 | alarm is triggered by the hardware interrupt status registers. |
|---|
| 59 | After a discusion with lm_sensors group, the "software-level" alarm method |
|---|
| 60 | to temperature may be modified in the future, but the alarm of voltage and |
|---|
| 61 | fan will not be modified, because W83792AD/D does NOT support it. |
|---|
| 62 | |
|---|
| 63 | |
|---|
| 64 | In addition to the alarms described above, there is a CHAS alarm on the |
|---|
| 65 | chips which triggers if your computer case is open. |
|---|
| 66 | |
|---|
| 67 | The chips only update values each 3 seconds; reading them more often will |
|---|
| 68 | do no harm, but will return 'old' values. |
|---|
| 69 | |
|---|
| 70 | |
|---|
| 71 | W83792D PROBLEMS |
|---|
| 72 | ----------------- |
|---|
| 73 | Known problems: |
|---|
| 74 | - This driver is only for Winbond W83792D C version device, there |
|---|
| 75 | are also some motherboards with B version W83792D device. The |
|---|
| 76 | calculation method to in6-in7(measured value, limits) is a little |
|---|
| 77 | different between C and B version. C or B version can be identified |
|---|
| 78 | by CR[0x49h]. |
|---|
| 79 | - The function of vid and vrm has not been finished, because I'm NOT |
|---|
| 80 | very familiar with them. If someone can finish it, that's good, |
|---|
| 81 | - The function of chassis open detection need further test. |
|---|
| 82 | |
|---|
| 83 | |
|---|
| 84 | Chip Features |
|---|
| 85 | ------------- |
|---|
| 86 | |
|---|
| 87 | Chip `w83792d' |
|---|
| 88 | LABEL LABEL CLASS COMPUTE CLASS ACCESS MAGNITUDE |
|---|
| 89 | in0 NONE NONE R 3 |
|---|
| 90 | in1 NONE NONE R 3 |
|---|
| 91 | in2 NONE NONE R 3 |
|---|
| 92 | in3 NONE NONE R 3 |
|---|
| 93 | in4 NONE NONE R 3 |
|---|
| 94 | in5 NONE NONE R 3 |
|---|
| 95 | in6 NONE NONE R 3 |
|---|
| 96 | in7 NONE NONE R 3 |
|---|
| 97 | in8 NONE NONE R 3 |
|---|
| 98 | in0_min in0 in0 RW 3 |
|---|
| 99 | in1_min in1 in1 RW 3 |
|---|
| 100 | in2_min in2 in2 RW 3 |
|---|
| 101 | in3_min in3 in3 RW 3 |
|---|
| 102 | in4_min in4 in4 RW 3 |
|---|
| 103 | in5_min in5 in5 RW 3 |
|---|
| 104 | in6_min in6 in6 RW 3 |
|---|
| 105 | in7_min in7 in7 RW 3 |
|---|
| 106 | in8_min in8 in8 RW 3 |
|---|
| 107 | in0_max in0 in0 RW 3 |
|---|
| 108 | in1_max in1 in1 RW 3 |
|---|
| 109 | in2_max in2 in2 RW 3 |
|---|
| 110 | in3_max in3 in3 RW 3 |
|---|
| 111 | in4_max in4 in4 RW 3 |
|---|
| 112 | in5_max in5 in5 RW 3 |
|---|
| 113 | in6_max in6 in6 RW 3 |
|---|
| 114 | in7_max in7 in7 RW 3 |
|---|
| 115 | in8_max in8 in8 RW 3 |
|---|
| 116 | fan1 NONE NONE R 0 |
|---|
| 117 | fan2 NONE NONE R 0 |
|---|
| 118 | fan3 NONE NONE R 0 |
|---|
| 119 | fan4 NONE NONE R 0 |
|---|
| 120 | fan5 NONE NONE R 0 |
|---|
| 121 | fan6 NONE NONE R 0 |
|---|
| 122 | fan7 NONE NONE R 0 |
|---|
| 123 | fan1_min fan1 NONE RW 0 |
|---|
| 124 | fan2_min fan2 NONE RW 0 |
|---|
| 125 | fan3_min fan3 NONE RW 0 |
|---|
| 126 | fan4_min fan4 NONE RW 0 |
|---|
| 127 | fan5_min fan5 NONE RW 0 |
|---|
| 128 | fan6_min fan6 NONE RW 0 |
|---|
| 129 | fan7_min fan7 NONE RW 0 |
|---|
| 130 | temp1 NONE NONE R 1 |
|---|
| 131 | temp1_hyst temp1 temp1 RW 1 |
|---|
| 132 | temp1_over temp1 temp1 RW 1 |
|---|
| 133 | temp2 NONE NONE R 1 |
|---|
| 134 | temp2_hyst temp2 temp2 RW 1 |
|---|
| 135 | temp2_over temp2 temp2 RW 1 |
|---|
| 136 | temp3 NONE NONE R 1 |
|---|
| 137 | temp3_hyst temp3 temp3 RW 1 |
|---|
| 138 | temp3_over temp3 temp3 RW 1 |
|---|
| 139 | fan1_div fan1 NONE RW 0 |
|---|
| 140 | fan2_div fan2 NONE RW 0 |
|---|
| 141 | fan3_div fan3 NONE RW 0 |
|---|
| 142 | fan4_div fan4 NONE RW 0 |
|---|
| 143 | fan5_div fan5 NONE RW 0 |
|---|
| 144 | fan6_div fan6 NONE RW 0 |
|---|
| 145 | fan7_div fan7 NONE RW 0 |
|---|
| 146 | |
|---|
| 147 | LABEL FEATURE SYMBOL SYSCTL FILE:NR |
|---|
| 148 | in0 SENSORS_W83792D_IN0 in0:3 |
|---|
| 149 | in1 SENSORS_W83792D_IN1 in1:3 |
|---|
| 150 | in2 SENSORS_W83792D_IN2 in2:3 |
|---|
| 151 | in3 SENSORS_W83792D_IN3 in3:3 |
|---|
| 152 | in4 SENSORS_W83792D_IN4 in4:3 |
|---|
| 153 | in5 SENSORS_W83792D_IN5 in5:3 |
|---|
| 154 | in6 SENSORS_W83792D_IN6 in6:3 |
|---|
| 155 | in7 SENSORS_W83792D_IN7 in7:3 |
|---|
| 156 | in8 SENSORS_W83792D_IN8 in8:3 |
|---|
| 157 | in0_min SENSORS_W83792D_IN0_MIN in0:1 |
|---|
| 158 | in1_min SENSORS_W83792D_IN1_MIN in1:1 |
|---|
| 159 | in2_min SENSORS_W83792D_IN2_MIN in2:1 |
|---|
| 160 | in3_min SENSORS_W83792D_IN3_MIN in3:1 |
|---|
| 161 | in4_min SENSORS_W83792D_IN4_MIN in4:1 |
|---|
| 162 | in5_min SENSORS_W83792D_IN5_MIN in5:1 |
|---|
| 163 | in6_min SENSORS_W83792D_IN6_MIN in6:1 |
|---|
| 164 | in7_min SENSORS_W83792D_IN7_MIN in7:1 |
|---|
| 165 | in8_min SENSORS_W83792D_IN8_MIN in8:1 |
|---|
| 166 | in0_max SENSORS_W83792D_IN0_MAX in0:2 |
|---|
| 167 | in1_max SENSORS_W83792D_IN1_MAX in1:2 |
|---|
| 168 | in2_max SENSORS_W83792D_IN2_MAX in2:2 |
|---|
| 169 | in3_max SENSORS_W83792D_IN3_MAX in3:2 |
|---|
| 170 | in4_max SENSORS_W83792D_IN4_MAX in4:2 |
|---|
| 171 | in5_max SENSORS_W83792D_IN5_MAX in5:2 |
|---|
| 172 | in6_max SENSORS_W83792D_IN6_MAX in6:2 |
|---|
| 173 | in7_max SENSORS_W83792D_IN7_MAX in7:2 |
|---|
| 174 | in8_max SENSORS_W83792D_IN8_MAX in8:2 |
|---|
| 175 | fan1 SENSORS_W83792D_FAN1 fan1:2 |
|---|
| 176 | fan2 SENSORS_W83792D_FAN2 fan2:2 |
|---|
| 177 | fan3 SENSORS_W83792D_FAN3 fan3:2 |
|---|
| 178 | fan4 SENSORS_W83792D_FAN4 fan4:2 |
|---|
| 179 | fan5 SENSORS_W83792D_FAN5 fan5:2 |
|---|
| 180 | fan6 SENSORS_W83792D_FAN6 fan6:2 |
|---|
| 181 | fan7 SENSORS_W83792D_FAN7 fan7:2 |
|---|
| 182 | fan1_min SENSORS_W83792D_FAN1_MIN fan1:1 |
|---|
| 183 | fan2_min SENSORS_W83792D_FAN2_MIN fan2:1 |
|---|
| 184 | fan3_min SENSORS_W83792D_FAN3_MIN fan3:1 |
|---|
| 185 | fan4_min SENSORS_W83792D_FAN4_MIN fan4:1 |
|---|
| 186 | fan5_min SENSORS_W83792D_FAN5_MIN fan5:1 |
|---|
| 187 | fan6_min SENSORS_W83792D_FAN6_MIN fan6:1 |
|---|
| 188 | fan7_min SENSORS_W83792D_FAN7_MIN fan7:1 |
|---|
| 189 | temp1 SENSORS_W83792D_TEMP1 temp1:3 |
|---|
| 190 | temp1_hyst SENSORS_W83792D_TEMP1_HYST temp1:2 |
|---|
| 191 | temp1_over SENSORS_W83792D_TEMP1_OVER temp1:1 |
|---|
| 192 | temp2 SENSORS_W83792D_TEMP2 temp2:3 |
|---|
| 193 | temp2_hyst SENSORS_W83792D_TEMP2_HYST temp2:2 |
|---|
| 194 | temp2_over SENSORS_W83792D_TEMP2_OVER temp2:1 |
|---|
| 195 | temp3 SENSORS_W83792D_TEMP3 temp3:3 |
|---|
| 196 | temp3_hyst SENSORS_W83792D_TEMP3_HYST temp3:2 |
|---|
| 197 | temp3_over SENSORS_W83792D_TEMP3_OVER temp3:1 |
|---|
| 198 | fan1_div SENSORS_W83792D_FAN1_DIV fan_div:1 |
|---|
| 199 | fan2_div SENSORS_W83792D_FAN2_DIV fan_div:2 |
|---|
| 200 | fan3_div SENSORS_W83792D_FAN3_DIV fan_div:3 |
|---|
| 201 | fan4_div SENSORS_W83792D_FAN4_DIV fan_div:4 |
|---|
| 202 | fan5_div SENSORS_W83792D_FAN5_DIV fan_div:5 |
|---|
| 203 | fan6_div SENSORS_W83792D_FAN6_DIV fan_div:6 |
|---|
| 204 | fan7_div SENSORS_W83792D_FAN7_DIV fan_div:7 |
|---|
| 205 | |
|---|
| 206 | |
|---|
| 207 | |
|---|
| 208 | |
|---|
| 209 | /PROC ENTRIES |
|---|
| 210 | ------------- |
|---|
| 211 | Most are identical to the w83781d entries. See the w83781d documentation for |
|---|
| 212 | details. |
|---|
| 213 | |
|---|
| 214 | Most of the additional entries not in the w83781d are Winbond Smart Fan I/II: |
|---|
| 215 | Please read "7.7 FAN Speed Count and FAN Speed Control" of W83792AD/D datasheet |
|---|
| 216 | before you read the explanation to the /proc entries below. |
|---|
| 217 | |
|---|
| 218 | fan_cfg: indicates the fan speed control mode: 0 means PWM/DC mode, |
|---|
| 219 | 1 means Smart Fan I(Thermal Cruise) mode, 2 or 3 means Smart Fan II |
|---|
| 220 | mode. There are three items in this entry, the first one is the |
|---|
| 221 | configuration of Fan1, the rest may be deduced by analogy. |
|---|
| 222 | |
|---|
| 223 | pwm_flag: valid under PWM/DC mode, 1 means PWM mode, 0 means DC mode. |
|---|
| 224 | There are three items in this entry, the first one is PWM/DC mode |
|---|
| 225 | of Fan1, the rest may be deduced by analogy. |
|---|
| 226 | |
|---|
| 227 | thermal_cruise: valid under Smart Fan I mode, indicates the wanted |
|---|
| 228 | temperature. There are three items in this entry, the first one |
|---|
| 229 | is setting temperature of Fan1, the rest may be deduced by analogy. |
|---|
| 230 | |
|---|
| 231 | fan_tolerance: valid under Smart Fan I or Smart Fan II mode, indicates |
|---|
| 232 | the interval temperature. There are also three items in this entry. |
|---|
| 233 | |
|---|
| 234 | sf2_points_fan1: valid under Smart Fan II mode, there are four items in |
|---|
| 235 | this entry, indicates the Temp.[1-4] in "Figure 8. Smart Fan II |
|---|
| 236 | behavior" to Fan1. |
|---|
| 237 | |
|---|
| 238 | sf2_points_fan2: almost same as the above one, except that this entry |
|---|
| 239 | is for Fan2. |
|---|
| 240 | |
|---|
| 241 | sf2_points_fan3: almost same as the above one, except that this entry |
|---|
| 242 | is for Fan3. |
|---|
| 243 | |
|---|
| 244 | sf2_levels_fan1: valid under Smart Fan II mode, there are four items in |
|---|
| 245 | this entry, indicates the "Non-Stop Duty Cycle" and "Fan Duty Cycle |
|---|
| 246 | Level [1-3]" in "Figure 8. Smart Fan II behavior" to Fan1. The |
|---|
| 247 | first item "Non-Stop Duty Cycle" is read only in this driver, while |
|---|
| 248 | the other three items can be modified. |
|---|
| 249 | |
|---|
| 250 | sf2_levels_fan2: almost same as the above one, except that this entry |
|---|
| 251 | is for Fan2. |
|---|
| 252 | |
|---|
| 253 | sf2_levels_fan3: almost same as the above one, except that this entry |
|---|
| 254 | is for Fan3. |
|---|
| 255 | |
|---|
| 256 | |
|---|
| 257 | additional entries for chassis intrusion detection: |
|---|
| 258 | chassis: There are two items in this entry, the first one indicats the |
|---|
| 259 | chassis status, 1 means chassis intrusion detected, while 1 means |
|---|
| 260 | normal. The second item in this entry is used to clear the |
|---|
| 261 | detected chassis intrusion interrupt and reset the chassis status |
|---|
| 262 | to normal. |
|---|
| 263 | |
|---|
| 264 | |
|---|
| 265 | Author/Maintainer |
|---|
| 266 | ----------------- |
|---|
| 267 | Original 792D support: Chunhao Huang(huang0@winbond.com.tw) |
|---|
| 268 | subclients register added by: Mark D. Studebaker(mdsxyz123@yahoo.com) |
|---|
| 269 | and modified by Jean Delvare <khali@linux-fr.org>. |
|---|
