| 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 |
|---|
