root/lm-sensors/trunk/INSTALL

Revision 5072, 3.0 KB (checked in by khali, 6 years ago)

sensord: Drop workaround needed by old versions of rrdtool. The bug
(missing getopt variables initialization) was fixed in rrdtool version
1.2.1, 2.5 years ago.

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