         	klm - a KDE front end for lm_sensors
                   (C)1998, 1999 Brendon Humphrey
                      Released under the GPL.

Klm is a graphical display and configuration
application for the hardware health monitoring sensors
that are present in most Pentium and Pentium II 
motherboards. Klm accesses these sensors via the
lm_sensors2 kernel modules.

lm_sensors is maintained by the following people:

	Alexander Larsson (alla@lysator.liu.se)
	Frodo Looijaard (frodol@dds.nl)
	Philip Edelbrock (phil@netroedge.com)

The lm_sensors module is available from http://www.netroedge.com/~lm78.

All suggestions and input regarding klm will be greatfully received.

HISTORY
=======

This is Version 0.5.0

o Stopped massive memory leak in tool tip code for 
  the dock widget. 
o Stopped the main window from jumping to (0,0) 
  every time that a sensor is added or removed
  from the display.
o Klm now remembers where it was positioned when
  it is closed.
o Changed app name to "Hardware Monitor" in menu.
o Added support for ADM1021 and ADM9240 sensor chips.
  The ADM9240 temperature and fan readings should be
  accurate, the voltages won't as I dont have the 
  divider values yet (waiting for future lm_sensors
  releases). Of course, this code is untested, so
  let me know if it worksi (or not!).
o Added dialog for setting update interval and also
  added the ability to enable alarm beeping and 
  call a script when an alarm is detected.
o Added ability to execute a command when an error
  is detected. Putting %s into the command string
  will cause a space delimited list of the sensors
  causing the alarm to be added to the command line
  as arguments.
o Added support for SIS5595 (Lm78 clone).

Version 0.4.0

o compatability with lm_sensors 2.1.1. All sensors support by
  lm_sensors 2.1.1 are supported. However, only the LM78, LM79, and 
  LM75 are known to work. New sensors such as gl518sm, LM80, and 
  w83781d are totally untested.

Version 0.3.2

o Solved NaN and ridiculous vertical graph range 
  problems with egcs 1.0.3 and gcc 2.8.2.
o Removed some error message code which in itself could crash.
o Arranged for the klm icon to be removed from the task list
  the main klm window is not visible.

Version 0.3.1

o Altered display of lm75 temperature data to reflect "offset"
  and "Hysteresis" rather than min and max.
o Removed a possible crash if you delete a temperature sensors
  graph.
o Swapped the QToolButtons for KButtons - much nicer look and cures
  a crash that some people were experiencing - thanks antonio!
o If you are not root, you can still use configuration mode in a 
  limited manner - usually just altering settings that are provided
  by klm, rather than lm_sensors. This solves the problem of non root
  users being unable to disable sensors.
o Added internationalisation support. Translators anyone?
o Updated acinclude.m4 to complain if Qt >= 1.4 is not installed
  as I just heard that it does not compile with 1.3 (thanks Colin).
o Removed temperature limits configuration ability on vid.
o Added ability to add a + or - constant to the reading of a temperature
  sensor to aid in calibrating temp sensors. Offset is not reflected
  in lm_sensors, but the alarm limits retain the same relative positions
  to the sensor readings.
o Fixed a horrible bug with the size of the main window when only one
  sensor is displayed.
o Removed the resizing problem that older version displayed with the
  main window not shrinking when graphs/sensors are disabled.
o Klm will now report errors in operations in the status bar.

Version 0.3.0

o Background area around graphs can be middle clicked
  to enter configuration mode.
o Configuration mode is only available if the initial
  attempts at setting up lm_sensors succeed - i.e 
  klm is running as a user with correct (root) permissions.
o If configuration of lm_sensors fails, klm will not 
  overwrite the contents of the configuration file when
  it is closed.
o Graphs automatically vertically scale themselves, to
  be at least 10% taller than the larger of the sensor
  reading or the sensor maximum alarm value.
o Background colour of the graph widgets is 
  no longer hard coded to 'grey'. Now takes
  colour from scheme in use.
o Had a serious chat with the layout manager
  so now everything resizes properly.
o Added a tooltip to the Dock widget which will
  display the name of the sensor being displayed.
