root/lm-sensors/branches/lm-sensors-3.0.0/INSTALL @ 4990

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

Use /etc/sensors3.conf as the default configuration file. If it can't
be found, fallback to /etc/sensors.conf. This allows for an old
libsensors and a new libsensors to be installed in parallel, and each
one has its own configuration file.

One important change here is that the default configuration file will
be installed as /etc/sensors3.conf by "make install".

  • 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* libsysfs header files (from sysfsutils-devel)
18* rrd header files (optional, for sensord)
19
20Run-time dependencies:
21* libsysfs (from sysfsutils)
22* perl (for sensors-detect)
23* rrd (optional, for sensord)
24* proper kernel configuration (see below)
25
26
27Compilation
28===========
29
30At the top of the Makefile are a couple of configuration variables that
31you may want to change. There's a description of what each variable does
32in the Makefile itself.
33
34Compilation is done by `make all'. You will get a lot of warnings about
35files which are not found, all ending in `.*d'. You can safely ignore
36this; they contain dependency information, which is regenerated on the
37spot.
38
39`make install' installs the package (to /usr/local by default).
40
41
42Kernel configuration
43====================
44
45This package assumes that you have a properly configured kernel. If
46you run a distribution kernel, that should be the case. If you're
47building 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
60Using the sensors package
61=========================
62
63There is a scanning program installed called sensors-detect. It
64will scan all available I2C and SMBus adapters for all known sensor
65devices, and will also look for ISA, PCI and Super-I/O chips with
66sensors, and give you a list of what kernel drivers you need to load
67(using modprobe).
68
69After loading the suggested drivers, you can use the installed sensors
70program to get a report of all detected sensor devices. Chek the manual
71page for available options.
72
73The initial output of `sensors' will not be perfect. You have to adjust
74the configuration file (/etc/sensors3.conf) to match your motherboard.
75This includes (re)labelling inputs, ignoring unused inputs, changing
76voltage compute lines and setting limits. Write down all the sensor
77information your BIOS displays as a hint to what you are supposed to
78obtain in the end. Make sure you modify the right chip section.
79
80Once you are done with editing the configuration file, calling
81`sensors -s' will set the new limits. Then the output of `sensors'
82should look much better.
83
84There are many auxiliary programs not installed. You can find them under
85the prog subdirectory. A list can be found in doc/progs.
Note: See TracBrowser for help on using the browser.