0001 Kernel driver w83627hf
0002 ======================
0003
0004 Supported chips:
0005 * Winbond W83627HF (ISA accesses ONLY)
0006 Prefix: 'w83627hf'
0007 Addresses scanned: ISA address retrieved from Super I/O registers
0008 * Winbond W83627THF
0009 Prefix: 'w83627thf'
0010 Addresses scanned: ISA address retrieved from Super I/O registers
0011 * Winbond W83697HF
0012 Prefix: 'w83697hf'
0013 Addresses scanned: ISA address retrieved from Super I/O registers
0014 * Winbond W83637HF
0015 Prefix: 'w83637hf'
0016 Addresses scanned: ISA address retrieved from Super I/O registers
0017 * Winbond W83687THF
0018 Prefix: 'w83687thf'
0019 Addresses scanned: ISA address retrieved from Super I/O registers
0020 Datasheet: Provided by Winbond on request(http://www.winbond.com/hq/enu)
0021
0022 Authors:
0023 Frodo Looijaard <frodol@dds.nl>,
0024 Philip Edelbrock <phil@netroedge.com>,
0025 Mark Studebaker <mdsxyz123@yahoo.com>,
0026 Bernhard C. Schrenk <clemy@clemy.org>
0027
0028 Module Parameters
0029 -----------------
0030
0031 * force_i2c: int
0032 Initialize the I2C address of the sensors
0033 * init: int
0034 (default is 1)
0035 Use 'init=0' to bypass initializing the chip.
0036 Try this if your computer crashes when you load the module.
0037
0038 Description
0039 -----------
0040
0041 This driver implements support for ISA accesses *only* for
0042 the Winbond W83627HF, W83627THF, W83697HF and W83637HF Super I/O chips.
0043 We will refer to them collectively as Winbond chips.
0044
0045 This driver supports ISA accesses, which should be more reliable
0046 than i2c accesses. Also, for Tyan boards which contain both a
0047 Super I/O chip and a second i2c-only Winbond chip (often a W83782D),
0048 using this driver will avoid i2c address conflicts and complex
0049 initialization that were required in the w83781d driver.
0050
0051 If you really want i2c accesses for these Super I/O chips,
0052 use the w83781d driver. However this is not the preferred method
0053 now that this ISA driver has been developed.
0054
0055 The `w83627_HF_` uses pins 110-106 as VID0-VID4. The `w83627_THF_` uses the
0056 same pins as GPIO[0:4]. Technically, the `w83627_THF_` does not support a
0057 VID reading. However the two chips have the identical 128 pin package. So,
0058 it is possible or even likely for a w83627thf to have the VID signals routed
0059 to these pins despite their not being labeled for that purpose. Therefore,
0060 the w83627thf driver interprets these as VID. If the VID on your board
0061 doesn't work, first see doc/vid in the lm_sensors package[1]. If that still
0062 doesn't help, you may just ignore the bogus VID reading with no harm done.
0063
0064 For further information on this driver see the w83781d driver documentation.
0065
0066 [1] http://www.lm-sensors.org/browser/lm-sensors/trunk/doc/vid
0067
0068 Forcing the address
0069 -------------------
0070
0071 The driver used to have a module parameter named force_addr, which could
0072 be used to force the base I/O address of the hardware monitoring block.
0073 This was meant as a workaround for mainboards with a broken BIOS. This
0074 module parameter is gone for technical reasons. If you need this feature,
0075 you can obtain the same result by using the isaset tool (part of
0076 lm-sensors) before loading the driver:
0077
0078 # Enter the Super I/O config space::
0079
0080 isaset -y -f 0x2e 0x87
0081 isaset -y -f 0x2e 0x87
0082
0083 # Select the hwmon logical device::
0084
0085 isaset -y 0x2e 0x2f 0x07 0x0b
0086
0087 # Set the base I/O address (to 0x290 in this example)::
0088
0089 isaset -y 0x2e 0x2f 0x60 0x02
0090 isaset -y 0x2e 0x2f 0x61 0x90
0091
0092 # Exit the Super-I/O config space::
0093
0094 isaset -y -f 0x2e 0xaa
0095
0096 The above sequence assumes a Super-I/O config space at 0x2e/0x2f, but
0097 0x4e/0x4f is also possible.
0098
0099 Voltage pin mapping
0100 -------------------
0101
0102 Here is a summary of the voltage pin mapping for the W83627THF. This
0103 can be useful to convert data provided by board manufacturers into
0104 working libsensors configuration statements:
0105
0106
0107 - W83627THF
0108
0109
0110 ======== =============== =============== ===============
0111 Pin Name Register Sysfs attribute
0112 ======== =============== =============== ===============
0113 100 CPUVCORE 20h in0
0114 99 VIN0 21h in1
0115 98 VIN1 22h in2
0116 97 VIN2 24h in4
0117 114 AVCC 23h in3
0118 61 5VSB 50h (bank 5) in7
0119 74 VBAT 51h (bank 5) in8
0120 ======== =============== =============== ===============
0121
0122 For other supported devices, you'll have to take the hard path and
0123 look up the information in the datasheet yourself (and then add it
0124 to this document please.)
