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

Revision 797, 31.2 KB (checked in by mds, 13 years ago)

(mds) w83627hf only has 2 pwm whether on ISA or I2C bus.

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