root/lm-sensors/trunk/README @ 1105

Revision 1105, 6.2 KB (checked in by mds, 14 years ago)

minor update for 2.6.0

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1=============================================================================
2     FOR QUICK INSTALLATION INSTRUCTIONS SEE THE 'QUICKSTART' FILE.
3     FOR FULL INSTALLATION INSTRUCTIONS SEE THE 'INSTALL' FILE.
4     FOR THE FAQ SEE THE 'doc/FAQ' FILE.
5=============================================================================
6
7OVERVIEW OF THE LM_SENSORS PACKAGE AND SUMMARY OF SUPPORTED DEVICES
8
9This is the completely rewritten version 2 of lm_sensors, a collection of
10modules for general SMBus access and hardware monitoring.
11Version 1 is now officially unsupported.
12
13WARNING! Starting with lm_sensors version 2.5.0, only kernels 2.2.0 and
14later are supported. Use lm_sensors version 2.4.5 if you use an older
15kernel.
16
17WARNING! If you downloaded this package through our CVS archive, you walk
18the cutting edge. Things may not even compile! On the other hand, you will
19be the first to profit from new drivers and other changes. Have fun!
20
21WARNING! You also need the latest i2c package,
22EVEN IF your kernel does contain i2c support!!!!!!!!!,
23unless i2c came bundled with lm_sensors.
24
25Kernels 2.3.34 and later, and all 2.4.x kernels, contain the
26I2C package; however, you will still need to download and install
27the latest I2C version if you want lm_sensors to compile.
28
29See the lm_sensors download page for guidance:
30  http://www.netroedge.com/~lm78/download.html
31
32
33At least the following I2C/SMBus adapters are supported:
34  Acer Labs M1533, M1535, and M1543C
35  AMD 756
36  Apple Hydra (used on some PPC machines)
37  Intel I801 ICH/ICH0/ICH2 (used in Intel 810, 810E, 815E, 820, 840 chipsets)
38  Intel PIIX4 (used in many Intel chipsets)
39  Intel I810/I815 GMCH
40  ServerWorks OSB4
41  SiS 5595
42  3Dfx Voodoo 3 and Banshee
43  VIA Technologies VT82C586B, VT82C596A/B, and VT82C686A
44
45
46At least the following hardware sensor chips are supported:
47  Analog Devices ADM1021, ADM1021A, ADM1022,
48                 ADM1023, ADM1024, ADM1025, and ADM9240
49  Asus AS99127F
50  Dallas Semiconductor DS75, DS1621, DS1625, DS1775, and DS1780
51  Hewlett Packard Maxilife (several revisions including '99 NBA)
52  Genesys Logic GL518SM (rev 00, 80), GL520SM, GL523SM
53  Intel Xeon processor embedded sensors
54  Maxim MAX1617 and MAX1617A
55  Myson MTP008
56  National Semicoductor LM75, LM77, LM78, LM78-J, LM79,
57                        LM80, LM81, LM84, and LM87
58  SiS 5595 embedded sensors
59  TelCom TCN75
60  TI THMC10 and THMC50
61  VIA Technologies VT82C686A/B embedded sensors
62  Winbond W83781D, W83782D, W83783S, and W83627HF
63
64
65We also support some miscellaneous chips:
66  Linear Technologies LTC1710
67  SDRAM Dimms with Serial Presence Detect EEPROMs
68  Intel Xeon processor embedded EEPROMs
69  DDC Monitor embedded EEPROMs
70
71
72We always appreciate testers. If you own a specific monitoring
73chip listed on our 'new drivers' page, and are willing to help us out,
74please contact us. Even if you have no programming knowledge, you could
75help us by running new modules and reporting on the results and output.
76If you want to offer more substantial help, this is very welcome too, of
77course.
78
79
80Don't ask us whether we support a particular mainboard; we do not know.
81We *do* know what hardware we support, but usually, it is easier to
82install everything and run sensors-detect. It will tell you what hardware
83you have (and incidentally, what corresponding drivers are needed). You
84could also take a look at http://mbm.livewiredev.com/
85(this lists chips found on many mainboard, but regrettable, not the adapters
86on them) or http://web01.fureai.or.jp/~hirobo/project/reserch_project.html
87(yes, it is japanese; you want the ninth column, and it again lists only
88chips, not adapters).
89
90
91SMBus, also known as System Management Bus, is a protocol for communicating
92through a I2C ('I squared C') bus. Many modern mainboards have a System
93Management Bus. There are a lot of devices which can be connected to a
94SMBus; the most notable are modern memory chips with EEPROM memories and
95chips for hardware monitoring.
96
97Most modern mainboards incorporate some form of hardware monitoring chips.
98These chips read things like chip temperatures, fan rotation speeds and
99voltage levels. There are quite a few different chips which can be used
100by mainboard builders for approximately the same results.
101
102Hardware monitoring chips are often connected to the SMBus, but often they
103can also be connected to the ISA bus. The modules in this package usually
104support both ways of accessing them.
105
106Because the SMBus is just a special case of the generalized I2C bus, we
107can simulate the SMBus protocol on plain I2C busses. These busses are
108sometimes used in other parts of your computer. If a supported chip is
109attached to one of these additional busses, they can be used too.
110
111Please read INSTALL before trying to compile and install these modules.
112There is a lot of additional documentation in the doc/ subdirectory.
113Amnong these is a list of supported busses and chips. Regrettably, there
114are too many mainboards to keep a list of busses and chips used on them.
115On the other hand, we provide a program called 'sensors-detect' which
116tries to figure out what hardware is available on your system.
117
118The developers of this package can be reached through the email address
119<sensors@stimpy.netroedge.com>. Do not hesitate to mail us if you have
120questions, suggestions, problems, want to contribute, or just want to
121report it works for you. But please try to read the documentation and
122FAQ before you ask any questions!
123
124The latest version of this package can always be found on our homepage:
125http://www.netroedge.com/~lm78. Pre-release versions can be retrieved
126through anonymous CVS; see doc/cvs for more information.
127
128This whole package is copyright (c) 1998 - 2001 by Frodo Looijaard and
129Philip Edelbrock, except for a few drivers written by
130other people. See the individual files for more exact copyright information. 
131This package may be distributed according to the GNU General Public License
132(GPL), as included in the file COPYING.
133
134Note that at this moment, libsensors falls under the GPL, not the LGPL.
135In more human language, that means it is FORBIDDEN to link any application
136to the library, even to the shared version, if the application itself
137does not fall under the GPL. This will probably be changed in the future.
138In the meantime, you will have to contact us first if you want to do this.
Note: See TracBrowser for help on using the browser.