xref: /OK3568_Linux_fs/kernel/Documentation/hwmon/userspace-tools.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunUserspace tools
2*4882a593Smuzhiyun===============
3*4882a593Smuzhiyun
4*4882a593SmuzhiyunIntroduction
5*4882a593Smuzhiyun------------
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunMost mainboards have sensor chips to monitor system health (like temperatures,
8*4882a593Smuzhiyunvoltages, fans speed). They are often connected through an I2C bus, but some
9*4882a593Smuzhiyunare also connected directly through the ISA bus.
10*4882a593Smuzhiyun
11*4882a593SmuzhiyunThe kernel drivers make the data from the sensor chips available in the /sys
12*4882a593Smuzhiyunvirtual filesystem. Userspace tools are then used to display the measured
13*4882a593Smuzhiyunvalues or configure the chips in a more friendly manner.
14*4882a593Smuzhiyun
15*4882a593SmuzhiyunLm-sensors
16*4882a593Smuzhiyun----------
17*4882a593Smuzhiyun
18*4882a593SmuzhiyunCore set of utilities that will allow you to obtain health information,
19*4882a593Smuzhiyunsetup monitoring limits etc. You can get them on their homepage
20*4882a593Smuzhiyunhttp://www.lm-sensors.org/ or as a package from your Linux distribution.
21*4882a593Smuzhiyun
22*4882a593SmuzhiyunIf from website:
23*4882a593SmuzhiyunGet lm-sensors from project web site. Please note, you need only userspace
24*4882a593Smuzhiyunpart, so compile with "make user" and install with "make user_install".
25*4882a593Smuzhiyun
26*4882a593SmuzhiyunGeneral hints to get things working:
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun0) get lm-sensors userspace utils
29*4882a593Smuzhiyun1) compile all drivers in I2C and Hardware Monitoring sections as modules
30*4882a593Smuzhiyun   in your kernel
31*4882a593Smuzhiyun2) run sensors-detect script, it will tell you what modules you need to load.
32*4882a593Smuzhiyun3) load them and run "sensors" command, you should see some results.
33*4882a593Smuzhiyun4) fix sensors.conf, labels, limits, fan divisors
34*4882a593Smuzhiyun5) if any more problems consult FAQ, or documentation
35*4882a593Smuzhiyun
36*4882a593SmuzhiyunOther utilities
37*4882a593Smuzhiyun---------------
38*4882a593Smuzhiyun
39*4882a593SmuzhiyunIf you want some graphical indicators of system health look for applications
40*4882a593Smuzhiyunlike: gkrellm, ksensors, xsensors, wmtemp, wmsensors, wmgtemp, ksysguardd,
41*4882a593Smuzhiyunhardware-monitor
42*4882a593Smuzhiyun
43*4882a593SmuzhiyunIf you are server administrator you can try snmpd or mrtgutils.
44