Context Navigation

w83781d @ 2313

Revision 2313, 36.2 KB (checked in by khali, 9 years ago)
w83781d driver doesn't support ASB100 anymore.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`

Line
1	Kernel driver `w83781d.o'
2	=========================
3
4	Status: 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	W83791D support is BETA.
8	W83627HF support is complete but has not been well-tested.
9	W83697HF support is complete but has not been well-tested.
10	AS99127F support is BETA and has known problems due to lack of a
11	chip datasheet. SEE BELOW.
12
13	Supported chips:
14	* Winbond W83781D
15	Prefix 'w83781d'
16	Addresses scanned: I2C 0x20 - 0x2f (inclusive), ISA 0x290 (8 I/O ports)
17	Datasheet: Publicly available at the Winbond website (www.winbond.com.tw)
18	* Winbond W83782D
19	Prefix 'w83782d'
20	Addresses scanned: I2C 0x20 - 0x2f (inclusive), ISA 0x290 (8 I/O ports)
21	Datasheet: Publicly available at the Winbond website
22	* Winbond W83783S
23	Prefix 'w83783s'
24	Addresses scanned: I2C 0x2d
25	Datasheet: Publicly available at the Winbond website
26	* Winbond W83791D
27	Prefix 'w83791d'
28	Addresses scanned: I2C 0x2c - 0x2f (inclusive)
29	Datasheet: Publicly available at the Winbond website
30	* Winbond W83627HF
31	Prefix 'w83627hf'
32	Addresses scanned: I2C 0x20 - 0x2f (inclusive), ISA 0x290 (8 I/O ports)
33	Datasheet: Publicly available at the Winbond website
34	* Winbond W83697HF
35	Prefix 'w83697hf'
36	Addresses scanned: ISA 0x290 (8 I/O ports)
37	Datasheet: Publicly available at the Winbond website
38	* Asus AS99127F
39	Prefix 'as99127f'
40	Addresses scanned: I2C 0x28 - 0x2f (inclusive)
41	Datasheet: Unavailable from Asus
42
43
44
45	Authors: Frodo Looijaard <frodol@dds.nl>, Philip Edelbrock <phil@netroedge.com>,
46	and Mark Studebaker <mdsxyz123@yahoo.com>
47
48
49	Module Parameters
50	-----------------
51
52	* force: short array (min = 1, max = 48)
53	List of adapter,address pairs to boldly assume to be present
54	* force_w83781d: short array (min = 1, max = 48)
55	List of adapter,address pairs which are unquestionably assumed to contain
56	a `w83781d' chip
57	* force_w83782d:
58	Ditto
59	* force_w83783s:
60	Ditto
61	* force_w83791d:
62	Ditto
63	* force_w83627hf:
64	Ditto
65	* force_w83697hf:
66	Ditto
67	* force_as99127f:
68	Ditto
69	* force_subclients=bus,caddr,saddr,saddr
70	This is used to force the i2c addresses for subclients of
71	a certain chip. Typical usage is `force_subclients=0,0x2d,0x4a,0x4b'
72	to force the subclients of chip 0x2d on bus 0 to i2c addresses
73	0x4a and 0x4b.
74	This parameter is useful for certain Tyan boards.
75	* ignore: short array (min = 1, max = 48)
76	List of adapter,address pairs not to scan
77	* ignore_range: short array (min = 1, max = 48)
78	List of adapter,start-addr,end-addr triples not to scan
79	* probe: short array (min = 1, max = 48)
80	List of adapter,address pairs to scan additionally
81	* probe_range: short array (min = 1, max = 48)
82	List of adapter,start-addr,end-addr triples to scan additionally
83	* init=[0,1] (default 1)
84	Use 'init=0' to bypass initializing the chip.
85	Try this if your computer crashes when you load the module.
86
87
88	Description
89	-----------
90
91	This driver implements support for the Winbond W83781D, W83782D,
92	W8783S, and W83627HF chips, and the Asus AS99127F chips.
93	We will refer to them collectively as W8378* chips.
94
95	There is quite some difference between these chips, but they are similar
96	enough that it was sensible to put them together in one driver.
97	The W83627HF chip is assumed to be identical to the ISA W83782D.
98	The Asus chips are similar to an I2C-only W83782D.
99
100	Detection of these chips can sometimes be foiled because they can be in
101	an internal state that allows no clean access. If you know the address
102	of the chip, use a 'force' parameter; this will put them into a more
103	well-behaved state first.
104
105	The W8378* implements temperature sensors (three on the W83781D and W83782D,
106	two on the W83783S), three FAN rotation speed sensors, voltage sensors
107	(seven on the W83781D, nine on the W83782D and six on the W83783S), VID
108	lines, alarms with beep warnings, and some miscellaneous stuff.
109
110	Temperatures are measured in degrees Celcius. There is always one main
111	temperature sensor, and one (W83783S) or two (W83781D and W83782D) other
112	sensors. An alarm is triggered for the main sensor once when the
113	Overtemperature Shutdown limit is crossed; it is triggered again as soon as
114	it drops below the Hysteresis value. A more useful behaviour
115	can be found by setting the Hysteresis value to +127 degrees Celcius; in
116	this case, alarms are issued during all the time when the actual temperature
117	is above the Overtemperature Shutdown value. The driver sets the
118	hysteresis value for temp1 to 127 at initialization.
119
120	For the other temperature sensor(s), an
121	alarm is triggered when the temperature gets higher then the Overtemperature
122	Shutdown value; it stays on until the temperature falls below the Hysteresis
123	value. But on the W83781D, there is only one alarm that functions for both
124	other sensors! Temperatures are guaranteed within a range of -55 to +125
125	degrees. The main temperature sensors has a resolution of 1 degree; the other
126	sensor(s) of 0.5 degree.
127
128	FAN rotation speeds are reported in RPM (rotations per minute). An alarm is
129	triggered if the rotation speed has dropped below a programmable limit. FAN
130	readings can be divided by a programmable divider (1, 2, 4 or 8 for the
131	W83781D; 1, 2, 4, 8, 16, 32, 64 or 128 for the others) to give
132	the readings more range or accuracy. This is important because some FANs
133	report only one 'tick' each rotation, while others report two - making
134	all readings twice as high. Not all RPM values can accurately be represented,
135	so some rounding is done. With a divider of 2, the lowest representable
136	value is around 2600 RPM.
137
138	Voltage sensors (also known as IN sensors) report their values in volts.
139	An alarm is triggered if the voltage has crossed a programmable minimum
140	or maximum limit. Note that minimum in this case always means 'closest to
141	zero'; this is important for negative voltage measurements. All voltage
142	inputs can measure voltages between 0 and 4.08 volts, with a resolution
143	of 0.016 volt.
144
145	The VID lines encode the core voltage value: the voltage level your processor
146	should work with. This is hardcoded by the mainboard and/or processor itself.
147	It is a value in volts. When it is unconnected, you will often find the
148	value 3.50 V here.
149
150	The W83782D and W83783S temperature conversion machine understands about
151	several kinds of temperature probes. You can program the so-called
152	beta value in the sensor files. '1' is the PII/Celeron diode, '2' is the
153	TN3904 transistor, and 3435 the default thermistor value. Other values
154	are (not yet) supported. You can program your own values through the
155	rt interface, but this is not very useful, because these tables are
156	under NDA.
157
158	In addition to the alarms described above, there is a CHAS alarm on the
159	chips which triggers if your computer case is open.
160
161	When an alarm goes off, you can be warned by a beeping signal through
162	your computer speaker. It is possible to enable all beeping globally,
163	or only the beeping for some alarms.
164
165	If an alarm triggers, it will remain triggered until the hardware register
166	is read at least once. This means that the cause for the alarm may
167	already have disappeared! Note that in the current implementation, all
168	hardware registers are read whenever any data is read (unless it is less
169	than 1.5 seconds since the last update). This means that you can easily
170	miss once-only alarms.
171
172	The chips only update values each 1.5 seconds; reading them more often
173	will do no harm, but will return 'old' values.
174
175
176	W8378* PROBLEMS
177	-----------------
178	Known problems:
179	- Some chips are misidentified.
180	This is caused by the chip having the wrong WCHIPID register
181	value, so there is no fix. The workaround is to use the
182	force_CHIP parameter.
183	(modprobe w83781d force_CHIP=BUS,0x2d where CHIP is the chip name
184	and BUS is your i2c bus number -
185	cat /proc/bus/i2c to see a list of bus numbers)
186
187
188	AS99127F PROBLEMS
189	-----------------
190	The as99127f support was developed without the benefit of a datasheet.
191	In most cases it is treated as a w83781d.
192	This support will be BETA until a datasheet is released.
193	One user has reported problems with fans stopping
194	occasionally.
195
196	Note that the individual beep bits are inverted from the other chips.
197	That is, in the second entry in the 'beep' file, a '1' bit means
198	disable, not enable. This may be changed in the future.
199
200	Known problems:
201	- Problems with diode/thermistor settings (supported?)
202	- fan_div register may not really be fan_div.
203	- One user reports fans stopping under high server load.
204	- Some as99127f chips are misidentified as a w83781d or w83782d.
205	This is caused by the chip having the wrong WCHIPID register
206	value, so there is no fix. The workaround is to use the
207	force_as99127f parameter.
208	(modprobe w83781d force_as99127f=BUS,0x2d where BUS is your i2c bus number)
209
210	These will not be fixed unless we get a datasheet.
211	If you have problems, please lobby Asus to release a datasheet.
212	Unfortunately several others have without success.
213	Please do not send mail to us asking for better as99127f support.
214	We have done the best we can without a datasheet.
215	Please do not send mail to the author or the sensors group asking for
216	a datasheet or ideas on how to convince Asus. We can't help.
217
218
219	Chip Features
220	-------------
221
222	Chip `w83781d'
223	LABEL LABEL CLASS COMPUTE CLASS ACCESS MAGNITUDE
224	in0 NONE NONE R 2
225	in1 NONE NONE R 2
226	in2 NONE NONE R 2
227	in3 NONE NONE R 2
228	in4 NONE NONE R 2
229	in5 NONE NONE R 2
230	in6 NONE NONE R 2
231	in0_min in0 in0 RW 2
232	in1_min in1 in1 RW 2
233	in2_min in2 in2 RW 2
234	in3_min in3 in3 RW 2
235	in4_min in4 in4 RW 2
236	in5_min in5 in5 RW 2
237	in6_min in6 in6 RW 2
238	in0_max in0 in0 RW 2
239	in1_max in1 in1 RW 2
240	in2_max in2 in2 RW 2
241	in3_max in3 in3 RW 2
242	in4_max in4 in4 RW 2
243	in5_max in5 in5 RW 2
244	in6_max in6 in6 RW 2
245	fan1 NONE NONE R 0
246	fan2 NONE NONE R 0
247	fan3 NONE NONE R 0
248	fan1_min fan1 NONE RW 0
249	fan2_min fan2 NONE RW 0
250	fan3_min fan3 NONE RW 0
251	temp1 NONE NONE R 1
252	temp1_hyst temp1 temp1 RW 1
253	temp1_over temp1 temp1 RW 1
254	temp2 NONE NONE R 1
255	temp2_hyst temp2 temp2 RW 1
256	temp2_over temp2 temp2 RW 1
257	temp3 NONE NONE R 1
258	temp3_hyst temp3 temp3 RW 1
259	temp3_over temp3 temp3 RW 1
260	vid NONE NONE R 2
261	fan1_div fan1 NONE RW 0
262	fan2_div fan2 NONE RW 0
263	fan3_div fan3 NONE R 0
264	alarms NONE NONE R 0
265	beep_enable alarms NONE RW 0
266	beeps alarms alarms RW 0
267
268	LABEL FEATURE SYMBOL SYSCTL FILE:NR
269	in0 SENSORS_W83781D_IN0 in0:3
270	in1 SENSORS_W83781D_IN1 in1:3
271	in2 SENSORS_W83781D_IN2 in2:3
272	in3 SENSORS_W83781D_IN3 in3:3
273	in4 SENSORS_W83781D_IN4 in4:3
274	in5 SENSORS_W83781D_IN5 in5:3
275	in6 SENSORS_W83781D_IN6 in6:3
276	in0_min SENSORS_W83781D_IN0_MIN in0:1
277	in1_min SENSORS_W83781D_IN1_MIN in1:1
278	in2_min SENSORS_W83781D_IN2_MIN in2:1
279	in3_min SENSORS_W83781D_IN3_MIN in3:1
280	in4_min SENSORS_W83781D_IN4_MIN in4:1
281	in5_min SENSORS_W83781D_IN5_MIN in5:1
282	in6_min SENSORS_W83781D_IN6_MIN in6:1
283	in0_max SENSORS_W83781D_IN0_MAX in0:2
284	in1_max SENSORS_W83781D_IN1_MAX in1:2
285	in2_max SENSORS_W83781D_IN2_MAX in2:2
286	in3_max SENSORS_W83781D_IN3_MAX in3:2
287	in4_max SENSORS_W83781D_IN4_MAX in4:2
288	in5_max SENSORS_W83781D_IN5_MAX in5:2
289	in6_max SENSORS_W83781D_IN6_MAX in6:2
290	fan1 SENSORS_W83781D_FAN1 fan1:2
291	fan2 SENSORS_W83781D_FAN2 fan2:2
292	fan3 SENSORS_W83781D_FAN3 fan3:2
293	fan1_min SENSORS_W83781D_FAN1_MIN fan1:1
294	fan2_min SENSORS_W83781D_FAN2_MIN fan2:1
295	fan3_min SENSORS_W83781D_FAN3_MIN fan3:1
296	temp1 SENSORS_W83781D_TEMP1 temp1:3
297	temp1_hyst SENSORS_W83781D_TEMP1_HYST temp1:2
298	temp1_over SENSORS_W83781D_TEMP1_OVER temp1:1
299	temp2 SENSORS_W83781D_TEMP2 temp2:3
300	temp2_hyst SENSORS_W83781D_TEMP2_HYST temp2:2
301	temp2_over SENSORS_W83781D_TEMP2_OVER temp2:1
302	temp3 SENSORS_W83781D_TEMP3 temp3:3
303	temp3_hyst SENSORS_W83781D_TEMP3_HYST temp3:2
304	temp3_over SENSORS_W83781D_TEMP3_OVER temp3:1
305	vid SENSORS_W83781D_VID vid:1
306	fan1_div SENSORS_W83781D_FAN1_DIV fan_div:1
307	fan2_div SENSORS_W83781D_FAN2_DIV fan_div:2
308	fan3_div SENSORS_W83781D_FAN3_DIV fan_div:3
309	alarms SENSORS_W83781D_ALARMS alarms:1
310	beep_enable SENSORS_W83781D_BEEP_ENABLE beep:1
311	beeps SENSORS_W83781D_BEEPS beep:2
312
313
314	Chip `w83782d'
315	LABEL LABEL CLASS COMPUTE CLASS ACCESS MAGNITUDE
316	in0 NONE NONE R 2
317	in1 NONE NONE R 2
318	in2 NONE NONE R 2
319	in3 NONE NONE R 2
320	in4 NONE NONE R 2
321	in5 NONE NONE R 2
322	in6 NONE NONE R 2
323	in7 NONE NONE R 2
324	in8 NONE NONE R 2
325	in0_min in0 in0 RW 2
326	in1_min in1 in1 RW 2
327	in2_min in2 in2 RW 2
328	in3_min in3 in3 RW 2
329	in4_min in4 in4 RW 2
330	in5_min in5 in5 RW 2
331	in6_min in6 in6 RW 2
332	in7_min in7 in7 RW 2
333	in8_min in8 in8 RW 2
334	in0_max in0 in0 RW 2
335	in1_max in1 in1 RW 2
336	in2_max in2 in2 RW 2
337	in3_max in3 in3 RW 2
338	in4_max in4 in4 RW 2
339	in5_max in5 in5 RW 2
340	in6_max in6 in6 RW 2
341	in7_max in7 in7 RW 2
342	in8_max in8 in8 RW 2
343	fan1 NONE NONE R 0
344	fan2 NONE NONE R 0
345	fan3 NONE NONE R 0
346	fan1_min fan1 NONE RW 0
347	fan2_min fan2 NONE RW 0
348	fan3_min fan3 NONE RW 0
349	temp1 NONE NONE R 1
350	temp1_hyst temp1 temp1 RW 1
351	temp1_over temp1 temp1 RW 1
352	temp2 NONE NONE R 1
353	temp2_hyst temp2 temp2 RW 1
354	temp2_over temp2 temp2 RW 1
355	temp3 NONE NONE R 1
356	temp3_hyst temp3 temp3 RW 1
357	temp3_over temp3 temp3 RW 1
358	vid NONE NONE R 2
359	fan1_div fan1 NONE RW 0
360	fan2_div fan2 NONE RW 0
361	fan3_div fan3 NONE R 0
362	alarms NONE NONE R 0
363	beep_enable alarms NONE RW 0
364	beeps alarms alarms RW 0
365	sensor1 NONE NONE RW 0
366	sensor2 NONE NONE RW 0
367	sensor3 NONE NONE RW 0
368
369	LABEL FEATURE SYMBOL SYSCTL FILE:NR
370	in0 SENSORS_W83782D_IN0 in0:3
371	in1 SENSORS_W83782D_IN1 in1:3
372	in2 SENSORS_W83782D_IN2 in2:3
373	in3 SENSORS_W83782D_IN3 in3:3
374	in4 SENSORS_W83782D_IN4 in4:3
375	in5 SENSORS_W83782D_IN5 in5:3
376	in6 SENSORS_W83782D_IN6 in6:3
377	in7 SENSORS_W83782D_IN7 in7:3
378	in8 SENSORS_W83782D_IN8 in8:3
379	in0_min SENSORS_W83782D_IN0_MIN in0:1
380	in1_min SENSORS_W83782D_IN1_MIN in1:1
381	in2_min SENSORS_W83782D_IN2_MIN in2:1
382	in3_min SENSORS_W83782D_IN3_MIN in3:1
383	in4_min SENSORS_W83782D_IN4_MIN in4:1
384	in5_min SENSORS_W83782D_IN5_MIN in5:1
385	in6_min SENSORS_W83782D_IN6_MIN in6:1
386	in7_min SENSORS_W83782D_IN7_MIN in7:1
387	in8_min SENSORS_W83782D_IN8_MIN in8:1
388	in0_max SENSORS_W83782D_IN0_MAX in0:2
389	in1_max SENSORS_W83782D_IN1_MAX in1:2
390	in2_max SENSORS_W83782D_IN2_MAX in2:2
391	in3_max SENSORS_W83782D_IN3_MAX in3:2
392	in4_max SENSORS_W83782D_IN4_MAX in4:2
393	in5_max SENSORS_W83782D_IN5_MAX in5:2
394	in6_max SENSORS_W83782D_IN6_MAX in6:2
395	in7_max SENSORS_W83782D_IN7_MAX in7:2
396	in8_max SENSORS_W83782D_IN8_MAX in8:2
397	fan1 SENSORS_W83782D_FAN1 fan1:2
398	fan2 SENSORS_W83782D_FAN2 fan2:2
399	fan3 SENSORS_W83781D_FAN3 fan3:2
400	fan1_min SENSORS_W83782D_FAN1_MIN fan1:1
401	fan2_min SENSORS_W83782D_FAN2_MIN fan2:1
402	fan3_min SENSORS_W83781D_FAN3_MIN fan3:1
403	temp1 SENSORS_W83782D_TEMP1 temp1:3
404	temp1_hyst SENSORS_W83782D_TEMP1_HYST temp1:2
405	temp1_over SENSORS_W83782D_TEMP1_OVER temp1:1
406	temp2 SENSORS_W83782D_TEMP2 temp2:3
407	temp2_hyst SENSORS_W83782D_TEMP2_HYST temp2:2
408	temp2_over SENSORS_W83782D_TEMP2_OVER temp2:1
409	temp3 SENSORS_W83782D_TEMP3 temp3:3
410	temp3_hyst SENSORS_W83782D_TEMP3_HYST temp3:2
411	temp3_over SENSORS_W83782D_TEMP3_OVER temp3:1
412	vid SENSORS_W83782D_VID vid:1
413	fan1_div SENSORS_W83782D_FAN1_DIV fan_div:1
414	fan2_div SENSORS_W83782D_FAN2_DIV fan_div:2
415	fan3_div SENSORS_W83781D_FAN3_DIV fan_div:3
416	alarms SENSORS_W83782D_ALARMS alarms:1
417	beep_enable SENSORS_W83782D_BEEP_ENABLE beep:1
418	beeps SENSORS_W83782D_BEEPS beep:2
419	sensor1 SENSORS_W83782D_SENS1 sensor1:1
420	sensor2 SENSORS_W83782D_SENS2 sensor2:1
421	sensor3 SENSORS_W83782D_SENS3 sensor3:1
422
423
424	Chip `w83783s'
425	LABEL LABEL CLASS COMPUTE CLASS ACCESS MAGNITUDE
426	in0 NONE NONE R 2
427	in1 NONE NONE R 2
428	in2 NONE NONE R 2
429	in3 NONE NONE R 2
430	in4 NONE NONE R 2
431	in5 NONE NONE R 2
432	in6 NONE NONE R 2
433	in0_min in0 in0 RW 2
434	in1_min in1 in1 RW 2
435	in2_min in2 in2 RW 2
436	in3_min in3 in3 RW 2
437	in4_min in4 in4 RW 2
438	in5_min in5 in5 RW 2
439	in6_min in6 in6 RW 2
440	in0_max in0 in0 RW 2
441	in1_max in1 in1 RW 2
442	in2_max in2 in2 RW 2
443	in3_max in3 in3 RW 2
444	in4_max in4 in4 RW 2
445	in5_max in5 in5 RW 2
446	in6_max in6 in6 RW 2
447	fan1 NONE NONE R 0
448	fan2 NONE NONE R 0
449	fan3 NONE NONE R 0
450	fan1_min fan1 NONE RW 0
451	fan2_min fan2 NONE RW 0
452	fan3_min fan3 NONE RW 0
453	temp1 NONE NONE R 1
454	temp1_hyst temp1 temp1 RW 1
455	temp1_over temp1 temp1 RW 1
456	temp2 NONE NONE R 1
457	temp2_hyst temp2 temp2 RW 1
458	temp2_over temp2 temp2 RW 1
459	vid NONE NONE R 2
460	fan1_div fan1 NONE RW 0
461	fan2_div fan2 NONE RW 0
462	fan3_div fan3 NONE R 0
463	alarms NONE NONE R 0
464	beep_enable alarms NONE RW 0
465	beeps alarms alarms RW 0
466	sensor1 NONE NONE RW 0
467	sensor2 NONE NONE RW 0
468
469	LABEL FEATURE SYMBOL SYSCTL FILE:NR
470	in0 SENSORS_W83783S_IN0 in0:3
471	in1 SENSORS_W83783S_IN1 in1:3
472	in2 SENSORS_W83783S_IN2 in2:3
473	in3 SENSORS_W83783S_IN3 in3:3
474	in4 SENSORS_W83783S_IN4 in4:3
475	in5 SENSORS_W83783S_IN5 in5:3
476	in6 SENSORS_W83783S_IN6 in6:3
477	in0_min SENSORS_W83783S_IN0_MIN in0:1
478	in1_min SENSORS_W83783S_IN1_MIN in1:1
479	in2_min SENSORS_W83783S_IN2_MIN in2:1
480	in3_min SENSORS_W83783S_IN3_MIN in3:1
481	in4_min SENSORS_W83783S_IN4_MIN in4:1
482	in5_min SENSORS_W83783S_IN5_MIN in5:1
483	in6_min SENSORS_W83783S_IN6_MIN in6:1
484	in0_max SENSORS_W83783S_IN0_MAX in0:2
485	in1_max SENSORS_W83783S_IN1_MAX in1:2
486	in2_max SENSORS_W83783S_IN2_MAX in2:2
487	in3_max SENSORS_W83783S_IN3_MAX in3:2
488	in4_max SENSORS_W83783S_IN4_MAX in4:2
489	in5_max SENSORS_W83783S_IN5_MAX in5:2
490	in6_max SENSORS_W83783S_IN6_MAX in6:2
491	fan1 SENSORS_W83783S_FAN1 fan1:2
492	fan2 SENSORS_W83783S_FAN2 fan2:2
493	fan3 SENSORS_W83783S_FAN3 fan3:2
494	fan1_min SENSORS_W83783S_FAN1_MIN fan1:1
495	fan2_min SENSORS_W83783S_FAN2_MIN fan2:1
496	fan3_min SENSORS_W83783S_FAN3_MIN fan3:1
497	temp1 SENSORS_W83783S_TEMP1 temp1:3
498	temp1_hyst SENSORS_W83783S_TEMP1_HYST temp1:2
499	temp1_over SENSORS_W83783S_TEMP1_OVER temp1:1
500	temp2 SENSORS_W83783S_TEMP2 temp2:3
501	temp2_hyst SENSORS_W83783S_TEMP2_HYST temp2:2
502	temp2_over SENSORS_W83783S_TEMP2_OVER temp2:1
503	vid SENSORS_W83783S_VID vid:1
504	fan1_div SENSORS_W83783S_FAN1_DIV fan_div:1
505	fan2_div SENSORS_W83783S_FAN2_DIV fan_div:2
506	fan3_div SENSORS_W83783S_FAN3_DIV fan_div:3
507	alarms SENSORS_W83783S_ALARMS alarms:1
508	beep_enable SENSORS_W83783S_BEEP_ENABLE beep:1
509	beeps SENSORS_W83783S_BEEPS beep:2
510	sensor1 SENSORS_W83783S_SENS1 sensor1:1
511	sensor2 SENSORS_W83783S_SENS2 sensor2:1
512
513
514
515	Miscellaneous documentation
516	===========================
517
518
519
520	/PROC ENTRIES
521	-------------
522	Varies depending on chip type. Most are identical to the lm78 entries.
523	See the lm78 documentation for details.
524
525	Additional entries not in the lm78:
526
527	pwm[1-4]: (not on w83781d)
528	Controls the speed of the fans with PWM (Pulse Width Modulation)
529	Valid values:
530	0 - 255. 255 = max speed.
531	Second value is PWM enable 0/1.
532
533	sensor[1-3]: (not on w83781d)
534	Controls the sensor type. To change to a different
535	sensor type, for example, do 'echo 2 > sensor1'.
536	Valid values:
537	1: Pentium II / Celeron diode
538	2: 2N3904 Transistor in a diode configuration
539	3435: Thermistor with Beta = 3435. Beta is a measure
540	of sensitivity to temperature.
541	Thermistors with other Betas could in theory be supported
542	after correspondence with Winbond. See below.
543
544	rt[1-3]: (781d only)
545	32-byte tables controlling the conversion from
546	resistance to temperature for thermistors.
547	For the curious only. Writing to these entries will
548	probably render temperature sensing insane.
549	Only set at initialization; not updated every 1.5 seconds.
550
551
552
553	TO DO:
554	-----
555	782d programmable pins
556
557
558	NOTES:
559	-----
560	783s has no in1 so that in[2-6] are compatible with the 781d/782d.
561
562	783s pin is programmable for -5V or temp1; defaults to -5V,
563	no control in driver so temp1 doesn't work.
564
565	782d and 783s datasheets differ on which is pwm1 and which is pwm2.
566	We chose to follow 782d.
567
568	782d and 783s pin is programmable for fan3 input or pwm2 output;
569	defaults to fan3 input.
570	If pwm2 is enabled (with echo 255 1 > pwm2), then
571	fan3 will report 0.
572
573	782d has pwm1-2 for isa, pwm1-4 for i2c. (pwm3-4 share pins with
574	the isa pins)
575
576	781d allowable values for fan_div are 1,2,4,8.
577	782d/783s allowable values for fan_div are 1,2,4,8,16,32,64,128.
578
579
580
581	Data sheet updates:
582	------------------
583	- Mask off lower bit of all ID registers.
584
585	- PWM clock registers:
586
587	000: master / 512
588	001: master / 1024
589	010: master / 2048
590	011: master / 4096
591	100: master / 8192
592
593
594	Answers from Winbond tech support
595	---------------------------------
596	>
597	> 1) In the W83781D data sheet section 7.2 last paragraph, it talks about
598	> reprogramming the R-T table if the Beta of the thermistor is not
599	> 3435K. The R-T table is described briefly in section 8.20.
600	> What formulas do I use to program a new R-T table for a given Beta?
601	>
602	We are sorry that the calculation for R-T table value is
603	confidential. If you have another Beta value of thermistor, we can help
604	to calculate the R-T table for you. But you should give us real R-T
605	Table which can be gotten by thermistor vendor. Therefore we will calculate
606	them and obtain 32-byte data, and you can fill the 32-byte data to the
607	register in Bank0.CR51 of W83781D.
608
609
610	> 2) In the W83782D data sheet, it mentions that pins 38, 39, and 40 are
611	> programmable to be either thermistor or Pentium II diode inputs.
612	> How do I program them for diode inputs? I can't find any register
613	> to program these to be diode inputs.
614	--> You may program Bank0 CR[5Dh] and CR[59h] registers.
615
616	CR[5Dh] bit 1(VTIN1) bit 2(VTIN2) bit 3(VTIN3)
617
618	thermistor 0 0 0
619	diode 1 1 1
620
621
622	(error) CR[59h] bit 4(VTIN1) bit 2(VTIN2) bit 3(VTIN3)
623	(right) CR[59h] bit 4(VTIN1) bit 5(VTIN2) bit 6(VTIN3)
624
625	PII thermal diode 1 1 1
626	2N3904 diode 0 0 0
627
628
629	Author/Maintainer
630	-----------------
631	Original 781D support: Frodo and Phil (sensors@stimpy.netroedge.com)
632	782D/783S support added by: Mark D. Studebaker (mdsxyz123@yahoo.com)
633	Send requests to the sensors@stimpy.netroedge.com mailing list.
634
635
636	Asus Clones
637	-----------
638
639	We have no datasheets for the Asus clones (AS99127F and ASB100 Bach).
640	Here are some very useful information that were given to us by Alex Van
641	Kaam about how to detect these chips, and how to read their values. He
642	also gives advice for another Asus chipset, the Mozart-2 (which we
643	don't support yet). Thanks Alex!
644	I reworded some parts and added personal comments.
645
646	# Detection:
647
648	AS99127F rev.1, AS99127F rev.2 and ASB100:
649	- I2C address range: 0x29 - 0x2F
650	- If register 0x58 holds 0x31 then we have an Asus (either ASB100 or
651	AS99127F)
652	- Which one depends on register 0x4F (manufacturer ID):
653	0x06 or 0x94: ASB100
654	0x12 or 0xC3: AS99127F rev.1
655	0x5C or 0xA3: AS99127F rev.2
656	Note that 0x5CA3 is Winbond's ID (WEC), which let us think Asus get their
657	AS99127F rev.2 direct from Winbond. The other codes mean ATT and DVC,
658	respectively. ATT could stand for Asustek something (although it would be
659	very badly chosen IMHO), I don't know what DVC could stand for. Maybe
660	these codes simply aren't meant to be decoded that way.
661
662	Mozart-2:
663	- I2C address: 0x77
664	- If register 0x58 holds 0x56 or 0x10 then we have a Mozart-2
665	- Of the mozart there are 3 types:
666	0x58=0x56, 0x4E=0x94, 0x4F=0x36: Asus ASM58 Mozart-2
667	0x58=0x56, 0x4E=0x94, 0x4F=0x06: Asus AS2K129R Mozart-2
668	0x58=0x10, 0x4E=0x5C, 0x4F=0xA3: Asus ??? Mozart-2
669	You can handle all 3 the exact same way :)
670
671	# Temperature sensors:
672
673	ASB100:
674	- sensor 1: register 0x27
675	- sensor 2 & 3 are the 2 LM75's on the SMBus
676	- sensor 4: register 0x17
677	Remark: I noticed that on Intel boards sensor 2 is used for the CPU
678	and 4 is ignored/stuck, on AMD boards sensor 4 is the CPU and sensor 2 is
679	either ignored or a socket temperature.
680
681	AS99127F (rev.1 and 2 alike):
682	- sensor 1: register 0x27
683	- sensor 2 & 3 are the 2 LM75's on the SMBus
684	Remark: Register 0x5b is suspected to be temperature type selector. Bit 1
685	would control temp1, bit 3 temp2 and bit 5 temp3.
686
687	Mozart-2:
688	- sensor 1: register 0x27
689	- sensor 2: register 0x13
690
691	# Fan sensors:
692
693	ASB100, AS99127F (rev.1 and 2 alike):
694	- 3 fans, identical to the W83781D
695
696	Mozart-2:
697	- 2 fans only, 1350000/rpm/div
698	- fan 1: register 0x28, divisor on register 0xA1 (bits 4-5)
699	- fan 2: register 0x29, divisor on register 0xA1 (bits 6-7)
700
701	# Voltages:
702
703	This is where there is a diffrence between AS99127F rev.1 and 2.
704	Remark: The difference is similar to the difference between
705	W83781D and W83782D.
706
707	ASB100:
708	in0=r(0x20)*0.016
709	in1=r(0x21)*0.016
710	in2=r(0x22)*0.016
711	in3=r(0x23)0.0161.68
712	in4=r(0x24)0.0163.8
713	in5=r(0x25)(-0.016)3.97
714	in6=r(0x26)(-0.016)1.666
715
716	AS99127F rev.1:
717	in0=r(0x20)*0.016
718	in1=r(0x21)*0.016
719	in2=r(0x22)*0.016
720	in3=r(0x23)0.0161.68
721	in4=r(0x24)0.0163.8
722	in5=r(0x25)(-0.016)3.97
723	in6=r(0x26)(-0.016)1.503
724
725	AS99127F rev.2:
726	in0=r(0x20)*0.016
727	in1=r(0x21)*0.016
728	in2=r(0x22)*0.016
729	in3=r(0x23)0.0161.68
730	in4=r(0x24)0.0163.8
731	in5=(r(0x25)0.016-3.6)5.14+3.6
732	in6=(r(0x26)0.016-3.6)3.14+3.6
733
734	Mozart-2:
735	in0=r(0x20)*0.016
736	in1=255
737	in2=r(0x22)*0.016
738	in3=r(0x23)0.0161.68
739	in4=r(0x24)0.0164
740	in5=255
741	in6=255

Note: See TracBrowser for help on using the browser.

Download in other formats:

Original Format