aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@woody.linux-foundation.org>2007-02-19 16:36:16 -0500
committerLinus Torvalds <torvalds@woody.linux-foundation.org>2007-02-19 16:36:16 -0500
commit42eaf0d8f2e7b8201afc00b0ebe1bd89ea51d42d (patch)
treea2c92841628fb7cf63a0df9ec6e7e4c8b8acdd19 /Documentation
parent4935361766cc73949fe032cd157d314f288922ba (diff)
parent2219cd81a6cd186200606693b360c6429c003bb3 (diff)
Merge branch 'hwmon-for-linus' of git://jdelvare.pck.nerim.net/jdelvare-2.6
* 'hwmon-for-linus' of git://jdelvare.pck.nerim.net/jdelvare-2.6: hwmon/vt1211: Add probing of alternate config index port hwmon/f71805f: Fix a race condition hwmon/abituguru: Fix unchecked return status hwmon: New driver for the Analog Devices ADM1029 hwmon/w83627ehf: Add support for the W83627DHG chip hwmon: Use subsys_initcall hwmon/lm70: Make lm70_remove a __devexit function hwmon: Cleanup a bogus legacy comment hwmon: Simplify the locking model of two drivers hwmon: Drop unused mutexes in two drivers hwmon/it87: Add PWM base frequency control
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/hwmon/it8710
-rw-r--r--Documentation/hwmon/sysfs-interface15
-rw-r--r--Documentation/hwmon/w83627ehf54
3 files changed, 67 insertions, 12 deletions
diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87
index 74a80992d237..c0528d6f9ace 100644
--- a/Documentation/hwmon/it87
+++ b/Documentation/hwmon/it87
@@ -135,6 +135,16 @@ Give 0 for unused sensor. Any other value is invalid. To configure this at
135startup, consult lm_sensors's /etc/sensors.conf. (2 = thermistor; 135startup, consult lm_sensors's /etc/sensors.conf. (2 = thermistor;
1363 = thermal diode) 1363 = thermal diode)
137 137
138
139Fan speed control
140-----------------
141
138The fan speed control features are limited to manual PWM mode. Automatic 142The fan speed control features are limited to manual PWM mode. Automatic
139"Smart Guardian" mode control handling is not implemented. However 143"Smart Guardian" mode control handling is not implemented. However
140if you want to go for "manual mode" just write 1 to pwmN_enable. 144if you want to go for "manual mode" just write 1 to pwmN_enable.
145
146If you are only able to control the fan speed with very small PWM values,
147try lowering the PWM base frequency (pwm1_freq). Depending on the fan,
148it may give you a somewhat greater control range. The same frequency is
149used to drive all fan outputs, which is why pwm2_freq and pwm3_freq are
150read-only.
diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface
index efef3b962cd3..d73d2e8c7534 100644
--- a/Documentation/hwmon/sysfs-interface
+++ b/Documentation/hwmon/sysfs-interface
@@ -166,16 +166,21 @@ pwm[1-*] Pulse width modulation fan control.
166 166
167pwm[1-*]_enable 167pwm[1-*]_enable
168 Switch PWM on and off. 168 Switch PWM on and off.
169 Not always present even if fan*_pwm is. 169 Not always present even if pwmN is.
170 0: turn off 170 0: turn off
171 1: turn on in manual mode 171 1: turn on in manual mode
172 2+: turn on in automatic mode 172 2+: turn on in automatic mode
173 Check individual chip documentation files for automatic mode details. 173 Check individual chip documentation files for automatic mode
174 details.
174 RW 175 RW
175 176
176pwm[1-*]_mode 177pwm[1-*]_mode 0: DC mode (direct current)
177 0: DC mode 178 1: PWM mode (pulse-width modulation)
178 1: PWM mode 179 RW
180
181pwm[1-*]_freq Base PWM frequency in Hz.
182 Only possibly available when pwmN_mode is PWM, but not always
183 present even then.
179 RW 184 RW
180 185
181pwm[1-*]_auto_channels_temp 186pwm[1-*]_auto_channels_temp
diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf
index 8a15a7408753..030fac6cec7a 100644
--- a/Documentation/hwmon/w83627ehf
+++ b/Documentation/hwmon/w83627ehf
@@ -2,26 +2,29 @@ Kernel driver w83627ehf
2======================= 2=======================
3 3
4Supported chips: 4Supported chips:
5 * Winbond W83627EHF/EHG (ISA access ONLY) 5 * Winbond W83627EHF/EHG/DHG (ISA access ONLY)
6 Prefix: 'w83627ehf' 6 Prefix: 'w83627ehf'
7 Addresses scanned: ISA address retrieved from Super I/O registers 7 Addresses scanned: ISA address retrieved from Super I/O registers
8 Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83627EHF_%20W83627EHGb.pdf 8 Datasheet:
9 http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83627EHF_%20W83627EHGb.pdf
10 DHG datasheet confidential.
9 11
10Authors: 12Authors:
11 Jean Delvare <khali@linux-fr.org> 13 Jean Delvare <khali@linux-fr.org>
12 Yuan Mu (Winbond) 14 Yuan Mu (Winbond)
13 Rudolf Marek <r.marek@assembler.cz> 15 Rudolf Marek <r.marek@assembler.cz>
16 David Hubbard <david.c.hubbard@gmail.com>
14 17
15Description 18Description
16----------- 19-----------
17 20
18This driver implements support for the Winbond W83627EHF and W83627EHG 21This driver implements support for the Winbond W83627EHF, W83627EHG, and
19super I/O chips. We will refer to them collectively as Winbond chips. 22W83627DHG super I/O chips. We will refer to them collectively as Winbond chips.
20 23
21The chips implement three temperature sensors, five fan rotation 24The chips implement three temperature sensors, five fan rotation
22speed sensors, ten analog voltage sensors, alarms with beep warnings (control 25speed sensors, ten analog voltage sensors (only nine for the 627DHG), alarms
23unimplemented), and some automatic fan regulation strategies (plus manual 26with beep warnings (control unimplemented), and some automatic fan regulation
24fan control mode). 27strategies (plus manual fan control mode).
25 28
26Temperatures are measured in degrees Celsius and measurement resolution is 1 29Temperatures are measured in degrees Celsius and measurement resolution is 1
27degC for temp1 and 0.5 degC for temp2 and temp3. An alarm is triggered when 30degC for temp1 and 0.5 degC for temp2 and temp3. An alarm is triggered when
@@ -55,6 +58,9 @@ prog -> pwm4 (the programmable setting is not supported by the driver)
55/sys files 58/sys files
56---------- 59----------
57 60
61name - this is a standard hwmon device entry. For the W83627EHF and W83627EHG,
62 it is set to "w83627ehf" and for the W83627DHG it is set to "w83627dhg"
63
58pwm[1-4] - this file stores PWM duty cycle or DC value (fan speed) in range: 64pwm[1-4] - this file stores PWM duty cycle or DC value (fan speed) in range:
59 0 (stop) to 255 (full) 65 0 (stop) to 255 (full)
60 66
@@ -83,3 +89,37 @@ pwm[1-4]_stop_time - how many milliseconds [ms] must elapse to switch
83 89
84Note: last two functions are influenced by other control bits, not yet exported 90Note: last two functions are influenced by other control bits, not yet exported
85 by the driver, so a change might not have any effect. 91 by the driver, so a change might not have any effect.
92
93Implementation Details
94----------------------
95
96Future driver development should bear in mind that the following registers have
97different functions on the 627EHF and the 627DHG. Some registers also have
98different power-on default values, but BIOS should already be loading
99appropriate defaults. Note that bank selection must be performed as is currently
100done in the driver for all register addresses.
101
1020x49: only on DHG, selects temperature source for AUX fan, CPU fan0
1030x4a: not completely documented for the EHF and the DHG documentation assigns
104 different behavior to bits 7 and 6, including extending the temperature
105 input selection to SmartFan I, not just SmartFan III. Testing on the EHF
106 will reveal whether they are compatible or not.
107
1080x58: Chip ID: 0xa1=EHF 0xc1=DHG
1090x5e: only on DHG, has bits to enable "current mode" temperature detection and
110 critical temperature protection
1110x45b: only on EHF, bit 3, vin4 alarm (EHF supports 10 inputs, only 9 on DHG)
1120x552: only on EHF, vin4
1130x558: only on EHF, vin4 high limit
1140x559: only on EHF, vin4 low limit
1150x6b: only on DHG, SYS fan critical temperature
1160x6c: only on DHG, CPU fan0 critical temperature
1170x6d: only on DHG, AUX fan critical temperature
1180x6e: only on DHG, CPU fan1 critical temperature
119
1200x50-0x55 and 0x650-0x657 are marked "Test Register" for the EHF, but "Reserved
121 Register" for the DHG
122
123The DHG also supports PECI, where the DHG queries Intel CPU temperatures, and
124the ICH8 southbridge gets that data via PECI from the DHG, so that the
125southbridge drives the fans. And the DHG supports SST, a one-wire serial bus.