| 1 |
============================================================================= |
|---|
| 2 |
|
|---|
| 3 |
FOR QUICK INSTALLATION INSTRUCTIONS SEE THE 'QUICKSTART' FILE. |
|---|
| 4 |
FOR FULL INSTALLATION INSTRUCTIONS SEE THE 'INSTALL' FILE. |
|---|
| 5 |
FOR THE FAQ SEE THE 'doc/FAQ' or 'doc/lm_sensors-FAQ.html' FILES. |
|---|
| 6 |
|
|---|
| 7 |
============================================================================= |
|---|
| 8 |
|
|---|
| 9 |
OVERVIEW OF THE LM_SENSORS PACKAGE AND SUMMARY OF SUPPORTED DEVICES |
|---|
| 10 |
|
|---|
| 11 |
!!! This package is ONLY for 2.6 and 2.4 kernels (2.4.10 or later). !!! |
|---|
| 12 |
!!! For 2.4 kernels, this package requires i2c-2.9.0 or later. !!! |
|---|
| 13 |
|
|---|
| 14 |
FOR 2.6 KERNELS, use only the userspace tools in this package! |
|---|
| 15 |
Build and install them with 'make user' and 'make user_install'. |
|---|
| 16 |
The kernel modules in this package will NOT compile for 2.6; |
|---|
| 17 |
use the drivers already in the 2.6 kernel. Check the QUICKSTART |
|---|
| 18 |
file for brief installation instructions please. |
|---|
| 19 |
|
|---|
| 20 |
============================================================================= |
|---|
| 21 |
|
|---|
| 22 |
This is the completely rewritten version 2 of lm_sensors, a collection of |
|---|
| 23 |
modules for general SMBus[1] access and hardware monitoring. |
|---|
| 24 |
Version 1 is now officially unsupported. |
|---|
| 25 |
|
|---|
| 26 |
WARNING! The drivers in this package will work on reasonably recent 2.4 |
|---|
| 27 |
kernels only (2.4.10 and later). |
|---|
| 28 |
Use lm_sensors-2.4.5 for 2.0 kernels. |
|---|
| 29 |
Use lm_sensors-2.7.0 for 2.2, and early 2.4 (up to 2.4.9) kernels. |
|---|
| 30 |
Use the drivers already in the kernel for 2.6 kernels; if you need |
|---|
| 31 |
additional drivers in 2.6 please port and submit them to us. |
|---|
| 32 |
|
|---|
| 33 |
HOWEVER, the userspace tools in this package will work for |
|---|
| 34 |
both 2.4 and 2.6 kernels. |
|---|
| 35 |
|
|---|
| 36 |
The I2C[2] package in existing 2.4 kernels is NOT sufficient |
|---|
| 37 |
for compilation of this package. You need i2c-2.9.0 or later. |
|---|
| 38 |
|
|---|
| 39 |
See the lm_sensors download page for further guidance: |
|---|
| 40 |
http://www.lm-sensors.org/wiki/Download |
|---|
| 41 |
|
|---|
| 42 |
|
|---|
| 43 |
============================================================================= |
|---|
| 44 |
|
|---|
| 45 |
At least the following I2C/SMBus adapters are supported: |
|---|
| 46 |
Acer Labs M1533, M1535, M1543C and M1563 |
|---|
| 47 |
AMD 756, 766, 768 and 8111 |
|---|
| 48 |
AMD 8111 SMBus 2.0 |
|---|
| 49 |
Apple Hydra (used on some PPC machines) |
|---|
| 50 |
ATI IXP200, IXP300, IXP400 |
|---|
| 51 |
DEC 21272/21274 (Tsunami/Typhoon - on Alpha boards) |
|---|
| 52 |
Intel I801 ICH/ICH0/ICH2/ICH3/ICH4/ICH5/ICH6/ICH7/ICH8 (82801xx), 6300ESB |
|---|
| 53 |
Intel PIIX4 (used in many Intel chipsets) |
|---|
| 54 |
Intel I810/I810E/I815/I845G GMCH |
|---|
| 55 |
Intel 82443MX (440MX) |
|---|
| 56 |
NVidia nForce, nForce2, nForce3, nForce4 |
|---|
| 57 |
ServerWorks OSB4, CSB5, CSB6, HT-1000 |
|---|
| 58 |
SiS 5595, 630, 645, 655, 730 |
|---|
| 59 |
SMSC Victory66 |
|---|
| 60 |
3Dfx Voodoo 3 and Banshee |
|---|
| 61 |
VIA Technologies VT82C586B, VT82C596A/B, VT82C686A/B, VT8231, |
|---|
| 62 |
VT8233, VT8233A, VT8235, VT8237R/A and VT8251 |
|---|
| 63 |
|
|---|
| 64 |
|
|---|
| 65 |
At least the following hardware sensor chips are supported: |
|---|
| 66 |
Analog Devices ADM1021, ADM1021A, ADM1022, ADM1023, ADM1024, |
|---|
| 67 |
ADM1025, ADM1026, ADM1027, ADM1030, ADM1031, |
|---|
| 68 |
ADM1032, ADM9240, ADT7461 and ADT7463 |
|---|
| 69 |
Asus AS99127F, ASB100 Bach |
|---|
| 70 |
Dallas Semiconductor DS75, DS1621, DS1625, DS1775, and DS1780 |
|---|
| 71 |
Hewlett Packard Maxilife (several revisions including '99 NBA) |
|---|
| 72 |
Fintek F71805F/FG |
|---|
| 73 |
Fujitsu Siemens Poseidon, Scylla, Hermes |
|---|
| 74 |
Genesys Logic GL518SM, GL520SM, GL523SM |
|---|
| 75 |
Intel Xeon processor embedded sensors |
|---|
| 76 |
ITE IT8705F, IT8712F |
|---|
| 77 |
Maxim MAX1617, MAX1617A, MAX1619, MAX6650, MAX6651, |
|---|
| 78 |
MAX6633, MAX6634, MAX6635, MAX6657, MAX6658, MAX6659 |
|---|
| 79 |
Microchip TC1068, TCM1617, TCN75 |
|---|
| 80 |
Myson MTP008 |
|---|
| 81 |
National Semiconductor LM63, LM75, LM76, LM78, LM78-J, LM79, |
|---|
| 82 |
LM80, LM81, LM82, LM83, LM84, LM85, LM86, LM87, |
|---|
| 83 |
LM89, LM90, LM92, LM93, LM99, PC87360, |
|---|
| 84 |
PC87363, PC87364, PC87365, PC87366 |
|---|
| 85 |
Philips NE1617, NE1617A, NE1619 |
|---|
| 86 |
SiS 5595, 950 embedded sensors |
|---|
| 87 |
SMSC 47M1xx embedded sensors, EMC6D100, EMC6D101, EMC6D102 |
|---|
| 88 |
TI THMC10 and THMC50 |
|---|
| 89 |
VIA Technologies VT1211, VT8231 and VT82C686A/B embedded sensors |
|---|
| 90 |
Winbond W83781D, W83782D, W83783S, W83791D, W83792D, |
|---|
| 91 |
W83627HF, W83627THF, W83637HF, W83687THF and W83697HF |
|---|
| 92 |
|
|---|
| 93 |
|
|---|
| 94 |
We also support some miscellaneous chips: |
|---|
| 95 |
Dallas DS1307 real time clock |
|---|
| 96 |
Intel Xeon processor embedded EEPROMs |
|---|
| 97 |
Linear Technologies LTC1710 |
|---|
| 98 |
Philips Semiconductors PCF8574, PCF8591 |
|---|
| 99 |
DDC Monitor embedded EEPROMs |
|---|
| 100 |
SDRAM Dimms with Serial Presence Detect EEPROMs |
|---|
| 101 |
Smart Battery sensors |
|---|
| 102 |
IPMI-BMC sensors |
|---|
| 103 |
Philips Semiconductors SAA1064 |
|---|
| 104 |
|
|---|
| 105 |
|
|---|
| 106 |
The list above may be out of date; |
|---|
| 107 |
see our Devices page at http://www.lm-sensors.org/wiki/Devices |
|---|
| 108 |
for the latest information on supported devices. |
|---|
| 109 |
You may also refer to doc/chips/SUMMARY for details on what each chip |
|---|
| 110 |
can monitor. |
|---|
| 111 |
|
|---|
| 112 |
|
|---|
| 113 |
We always appreciate testers. If you own a specific monitoring chip we do |
|---|
| 114 |
not yet (properly) support, and are willing to help us out, please contact |
|---|
| 115 |
us. Even if you have no programming knowledge, you could help us by running |
|---|
| 116 |
new modules and reporting on the results and output. If you want to offer |
|---|
| 117 |
more substantial help, this is very welcome too, of course. |
|---|
| 118 |
|
|---|
| 119 |
|
|---|
| 120 |
Don't ask us whether we support a particular mainboard; we do not know. |
|---|
| 121 |
We *do* know what hardware we support, but usually, it is easier to |
|---|
| 122 |
install everything and run sensors-detect. It will tell you what hardware |
|---|
| 123 |
you have (and incidentally, what corresponding drivers are needed). |
|---|
| 124 |
|
|---|
| 125 |
|
|---|
| 126 |
SMBus, also known as System Management Bus, is a protocol for communicating |
|---|
| 127 |
through a I2C ('I squared C') bus. Many modern mainboards have a System |
|---|
| 128 |
Management Bus. There are a lot of devices which can be connected to a |
|---|
| 129 |
SMBus; the most notable are modern memory chips with EEPROM memories and |
|---|
| 130 |
chips for hardware monitoring. |
|---|
| 131 |
|
|---|
| 132 |
Most modern mainboards incorporate some form of hardware monitoring chips. |
|---|
| 133 |
These chips read things like chip temperatures, fan rotation speeds and |
|---|
| 134 |
voltage levels. There are quite a few different chips which can be used by |
|---|
| 135 |
mainboard builders for approximately the same results. |
|---|
| 136 |
|
|---|
| 137 |
Hardware monitoring chips often have an SMBus or I2C interface. Some are |
|---|
| 138 |
connected to ISA bus instead. Some of them can do both, in which case we |
|---|
| 139 |
either support both access methods (old drivers) or only support ISA |
|---|
| 140 |
access (new drivers) as it is faster. |
|---|
| 141 |
|
|---|
| 142 |
Because the SMBus is just a special case of the generalized I2C bus, we can |
|---|
| 143 |
simulate the SMBus protocol on plain I2C busses. These busses are sometimes |
|---|
| 144 |
used in other parts of your computer. If a supported chip is attached to |
|---|
| 145 |
one of these additional busses, they can be used too. |
|---|
| 146 |
|
|---|
| 147 |
Please read INSTALL before trying to compile and install these modules. |
|---|
| 148 |
There is a lot of additional documentation in the doc/ subdirectory. |
|---|
| 149 |
|
|---|
| 150 |
The developers of this package can be reached through a mailing-list |
|---|
| 151 |
(see http://www.lm-sensors.org/wiki/AuthorsAndContributors). Do not hesitate |
|---|
| 152 |
to mail us if you have questions, suggestions, problems, want to |
|---|
| 153 |
contribute, or just want to report it works for you. But please try to |
|---|
| 154 |
read the documentation and FAQ before you ask any questions! |
|---|
| 155 |
|
|---|
| 156 |
The latest version of this package can always be found at: |
|---|
| 157 |
http://www.lm-sensors.org/wiki/Download. Pre-release versions can be |
|---|
| 158 |
retrieved through anonymous SVN; see doc/svn for details. |
|---|
| 159 |
|
|---|
| 160 |
This package may be distributed according to the GNU General Public |
|---|
| 161 |
License (GPL), as included in the file COPYING. |
|---|
| 162 |
|
|---|
| 163 |
Note that libsensors falls under the GPL, not the LGPL. In more human |
|---|
| 164 |
language, that means it is FORBIDDEN to link any application to the |
|---|
| 165 |
library, even to the shared version, if the application itself does not |
|---|
| 166 |
fall under the GPL. |
|---|
| 167 |
|
|---|
| 168 |
|
|---|
| 169 |
----- |
|---|
| 170 |
[1] SMBus is a trademark of Intel Corporation |
|---|
| 171 |
[2] I2C is a trademark of Philips Corporation |
|---|
