17ebd8b66SMauro Carvalho ChehabKernel driver w83627hf 27ebd8b66SMauro Carvalho Chehab====================== 37ebd8b66SMauro Carvalho Chehab 47ebd8b66SMauro Carvalho ChehabSupported chips: 57ebd8b66SMauro Carvalho Chehab * Winbond W83627HF (ISA accesses ONLY) 67ebd8b66SMauro Carvalho Chehab Prefix: 'w83627hf' 77ebd8b66SMauro Carvalho Chehab Addresses scanned: ISA address retrieved from Super I/O registers 87ebd8b66SMauro Carvalho Chehab * Winbond W83627THF 97ebd8b66SMauro Carvalho Chehab Prefix: 'w83627thf' 107ebd8b66SMauro Carvalho Chehab Addresses scanned: ISA address retrieved from Super I/O registers 117ebd8b66SMauro Carvalho Chehab * Winbond W83697HF 127ebd8b66SMauro Carvalho Chehab Prefix: 'w83697hf' 137ebd8b66SMauro Carvalho Chehab Addresses scanned: ISA address retrieved from Super I/O registers 147ebd8b66SMauro Carvalho Chehab * Winbond W83637HF 157ebd8b66SMauro Carvalho Chehab Prefix: 'w83637hf' 167ebd8b66SMauro Carvalho Chehab Addresses scanned: ISA address retrieved from Super I/O registers 177ebd8b66SMauro Carvalho Chehab * Winbond W83687THF 187ebd8b66SMauro Carvalho Chehab Prefix: 'w83687thf' 197ebd8b66SMauro Carvalho Chehab Addresses scanned: ISA address retrieved from Super I/O registers 207ebd8b66SMauro Carvalho Chehab Datasheet: Provided by Winbond on request(http://www.winbond.com/hq/enu) 217ebd8b66SMauro Carvalho Chehab 227ebd8b66SMauro Carvalho ChehabAuthors: 237ebd8b66SMauro Carvalho Chehab Frodo Looijaard <frodol@dds.nl>, 247ebd8b66SMauro Carvalho Chehab Philip Edelbrock <phil@netroedge.com>, 257ebd8b66SMauro Carvalho Chehab Mark Studebaker <mdsxyz123@yahoo.com>, 267ebd8b66SMauro Carvalho Chehab Bernhard C. Schrenk <clemy@clemy.org> 277ebd8b66SMauro Carvalho Chehab 287ebd8b66SMauro Carvalho ChehabModule Parameters 297ebd8b66SMauro Carvalho Chehab----------------- 307ebd8b66SMauro Carvalho Chehab 317ebd8b66SMauro Carvalho Chehab* force_i2c: int 327ebd8b66SMauro Carvalho Chehab Initialize the I2C address of the sensors 337ebd8b66SMauro Carvalho Chehab* init: int 347ebd8b66SMauro Carvalho Chehab (default is 1) 357ebd8b66SMauro Carvalho Chehab Use 'init=0' to bypass initializing the chip. 367ebd8b66SMauro Carvalho Chehab Try this if your computer crashes when you load the module. 377ebd8b66SMauro Carvalho Chehab 387ebd8b66SMauro Carvalho ChehabDescription 397ebd8b66SMauro Carvalho Chehab----------- 407ebd8b66SMauro Carvalho Chehab 417ebd8b66SMauro Carvalho ChehabThis driver implements support for ISA accesses *only* for 427ebd8b66SMauro Carvalho Chehabthe Winbond W83627HF, W83627THF, W83697HF and W83637HF Super I/O chips. 437ebd8b66SMauro Carvalho ChehabWe will refer to them collectively as Winbond chips. 447ebd8b66SMauro Carvalho Chehab 457ebd8b66SMauro Carvalho ChehabThis driver supports ISA accesses, which should be more reliable 467ebd8b66SMauro Carvalho Chehabthan i2c accesses. Also, for Tyan boards which contain both a 477ebd8b66SMauro Carvalho ChehabSuper I/O chip and a second i2c-only Winbond chip (often a W83782D), 487ebd8b66SMauro Carvalho Chehabusing this driver will avoid i2c address conflicts and complex 497ebd8b66SMauro Carvalho Chehabinitialization that were required in the w83781d driver. 507ebd8b66SMauro Carvalho Chehab 517ebd8b66SMauro Carvalho ChehabIf you really want i2c accesses for these Super I/O chips, 527ebd8b66SMauro Carvalho Chehabuse the w83781d driver. However this is not the preferred method 537ebd8b66SMauro Carvalho Chehabnow that this ISA driver has been developed. 547ebd8b66SMauro Carvalho Chehab 557ebd8b66SMauro Carvalho ChehabThe `w83627_HF_` uses pins 110-106 as VID0-VID4. The `w83627_THF_` uses the 567ebd8b66SMauro Carvalho Chehabsame pins as GPIO[0:4]. Technically, the `w83627_THF_` does not support a 577ebd8b66SMauro Carvalho ChehabVID reading. However the two chips have the identical 128 pin package. So, 587ebd8b66SMauro Carvalho Chehabit is possible or even likely for a w83627thf to have the VID signals routed 597ebd8b66SMauro Carvalho Chehabto these pins despite their not being labeled for that purpose. Therefore, 607ebd8b66SMauro Carvalho Chehabthe w83627thf driver interprets these as VID. If the VID on your board 617ebd8b66SMauro Carvalho Chehabdoesn't work, first see doc/vid in the lm_sensors package[1]. If that still 627ebd8b66SMauro Carvalho Chehabdoesn't help, you may just ignore the bogus VID reading with no harm done. 637ebd8b66SMauro Carvalho Chehab 647ebd8b66SMauro Carvalho ChehabFor further information on this driver see the w83781d driver documentation. 657ebd8b66SMauro Carvalho Chehab 667ebd8b66SMauro Carvalho Chehab[1] http://www.lm-sensors.org/browser/lm-sensors/trunk/doc/vid 677ebd8b66SMauro Carvalho Chehab 687ebd8b66SMauro Carvalho ChehabForcing the address 697ebd8b66SMauro Carvalho Chehab------------------- 707ebd8b66SMauro Carvalho Chehab 717ebd8b66SMauro Carvalho ChehabThe driver used to have a module parameter named force_addr, which could 727ebd8b66SMauro Carvalho Chehabbe used to force the base I/O address of the hardware monitoring block. 737ebd8b66SMauro Carvalho ChehabThis was meant as a workaround for mainboards with a broken BIOS. This 747ebd8b66SMauro Carvalho Chehabmodule parameter is gone for technical reasons. If you need this feature, 757ebd8b66SMauro Carvalho Chehabyou can obtain the same result by using the isaset tool (part of 767ebd8b66SMauro Carvalho Chehablm-sensors) before loading the driver: 777ebd8b66SMauro Carvalho Chehab 787ebd8b66SMauro Carvalho Chehab# Enter the Super I/O config space:: 797ebd8b66SMauro Carvalho Chehab 807ebd8b66SMauro Carvalho Chehab isaset -y -f 0x2e 0x87 817ebd8b66SMauro Carvalho Chehab isaset -y -f 0x2e 0x87 827ebd8b66SMauro Carvalho Chehab 837ebd8b66SMauro Carvalho Chehab# Select the hwmon logical device:: 847ebd8b66SMauro Carvalho Chehab 857ebd8b66SMauro Carvalho Chehab isaset -y 0x2e 0x2f 0x07 0x0b 867ebd8b66SMauro Carvalho Chehab 877ebd8b66SMauro Carvalho Chehab# Set the base I/O address (to 0x290 in this example):: 887ebd8b66SMauro Carvalho Chehab 897ebd8b66SMauro Carvalho Chehab isaset -y 0x2e 0x2f 0x60 0x02 907ebd8b66SMauro Carvalho Chehab isaset -y 0x2e 0x2f 0x61 0x90 917ebd8b66SMauro Carvalho Chehab 927ebd8b66SMauro Carvalho Chehab# Exit the Super-I/O config space:: 937ebd8b66SMauro Carvalho Chehab 947ebd8b66SMauro Carvalho Chehab isaset -y -f 0x2e 0xaa 957ebd8b66SMauro Carvalho Chehab 967ebd8b66SMauro Carvalho ChehabThe above sequence assumes a Super-I/O config space at 0x2e/0x2f, but 977ebd8b66SMauro Carvalho Chehab0x4e/0x4f is also possible. 987ebd8b66SMauro Carvalho Chehab 997ebd8b66SMauro Carvalho ChehabVoltage pin mapping 1007ebd8b66SMauro Carvalho Chehab------------------- 1017ebd8b66SMauro Carvalho Chehab 1027ebd8b66SMauro Carvalho ChehabHere is a summary of the voltage pin mapping for the W83627THF. This 1037ebd8b66SMauro Carvalho Chehabcan be useful to convert data provided by board manufacturers into 1047ebd8b66SMauro Carvalho Chehabworking libsensors configuration statements: 1057ebd8b66SMauro Carvalho Chehab 1067ebd8b66SMauro Carvalho Chehab 1077ebd8b66SMauro Carvalho Chehab- W83627THF 1087ebd8b66SMauro Carvalho Chehab 1097ebd8b66SMauro Carvalho Chehab 1107ebd8b66SMauro Carvalho Chehab ======== =============== =============== =============== 1117ebd8b66SMauro Carvalho Chehab Pin Name Register Sysfs attribute 1127ebd8b66SMauro Carvalho Chehab ======== =============== =============== =============== 1137ebd8b66SMauro Carvalho Chehab 100 CPUVCORE 20h in0 1147ebd8b66SMauro Carvalho Chehab 99 VIN0 21h in1 1157ebd8b66SMauro Carvalho Chehab 98 VIN1 22h in2 1167ebd8b66SMauro Carvalho Chehab 97 VIN2 24h in4 1177ebd8b66SMauro Carvalho Chehab 114 AVCC 23h in3 1187ebd8b66SMauro Carvalho Chehab 61 5VSB 50h (bank 5) in7 1197ebd8b66SMauro Carvalho Chehab 74 VBAT 51h (bank 5) in8 1207ebd8b66SMauro Carvalho Chehab ======== =============== =============== =============== 1217ebd8b66SMauro Carvalho Chehab 1227ebd8b66SMauro Carvalho ChehabFor other supported devices, you'll have to take the hard path and 1237ebd8b66SMauro Carvalho Chehablook up the information in the datasheet yourself (and then add it 1247ebd8b66SMauro Carvalho Chehabto this document please.) 125