root/lm-sensors/trunk/README @ 1520

Revision 1520, 7.1 KB (checked in by mmh, 12 years ago)

added notes/mentions SiS645

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