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

Revision 1148, 32.2 KB (checked in by mds, 12 years ago)

Asus board help. Thanks

Patrick Tullmann <tullmann@…>

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