]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - Documentation/hwmon/w83627hf
Merge git://git.kernel.org/pub/scm/linux/kernel/git/herbert/crypto-2.6
[mirror_ubuntu-artful-kernel.git] / Documentation / hwmon / w83627hf
CommitLineData
7f15b664
RM
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
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
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
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
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
5b319400
MH
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.
7f15b664 63
5b319400
MH
64For 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
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
79isaset -y -f 0x2e 0x87
80isaset -y -f 0x2e 0x87
81
82# Select the hwmon logical device
83isaset -y 0x2e 0x2f 0x07 0x0b
84
85# Set the base I/O address (to 0x290 in this example)
86isaset -y 0x2e 0x2f 0x60 0x02
87isaset -y 0x2e 0x2f 0x61 0x90
88
89# Exit the Super-I/O config space
90isaset -y -f 0x2e 0xaa
91
92The above sequence assumes a Super-I/O config space at 0x2e/0x2f, but
930x4e/0x4f is also possible.
3ea1bd58
JD
94
95Voltage pin mapping
96-------------------
97
98Here is a summary of the voltage pin mapping for the W83627THF. This
99can be useful to convert data provided by board manufacturers into
100working 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
113For other supported devices, you'll have to take the hard path and
114look up the information in the datasheet yourself (and then add it
115to this document please.)