|
Packit |
53d5b6 |
OVERVIEW OF THE LM-SENSORS PACKAGE
|
|
Packit |
53d5b6 |
==================================
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
The lm-sensors package, version 3, provides user-space support for the
|
|
Packit |
53d5b6 |
hardware monitoring drivers in Linux 2.6.5 and later. For older kernel
|
|
Packit |
53d5b6 |
versions, you have to use lm-sensors version 2.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
The directories within this package:
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
* doc
|
|
Packit |
53d5b6 |
Documentation.
|
|
Packit |
53d5b6 |
* etc
|
|
Packit |
53d5b6 |
A sample configuration file for libsensors, and a script to convert
|
|
Packit |
53d5b6 |
lm-sensors version 2 configuration files to work with version 3.
|
|
Packit |
53d5b6 |
* lib
|
|
Packit |
53d5b6 |
The user-space sensors support library code (libsensors).
|
|
Packit |
53d5b6 |
* prog
|
|
Packit |
53d5b6 |
Several supporting programs. The most important ones are:
|
|
Packit |
53d5b6 |
- sensors-detect: A stand-alone program for detecting installed
|
|
Packit |
53d5b6 |
hardware and recommending specific modules to load.
|
|
Packit |
53d5b6 |
- sensors: A console tool to report sensor readings and set new
|
|
Packit |
53d5b6 |
sensor limits.
|
|
Packit |
53d5b6 |
- sensord: A daemon to watch sensor values and log problems. It
|
|
Packit |
53d5b6 |
includes RRD support.
|
|
Packit |
53d5b6 |
* configs
|
|
Packit |
53d5b6 |
This directory contains sample configurations of various boards,
|
|
Packit |
53d5b6 |
contributed by users of lm-sensors.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
Older sample configurations can be found on an old lm-sensors wiki
|
|
Packit |
53d5b6 |
archived here:
|
|
Packit |
53d5b6 |
http://web.archive.org/web/20150901092438/http://www.lm-sensors.org:80/wiki/Configurations
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
Please contribute back a configuration of your board so other users with
|
|
Packit |
53d5b6 |
the same hardware won't need to recreate it again and again.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
INSTALLING LM-SENSORS
|
|
Packit |
53d5b6 |
---------------------
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
See the INSTALL file.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
HARDWARE SUPPORT
|
|
Packit |
53d5b6 |
----------------
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
To find out what hardware you have, just run 'sensors-detect' as root.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
Most modern mainboards incorporate some form of hardware monitoring chips.
|
|
Packit |
53d5b6 |
These chips read things like chip temperatures, fan rotation speeds and
|
|
Packit |
53d5b6 |
voltage levels. There are quite a few different chips which can be used by
|
|
Packit |
53d5b6 |
mainboard builders for approximately the same results.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
Laptops, on the other hand, rarely expose any hardware monitoring
|
|
Packit |
53d5b6 |
chip. They often have some BIOS and/or ACPI magic to get the CPU
|
|
Packit |
53d5b6 |
temperature value, but that's about it. For such laptops, the lm-sensors
|
|
Packit |
53d5b6 |
package is of no use (sensors-detect will not find anything), and you have
|
|
Packit |
53d5b6 |
to use acpi instead.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
This package doesn't contain chip-specific knowledge. It will support all
|
|
Packit |
53d5b6 |
the hardware monitoring chips your kernel has drivers for. In other words,
|
|
Packit |
53d5b6 |
if you find out that you have unsupported hardware (e.g. sensors-detect
|
|
Packit |
53d5b6 |
told you so) then it means that you need a more recent kernel, or you
|
|
Packit |
53d5b6 |
even need to wait for a new kernel driver to be written. Updating the
|
|
Packit |
53d5b6 |
lm-sensors package itself will not help.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
LIBSENSORS
|
|
Packit |
53d5b6 |
----------
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
The kernel drivers communicate their information through the /sys
|
|
Packit |
53d5b6 |
interface. Because every motherboard is different, the drivers always
|
|
Packit |
53d5b6 |
advert the measurements at their pins. This means that the values they
|
|
Packit |
53d5b6 |
report are not always immediately relevant to you. They have to be
|
|
Packit |
53d5b6 |
labelled properly, and sometimes they must be scaled to correspond to
|
|
Packit |
53d5b6 |
real-world values.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
libsensors is a (shared or static) library of access functions. It
|
|
Packit |
53d5b6 |
offers a simple-to-use interface for applications to access the sensor
|
|
Packit |
53d5b6 |
chip readings and configure them as you like. It has a configuration
|
|
Packit |
53d5b6 |
file where you can put all the motherboard-specific labels and
|
|
Packit |
53d5b6 |
conversion rules. That way, all applications do not need to duplicate
|
|
Packit |
53d5b6 |
the effort and can simply link with libsensors and work out of the box.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
APPLICATIONS
|
|
Packit |
53d5b6 |
------------
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
This package contains an example console program that reports all current
|
|
Packit |
53d5b6 |
sensors values. This program is called 'sensors'. You can use it as a
|
|
Packit |
53d5b6 |
reference implementation for more intricate programs. It also contains a
|
|
Packit |
53d5b6 |
daemon watching for sensor values, logging alarms and feeding an RRD
|
|
Packit |
53d5b6 |
database with the sensor measurements.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
This package does not contain a nice graphical monitor. See
|
|
Packit |
53d5b6 |
http://sensors-applet.sourceforge.net/
|
|
Packit |
53d5b6 |
https://01.org/powertop/
|
|
Packit |
53d5b6 |
https://wpitchoune.net/psensor/
|
|
Packit |
53d5b6 |
https://amanusk.github.io/s-tui/
|
|
Packit |
53d5b6 |
for such programs.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
OTHER INFORMATION
|
|
Packit |
53d5b6 |
-----------------
|
|
Packit |
53d5b6 |
|
|
Packit Service |
5377e5 |
The lm_sensors website can be found at
|
|
Packit Service |
5377e5 |
https://hwmon.wiki.kernel.org/lm_sensors
|
|
Packit Service |
5377e5 |
|
|
Packit Service |
5377e5 |
The developers of this package can be reached using
|
|
Packit Service |
5377e5 |
* a mailing list lm-sensors <at> vger <dot> kernel <dot> org
|
|
Packit Service |
5377e5 |
(you can get information on how to subscribe, unsubscribe, and the list
|
|
Packit Service |
5377e5 |
of archives at http://vger.kernel.org/vger-lists.html#lm-sensors;
|
|
Packit Service |
5377e5 |
you do not need to be subscribed to post to the list)
|
|
Packit Service |
5377e5 |
* GitHub (see https://github.com/lm-sensors/lm-sensors)
|
|
Packit Service |
5377e5 |
|
|
Packit Service |
5377e5 |
Do not hesitate to contact us if you have questions, suggestions, problems,
|
|
Packit Service |
5377e5 |
want to contribute, or just want to report it works for you. But please try to
|
|
Packit |
53d5b6 |
read the documentation before you ask any questions! It's all under doc/.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
The latest version of this package can always be found at:
|
|
Packit Service |
5377e5 |
https://github.com/lm-sensors/lm-sensors.
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
LICENSE
|
|
Packit |
53d5b6 |
-------
|
|
Packit |
53d5b6 |
|
|
Packit |
53d5b6 |
The library (libsensors) is released under the GNU Lesser General Public
|
|
Packit |
53d5b6 |
License (LGPL), as included in the file COPYING.LGPL. The rest of this
|
|
Packit |
53d5b6 |
package may be distributed according to the GNU General Public License
|
|
Packit |
53d5b6 |
(GPL), as included in the file COPYING.
|