Context Navigation

lm78 @ 3007

Revision 3007, 19.2 KB (checked in by khali, 8 years ago)
Backport the cleanups and corrections Rudolf Marek and I did when porting the chips documentation to Linux 2.6.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`

Line
1	Kernel driver `lm78.o'
2	======================
3
4	Status: Complete and well-tested
5
6	Supported chips:
7	* National Semiconductor LM78
8	Prefix: 'lm78'
9	Addresses scanned: I2C 0x20 - 0x2f, ISA 0x290 (8 I/O ports)
10	Datasheet: Publicly available at the National Semiconductor website
11	* National Semiconductor LM78-J
12	Prefix: 'lm78-j'
13	Addresses scanned: I2C 0x20 - 0x2f, ISA 0x290 (8 I/O ports)
14	Datasheet: Publicly available at the National Semiconductor website
15	* National Semiconductor LM79
16	Prefix: 'lm79'
17	Addresses scanned: I2C 0x20 - 0x2f, ISA 0x290 (8 I/O ports)
18	Datasheet: Publicly available at the National Semiconductor website
19
20	Author: Frodo Looijaard <frodol@dds.nl>
21
22
23	Module Parameters
24	-----------------
25
26	* force: short array (min = 1, max = 48)
27	List of adapter,address pairs to boldly assume to be present
28	* force_lm78: short array (min = 1, max = 48)
29	List of adapter,address pairs which are unquestionably assumed to contain
30	a `lm78' chip
31	* force_lm78j: short array (min = 1, max = 48)
32	List of adapter,address pairs which are unquestionably assumed to contain
33	a `lm78j' chip
34	* force_lm79: short array (min = 1, max = 48)
35	List of adapter,address pairs which are unquestionably assumed to contain
36	a `lm79' chip
37	* ignore: short array (min = 1, max = 48)
38	List of adapter,address pairs not to scan
39	* ignore_range: short array (min = 1, max = 48)
40	List of adapter,start-addr,end-addr triples not to scan
41	* probe: short array (min = 1, max = 48)
42	List of adapter,address pairs to scan additionally
43	* probe_range: short array (min = 1, max = 48)
44	List of adapter,start-addr,end-addr triples to scan additionally
45
46
47	Description
48	-----------
49
50	This driver implements support for the National Semiconductor LM78, LM78-J
51	and LM79. They are described as `Microprocessor System Hardware Monitors'.
52
53	There is almost no difference between the three supported chips. Functionally,
54	the LM78 and LM78-J are exactly identical. The LM79 has one more VID line,
55	which is used to report the lower voltages newer Pentium processors use.
56	From here on, LM7* means either of these three types.
57
58	The LM7* implements one temperature sensor, three fan rotation speed sensors,
59	seven voltage sensors, VID lines, alarms, and some miscellaneous stuff.
60
61	Temperatures are measured in degrees Celsius. An alarm is triggered once
62	when the Overtemperature Shutdown limit is crossed; it is triggered again
63	as soon as it drops below the Hysteresis value. A more useful behaviour
64	can be found by setting the Hysteresis value to +127 degrees Celsius; in
65	this case, alarms are issued during all the time when the actual temperature
66	is above the Overtemperature Shutdown value. Measurements are guaranteed
67	between -55 and +125 degrees, with a resolution of 1 degree.
68
69	Fan rotation speeds are reported in RPM (rotations per minute). An alarm is
70	triggered if the rotation speed has dropped below a programmable limit. Fan
71	readings can be divided by a programmable divider (1, 2, 4 or 8) to give
72	the readings more range or accuracy. Not all RPM values can accurately be
73	represented, so some rounding is done. With a divider of 2, the lowest
74	representable value is around 2600 RPM.
75
76	Voltage sensors (also known as IN sensors) report their values in volts.
77	An alarm is triggered if the voltage has crossed a programmable minimum
78	or maximum limit. Note that minimum in this case always means 'closest to
79	zero'; this is important for negative voltage measurements. All voltage
80	inputs can measure voltages between 0 and 4.08 volts, with a resolution
81	of 0.016 volt.
82
83	The VID lines encode the core voltage value: the voltage level your processor
84	should work with. This is hardcoded by the mainboard and/or processor itself.
85	It is a value in volts. When it is unconnected, you will often find the
86	value 3.50 V here.
87
88	In addition to the alarms described above, there are a couple of additional
89	ones. There is a BTI alarm, which gets triggered when an external chip has
90	crossed its limits. Usually, this is connected to all LM75 chips; if at
91	least one crosses its limits, this bit gets set. The CHAS alarm triggers
92	if your computer case is open. The FIFO alarms should never trigger; it
93	indicates an internal error. The SMI_IN alarm indicates some other chip
94	has triggered an SMI interrupt. As we do not use SMI interrupts at all,
95	this condition usually indicates there is a problem with some other
96	device.
97
98	If an alarm triggers, it will remain triggered until the hardware register
99	is read at least once. This means that the cause for the alarm may
100	already have disappeared! Note that in the current implementation, all
101	hardware registers are read whenever any data is read (unless it is less
102	than 1.5 seconds since the last update). This means that you can easily
103	miss once-only alarms.
104
105	The LM7* only updates its values each 1.5 seconds; reading it more often
106	will do no harm, but will return 'old' values.
107
108
109	Chip features
110	-------------
111
112	Chip `lm78'
113	LABEL LABEL CLASS COMPUTE CLASS ACCESS MAGNITUDE
114	in0 NONE NONE R 2
115	in1 NONE NONE R 2
116	in2 NONE NONE R 2
117	in3 NONE NONE R 2
118	in4 NONE NONE R 2
119	in5 NONE NONE R 2
120	in6 NONE NONE R 2
121	in0_min in0 in0 RW 2
122	in1_min in1 in1 RW 2
123	in2_min in2 in2 RW 2
124	in3_min in3 in3 RW 2
125	in4_min in4 in4 RW 2
126	in5_min in5 in5 RW 2
127	in6_min in6 in6 RW 2
128	in0_max in0 in0 RW 2
129	in1_max in1 in1 RW 2
130	in2_max in2 in2 RW 2
131	in3_max in3 in3 RW 2
132	in4_max in4 in4 RW 2
133	in5_max in5 in5 RW 2
134	in6_max in6 in6 RW 2
135	fan1 NONE NONE R 0
136	fan2 NONE NONE R 0
137	fan3 NONE NONE R 0
138	fan1_min fan1 fan1 RW 0
139	fan2_min fan2 fan2 RW 0
140	fan3_min fan3 fan3 RW 0
141	temp NONE NONE R 1
142	temp_hyst temp temp RW 1
143	temp_over temp temp RW 1
144	vid NONE NONE R 2
145	fan1_div fan1 NONE RW 0
146	fan2_div fan2 NONE RW 0
147	fan3_div fan3 NONE R 0
148	alarms NONE NONE R 0
149
150	LABEL FEATURE SYMBOL SYSCTL FILE:OFFSET
151	in0 SENSORS_LM78_IN0 in0:3
152	in1 SENSORS_LM78_IN1 in1:3
153	in2 SENSORS_LM78_IN2 in2:3
154	in3 SENSORS_LM78_IN3 in3:3
155	in4 SENSORS_LM78_IN4 in4:3
156	in5 SENSORS_LM78_IN5 in5:3
157	in6 SENSORS_LM78_IN6 in6:3
158	in0_min SENSORS_LM78_IN0_MIN in0:1
159	in1_min SENSORS_LM78_IN1_MIN in1:1
160	in2_min SENSORS_LM78_IN2_MIN in2:1
161	in3_min SENSORS_LM78_IN3_MIN in3:1
162	in4_min SENSORS_LM78_IN4_MIN in4:1
163	in5_min SENSORS_LM78_IN5_MIN in5:1
164	in6_min SENSORS_LM78_IN6_MIN in6:1
165	in0_max SENSORS_LM78_IN0_MAX in0:2
166	in1_max SENSORS_LM78_IN1_MAX in1:2
167	in2_max SENSORS_LM78_IN2_MAX in2:2
168	in3_max SENSORS_LM78_IN3_MAX in3:2
169	in4_max SENSORS_LM78_IN4_MAX in4:2
170	in5_max SENSORS_LM78_IN5_MAX in5:2
171	in6_max SENSORS_LM78_IN6_MAX in6:2
172	fan1 SENSORS_LM78_FAN1 fan1:2
173	fan2 SENSORS_LM78_FAN2 fan2:2
174	fan3 SENSORS_LM78_FAN3 fan3:2
175	fan1_min SENSORS_LM78_FAN1_MIN fan1:1
176	fan2_min SENSORS_LM78_FAN2_MIN fan2:1
177	fan3_min SENSORS_LM78_FAN3_MIN fan3:1
178	temp SENSORS_LM78_TEMP temp:3
179	temp_hyst SENSORS_LM78_TEMP_HYST temp:2
180	temp_over SENSORS_LM78_TEMP_OVER temp:1
181	vid SENSORS_LM78_VID vid:1
182	fan1_div SENSORS_LM78_FAN1_DIV fan_div:1
183	fan2_div SENSORS_LM78_FAN2_DIV fan_div:2
184	fan3_div SENSORS_LM78_FAN3_DIV fan_div:3
185	alarms SENSORS_LM78_ALARMS alarms:1
186
187
188	Chip `lm78-j'
189	LABEL LABEL CLASS COMPUTE CLASS ACCESS MAGNITUDE
190	in0 NONE NONE R 2
191	in1 NONE NONE R 2
192	in2 NONE NONE R 2
193	in3 NONE NONE R 2
194	in4 NONE NONE R 2
195	in5 NONE NONE R 2
196	in6 NONE NONE R 2
197	in0_min in0 in0 RW 2
198	in1_min in1 in1 RW 2
199	in2_min in2 in2 RW 2
200	in3_min in3 in3 RW 2
201	in4_min in4 in4 RW 2
202	in5_min in5 in5 RW 2
203	in6_min in6 in6 RW 2
204	in0_max in0 in0 RW 2
205	in1_max in1 in1 RW 2
206	in2_max in2 in2 RW 2
207	in3_max in3 in3 RW 2
208	in4_max in4 in4 RW 2
209	in5_max in5 in5 RW 2
210	in6_max in6 in6 RW 2
211	fan1 NONE NONE R 0
212	fan2 NONE NONE R 0
213	fan3 NONE NONE R 0
214	fan1_min fan1 fan1 RW 0
215	fan2_min fan2 fan2 RW 0
216	fan3_min fan3 fan3 RW 0
217	temp NONE NONE R 1
218	temp_hyst temp temp RW 1
219	temp_over temp temp RW 1
220	vid NONE NONE R 2
221	fan1_div fan1 NONE RW 0
222	fan2_div fan2 NONE RW 0
223	fan3_div fan3 NONE R 0
224	alarms NONE NONE R 0
225
226	LABEL FEATURE SYMBOL SYSCTL FILE:OFFSET
227	in0 SENSORS_LM78J_IN0 in0:3
228	in1 SENSORS_LM78J_IN1 in1:3
229	in2 SENSORS_LM78J_IN2 in2:3
230	in3 SENSORS_LM78J_IN3 in3:3
231	in4 SENSORS_LM78J_IN4 in4:3
232	in5 SENSORS_LM78J_IN5 in5:3
233	in6 SENSORS_LM78J_IN6 in6:3
234	in0_min SENSORS_LM78J_IN0_MIN in0:1
235	in1_min SENSORS_LM78J_IN1_MIN in1:1
236	in2_min SENSORS_LM78J_IN2_MIN in2:1
237	in3_min SENSORS_LM78J_IN3_MIN in3:1
238	in4_min SENSORS_LM78J_IN4_MIN in4:1
239	in5_min SENSORS_LM78J_IN5_MIN in5:1
240	in6_min SENSORS_LM78J_IN6_MIN in6:1
241	in0_max SENSORS_LM78J_IN0_MAX in0:2
242	in1_max SENSORS_LM78J_IN1_MAX in1:2
243	in2_max SENSORS_LM78J_IN2_MAX in2:2
244	in3_max SENSORS_LM78J_IN3_MAX in3:2
245	in4_max SENSORS_LM78J_IN4_MAX in4:2
246	in5_max SENSORS_LM78J_IN5_MAX in5:2
247	in6_max SENSORS_LM78J_IN6_MAX in6:2
248	fan1 SENSORS_LM78J_FAN1 fan1:2
249	fan2 SENSORS_LM78J_FAN2 fan2:2
250	fan3 SENSORS_LM78J_FAN3 fan3:2
251	fan1_min SENSORS_LM78J_FAN1_MIN fan1:1
252	fan2_min SENSORS_LM78J_FAN2_MIN fan2:1
253	fan3_min SENSORS_LM78J_FAN3_MIN fan3:1
254	temp SENSORS_LM78J_TEMP temp:3
255	temp_hyst SENSORS_LM78J_TEMP_HYST temp:2
256	temp_over SENSORS_LM78J_TEMP_OVER temp:1
257	vid SENSORS_LM78J_VID vid:1
258	fan1_div SENSORS_LM78J_FAN1_DIV fan_div:1
259	fan2_div SENSORS_LM78J_FAN2_DIV fan_div:2
260	fan3_div SENSORS_LM78J_FAN3_DIV fan_div:3
261	alarms SENSORS_LM78J_ALARMS alarms:1
262
263
264	Chip `lm79'
265	LABEL LABEL CLASS COMPUTE CLASS ACCESS MAGNITUDE
266	in0 NONE NONE R 2
267	in1 NONE NONE R 2
268	in2 NONE NONE R 2
269	in3 NONE NONE R 2
270	in4 NONE NONE R 2
271	in5 NONE NONE R 2
272	in6 NONE NONE R 2
273	in0_min in0 in0 RW 2
274	in1_min in1 in1 RW 2
275	in2_min in2 in2 RW 2
276	in3_min in3 in3 RW 2
277	in4_min in4 in4 RW 2
278	in5_min in5 in5 RW 2
279	in6_min in6 in6 RW 2
280	in0_max in0 in0 RW 2
281	in1_max in1 in1 RW 2
282	in2_max in2 in2 RW 2
283	in3_max in3 in3 RW 2
284	in4_max in4 in4 RW 2
285	in5_max in5 in5 RW 2
286	in6_max in6 in6 RW 2
287	fan1 NONE NONE R 0
288	fan2 NONE NONE R 0
289	fan3 NONE NONE R 0
290	fan1_min fan1 fan1 RW 0
291	fan2_min fan2 fan2 RW 0
292	fan3_min fan3 fan3 RW 0
293	temp NONE NONE R 1
294	temp_hyst temp temp RW 1
295	temp_over temp temp RW 1
296	vid NONE NONE R 2
297	fan1_div fan1 NONE RW 0
298	fan2_div fan2 NONE RW 0
299	fan3_div fan3 NONE R 0
300	alarms NONE NONE R 0
301
302	LABEL FEATURE SYMBOL SYSCTL FILE:OFFSET
303	in0 SENSORS_LM79_IN0 in0:3
304	in1 SENSORS_LM79_IN1 in1:3
305	in2 SENSORS_LM79_IN2 in2:3
306	in3 SENSORS_LM79_IN3 in3:3
307	in4 SENSORS_LM79_IN4 in4:3
308	in5 SENSORS_LM79_IN5 in5:3
309	in6 SENSORS_LM79_IN6 in6:3
310	in0_min SENSORS_LM79_IN0_MIN in0:1
311	in1_min SENSORS_LM79_IN1_MIN in1:1
312	in2_min SENSORS_LM79_IN2_MIN in2:1
313	in3_min SENSORS_LM79_IN3_MIN in3:1
314	in4_min SENSORS_LM79_IN4_MIN in4:1
315	in5_min SENSORS_LM79_IN5_MIN in5:1
316	in6_min SENSORS_LM79_IN6_MIN in6:1
317	in0_max SENSORS_LM79_IN0_MAX in0:2
318	in1_max SENSORS_LM79_IN1_MAX in1:2
319	in2_max SENSORS_LM79_IN2_MAX in2:2
320	in3_max SENSORS_LM79_IN3_MAX in3:2
321	in4_max SENSORS_LM79_IN4_MAX in4:2
322	in5_max SENSORS_LM79_IN5_MAX in5:2
323	in6_max SENSORS_LM79_IN6_MAX in6:2
324	fan1 SENSORS_LM79_FAN1 fan1:2
325	fan2 SENSORS_LM79_FAN2 fan2:2
326	fan3 SENSORS_LM79_FAN3 fan3:2
327	fan1_min SENSORS_LM79_FAN1_MIN fan1:1
328	fan2_min SENSORS_LM79_FAN2_MIN fan2:1
329	fan3_min SENSORS_LM79_FAN3_MIN fan3:1
330	temp SENSORS_LM79_TEMP temp:3
331	temp_hyst SENSORS_LM79_TEMP_HYST temp:2
332	temp_over SENSORS_LM79_TEMP_OVER temp:1
333	vid SENSORS_LM79_VID vid:1
334	fan1_div SENSORS_LM79_FAN1_DIV fan_div:1
335	fan2_div SENSORS_LM79_FAN2_DIV fan_div:2
336	fan3_div SENSORS_LM79_FAN3_DIV fan_div:3
337	alarms SENSORS_LM79_ALARMS alarms:1

Note: See TracBrowser for help on using the browser.

Download in other formats:

Original Format