diff options
author | Steven Whitehouse <swhiteho@redhat.com> | 2006-07-03 10:25:08 -0400 |
---|---|---|
committer | Steven Whitehouse <swhiteho@redhat.com> | 2006-07-03 10:25:08 -0400 |
commit | 0a1340c185734a57fbf4775927966ad4a1347b02 (patch) | |
tree | d9ed8f0dd809a7c542a3356601125ea5b5aaa804 /Documentation/hwmon/w83791d | |
parent | af18ddb8864b096e3ed4732e2d4b21c956dcfe3a (diff) | |
parent | 29454dde27d8e340bb1987bad9aa504af7081eba (diff) |
Merge rsync://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6
Conflicts:
include/linux/kernel.h
Diffstat (limited to 'Documentation/hwmon/w83791d')
-rw-r--r-- | Documentation/hwmon/w83791d | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d new file mode 100644 index 000000000000..83a3836289c2 --- /dev/null +++ b/Documentation/hwmon/w83791d | |||
@@ -0,0 +1,113 @@ | |||
1 | Kernel driver w83791d | ||
2 | ===================== | ||
3 | |||
4 | Supported chips: | ||
5 | * Winbond W83791D | ||
6 | Prefix: 'w83791d' | ||
7 | Addresses scanned: I2C 0x2c - 0x2f | ||
8 | Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83791Da.pdf | ||
9 | |||
10 | Author: Charles Spirakis <bezaur@gmail.com> | ||
11 | |||
12 | This driver was derived from the w83781d.c and w83792d.c source files. | ||
13 | |||
14 | Credits: | ||
15 | w83781d.c: | ||
16 | Frodo Looijaard <frodol@dds.nl>, | ||
17 | Philip Edelbrock <phil@netroedge.com>, | ||
18 | and Mark Studebaker <mdsxyz123@yahoo.com> | ||
19 | w83792d.c: | ||
20 | Chunhao Huang <DZShen@Winbond.com.tw>, | ||
21 | Rudolf Marek <r.marek@sh.cvut.cz> | ||
22 | |||
23 | Module Parameters | ||
24 | ----------------- | ||
25 | |||
26 | * init boolean | ||
27 | (default 0) | ||
28 | Use 'init=1' to have the driver do extra software initializations. | ||
29 | The default behavior is to do the minimum initialization possible | ||
30 | and depend on the BIOS to properly setup the chip. If you know you | ||
31 | have a w83791d and you're having problems, try init=1 before trying | ||
32 | reset=1. | ||
33 | |||
34 | * reset boolean | ||
35 | (default 0) | ||
36 | Use 'reset=1' to reset the chip (via index 0x40, bit 7). The default | ||
37 | behavior is no chip reset to preserve BIOS settings. | ||
38 | |||
39 | * force_subclients=bus,caddr,saddr,saddr | ||
40 | This is used to force the i2c addresses for subclients of | ||
41 | a certain chip. Example usage is `force_subclients=0,0x2f,0x4a,0x4b' | ||
42 | to force the subclients of chip 0x2f on bus 0 to i2c addresses | ||
43 | 0x4a and 0x4b. | ||
44 | |||
45 | |||
46 | Description | ||
47 | ----------- | ||
48 | |||
49 | This driver implements support for the Winbond W83791D chip. | ||
50 | |||
51 | Detection of the chip can sometimes be foiled because it can be in an | ||
52 | internal state that allows no clean access (Bank with ID register is not | ||
53 | currently selected). If you know the address of the chip, use a 'force' | ||
54 | parameter; this will put it into a more well-behaved state first. | ||
55 | |||
56 | The driver implements three temperature sensors, five fan rotation speed | ||
57 | sensors, and ten voltage sensors. | ||
58 | |||
59 | Temperatures are measured in degrees Celsius and measurement resolution is 1 | ||
60 | degC for temp1 and 0.5 degC for temp2 and temp3. An alarm is triggered when | ||
61 | the temperature gets higher than the Overtemperature Shutdown value; it stays | ||
62 | on until the temperature falls below the Hysteresis value. | ||
63 | |||
64 | Fan rotation speeds are reported in RPM (rotations per minute). An alarm is | ||
65 | triggered if the rotation speed has dropped below a programmable limit. Fan | ||
66 | readings can be divided by a programmable divider (1, 2, 4, 8 for fan 1/2/3 | ||
67 | and 1, 2, 4, 8, 16, 32, 64 or 128 for fan 4/5) to give the readings more | ||
68 | range or accuracy. | ||
69 | |||
70 | Voltage sensors (also known as IN sensors) report their values in millivolts. | ||
71 | An alarm is triggered if the voltage has crossed a programmable minimum | ||
72 | or maximum limit. | ||
73 | |||
74 | Alarms are provided as output from a "realtime status register". The | ||
75 | following bits are defined: | ||
76 | |||
77 | bit - alarm on: | ||
78 | 0 - Vcore | ||
79 | 1 - VINR0 | ||
80 | 2 - +3.3VIN | ||
81 | 3 - 5VDD | ||
82 | 4 - temp1 | ||
83 | 5 - temp2 | ||
84 | 6 - fan1 | ||
85 | 7 - fan2 | ||
86 | 8 - +12VIN | ||
87 | 9 - -12VIN | ||
88 | 10 - -5VIN | ||
89 | 11 - fan3 | ||
90 | 12 - chassis | ||
91 | 13 - temp3 | ||
92 | 14 - VINR1 | ||
93 | 15 - reserved | ||
94 | 16 - tart1 | ||
95 | 17 - tart2 | ||
96 | 18 - tart3 | ||
97 | 19 - VSB | ||
98 | 20 - VBAT | ||
99 | 21 - fan4 | ||
100 | 22 - fan5 | ||
101 | 23 - reserved | ||
102 | |||
103 | When an alarm goes off, you can be warned by a beeping signal through your | ||
104 | computer speaker. It is possible to enable all beeping globally, or only | ||
105 | the beeping for some alarms. | ||
106 | |||
107 | The driver only reads the chip values each 3 seconds; reading them more | ||
108 | often will do no harm, but will return 'old' values. | ||
109 | |||
110 | W83791D TODO: | ||
111 | --------------- | ||
112 | Provide a patch for per-file alarms as discussed on the mailing list | ||
113 | Provide a patch for smart-fan control (still need appropriate motherboard/fans) | ||