Based on kernel version 4.16.1. Page generated on 2018-04-09 11:53 EST.
1 Kernel driver w83781d 2 ===================== 3 4 Supported chips: 5 * Winbond W83781D 6 Prefix: 'w83781d' 7 Addresses scanned: I2C 0x28 - 0x2f, ISA 0x290 (8 I/O ports) 8 Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/w83781d.pdf 9 * Winbond W83782D 10 Prefix: 'w83782d' 11 Addresses scanned: I2C 0x28 - 0x2f, ISA 0x290 (8 I/O ports) 12 Datasheet: http://www.winbond.com 13 * Winbond W83783S 14 Prefix: 'w83783s' 15 Addresses scanned: I2C 0x2d 16 Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/w83783s.pdf 17 * Asus AS99127F 18 Prefix: 'as99127f' 19 Addresses scanned: I2C 0x28 - 0x2f 20 Datasheet: Unavailable from Asus 21 22 Authors: 23 Frodo Looijaard <frodol@dds.nl>, 24 Philip Edelbrock <phil@netroedge.com>, 25 Mark Studebaker <mdsxyz123@yahoo.com> 26 27 Module parameters 28 ----------------- 29 30 * init int 31 (default 1) 32 Use 'init=0' to bypass initializing the chip. 33 Try this if your computer crashes when you load the module. 34 35 * reset int 36 (default 0) 37 The driver used to reset the chip on load, but does no more. Use 38 'reset=1' to restore the old behavior. Report if you need to do this. 39 40 force_subclients=bus,caddr,saddr,saddr 41 This is used to force the i2c addresses for subclients of 42 a certain chip. Typical usage is `force_subclients=0,0x2d,0x4a,0x4b' 43 to force the subclients of chip 0x2d on bus 0 to i2c addresses 44 0x4a and 0x4b. This parameter is useful for certain Tyan boards. 45 46 Description 47 ----------- 48 49 This driver implements support for the Winbond W83781D, W83782D, W83783S 50 chips, and the Asus AS99127F chips. We will refer to them collectively as 51 W8378* chips. 52 53 There is quite some difference between these chips, but they are similar 54 enough that it was sensible to put them together in one driver. 55 The Asus chips are similar to an I2C-only W83782D. 56 57 Chip #vin #fanin #pwm #temp wchipid vendid i2c ISA 58 as99127f 7 3 0 3 0x31 0x12c3 yes no 59 as99127f rev.2 (type_name = as99127f) 0x31 0x5ca3 yes no 60 w83781d 7 3 0 3 0x10-1 0x5ca3 yes yes 61 w83782d 9 3 2-4 3 0x30 0x5ca3 yes yes 62 w83783s 5-6 3 2 1-2 0x40 0x5ca3 yes no 63 64 Detection of these chips can sometimes be foiled because they can be in 65 an internal state that allows no clean access. If you know the address 66 of the chip, use a 'force' parameter; this will put them into a more 67 well-behaved state first. 68 69 The W8378* implements temperature sensors (three on the W83781D and W83782D, 70 two on the W83783S), three fan rotation speed sensors, voltage sensors 71 (seven on the W83781D, nine on the W83782D and six on the W83783S), VID 72 lines, alarms with beep warnings, and some miscellaneous stuff. 73 74 Temperatures are measured in degrees Celsius. There is always one main 75 temperature sensor, and one (W83783S) or two (W83781D and W83782D) other 76 sensors. An alarm is triggered for the main sensor once when the 77 Overtemperature Shutdown limit is crossed; it is triggered again as soon as 78 it drops below the Hysteresis value. A more useful behavior 79 can be found by setting the Hysteresis value to +127 degrees Celsius; in 80 this case, alarms are issued during all the time when the actual temperature 81 is above the Overtemperature Shutdown value. The driver sets the 82 hysteresis value for temp1 to 127 at initialization. 83 84 For the other temperature sensor(s), an alarm is triggered when the 85 temperature gets higher then the Overtemperature Shutdown value; it stays 86 on until the temperature falls below the Hysteresis value. But on the 87 W83781D, there is only one alarm that functions for both other sensors! 88 Temperatures are guaranteed within a range of -55 to +125 degrees. The 89 main temperature sensors has a resolution of 1 degree; the other sensor(s) 90 of 0.5 degree. 91 92 Fan rotation speeds are reported in RPM (rotations per minute). An alarm is 93 triggered if the rotation speed has dropped below a programmable limit. Fan 94 readings can be divided by a programmable divider (1, 2, 4 or 8 for the 95 W83781D; 1, 2, 4, 8, 16, 32, 64 or 128 for the others) to give 96 the readings more range or accuracy. Not all RPM values can accurately 97 be represented, so some rounding is done. With a divider of 2, the lowest 98 representable value is around 2600 RPM. 99 100 Voltage sensors (also known as IN sensors) report their values in volts. 101 An alarm is triggered if the voltage has crossed a programmable minimum 102 or maximum limit. Note that minimum in this case always means 'closest to 103 zero'; this is important for negative voltage measurements. All voltage 104 inputs can measure voltages between 0 and 4.08 volts, with a resolution 105 of 0.016 volt. 106 107 The VID lines encode the core voltage value: the voltage level your processor 108 should work with. This is hardcoded by the mainboard and/or processor itself. 109 It is a value in volts. When it is unconnected, you will often find the 110 value 3.50 V here. 111 112 The W83782D and W83783S temperature conversion machine understands about 113 several kinds of temperature probes. You can program the so-called 114 beta value in the sensor files. '1' is the PII/Celeron diode, '2' is the 115 TN3904 transistor, and 3435 the default thermistor value. Other values 116 are (not yet) supported. 117 118 In addition to the alarms described above, there is a CHAS alarm on the 119 chips which triggers if your computer case is open. 120 121 When an alarm goes off, you can be warned by a beeping signal through 122 your computer speaker. It is possible to enable all beeping globally, 123 or only the beeping for some alarms. 124 125 Individual alarm and beep bits: 126 127 0x000001: in0 128 0x000002: in1 129 0x000004: in2 130 0x000008: in3 131 0x000010: temp1 132 0x000020: temp2 (+temp3 on W83781D) 133 0x000040: fan1 134 0x000080: fan2 135 0x000100: in4 136 0x000200: in5 137 0x000400: in6 138 0x000800: fan3 139 0x001000: chassis 140 0x002000: temp3 (W83782D only) 141 0x010000: in7 (W83782D only) 142 0x020000: in8 (W83782D only) 143 144 If an alarm triggers, it will remain triggered until the hardware register 145 is read at least once. This means that the cause for the alarm may 146 already have disappeared! Note that in the current implementation, all 147 hardware registers are read whenever any data is read (unless it is less 148 than 1.5 seconds since the last update). This means that you can easily 149 miss once-only alarms. 150 151 The chips only update values each 1.5 seconds; reading them more often 152 will do no harm, but will return 'old' values. 153 154 AS99127F PROBLEMS 155 ----------------- 156 The as99127f support was developed without the benefit of a datasheet. 157 In most cases it is treated as a w83781d (although revision 2 of the 158 AS99127F looks more like a w83782d). 159 This support will be BETA until a datasheet is released. 160 One user has reported problems with fans stopping 161 occasionally. 162 163 Note that the individual beep bits are inverted from the other chips. 164 The driver now takes care of this so that user-space applications 165 don't have to know about it. 166 167 Known problems: 168 - Problems with diode/thermistor settings (supported?) 169 - One user reports fans stopping under high server load. 170 - Revision 2 seems to have 2 PWM registers but we don't know 171 how to handle them. More details below. 172 173 These will not be fixed unless we get a datasheet. 174 If you have problems, please lobby Asus to release a datasheet. 175 Unfortunately several others have without success. 176 Please do not send mail to us asking for better as99127f support. 177 We have done the best we can without a datasheet. 178 Please do not send mail to the author or the sensors group asking for 179 a datasheet or ideas on how to convince Asus. We can't help. 180 181 182 NOTES: 183 ----- 184 783s has no in1 so that in[2-6] are compatible with the 781d/782d. 185 186 783s pin is programmable for -5V or temp1; defaults to -5V, 187 no control in driver so temp1 doesn't work. 188 189 782d and 783s datasheets differ on which is pwm1 and which is pwm2. 190 We chose to follow 782d. 191 192 782d and 783s pin is programmable for fan3 input or pwm2 output; 193 defaults to fan3 input. 194 If pwm2 is enabled (with echo 255 1 > pwm2), then 195 fan3 will report 0. 196 197 782d has pwm1-2 for ISA, pwm1-4 for i2c. (pwm3-4 share pins with 198 the ISA pins) 199 200 Data sheet updates: 201 ------------------ 202 - PWM clock registers: 203 204 000: master / 512 205 001: master / 1024 206 010: master / 2048 207 011: master / 4096 208 100: master / 8192 209 210 211 Answers from Winbond tech support 212 --------------------------------- 213 > 214 > 1) In the W83781D data sheet section 7.2 last paragraph, it talks about 215 > reprogramming the R-T table if the Beta of the thermistor is not 216 > 3435K. The R-T table is described briefly in section 8.20. 217 > What formulas do I use to program a new R-T table for a given Beta? 218 > 219 We are sorry that the calculation for R-T table value is 220 confidential. If you have another Beta value of thermistor, we can help 221 to calculate the R-T table for you. But you should give us real R-T 222 Table which can be gotten by thermistor vendor. Therefore we will calculate 223 them and obtain 32-byte data, and you can fill the 32-byte data to the 224 register in Bank0.CR51 of W83781D. 225 226 227 > 2) In the W83782D data sheet, it mentions that pins 38, 39, and 40 are 228 > programmable to be either thermistor or Pentium II diode inputs. 229 > How do I program them for diode inputs? I can't find any register 230 > to program these to be diode inputs. 231 --> You may program Bank0 CR[5Dh] and CR[59h] registers. 232 233 CR[5Dh] bit 1(VTIN1) bit 2(VTIN2) bit 3(VTIN3) 234 235 thermistor 0 0 0 236 diode 1 1 1 237 238 239 (error) CR[59h] bit 4(VTIN1) bit 2(VTIN2) bit 3(VTIN3) 240 (right) CR[59h] bit 4(VTIN1) bit 5(VTIN2) bit 6(VTIN3) 241 242 PII thermal diode 1 1 1 243 2N3904 diode 0 0 0 244 245 246 Asus Clones 247 ----------- 248 249 We have no datasheets for the Asus clones (AS99127F and ASB100 Bach). 250 Here are some very useful information that were given to us by Alex Van 251 Kaam about how to detect these chips, and how to read their values. He 252 also gives advice for another Asus chipset, the Mozart-2 (which we 253 don't support yet). Thanks Alex! 254 I reworded some parts and added personal comments. 255 256 # Detection: 257 258 AS99127F rev.1, AS99127F rev.2 and ASB100: 259 - I2C address range: 0x29 - 0x2F 260 - If register 0x58 holds 0x31 then we have an Asus (either ASB100 or 261 AS99127F) 262 - Which one depends on register 0x4F (manufacturer ID): 263 0x06 or 0x94: ASB100 264 0x12 or 0xC3: AS99127F rev.1 265 0x5C or 0xA3: AS99127F rev.2 266 Note that 0x5CA3 is Winbond's ID (WEC), which let us think Asus get their 267 AS99127F rev.2 direct from Winbond. The other codes mean ATT and DVC, 268 respectively. ATT could stand for Asustek something (although it would be 269 very badly chosen IMHO), I don't know what DVC could stand for. Maybe 270 these codes simply aren't meant to be decoded that way. 271 272 Mozart-2: 273 - I2C address: 0x77 274 - If register 0x58 holds 0x56 or 0x10 then we have a Mozart-2 275 - Of the Mozart there are 3 types: 276 0x58=0x56, 0x4E=0x94, 0x4F=0x36: Asus ASM58 Mozart-2 277 0x58=0x56, 0x4E=0x94, 0x4F=0x06: Asus AS2K129R Mozart-2 278 0x58=0x10, 0x4E=0x5C, 0x4F=0xA3: Asus ??? Mozart-2 279 You can handle all 3 the exact same way :) 280 281 # Temperature sensors: 282 283 ASB100: 284 - sensor 1: register 0x27 285 - sensor 2 & 3 are the 2 LM75's on the SMBus 286 - sensor 4: register 0x17 287 Remark: I noticed that on Intel boards sensor 2 is used for the CPU 288 and 4 is ignored/stuck, on AMD boards sensor 4 is the CPU and sensor 2 is 289 either ignored or a socket temperature. 290 291 AS99127F (rev.1 and 2 alike): 292 - sensor 1: register 0x27 293 - sensor 2 & 3 are the 2 LM75's on the SMBus 294 Remark: Register 0x5b is suspected to be temperature type selector. Bit 1 295 would control temp1, bit 3 temp2 and bit 5 temp3. 296 297 Mozart-2: 298 - sensor 1: register 0x27 299 - sensor 2: register 0x13 300 301 # Fan sensors: 302 303 ASB100, AS99127F (rev.1 and 2 alike): 304 - 3 fans, identical to the W83781D 305 306 Mozart-2: 307 - 2 fans only, 1350000/RPM/div 308 - fan 1: register 0x28, divisor on register 0xA1 (bits 4-5) 309 - fan 2: register 0x29, divisor on register 0xA1 (bits 6-7) 310 311 # Voltages: 312 313 This is where there is a difference between AS99127F rev.1 and 2. 314 Remark: The difference is similar to the difference between 315 W83781D and W83782D. 316 317 ASB100: 318 in0=r(0x20)*0.016 319 in1=r(0x21)*0.016 320 in2=r(0x22)*0.016 321 in3=r(0x23)*0.016*1.68 322 in4=r(0x24)*0.016*3.8 323 in5=r(0x25)*(-0.016)*3.97 324 in6=r(0x26)*(-0.016)*1.666 325 326 AS99127F rev.1: 327 in0=r(0x20)*0.016 328 in1=r(0x21)*0.016 329 in2=r(0x22)*0.016 330 in3=r(0x23)*0.016*1.68 331 in4=r(0x24)*0.016*3.8 332 in5=r(0x25)*(-0.016)*3.97 333 in6=r(0x26)*(-0.016)*1.503 334 335 AS99127F rev.2: 336 in0=r(0x20)*0.016 337 in1=r(0x21)*0.016 338 in2=r(0x22)*0.016 339 in3=r(0x23)*0.016*1.68 340 in4=r(0x24)*0.016*3.8 341 in5=(r(0x25)*0.016-3.6)*5.14+3.6 342 in6=(r(0x26)*0.016-3.6)*3.14+3.6 343 344 Mozart-2: 345 in0=r(0x20)*0.016 346 in1=255 347 in2=r(0x22)*0.016 348 in3=r(0x23)*0.016*1.68 349 in4=r(0x24)*0.016*4 350 in5=255 351 in6=255 352 353 354 # PWM 355 356 * Additional info about PWM on the AS99127F (may apply to other Asus 357 chips as well) by Jean Delvare as of 2004-04-09: 358 359 AS99127F revision 2 seems to have two PWM registers at 0x59 and 0x5A, 360 and a temperature sensor type selector at 0x5B (which basically means 361 that they swapped registers 0x59 and 0x5B when you compare with Winbond 362 chips). 363 Revision 1 of the chip also has the temperature sensor type selector at 364 0x5B, but PWM registers have no effect. 365 366 We don't know exactly how the temperature sensor type selection works. 367 Looks like bits 1-0 are for temp1, bits 3-2 for temp2 and bits 5-4 for 368 temp3, although it is possible that only the most significant bit matters 369 each time. So far, values other than 0 always broke the readings. 370 371 PWM registers seem to be split in two parts: bit 7 is a mode selector, 372 while the other bits seem to define a value or threshold. 373 374 When bit 7 is clear, bits 6-0 seem to hold a threshold value. If the value 375 is below a given limit, the fan runs at low speed. If the value is above 376 the limit, the fan runs at full speed. We have no clue as to what the limit 377 represents. Note that there seem to be some inertia in this mode, speed 378 changes may need some time to trigger. Also, an hysteresis mechanism is 379 suspected since walking through all the values increasingly and then 380 decreasingly led to slightly different limits. 381 382 When bit 7 is set, bits 3-0 seem to hold a threshold value, while bits 6-4 383 would not be significant. If the value is below a given limit, the fan runs 384 at full speed, while if it is above the limit it runs at low speed (so this 385 is the contrary of the other mode, in a way). Here again, we don't know 386 what the limit is supposed to represent. 387 388 One remarkable thing is that the fans would only have two or three 389 different speeds (transitional states left apart), not a whole range as 390 you usually get with PWM. 391 392 As a conclusion, you can write 0x00 or 0x8F to the PWM registers to make 393 fans run at low speed, and 0x7F or 0x80 to make them run at full speed. 394 395 Please contact us if you can figure out how it is supposed to work. As 396 long as we don't know more, the w83781d driver doesn't handle PWM on 397 AS99127F chips at all. 398 399 * Additional info about PWM on the AS99127F rev.1 by Hector Martin: 400 401 I've been fiddling around with the (in)famous 0x59 register and 402 found out the following values do work as a form of coarse pwm: 403 404 0x80 - seems to turn fans off after some time(1-2 minutes)... might be 405 some form of auto-fan-control based on temp? hmm (Qfan? this mobo is an 406 old ASUS, it isn't marketed as Qfan. Maybe some beta pre-attempt at Qfan 407 that was dropped at the BIOS) 408 0x81 - off 409 0x82 - slightly "on-ner" than off, but my fans do not get to move. I can 410 hear the high-pitched PWM sound that motors give off at too-low-pwm. 411 0x83 - now they do move. Estimate about 70% speed or so. 412 0x84-0x8f - full on 413 414 Changing the high nibble doesn't seem to do much except the high bit 415 (0x80) must be set for PWM to work, else the current pwm doesn't seem to 416 change. 417 418 My mobo is an ASUS A7V266-E. This behavior is similar to what I got 419 with speedfan under Windows, where 0-15% would be off, 15-2x% (can't 420 remember the exact value) would be 70% and higher would be full on. 421 422 * Additional info about PWM on the AS99127F rev.1 from lm-sensors 423 ticket #2350: 424 425 I conducted some experiment on Asus P3B-F motherboard with AS99127F 426 (Ver. 1). 427 428 I confirm that 0x59 register control the CPU_Fan Header on this 429 motherboard, and 0x5a register control PWR_Fan. 430 431 In order to reduce the dependency of specific fan, the measurement is 432 conducted with a digital scope without fan connected. I found out that 433 P3B-F actually output variable DC voltage on fan header center pin, 434 looks like PWM is filtered on this motherboard. 435 436 Here are some of measurements: 437 438 0x80 20 mV 439 0x81 20 mV 440 0x82 232 mV 441 0x83 1.2 V 442 0x84 2.31 V 443 0x85 3.44 V 444 0x86 4.62 V 445 0x87 5.81 V 446 0x88 7.01 V 447 9x89 8.22 V 448 0x8a 9.42 V 449 0x8b 10.6 V 450 0x8c 11.9 V 451 0x8d 12.4 V 452 0x8e 12.4 V 453 0x8f 12.4 V