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