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