root/lm-sensors/trunk/doc/chips/w83781d @ 738

Revision 738, 31.3 KB (checked in by frodo, 13 years ago)

Changed email address lm78@... to sensors@...

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1Kernel driver `w83781d.o'
2=========================
3
4Status: W83781D support is complete and well-tested, others are mostly complete
5        and somewhat tested.
6
7Supported chips:
8  * Winbond W83781D
9    Prefix 'w83781d'
10    Addresses scanned: I2C 0x20 - 0x2f (inclusive), ISA 0x290 (8 I/O ports)
11    Datasheet: Publicly available at the Winbond website
12  * Winbond W83782D
13    Prefix 'w83782d'
14    Addresses scanned: I2C 0x20 - 0x2f (inclusive), ISA 0x290 (8 I/O ports)
15    Datasheet: Publicly available at the Winbond website
16  * Winbond W83783S
17    Prefix 'w83783s'
18    Addresses scanned: I2C 0x20 - 0x2f (inclusive)
19    Datasheet: Publicly available at the Winbond website
20  * Winbond W83627HF
21    Prefix 'w83627hf'
22    Addresses scanned: I2C 0x20 - 0x2f (inclusive), ISA 0x290 (8 I/O ports)
23    Datasheet: Unavailable from Winbond
24  * Asus AS99127F
25    Prefix 'as99127f'
26    Addresses scanned: I2C 0x20 - 0x2f (inclusive)
27    Datasheet: Unavailable from Asus
28
29
30Author: Frodo Looijaard <frodol@dds.nl>, Philip Edelbrock <phil@netroedge.com>,
31        and Mark Studebaker <mdsxyz123@yahoo.com>
32
33
34Module Parameters
35-----------------
36
37* force: short array (min = 1, max = 48)
38  List of adapter,address pairs to boldly assume to be present
39* force_w83781d: short array (min = 1, max = 48)
40  List of adapter,address pairs which are unquestionably assumed to contain
41  a `w83781d' chip
42* force_w83782d: short array (min = 1, max = 48)
43  List of adapter,address pairs which are unquestionably assumed to contain
44  a `w83782d' chip
45* force_w83783s: short array (min = 1, max = 48)
46  List of adapter,address pairs which are unquestionably assumed to contain
47  a `w83783s' chip
48* ignore: short array (min = 1, max = 48)
49  List of adapter,address pairs not to scan
50* ignore_range: short array (min = 1, max = 48)
51  List of adapter,start-addr,end-addr triples not to scan
52* probe: short array (min = 1, max = 48)
53  List of adapter,address pairs to scan additionally
54* probe_range: short array (min = 1, max = 48)
55  List of adapter,start-addr,end-addr triples to scan additionally
56
57
58Description
59-----------
60
61This driver implements support for the Winbond W83781D, W83782D,
62W8783S, and W83627HF chips, and the Asus AS99127F.
63We will refer to them collectively as W8378* chips.
64
65There is quite some difference between these chips, but they are similar
66enough that it was sensible to put them together in one driver.
67The W83627HF chip is assumed to be identical to the W83782D.
68The AS99127F chip is assumed to be identical to an I2C-only W83782D.
69
70Detection of these chips can sometimes be foiled because they can be in
71an internal state that allows no clean access. If you know the address
72of the chip, use a 'force' parameter; this will put them into a more
73well-behaved state first.
74
75The W8378* implements temperature sensors (three on the W83781D and W83782D,
76two on the W83783S), three FAN rotation speed sensors, voltage sensors
77(seven on the W83781D, nine on the W83782D and six on the W83783S), VID
78lines, alarms with beep warnings, and some miscellaneous stuff.
79
80Temperatures are measured in degrees Celcius. There is always one main
81temperature sensor, and one (W83783S) or two (W83781D and W83782D) other
82sensors.  An alarm is triggered for the main sensor once when the
83Overtemperature Shutdown limit is crossed; it is triggered again as soon as
84it drops below the Hysteresis value. A more useful behaviour
85can be found by setting the Hysteresis value to +127 degrees Celcius; in
86this case, alarms are issued during all the time when the actual temperature
87is above the Overtemperature Shutdown value. For the other sensor(s), an
88alarm is triggered when the temperature gets higher then the Overtemperature
89Shutdown value; it stays on until the temperature falls below the Hysteresis
90value. But on the W83781D, there is only one alarm that functions for both
91other sensors!  Temperatures are guaranteed within a range of -55 to +125
92degrees. The main temperature sensors has a resolution of 1 degree; the other
93sensor(s) of 0.5 degree.
94
95FAN rotation speeds are reported in RPM (rotations per minute). An alarm is
96triggered if the rotation speed has dropped below a programmable limit. FAN
97readings can be divided by a programmable divider (1, 2, 4 or 8 for the
98W83781D; 1, 2, 4, 8, 16, 32, 64 or 128 for the W83782D and W83783S) to give
99the readings more range or accuracy. This is important because some FANs
100report only one 'tick' each rotation, while others report two - making
101all readings twice as high. Not all RPM values can accurately be represented,
102so some rounding is done. With a divider of 2, the lowest representable
103value is around 2600 RPM.
104
105Voltage sensors (also known as IN sensors) report their values in volts.
106An alarm is triggered if the voltage has crossed a programmable minimum
107or maximum limit. Note that minimum in this case always means 'closest to
108zero'; this is important for negative voltage measurements. All voltage
109inputs can measure voltages between 0 and 4.08 volts, with a resolution
110of 0.016 volt.
111
112The VID lines encode the core voltage value: the voltage level your processor
113should work with. This is hardcoded by the mainboard and/or processor itself.
114It is a value in volts. When it is unconnected, you will often find the
115value 3.50 V here.
116
117The W83782D and W83783S temperature conversion machine understands about
118several kinds of temperature probes. You can program the so-called
119beta value in the sensor files. '1' is the PII/Celeron diode, '2' is the
120TN3904 transistor, and 3435 the default thermistor value. Other values
121are (not yet) supported. You can program your own values through the
122rt interface, but this is not very useful, because these tables are
123under NDA.
124
125In addition to the alarms described above, there is a CHAS alarm on the
126W83781D and W83782D which triggers if your computer case is open.
127
128When an alarm goes off, you can be warned by a beeping signal through
129your computer speaker. It is possible to enable all beeping globally,
130or only the beeping for some alarms.
131
132If an alarm triggers, it will remain triggered until the hardware register
133is read at least once. This means that the cause for the alarm may
134already have disappeared!  Note that in the current implementation, all
135hardware registers are read whenever any data is read (unless it is less
136than 1.5 seconds since the last update). This means that you can easily
137miss once-only alarms.
138
139The W8378* only updates its values each 1.5 seconds; reading it more often
140will do no harm, but will return 'old' values.
141
142
143AS99127F PROBLEMS
144-----------------
145The as99127f support was developed without the benefit of a datasheet.
146In most cases it is treated as a w83782d.
147Known problems:
148        - Fans read about 30% low.
149        - -12V readings a little high (-9.5V to -10.5V)
150        - Problems with diode/thermistor settings (supported?)
151
152These will not be fixed unless we get a datasheet.
153
154
155Chip Features
156-------------
157
158Chip `w83781d'
159             LABEL        LABEL CLASS      COMPUTE CLASS ACCESS MAGNITUDE
160               in0               NONE               NONE     R     2
161               in1               NONE               NONE     R     2
162               in2               NONE               NONE     R     2
163               in3               NONE               NONE     R     2
164               in4               NONE               NONE     R     2
165               in5               NONE               NONE     R     2
166               in6               NONE               NONE     R     2
167           in0_min                in0                in0     RW    2
168           in1_min                in1                in1     RW    2
169           in2_min                in2                in2     RW    2
170           in3_min                in3                in3     RW    2
171           in4_min                in4                in4     RW    2
172           in5_min                in5                in5     RW    2
173           in6_min                in6                in6     RW    2
174           in0_max                in0                in0     RW    2
175           in1_max                in1                in1     RW    2
176           in2_max                in2                in2     RW    2
177           in3_max                in3                in3     RW    2
178           in4_max                in4                in4     RW    2
179           in5_max                in5                in5     RW    2
180           in6_max                in6                in6     RW    2
181              fan1               NONE               NONE     R     0
182              fan2               NONE               NONE     R     0
183              fan3               NONE               NONE     R     0
184          fan1_min               fan1               NONE     RW    0
185          fan2_min               fan2               NONE     RW    0
186          fan3_min               fan3               NONE     RW    0
187             temp1               NONE               NONE     R     1
188        temp1_hyst              temp1              temp1     RW    1
189        temp1_over              temp1              temp1     RW    1
190             temp2               NONE               NONE     R     1
191        temp2_hyst              temp2              temp2     RW    1
192        temp2_over              temp2              temp2     RW    1
193             temp3               NONE               NONE     R     1
194        temp3_hyst              temp3              temp3     RW    1
195        temp3_over              temp3              temp3     RW    1
196               vid               NONE               NONE     R     2
197          fan1_div               fan1               NONE     RW    0
198          fan2_div               fan2               NONE     RW    0
199          fan3_div               fan3               NONE     R     0
200            alarms               NONE               NONE     R     0
201       beep_enable             alarms               NONE     RW    0
202             beeps             alarms             alarms     RW    0
203
204             LABEL                          FEATURE SYMBOL        SYSCTL FILE:NR
205               in0                     SENSORS_W83781D_IN0                in0:3
206               in1                     SENSORS_W83781D_IN1                in1:3
207               in2                     SENSORS_W83781D_IN2                in2:3
208               in3                     SENSORS_W83781D_IN3                in3:3
209               in4                     SENSORS_W83781D_IN4                in4:3
210               in5                     SENSORS_W83781D_IN5                in5:3
211               in6                     SENSORS_W83781D_IN6                in6:3
212           in0_min                 SENSORS_W83781D_IN0_MIN                in0:1
213           in1_min                 SENSORS_W83781D_IN1_MIN                in1:1
214           in2_min                 SENSORS_W83781D_IN2_MIN                in2:1
215           in3_min                 SENSORS_W83781D_IN3_MIN                in3:1
216           in4_min                 SENSORS_W83781D_IN4_MIN                in4:1
217           in5_min                 SENSORS_W83781D_IN5_MIN                in5:1
218           in6_min                 SENSORS_W83781D_IN6_MIN                in6:1
219           in0_max                 SENSORS_W83781D_IN0_MAX                in0:2
220           in1_max                 SENSORS_W83781D_IN1_MAX                in1:2
221           in2_max                 SENSORS_W83781D_IN2_MAX                in2:2
222           in3_max                 SENSORS_W83781D_IN3_MAX                in3:2
223           in4_max                 SENSORS_W83781D_IN4_MAX                in4:2
224           in5_max                 SENSORS_W83781D_IN5_MAX                in5:2
225           in6_max                 SENSORS_W83781D_IN6_MAX                in6:2
226              fan1                    SENSORS_W83781D_FAN1               fan1:2
227              fan2                    SENSORS_W83781D_FAN2               fan2:2
228              fan3                    SENSORS_W83781D_FAN3               fan3:2
229          fan1_min                SENSORS_W83781D_FAN1_MIN               fan1:1
230          fan2_min                SENSORS_W83781D_FAN2_MIN               fan2:1
231          fan3_min                SENSORS_W83781D_FAN3_MIN               fan3:1
232             temp1                   SENSORS_W83781D_TEMP1              temp1:3
233        temp1_hyst              SENSORS_W83781D_TEMP1_HYST              temp1:2
234        temp1_over              SENSORS_W83781D_TEMP1_OVER              temp1:1
235             temp2                   SENSORS_W83781D_TEMP2              temp2:3
236        temp2_hyst              SENSORS_W83781D_TEMP2_HYST              temp2:2
237        temp2_over              SENSORS_W83781D_TEMP2_OVER              temp2:1
238             temp3                   SENSORS_W83781D_TEMP3              temp3:3
239        temp3_hyst              SENSORS_W83781D_TEMP3_HYST              temp3:2
240        temp3_over              SENSORS_W83781D_TEMP3_OVER              temp3:1
241               vid                     SENSORS_W83781D_VID                vid:1
242          fan1_div                SENSORS_W83781D_FAN1_DIV            fan_div:1
243          fan2_div                SENSORS_W83781D_FAN2_DIV            fan_div:2
244          fan3_div                SENSORS_W83781D_FAN3_DIV            fan_div:3
245            alarms                  SENSORS_W83781D_ALARMS             alarms:1
246       beep_enable             SENSORS_W83781D_BEEP_ENABLE               beep:1
247             beeps                   SENSORS_W83781D_BEEPS               beep:2
248
249
250Chip `w83782d'
251             LABEL        LABEL CLASS      COMPUTE CLASS ACCESS MAGNITUDE
252               in0               NONE               NONE     R     2
253               in1               NONE               NONE     R     2
254               in2               NONE               NONE     R     2
255               in3               NONE               NONE     R     2
256               in4               NONE               NONE     R     2
257               in5               NONE               NONE     R     2
258               in6               NONE               NONE     R     2
259               in7               NONE               NONE     R     2
260               in8               NONE               NONE     R     2
261           in0_min                in0                in0     RW    2
262           in1_min                in1                in1     RW    2
263           in2_min                in2                in2     RW    2
264           in3_min                in3                in3     RW    2
265           in4_min                in4                in4     RW    2
266           in5_min                in5                in5     RW    2
267           in6_min                in6                in6     RW    2
268           in7_min                in7                in7     RW    2
269           in8_min                in8                in8     RW    2
270           in0_max                in0                in0     RW    2
271           in1_max                in1                in1     RW    2
272           in2_max                in2                in2     RW    2
273           in3_max                in3                in3     RW    2
274           in4_max                in4                in4     RW    2
275           in5_max                in5                in5     RW    2
276           in6_max                in6                in6     RW    2
277           in7_max                in7                in7     RW    2
278           in8_max                in8                in8     RW    2
279              fan1               NONE               NONE     R     0
280              fan2               NONE               NONE     R     0
281              fan3               NONE               NONE     R     0
282          fan1_min               fan1               NONE     RW    0
283          fan2_min               fan2               NONE     RW    0
284          fan3_min               fan3               NONE     RW    0
285             temp1               NONE               NONE     R     1
286        temp1_hyst              temp1              temp1     RW    1
287        temp1_over              temp1              temp1     RW    1
288             temp2               NONE               NONE     R     1
289        temp2_hyst              temp2              temp2     RW    1
290        temp2_over              temp2              temp2     RW    1
291             temp3               NONE               NONE     R     1
292        temp3_hyst              temp3              temp3     RW    1
293        temp3_over              temp3              temp3     RW    1
294               vid               NONE               NONE     R     2
295          fan1_div               fan1               NONE     RW    0
296          fan2_div               fan2               NONE     RW    0
297          fan3_div               fan3               NONE     R     0
298            alarms               NONE               NONE     R     0
299       beep_enable             alarms               NONE     RW    0
300             beeps             alarms             alarms     RW    0
301           sensor1               NONE               NONE     RW    0
302           sensor2               NONE               NONE     RW    0
303           sensor3               NONE               NONE     RW    0
304
305             LABEL                          FEATURE SYMBOL        SYSCTL FILE:NR
306               in0                     SENSORS_W83782D_IN0                in0:3
307               in1                     SENSORS_W83782D_IN1                in1:3
308               in2                     SENSORS_W83782D_IN2                in2:3
309               in3                     SENSORS_W83782D_IN3                in3:3
310               in4                     SENSORS_W83782D_IN4                in4:3
311               in5                     SENSORS_W83782D_IN5                in5:3
312               in6                     SENSORS_W83782D_IN6                in6:3
313               in7                     SENSORS_W83782D_IN7                in7:3
314               in8                     SENSORS_W83782D_IN8                in8:3
315           in0_min                 SENSORS_W83782D_IN0_MIN                in0:1
316           in1_min                 SENSORS_W83782D_IN1_MIN                in1:1
317           in2_min                 SENSORS_W83782D_IN2_MIN                in2:1
318           in3_min                 SENSORS_W83782D_IN3_MIN                in3:1
319           in4_min                 SENSORS_W83782D_IN4_MIN                in4:1
320           in5_min                 SENSORS_W83782D_IN5_MIN                in5:1
321           in6_min                 SENSORS_W83782D_IN6_MIN                in6:1
322           in7_min                 SENSORS_W83782D_IN7_MIN                in7:1
323           in8_min                 SENSORS_W83782D_IN8_MIN                in8:1
324           in0_max                 SENSORS_W83782D_IN0_MAX                in0:2
325           in1_max                 SENSORS_W83782D_IN1_MAX                in1:2
326           in2_max                 SENSORS_W83782D_IN2_MAX                in2:2
327           in3_max                 SENSORS_W83782D_IN3_MAX                in3:2
328           in4_max                 SENSORS_W83782D_IN4_MAX                in4:2
329           in5_max                 SENSORS_W83782D_IN5_MAX                in5:2
330           in6_max                 SENSORS_W83782D_IN6_MAX                in6:2
331           in7_max                 SENSORS_W83782D_IN7_MAX                in7:2
332           in8_max                 SENSORS_W83782D_IN8_MAX                in8:2
333              fan1                    SENSORS_W83782D_FAN1               fan1:2
334              fan2                    SENSORS_W83782D_FAN2               fan2:2
335              fan3                    SENSORS_W83781D_FAN3               fan3:2
336          fan1_min                SENSORS_W83782D_FAN1_MIN               fan1:1
337          fan2_min                SENSORS_W83782D_FAN2_MIN               fan2:1
338          fan3_min                SENSORS_W83781D_FAN3_MIN               fan3:1
339             temp1                   SENSORS_W83782D_TEMP1              temp1:3
340        temp1_hyst              SENSORS_W83782D_TEMP1_HYST              temp1:2
341        temp1_over              SENSORS_W83782D_TEMP1_OVER              temp1:1
342             temp2                   SENSORS_W83782D_TEMP2              temp2:3
343        temp2_hyst              SENSORS_W83782D_TEMP2_HYST              temp2:2
344        temp2_over              SENSORS_W83782D_TEMP2_OVER              temp2:1
345             temp3                   SENSORS_W83782D_TEMP3              temp3:3
346        temp3_hyst              SENSORS_W83782D_TEMP3_HYST              temp3:2
347        temp3_over              SENSORS_W83782D_TEMP3_OVER              temp3:1
348               vid                     SENSORS_W83782D_VID                vid:1
349          fan1_div                SENSORS_W83782D_FAN1_DIV            fan_div:1
350          fan2_div                SENSORS_W83782D_FAN2_DIV            fan_div:2
351          fan3_div                SENSORS_W83781D_FAN3_DIV            fan_div:3
352            alarms                  SENSORS_W83782D_ALARMS             alarms:1
353       beep_enable             SENSORS_W83782D_BEEP_ENABLE               beep:1
354             beeps                   SENSORS_W83782D_BEEPS               beep:2
355           sensor1                   SENSORS_W83782D_SENS1            sensor1:1
356           sensor2                   SENSORS_W83782D_SENS2            sensor2:1
357           sensor3                   SENSORS_W83782D_SENS3            sensor3:1
358
359
360Chip `w83783s'
361             LABEL        LABEL CLASS      COMPUTE CLASS ACCESS MAGNITUDE
362               in0               NONE               NONE     R     2
363               in1               NONE               NONE     R     2
364               in2               NONE               NONE     R     2
365               in3               NONE               NONE     R     2
366               in4               NONE               NONE     R     2
367               in5               NONE               NONE     R     2
368               in6               NONE               NONE     R     2
369           in0_min                in0                in0     RW    2
370           in1_min                in1                in1     RW    2
371           in2_min                in2                in2     RW    2
372           in3_min                in3                in3     RW    2
373           in4_min                in4                in4     RW    2
374           in5_min                in5                in5     RW    2
375           in6_min                in6                in6     RW    2
376           in0_max                in0                in0     RW    2
377           in1_max                in1                in1     RW    2
378           in2_max                in2                in2     RW    2
379           in3_max                in3                in3     RW    2
380           in4_max                in4                in4     RW    2
381           in5_max                in5                in5     RW    2
382           in6_max                in6                in6     RW    2
383              fan1               NONE               NONE     R     0
384              fan2               NONE               NONE     R     0
385              fan3               NONE               NONE     R     0
386          fan1_min               fan1               NONE     RW    0
387          fan2_min               fan2               NONE     RW    0
388          fan3_min               fan3               NONE     RW    0
389             temp1               NONE               NONE     R     1
390        temp1_hyst              temp1              temp1     RW    1
391        temp1_over              temp1              temp1     RW    1
392             temp2               NONE               NONE     R     1
393        temp2_hyst              temp2              temp2     RW    1
394        temp2_over              temp2              temp2     RW    1
395               vid               NONE               NONE     R     2
396          fan1_div               fan1               NONE     RW    0
397          fan2_div               fan2               NONE     RW    0
398          fan3_div               fan3               NONE     R     0
399            alarms               NONE               NONE     R     0
400       beep_enable             alarms               NONE     RW    0
401             beeps             alarms             alarms     RW    0
402           sensor1               NONE               NONE     RW    0
403           sensor2               NONE               NONE     RW    0
404
405             LABEL                          FEATURE SYMBOL        SYSCTL FILE:NR
406               in0                     SENSORS_W83783S_IN0                in0:3
407               in1                     SENSORS_W83783S_IN1                in1:3
408               in2                     SENSORS_W83783S_IN2                in2:3
409               in3                     SENSORS_W83783S_IN3                in3:3
410               in4                     SENSORS_W83783S_IN4                in4:3
411               in5                     SENSORS_W83783S_IN5                in5:3
412               in6                     SENSORS_W83783S_IN6                in6:3
413           in0_min                 SENSORS_W83783S_IN0_MIN                in0:1
414           in1_min                 SENSORS_W83783S_IN1_MIN                in1:1
415           in2_min                 SENSORS_W83783S_IN2_MIN                in2:1
416           in3_min                 SENSORS_W83783S_IN3_MIN                in3:1
417           in4_min                 SENSORS_W83783S_IN4_MIN                in4:1
418           in5_min                 SENSORS_W83783S_IN5_MIN                in5:1
419           in6_min                 SENSORS_W83783S_IN6_MIN                in6:1
420           in0_max                 SENSORS_W83783S_IN0_MAX                in0:2
421           in1_max                 SENSORS_W83783S_IN1_MAX                in1:2
422           in2_max                 SENSORS_W83783S_IN2_MAX                in2:2
423           in3_max                 SENSORS_W83783S_IN3_MAX                in3:2
424           in4_max                 SENSORS_W83783S_IN4_MAX                in4:2
425           in5_max                 SENSORS_W83783S_IN5_MAX                in5:2
426           in6_max                 SENSORS_W83783S_IN6_MAX                in6:2
427              fan1                    SENSORS_W83783S_FAN1               fan1:2
428              fan2                    SENSORS_W83783S_FAN2               fan2:2
429              fan3                    SENSORS_W83783S_FAN3               fan3:2
430          fan1_min                SENSORS_W83783S_FAN1_MIN               fan1:1
431          fan2_min                SENSORS_W83783S_FAN2_MIN               fan2:1
432          fan3_min                SENSORS_W83783S_FAN3_MIN               fan3:1
433             temp1                   SENSORS_W83783S_TEMP1              temp1:3
434        temp1_hyst              SENSORS_W83783S_TEMP1_HYST              temp1:2
435        temp1_over              SENSORS_W83783S_TEMP1_OVER              temp1:1
436             temp2                   SENSORS_W83783S_TEMP2              temp2:3
437        temp2_hyst              SENSORS_W83783S_TEMP2_HYST              temp2:2
438        temp2_over              SENSORS_W83783S_TEMP2_OVER              temp2:1
439               vid                     SENSORS_W83783S_VID                vid:1
440          fan1_div                SENSORS_W83783S_FAN1_DIV            fan_div:1
441          fan2_div                SENSORS_W83783S_FAN2_DIV            fan_div:2
442          fan3_div                SENSORS_W83783S_FAN3_DIV            fan_div:3
443            alarms                  SENSORS_W83783S_ALARMS             alarms:1
444       beep_enable             SENSORS_W83783S_BEEP_ENABLE               beep:1
445             beeps                   SENSORS_W83783S_BEEPS               beep:2
446           sensor1                   SENSORS_W83783S_SENS1            sensor1:1
447           sensor2                   SENSORS_W83783S_SENS2            sensor2:1
448
449
450
451Old documentation
452-----------------
453
454
455Winbond 83781D driver
456---------------------
457Supports the following Winbond chips:
458
459Chip    #vin    #fanin  #pwm    #temp   wchipid i2c     ISA
460------------------------------------------------------------
461w83781d 7       3       0       3       0x10    yes     yes
462w83782d 9       3       2-4     3       0x30    yes     yes
463w83783s 5-6     3       2       1-2     0x40    yes     no
464
465
466Stability
467---------
468w83781d: tested, stable
469w83782d: beta tested, some minor bugs and things to do.
470w83783s: untested
471
472
473/PROC ENTRIES
474-------------
475Varies depending on chip type. Most are identical to the lm78 entries.
476See the lm78 documentation for details.
477
478Additional entries not in the lm78:
479
480        pwm[1-4]: (782d/783s only)
481          Controls the speed of the fans with PWM (Pulse Width Modulation)
482          Valid values:
483            0 - 255. 255 = max speed.
484
485        sensor[1-3]: (782d/783s only)
486          Controls the sensor type. To change to a different
487          sensor type, for example, do 'echo 2 > sensor1'.
488          Valid values:
489               1: Pentium II / Celeron diode
490               2: 2N3904 Transistor in a diode configuration
491            3435: Thermistor with Beta = 3435. Beta is a measure
492                  of sensitivity to temperature.
493          Thermistors with other Betas could in theory be supported
494          after correspondence with Winbond. See below.
495
496        rt[1-3]: (781d only)
497          32-byte tables controlling the conversion from
498          resistance to temperature for thermistors.
499          For the curious only. Writing to these entries will
500          probably render temperature sensing insane.
501          Only set at initialization; not updated every 1.5 seconds.
502
503
504The driver only updates its values each 1.5 seconds; reading it more often
505will do no harm, but will return 'old' values.
506
507
508TO DO:
509-----
510 782d programmable pins
511 783s temp2 (labeled as temp1 in data sheet) at different location
512      than 781d/782d, not implemented yet.
513
514
515NOTES:
516-----
517  783s has no in1 so that in[2-6] are compatible with the 781d/782d.
518
519  783s pin is programmable for -5V or temp1; defaults to -5V,
520       no control in driver so temp1 doesn't work.
521
522  782d and 783s datasheets differ on which is pwm1 and which is pwm2.
523       We chose to follow 782d.
524
525  782d and 783s pin is programmable for fan3 input or pwm2 output;
526       defaults to fan3 input.
527       no control in driver so pwm2 doesn't work.
528
529  782d has pwm1-2 for isa, pwm1-4 for i2c. (pwm3-4 share pins with
530       the isa pins)
531
532  781d allowable values for fan_div are 1,2,4,8.
533  782d/783s allowable values for fan_div are 1,2,4,8,16,32,64,128.
534
535
536
537Data sheet updates:
538------------------
539        - Mask off lower bit of all ID registers.
540
541        - PWM clock registers:
542
543                000: master /  512
544                001: master / 1024
545                010: master / 2048
546                011: master / 4096
547                100: master / 8192
548
549
550Answers from Winbond tech support
551---------------------------------
552>
553> 1) In the W83781D data sheet section 7.2 last paragraph, it talks about
554>    reprogramming the R-T table if the Beta of the thermistor is not
555>    3435K. The R-T table is described briefly in section 8.20.
556>    What formulas do I use to program a new R-T table for a given Beta?
557>
558        We are sorry that the calculation for R-T table value is
559confidential. If you have another Beta value of thermistor, we can help
560to calculate the R-T table for you. But you should give us real R-T
561Table which can be gotten by thermistor vendor. Therefore we will calculate
562them and obtain 32-byte data, and you can fill the 32-byte data to the
563register in Bank0.CR51 of W83781D.
564
565
566> 2) In the W83782D data sheet, it mentions that pins 38, 39, and 40 are
567>    programmable to be either thermistor or Pentium II diode inputs.
568>    How do I program them for diode inputs? I can't find any register
569>    to program these to be diode inputs.
570 --> You may program Bank0 CR[5Dh] and CR[59h] registers.
571 
572        CR[5Dh]                 bit 1(VTIN1)    bit 2(VTIN2)   bit 3(VTIN3)
573             
574        thermistor                0              0              0       
575        diode                     1              1              1               
576 
577 
578        CR[59h]                 bit 4(VTIN1)    bit 2(VTIN2)   bit 3(VTIN3)
579       
580        PII thermal diode         1              1              1
581        2N3904  diode             0              0              0
582 
583 
584Author/Maintainer
585-----------------
586Original 781D support: Frodo and Phil (sensors@stimpy.netroedge.com)
587782D/783S support added by: Mark D. Studebaker (mdsxyz123@yahoo.com)
588Send requests to the sensors@stimpy.netroedge.com mailing list.
Note: See TracBrowser for help on using the browser.