o Sensors that are reading zero will be treated as 
  alarms if the reading is out of the 'ok' zone.
  Users should either set the 'ok' zone of disconnected
  fans down to zero RPM, or simply turn off the sensor.
o Added support for LM75 sensors. Previously the LM75s were
  treated exactly the same as LM78, probably yielding 
  very large (10x) readings. 
  
  LM75 support is untested, as I don't have one in my
  machine. 

  I have interpreted the LM75 thus - the lower limit of
  the 'ok' zone is always zero. The upper limit is
  user definable. The Hysteresis value is set to the 
  same value as the upper limit (offset in LM75ese).
  Please, let me know if it does not work!

o Changed the color of the dockwidget to a more traditional
  grey colour. When any sensor is in alarm status, 
  the dockwidget gets a very red background.
o You can only change the name of a sensor while in 
  configuration mode.
o Added reset button to toolbar and main window menu.
  Pressing 'reset' will cause all sensors to be displayed
  even if they were configured to be ignored. There seems
  to be a small memory leak in the code that recreates
  the display, so use sparingly!
o In configuration mode, the widget displays five new
  buttons - up & down buttons for the graphs vertical
  range, up & down buttons for the sensors scale factor
  (only if configurable), a 'hide me' button for 
  setting the sensor to be ignored by klm.

  Supported scale values for fans (by lm_sensors!) are
  1, 2, 4, and 8. Voltage scale factors are much more
  variable, accepting values between 1 and 5 in 
  steps of 0.001.

  My machine has a problem setting scale factors on 
  Fan3 which is attached to an LM79, I don't think
  it is a problem with klm, rather lm_sensors or 
  hardware.
  
o Added the ability to display the VID input if present 
  in your computer. You can set upper and lower limits 
  on VID, but the limits are enforced by klm, rather than 
  lm_sensors as there is no hardware support for VID alarms.
o Added the ability for klm to read and remember the scale
  factors for voltage and fan inputs. This functionality 
  uncovered a bug in lm_sensors 1.4.11. Klm 0.3.0 therefore
  requires lm_sensors 1.4.12 to run correctly.

Version 0.2.1

o Fixed problem with sensor configuration not being saved properly
o Connected a signal and slot combination to ensure
  that configuration changes are saved when exiting configuration
  mode.


Version 0.2.0

o Totally reimplemented the way Sensors are managed.
o Removed a ton of debugging code.
o Changes in configuration are now stored in lm_sensors (root access needed)
o Added ability to set the name of graphs - those that have corresponding
  fields in lm_sensors have thier name stored there.
o If klm is run non-root, it will operate off the existing lm_sensors
  settings.
o Lower alarm range bar no longer gets dragged off bottom of widget.
o Fixed problem with graphs being configured out of range.  
o Added better feedback as to limit settings in graphs
o Prevented limits being set out of range (off the graphs)
o Continuing code cleanups
o Altered klm to use sysctl interface to the sensors module
  rather than the /proc/sys/dev/lm_sensors/* interface.
  In the process klm stopped supporting the HENDRICKS 
  modules, and (hopefully) is now ready to support 
  lm_sensors2 with a few small modifications.
o Eliminated problem with incorrect plotting of graphs
  and go/nogo regions and drag handles.


Version 0.1.0

o Removed horiz scrolling graphs and keys - decided they were impractical.
o Added vertical bargraph displays for each lm78 data item.
o Added alarm display and limits setting for above mentioned bargraphs.
o Added rudimentary HTML help.
o Added destructors to various classes...kinda overlooked those in 0.0.1

Version 0.0.1

o First attempt at a KDE application. Believe it or not, I wrote 
  this app because I need it, despite living in Sweden, I've 
  been having the odd heat problem with my machine.

o The version contains basically sensor display functionality, 
  including a little dock widget that displays the cpu temperature.

o This version has been tested and seems to work ok on my machine. 
  Lots of work needed though. Really just a placeholder release
  to let others know that it exists, and not to duplicate effort.



Thats it.

Brendon Humphrey
brendy@swipnet.se


