w83627hf.rst (4314B)
1Kernel driver w83627hf 2====================== 3 4Supported chips: 5 * Winbond W83627HF (ISA accesses ONLY) 6 Prefix: 'w83627hf' 7 Addresses scanned: ISA address retrieved from Super I/O registers 8 * Winbond W83627THF 9 Prefix: 'w83627thf' 10 Addresses scanned: ISA address retrieved from Super I/O registers 11 * Winbond W83697HF 12 Prefix: 'w83697hf' 13 Addresses scanned: ISA address retrieved from Super I/O registers 14 * Winbond W83637HF 15 Prefix: 'w83637hf' 16 Addresses scanned: ISA address retrieved from Super I/O registers 17 * Winbond W83687THF 18 Prefix: 'w83687thf' 19 Addresses scanned: ISA address retrieved from Super I/O registers 20 Datasheet: Provided by Winbond on request(http://www.winbond.com/hq/enu) 21 22Authors: 23 Frodo Looijaard <frodol@dds.nl>, 24 Philip Edelbrock <phil@netroedge.com>, 25 Mark Studebaker <mdsxyz123@yahoo.com>, 26 Bernhard C. Schrenk <clemy@clemy.org> 27 28Module Parameters 29----------------- 30 31* force_i2c: int 32 Initialize the I2C address of the sensors 33* init: int 34 (default is 1) 35 Use 'init=0' to bypass initializing the chip. 36 Try this if your computer crashes when you load the module. 37 38Description 39----------- 40 41This driver implements support for ISA accesses *only* for 42the Winbond W83627HF, W83627THF, W83697HF and W83637HF Super I/O chips. 43We will refer to them collectively as Winbond chips. 44 45This driver supports ISA accesses, which should be more reliable 46than i2c accesses. Also, for Tyan boards which contain both a 47Super I/O chip and a second i2c-only Winbond chip (often a W83782D), 48using this driver will avoid i2c address conflicts and complex 49initialization that were required in the w83781d driver. 50 51If you really want i2c accesses for these Super I/O chips, 52use the w83781d driver. However this is not the preferred method 53now that this ISA driver has been developed. 54 55The `w83627_HF_` uses pins 110-106 as VID0-VID4. The `w83627_THF_` uses the 56same pins as GPIO[0:4]. Technically, the `w83627_THF_` does not support a 57VID reading. However the two chips have the identical 128 pin package. So, 58it is possible or even likely for a w83627thf to have the VID signals routed 59to these pins despite their not being labeled for that purpose. Therefore, 60the w83627thf driver interprets these as VID. If the VID on your board 61doesn't work, first see doc/vid in the lm_sensors package[1]. If that still 62doesn't help, you may just ignore the bogus VID reading with no harm done. 63 64For further information on this driver see the w83781d driver documentation. 65 66[1] http://www.lm-sensors.org/browser/lm-sensors/trunk/doc/vid 67 68Forcing the address 69------------------- 70 71The driver used to have a module parameter named force_addr, which could 72be used to force the base I/O address of the hardware monitoring block. 73This was meant as a workaround for mainboards with a broken BIOS. This 74module parameter is gone for technical reasons. If you need this feature, 75you can obtain the same result by using the isaset tool (part of 76lm-sensors) before loading the driver: 77 78# Enter the Super I/O config space:: 79 80 isaset -y -f 0x2e 0x87 81 isaset -y -f 0x2e 0x87 82 83# Select the hwmon logical device:: 84 85 isaset -y 0x2e 0x2f 0x07 0x0b 86 87# Set the base I/O address (to 0x290 in this example):: 88 89 isaset -y 0x2e 0x2f 0x60 0x02 90 isaset -y 0x2e 0x2f 0x61 0x90 91 92# Exit the Super-I/O config space:: 93 94 isaset -y -f 0x2e 0xaa 95 96The above sequence assumes a Super-I/O config space at 0x2e/0x2f, but 970x4e/0x4f is also possible. 98 99Voltage pin mapping 100------------------- 101 102Here is a summary of the voltage pin mapping for the W83627THF. This 103can be useful to convert data provided by board manufacturers into 104working libsensors configuration statements: 105 106 107- W83627THF 108 109 110 ======== =============== =============== =============== 111 Pin Name Register Sysfs attribute 112 ======== =============== =============== =============== 113 100 CPUVCORE 20h in0 114 99 VIN0 21h in1 115 98 VIN1 22h in2 116 97 VIN2 24h in4 117 114 AVCC 23h in3 118 61 5VSB 50h (bank 5) in7 119 74 VBAT 51h (bank 5) in8 120 ======== =============== =============== =============== 121 122For other supported devices, you'll have to take the hard path and 123look up the information in the datasheet yourself (and then add it 124to this document please.)