Context Navigation

w83781d @ 1909

Revision 1909, 36.5 KB (checked in by khali, 10 years ago)

Add documentation about the Asus clones. Most of it is from

Alex van Kaam. Thanks Alex!

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

Note: See TracBrowser for help on using the browser.

Download in other formats:

Original Format