root/lm-sensors/trunk/doc/chips/lm83 @ 3000

Revision 3000, 5.7 KB (checked in by khali, 10 years ago)

Fix common spelling errors.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1Kernel driver `lm83.o'
2=====================
3
4Status: Complete and lightly tested
5
6Supported chips:
7  * National Semiconductor LM83
8    Prefix: `lm83'
9    Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e (inclusive)
10    Datasheet: Publicly available at the National Semiconductor website
11               http://www.national.com/pf/LM/LM83.html
12
13
14Author: Jean Delvare <khali@linux-fr.org>
15
16License: GPL
17
18
19Module Parameters
20-----------------
21
22* force: short array (min = 1, max = 48)
23  List of adapter,address pairs to boldly assume to be present
24* force_lm83: short array (min = 1, max = 48)
25  List of adapter,address pairs which are unquestionably assumed to contain
26  a `lm83' chip
27* probe: short array (min = 1, max = 48)
28  List of adapter,address pairs to scan additionally
29* probe_range: short array (min = 1, max = 48)
30  List of adapter,start-addr,end-addr triples to scan additionally
31* ignore: short array (min = 1, max = 48)
32  List of adapter,address pairs not to scan
33* ignore_range: short array (min = 1, max = 48)
34  List of adapter,start-addr,end-addr triples not to scan
35
36
37Description
38-----------
39
40The LM83 is a digital temperature sensor. It senses its own temperature as
41well as the temperature of up to three external diodes. It is compatible
42with many other devices such as the LM84 and all other ADM1021 clones.
43The main difference between the LM83 and the LM84 in that the later can
44only sense the temperature of one external diode.
45
46Using the adm1021 driver for a LM83 should work, but only two temperatures
47will be reported instead of four.
48
49The LM83 is only found on a handful of motherboards. Both a confirmed
50list and an unconfirmed list follow. If you can confirm or infirm the
51fact that any of these motherboards do actually have an LM83, please
52contact us. Note that the LM90 can easily be misdetected as a LM83.
53
54Confirmed motherboards:
55    SBS         P014
56
57Unconfirmed motherboards:
58    Gigabyte    GA-8IK1100
59    Iwill       MPX2
60    Soltek      SL-75DRV5
61
62The driver has been successfully tested by Magnus Forsström, who I'd
63like to thank here. More testers will be of course welcome.
64
65The fact that the LM83 is only scarcely used can be easily explained.
66Most motherboards come with more than just temperature sensors for
67health monitoring. They also have voltage and fan rotation speed
68sensors. This means that temperature-only chips are usually used as
69secondary chips coupled with another chip such as an IT87 or similar
70chip, which provides more features. Since systems usually need three
71temperature sensors (motherboard, processor, power supply) and primary
72chips provide some temperature sensors, the secondary chip, if needed,
73won't have to handle more than two temperatures. Thus, ADM1021 clones
74are sufficent, and there is no need for a four temperatures sensor
75chip such as the LM83. The only case where using an LM83 would make
76sense is on SMP systems, such as the above-mentioned Iwill MPX2,
77because you want an additional temperature sensor for each additional
78CPU.
79
80On the SBS P014, this is different, since the LM83 is the only hardware
81monitoring chipset. One temperature sensor is used for the motherboard
82(actually measuring the LM83's own temperature), one is used for the
83CPU. The two other sensors must be used to measure the temperature of
84two other points of the motherboard. We suspect these points to be the
85north and south bridges, but this couldn't be confirmed.
86
87All temperature values are given in degrees Celsius. Local temperature
88is given within a range of 0 to +85 degrees. Remote temperatures are
89given within a range of 0 to +125 degrees. Resolution is 1.0 degree,
90accuracy is guaranteed to 3.0 degrees (see the datasheet for more
91details).
92
93Each sensor has its own high limit, but the critical limit is common to
94all four sensors. There is no hysteresis mechanism as found on most
95recent temperature sensors.
96
97The lm83 driver will not update its values more frequently than every
98other second; reading them more often will do no harm, but will return
99'old' values.
100
101
102Chip Features
103-------------
104
105Chip 'lm83'
106
107LABEL                 LABEL CLASS           COMPUTE CLASS          MODE  MAGN
108temp1                 -                     -                       R-     0
109temp1_high            temp1                 temp1                   RW     0
110temp2                 -                     -                       R-     0
111temp2_high            temp2                 temp2                   RW     0
112temp3                 -                     -                       R-     0
113temp3_high            temp3                 temp3                   RW     0
114temp4                 -                     -                       R-     0
115temp4_high            temp4                 temp4                   RW     0
116tcrit                 -                     -                       RW     0
117alarms                -                     -                       R-     0
118
119LABEL                 FEATURE SYMBOL                              SYSCTL FILE:N
120temp1                 SENSORS_LM83_LOCAL_TEMP                           temp1:2
121temp1_high            SENSORS_LM83_LOCAL_HIGH                           temp1:1
122temp2                 SENSORS_LM83_REMOTE1_TEMP                         temp2:2
123temp2_high            SENSORS_LM83_REMOTE1_HIGH                         temp2:1
124temp3                 SENSORS_LM83_REMOTE2_TEMP                         temp3:2
125temp3_high            SENSORS_LM83_REMOTE2_HIGH                         temp3:1
126temp4                 SENSORS_LM83_REMOTE3_TEMP                         temp4:2
127temp4_high            SENSORS_LM83_REMOTE3_HIGH                         temp4:1
128tcrit                 SENSORS_LM83_TCRIT                                tcrit:1
129alarms                SENSORS_LM83_ALARMS                              alarms:1
Note: See TracBrowser for help on using the browser.