| 1 |
INSTALLATION INSTRUCTIONS |
|---|
| 2 |
========================= |
|---|
| 3 |
|
|---|
| 4 |
The lm-sensors package, version 3, provides user-space support for the |
|---|
| 5 |
hardware monitoring drivers in Linux 2.6.5 and later. For older kernel |
|---|
| 6 |
versions, you have to use lm-sensors version 2. |
|---|
| 7 |
|
|---|
| 8 |
|
|---|
| 9 |
Dependencies |
|---|
| 10 |
============ |
|---|
| 11 |
|
|---|
| 12 |
Build-time dependencies: |
|---|
| 13 |
* GNU make |
|---|
| 14 |
* gcc |
|---|
| 15 |
* bison |
|---|
| 16 |
* flex |
|---|
| 17 |
* libsysfs header files (from sysfsutils-devel) |
|---|
| 18 |
* rrd header files (optional, for sensord) |
|---|
| 19 |
|
|---|
| 20 |
Run-time dependencies: |
|---|
| 21 |
* libsysfs (from sysfsutils) |
|---|
| 22 |
* perl (for sensors-detect) |
|---|
| 23 |
* rrd (optional, for sensord) |
|---|
| 24 |
* proper kernel configuration (see below) |
|---|
| 25 |
|
|---|
| 26 |
|
|---|
| 27 |
Compilation |
|---|
| 28 |
=========== |
|---|
| 29 |
|
|---|
| 30 |
At the top of the Makefile are a couple of configuration variables that |
|---|
| 31 |
you may want to change. There's a description of what each variable does |
|---|
| 32 |
in the Makefile itself. |
|---|
| 33 |
|
|---|
| 34 |
Compilation is done by `make all'. You will get a lot of warnings about |
|---|
| 35 |
files which are not found, all ending in `.*d'. You can safely ignore |
|---|
| 36 |
this; they contain dependency information, which is regenerated on the |
|---|
| 37 |
spot. |
|---|
| 38 |
|
|---|
| 39 |
`make install' installs the package (to /usr/local by default). |
|---|
| 40 |
|
|---|
| 41 |
|
|---|
| 42 |
Kernel configuration |
|---|
| 43 |
==================== |
|---|
| 44 |
|
|---|
| 45 |
This package assumes that you have a properly configured kernel. If |
|---|
| 46 |
you run a distribution kernel, that should be the case. If you're |
|---|
| 47 |
building your own kernel, here are some recommendations: |
|---|
| 48 |
* Enable "I2C support" (CONFIG_I2C=y or m). On many motherboards, the |
|---|
| 49 |
sensor chip is connected to the SMBus, which is supported by I2C |
|---|
| 50 |
in the Linux kernel. |
|---|
| 51 |
* Enable "I2C device interface" (CONFIG_I2C_CHARDEV=m). sensors-detect |
|---|
| 52 |
needs this to probe for SMBus hardware monitoring chips. |
|---|
| 53 |
* In I2C Hardware Bus support, enable all drivers you might need, |
|---|
| 54 |
preferably as modules. If you're not sure, select them all. |
|---|
| 55 |
* Enable "Hardware Monitoring support" (CONFIG_HWMON=y or m). |
|---|
| 56 |
* Enable all hardware monitoring drivers you might need, preferably |
|---|
| 57 |
as modules. If you're not sure, select them all. |
|---|
| 58 |
|
|---|
| 59 |
|
|---|
| 60 |
Using the sensors package |
|---|
| 61 |
========================= |
|---|
| 62 |
|
|---|
| 63 |
There is a scanning program installed called sensors-detect. It |
|---|
| 64 |
will scan all available I2C and SMBus adapters for all known sensor |
|---|
| 65 |
devices, and will also look for ISA, PCI and Super-I/O chips with |
|---|
| 66 |
sensors, and give you a list of what kernel drivers you need to load |
|---|
| 67 |
(using modprobe). |
|---|
| 68 |
|
|---|
| 69 |
After loading the suggested drivers, you can use the installed sensors |
|---|
| 70 |
program to get a report of all detected sensor devices. Chek the manual |
|---|
| 71 |
page for available options. |
|---|
| 72 |
|
|---|
| 73 |
The initial output of `sensors' will not be perfect. You have to adjust |
|---|
| 74 |
the configuration file (/etc/sensors.conf) to match your motherboard. |
|---|
| 75 |
This includes (re)labelling inputs, ignoring unused inputs, changing |
|---|
| 76 |
voltage compute lines and setting limits. Write down all the sensor |
|---|
| 77 |
information your BIOS displays as a hint to what you are supposed to |
|---|
| 78 |
obtain in the end. Make sure you modify the right chip section. |
|---|
| 79 |
|
|---|
| 80 |
Once you are done with editing the configuration file, calling |
|---|
| 81 |
`sensors -s' will set the new limits. Then the output of `sensors' |
|---|
| 82 |
should look much better. |
|---|
| 83 |
|
|---|
| 84 |
There are many auxiliary programs not installed. You can find them under |
|---|
| 85 |
the prog subdirectory. A list can be found in doc/progs. |
|---|
