diff options
| -rw-r--r-- | CHANGES | 1 | ||||
| -rw-r--r-- | README | 15 | ||||
| -rw-r--r-- | doc/developers/makefiles | 4 | ||||
| -rw-r--r-- | doc/progs | 2 | ||||
| -rw-r--r-- | doc/useful_addresses.html | 326 |
5 files changed, 12 insertions, 336 deletions
@@ -2,6 +2,7 @@ lm-sensors CHANGES file ----------------------- SVN + useful_addresses.html: Moved to the wiki Makefile: Add sensors-conf-convert to make install libsensors: Notify the caller when writing a value fails Differentiate between different read error types @@ -75,13 +75,14 @@ the effort and can simply link with libsensors and work out of the box. APPLICATIONS ------------ -This package does not contain a nice graphical monitor. Look at the file -doc/useful_addresses.html for pointers to such programs. It does contain -an example console program that reports all current sensors values. This -program is called 'sensors'. You can use it as a reference implementation -for more intricate programs. It also contains a daemon watching for -sensor values, logging alarms and feeding an RRD database with the sensor -measurements. +This package contains an example console program that reports all current +sensors values. This program is called 'sensors'. You can use it as a +reference implementation for more intricate programs. It also contains a +daemon watching for sensor values, logging alarms and feeding an RRD +database with the sensor measurements. + +This package does not contain a nice graphical monitor. See +http://www.lm-sensors.org/wiki/UsefulLinks for pointers to such programs. OTHER INFORMATION diff --git a/doc/developers/makefiles b/doc/developers/makefiles index 4a4134b4..c2375c10 100644 --- a/doc/developers/makefiles +++ b/doc/developers/makefiles @@ -1,6 +1,6 @@ The Makefiles in this package are rather advanced. They are partially based -on the article "Recursive Make considered Harmful", written by Peter Miller. -See doc/useful_addresses.html for a link to this article. +on the article "Recursive Make considered Harmful", written by Peter Miller: + http://miller.emu.id.au/pmiller/books/rmch/ There is one big Makefile in the root of this package. It includes many other files; one for each directory in which source code is found. These @@ -6,7 +6,7 @@ These programs are generally small utilities used for debugging, and installation of the lm_sensors package, and for demonstrating the use of the drivers and libraries in this package. For more elaborate programs (for example, GUI sensor displays), -see useful_addresses.html. +see http://www.lm-sensors.org/wiki/UsefulLinks. * prog/daemon/healthd.sh (written in bash, not installed) diff --git a/doc/useful_addresses.html b/doc/useful_addresses.html deleted file mode 100644 index 5b8e41f2..00000000 --- a/doc/useful_addresses.html +++ /dev/null @@ -1,326 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - -<html> - -<head> - <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> - <style type="text/css"> - UL { margin-top: 4px; margin-bottom: 16px; } - .toplvl { font-weight: bold; } - </style> - <title>I²C, SMBus and hardware monitoring references</title> -</head> - -<body> - -<h1>I²C, SMBus and hardware monitoring references</h1> - -<p>This document contains all kinds of useful references to I²C and SMBus -documents and implementations, and to hardware sensors documentation and -implementations. Please report any other references you have found!</p> - -<ul> -<li><span class="toplvl"><a name="i2c">I²C</a></span> - <ul> - <li><a href="http://www.ping.be/~ping0751/i2cfaq/i2cindex.htm">I²C FAQ</a></li> - <li>Another <a href="http://vhimpe.crosswinds.net/electronics/i2cfaq/i2c.html">I²C - FAQ</a></li> - <li>Yet another <a href="http://www.esacademy.com/faq/i2c/">I²C FAQ</a></li> - <li><a href="http://www.semiconductors.philips.com/buses/i2c/">Philips</a>, the I²C bus - inventors - <br />This site contains many example programs.</li> - <li>Simon Vogl's <a href="http://voxel.at/prj/i2c/">I²C for Linux</a> page</li> - </ul> -</li> -<li><span class="toplvl"><a name="smbus">SMBus</a></span> - <ul> - <li><a href="http://www.smbus.org/specs/">SMBus specification documents</a> - <br />Includes version 1.1 and version 2.0 documents.</li> - </ul> -</li> -<li><span class="toplvl"><a name="implementations">I²C and SMBus implementations</a></span> - <ul> - <li><a href="http://www.ali.com.tw/">ALi</a> (M1533, - <a href="http://www.ali.com.tw/eng/product/corelogic/m1535.htm">M1535</a>, - <a href="http://www.ali.com.tw/eng/product/corelogic/m1535d.htm">M1535D</a>, - <a href="http://www.ali.com.tw/eng/product/corelogic/m1543c.htm">M1543C</a>) - <br />ALi chipsets include SMBus adapters, integrated with many other functions. - <br />Datasheets available on - <a href="http://210.63.71.156/app/csd/webuser.nsf/DTSRF?OpenForm">request</a>.</li> - <li><a href="http://developer.intel.com/">Intel</a> (PIIX4, - <a href="http://developer.intel.com/design/chipsets/440mx/">82443MX</a>, - i801, <a href="http://developer.intel.com/design/chipsets/810/">i810</a>, - <a href="http://developer.intel.com/design/chipsets/810/810e.htm">i810E</a>, - <a href="http://developer.intel.com/design/chipsets/815/">i815</a>) - <br />Intel SMBus adapter, integrated with many other functions. - <br />Datasheets available for - <a href="http://developer.intel.com/design/chipsets/datashts/index.htm?iid=PCG+devleftnav">download</a>.</li> - <li><a href="http://www.sis.com/">Silicon Integrated Systems</a> (SiS5595, - <a href="http://www.sis.com/products/chipsets/integrated/socket370/630.htm">SiS630</a>, - <a href="http://www.sis.com/products/chipsets/oa/pentium4/645.htm">SiS645</a>, - <a href="http://www.sis.com/products/chipsets/southbridge/96x.htm#961">SiS961</a>) - <br />No datasheet found.</li> - <li><a href="http://www.via.com.tw/">VIA</a> (VT85C586B, VT82C596, VT82C596B, VT82C686A, - VT82C686B, VT8231, VT8233, VT8233A) - <br />VIA I²C adapters, integrated with many other functions (south bridge). - Each south bridge may be used in many chipsets. To know which south bridge is used in - your VIA chipset, use <a href="http://www.viaarena.com/?PageID=14">this table</a>. - <br />Datasheets available on - <a href="http://www.via.com.tw/en/datasheet/datasheets.jsp">request</a>.</li> - </ul> -</li> -<li><span class="toplvl"><a name="chips">Hardware monitoring chips</a></span> - <ul> - <li><a href="http://www.analog.com/">Analog Devices</a> - (<a href="http://www.analog.com/en/prod/0,2877,ADM1021A,00.html">ADM1021A</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM1022%2C00.html">ADM1022</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM1023%2C00.html">ADM1023</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM1024%2C00.html">ADM1024</a>, - <a href="http://www.analog.com/en/prod/0,2877,ADM1025,00.html">ADM1025</a>, - <a href="http://www.analog.com/en/prod/0,2877,ADM1025A,00.html">ADM1025A</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM1026%2C00.html">ADM1026</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM1027%2C00.html">ADM1027</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM1028%2C00.html">ADM1028</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM1029%2C00.html">ADM1029</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM1030%2C00.html">ADM1030</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM1031%2C00.html">ADM1031</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM1032%2C00.html">ADM1032</a>, - <a href="http://www.analog.com/en/prod/0%2C2877%2CADM9240%2C00.html">ADM9240</a>) - <br />Datasheets available for download.</li> - <li><a href="http://www.genesyslogic.com/">Genesys Logic</a> (GL518, GL520, GL523) - <br />No datasheet available.</li> - <li><a href="http://www.hp.com/">Hewlett Packard</a> (Maxilife) - <br />Datasheets only under NDA.</li> - <li><a href="http://www.maxim-ic.com/">Maxim IC</a> (includes Dallas Semiconductor) - (<a href="http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2952">DS75</a>, - <a href="http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2737">DS1621</a>, DS1625, - <a href="http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2774">DS1775</a>, - <a href="http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2775">DS1780</a>, - <a href="http://www.maxim-ic.com/quick_view2.cfm/qv_pk/1855">MAX1617</a>, - <a href="http://www.maxim-ic.com/quick_view2.cfm/qv_pk/1964">MAX1617A</a>) - <br />Datasheets available for - <a href="http://www.maxim-ic.com/Sensors.cfm">download</a>.</li> - <li><a href="http://www.myson.com.tw/">Myson</a> (MTP008) - <br />No datasheet available.</li> - <li><a href="http://www.national.com/">National Semiconductor</a> - (<a href="http://www.national.com/pf/LM/LM75.html">LM75</a>, - <a href="http://www.national.com/pf/LM/LM77.html">LM77</a>, - <a href="http://www.national.com/pf/LM/LM78.html">LM78</a>, LM78J, - <a href="http://www.national.com/pf/LM/LM79.html">LM79</a>, - <a href="http://www.national.com/pf/LM/LM80.html">LM80</a>, - <a href="http://www.national.com/pf/LM/LM84.html">LM84</a>, - <a href="http://www.national.com/pf/LM/LM87.html">LM87</a>, - <a href="http://www.national.com/pf/LM/LM92.html">LM92</a>) - <br />Datasheets available for - <a href="http://www.national.com/catalog/AnalogThermalManagement.html">download</a>.</li> - <li><a href="http://www.sis.com/">Silicon Integrated Systems</a> (SIS5595, SIS950) - <br />No datasheet available.</li> - <li><a href="http://www.ti.com/">Texas Instruments</a> - (<a href="http://focus.ti.com/docs/prod/productfolder.jhtml?genericPartNumber=THMC10">THMC10</a>, - <a href="http://focus.ti.com/docs/prod/productfolder.jhtml?genericPartNumber=THMC50">THMC50</a>) - <br />Datasheets available for download.</li> - <li><a href="http://www.via.com.tw/">VIA</a> (VT82C686A, VT82C686B, VT8231, VT1211) - <br />VIA bridges and chips which include integrated sensors. - <br />Datasheets available on - <a href="http://www.via.com.tw/en/datasheet/datasheets.jsp">request</a>.</li> - <li><a href="http://www.winbond.com/">Winbond</a> (W83781D, W83782D, W83783S, - W83791D, W83792D, W83L785TS-S, - W83627HF, W83627THF, W83637HF, W83687THF, W83697HF) - <br />Datasheets available for - <a href="http://www.winbond.com/e-winbondhtm/partner/b_2_d_4.htm">hardware monitoring</a> and - <a href="http://www.winbond.com/e-winbondhtm/partner/b_2_d_2.htm">super-I/O</a> - chips.</li> - </ul> -</li> -<li><span class="toplvl"><a name="protocol">Other protocol information</a></span> - <ul> - <li><a href="http://developer.intel.com/design/servers/ipmi/">IPMI documentation</a> - <br />IPMI (intelligent platform management interface), a standard for hardware - monitor chip reading.</li> - </ul> -</li> -<li><span class="toplvl"><a name="installguides">Installation guides</a></span> - <ul> - <li><a href="http://khali.linux-fr.org/devel/i2c/">Jean Delvare's</a> - <br />Focuses on the new i2c interface issues.</li> - <li><a href="http://chrisp.orcon.net.nz/linux/sensors.html">Chris Peters'</a> - <br />More simple, probably better for beginners.</li> - </ul> -</li> -<li><span class="toplvl"><a name="sensorsconfdb">Motherboard configuration files</a></span> - <p>Poject is rather incomplete, help is wanted to develop it further (or start a new one altogether)!</p> - <ul> - <li><a href="http://lm-sensors-db.berlios.de/">lm_sensors_db</a> - <br />Hosted by berlios.de.</li> - </ul> - - <p> - As far we know only one motherboard manufacturer provides sensors.conf files:</p> - <ul> - <li><a href="http://www.tyan.com/archive/support/html/software_utilities.html#lms">TYAN motherboads sensors.conf - files database (archive link)</a></li> - <li><a href="ftp://ftp.tyan.com/software/lms/">TYAN motherboads sensors.conf - files database (ftp link)</a> - </li> - </ul> - - <p>Personal collections:</p> - <ul> - <li><a href="http://www.lathspell.de/linux/lm_sensors/">Christian Hammers'</a></li> - <li><a href="http://khali.linux-fr.org/devel/lm-sensors/">Jean Delvare's</a></li> - </ul> -</li> -<li><span class="toplvl"><a name="applications">Hardware monitoring applications using the lm_sensors package</a></span> - <ul> - <li><a href="http://www.lm-sensors.org">LM Sensors</a> - <br />First see the - <a href="http://www.lm-sensors.org/browser/lm-sensors/trunk/prog">prog - directory</a> in the lm_sensors package for sample applications. In particular, - see <a href="http://stimpy.netroedge.com/tellerstats/">Tellerstats</a>, a web-based - hardware monitor created by Phil Edelbrock, one of our main project contributors.</li> - <li><a href="http://freshmeat.net/">Freshmeat</a> - <br />A <a href="http://freshmeat.net/search/?q=lm_sensors">search for "lm_sensors"</a> - brings up a good starter list.</li> - <li><a href="http://sensors-applet.sourceforge.net/">GNOME Sensors Applet</a> - <br />An applet for the GNOME panel to monitor lm_sensors outputs.</li> - <li>ASFATM (Afterstep fan and temperature monitor) - <br />A wharf/dock app that is capable of displaying system/CPU temperatures and up to - three fan rotation speeds depending on the hardware being used. The development has - stopped, but you still can download the sources from - <a href="http://public.planetmirror.com/pub/afterstep/apps/asfatm/">Planet Mirror</a> - or <a href="http://www-ftp.lip6.fr/pub/X11/afterstep/apps/asfatm/">LIP6</a>.</li> - <li><a href="http://www.ma-scha.de/index.phtml?menu=progs&submenu=asftavm">ASFTAVM</a> - (Afterstep fan, temperature and voltage monitor) - <br />An enhancement of ASFATM.</li> - <li><a href="http://www.warmcat.com/milksop/cheapi2c.html">CheapI2C</a> - <br />A real-time linux I2C bus protocol capture tool using the parallel port.</li> - <li><a href="http://www.plogic.com/dogsled/">Dogsled</a> - <br />A tool to manage and monitor Linux clusters.</li> - <li><a href="http://www.gkrellm.net/">GKrellM</a> - <br />GKrellM is a single process stack of system monitors - which supports applying themes to match its appearance to your - window manager, Gtk, or any other theme. Very popular.</li> - <li><a href="http://ksim.sourceforge.net/">KSim</a> - <br />KSim is a GKrellM equivalent for KDE. Supports GKrellM skins.</li> - <li><a href="http://gpdialapplet.sourceforge.net/">GPDial Applet</a> - <br />A Gnome applet that displays a specific number from a file on the Gnome panel. - By configuring it for a specific sensor file in /proc, you get a - sensor reading. Requires fam and fam++.</li> - <li><a href="http://digilander.libero.it/robang/gsensor/gsensor_en.html">GSensor</a> - <br />GTK+ application.</li> - <li><a href="http://lcd4linux.sourceforge.net/">LCD4Linux</a> - <br />Displays kernel information on an external LCD.</li> - <li><a href="http://phpsysinfo.sourceforge.net/">phpSysInfo</a> - <br />Generates a web page with system information, optionally including sensors output. - Recommended.</li> - <li><a href="http://www.gedanken.demon.co.uk/procmeter3/">ProcMeter 3</a> - <br />A comprehensive system monitoring package. Nice desktop application. - Recommended.</li> - <li><a href="http://www.joenst.de/s2w/">Sens2web</a> - <br />A Perl script to generate a web page of sensor readings.</li> - <li><a href="http://www.coverfire.com/sensor_sweep_applet/">Sensor Sweep Applet</a> - <br />A configurable Gnome panel applet.</li> - <li><a href="http://voyager2.htmlplanet.com/sensors_srvr.html">Sensors Server</a> - <br />Nice client/server application with a html-embedded Java applet.</li> - <li><a href="http://denis.corbin.free.fr/software.html">Sentinelle</a> - <br />A daemon which warns you when your sensor readings reach critical values.</li> - <li><a href="http://packages.debian.org/stable/x11/wmsensors.html">WMSensors</a> - <br />A Windowmaker dockapp. By Adrian Baugh, maintained by the Debian team.</li> - <li><a href="http://www.linuxgod.net/~jd/">WMSens Dockapp</a> - <br />A Windowmaker dockapp that works only with the Winbond 83697HF chipset. - By Jonathan D. Meadows.</li> - <li><a href="http://www.fluxcode.net/">WMgtemp</a> - <br />A Windowmaker dockapp that displays the CPU and system temperatures. - By Roger Dunce.</li> - <li><a href="http://www.gnodde.org/projects/wmtemp.php">WMtemp</a> - <br />Another Windowmaker dockapp that displays the CPU and system temperatures. - By Peter Gnodde. Inspired from WMgtemp.</li> - <li><a href="http://member.melbpc.org.au/~iann/varyfan/">Varyfan</a> - <br />A C program to vary the fan speeds for the CPU and case fans according to - the temperature of the CPU and motherboard. By Ian Nicholls, more or less - abandoned.</li> - <li><a href="http://www.linuxhardware.org/xsensors/">xsensors</a> - <br />A X11 version of sensors. Requires GTK+ 2.0. Nice, although many chips are not - supported yet.</li> - <li>Floyd Davidson has nice <a href="http://web.newsguy.com/floyd_davidson/sensors/">monitoring - data graphics</a> generated using - <a href="http://web.newsguy.com/floyd_davidson/code/sensors/">modified tellerstats - scripts</a></li> - <li><a href="http://freshmeat.net/projects/e-sensors/">E-Sensors</a> - <br />An Enlightenment frontend (<i>epplet</i>) to lm_sensors, by Øystein Haare.</li> - </ul> -</li> -<li><span class="toplvl"><a name="other">Other hardware monitoring implementations (not using LM Sensors)</a></span> - <ul> - <li><a href="http://www.lysator.liu.se/~alla/files/lm78_stuff/">Alexander Larsson's - LM78 module</a> - <br />The original module LM Sensors is based upon.</li> - <li><a href="http://www.beowulf.org/software/">Beowulf project LM78 module</a> - <br />By Erik Hendriks. Old, probably unmaintained.</li> - <li><a href="http://smartmontools.sourceforge.net/">smartmontools</a> - <br />The smartmontools package contains two utility programs - (smartctl and smartd) to control and monitor storage systems - using the Self-Monitoring, Analysis and Reporting Technology - System (SMART) built into most modern ATA and SCSI hard - disks. </li> - <li><a href="http://www.guzu.net/linux/hddtemp.php">hddtemp</a> - <br />Get the hard drive temperatures - using the Self-Monitoring, Analysis and Reporting Technology - System (SMART) built into most modern ATA and SCSI hard - disks. Much simpler than smartmontools.</li> - <li><a href="http://www.ganzfix.de/">TXWD</a> - <br />Another LM78/LM75 module, by Chris Benndorf.</li> - <li><a href="ftp://ftp.hypercore.co.jp/linux-sbs/kernel-patches/">Beta SMBus access - through the BIOS interface</a> - <br />Old, obviously abandoned.</li> - </ul> -</li> -<li><span class="toplvl"><a name="tools">Other useful tools</a></span> - <ul> - <li><a href="http://users.ev1.net/~redelm/">CPUBurn</a> - <br />CPU-heating program to stress-test marginally-cooled systems and test - LM Sensors. Highly recommended.</li> - <li><a href="http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/">RRDTool (Round Robin - Database)</a> - <br />A database for readings taken over time, such as sensor data. - The LM Sensors package contains scripts to create and update an RRD database - and graphically display the data on webpages.</li> - </ul> -</li> -<li><span class="toplvl"><a name="papers">White papers, documents, articles and other things</a></span> - <ul> - <li><a href="http://www.sbs-forum.org/marcom/winter01/Designing%20with%20SMBus%202.pdf"> - Designing with SMBus 2.0</a><br /> - A great introduction to SMBus 2.0 and the differences with version 1.x.</li> - <li><a href="http://www.dmtf.org/standards/standard_alert.php">Alert standard format - (ASF) specification</a> - <br />A standard for system management messages using the SMBus - and passing this information to remote management devices. By the DMTF.</li> - <li><a href="http://www.tip.net.au/~millerp/rmch/recu-make-cons-harm.html">Recursive - make considered harmful</a> - <br />A paper on which the version 2 Makefile is based.</li> - <li><a href="http://www.thermometrics.com/assets/images/ntcnotes.pdf">NTC thermistors</a> - <br />A comprehensive description of the physics and mathematics of NTC thermistors.</li> - <li><a href="http://www.temperatures.com/">About temperature sensors</a> - <br />A web guide to devices that measure temperature. General information.</li> - <li><a href="http://www.analog.com/library/analogDialogue/archives/33-04/temperatures/index.html">Measuring - temperatures on computer chips with speed and accuracy</a> - <br />The advantages of thermal diodes over traditional thermistors.</li> - <li><a href="http://www-900.ibm.com/developerWorks/cn/linux/hardware/stability/index_eng.shtml">Linux - hardware stability guide</a> - <br />A nice article about using LM Sensors for diagnosing hardware problems.</li> - <li><a href="http://leenooks.com/163">Linux - hardware monitoring INcompatibility guide</a> - <br />A list of chips that don't work well under Linux.</li> - <li><a href="http://www.analog.com/library/analogDialogue/archives/38-02/fan_speed.html">Why - and how to control fan speed for cooling electronic equipment</a> - <br />A comprehensive article by Mary Burke comparing fan speed - control methods</li> - </ul> -</li> -</ul> - -</body> - -</html> |