KSermon Version 0.3.1
=====================

ksermon is an system-utility to watch the activities on a given serial
port. The current state of the TX,RX,CTS,RTS,DTR,DSR,DCD and RI lines are
shown by some kind of LEDs. Furthermore, the current TX/RX transfer rates
are visualisized using bars and within an osziloscope (this is nice to
analyse the transfer characteristics). Additionaly, you can watch the
online-time (depended to the  DCD-Signal) and the amount of received
and transmitted data since the  serial-device was opened the first time.
Also take a look at the homepage of ksermon:

http://www.lpr.e-technik.tu-muenchen.de/~kuhn/ksermon/



Usage
=====

As ksermon uses the session-management system from KDE, the user
has only to start the programm, and then choose the
device to observe from the Options->Preferences menu.
It is also possible to change the update interval and the
maximum displayed transfer-rate during runtime within the
Preferences



Compiling
=========

For proper compilation, you will have to install the kernel-patch included
in sermon-0.23; For proper execution, will have to recompile the kernel!

Then, just type "make", but be shure, that Qt and KDE are installed and
$QTDIR and $KDEDIR are set properly.

Type "make install" to install the binary and the Manual-pages (html).
Be sure that you are superuser, when doing this.

The program has been successfully compiled for linux-2.0.36 and
linux-2.2.0-pre1, using Qt 1.40, KDE-1.0 and serialmon-0.23 from Peter Fox
(fox@roestock.demon.co.uk).



Knwon Bugs
==========

- Errors are displayed in the terminal, if the size to small
  to draw an osziloscope.
- O-scope does not rescale when maximum rate is changed
- Better start ksermon, before using a serial line (i.e. with kppp).
  Doing it vice verca may hang uo the line (don't know why).
- The Preferences look very ugle, when using Motif-Style or large fonts.

Tell me, if you find more :-)



Troubleshooting
===============

- Sometimes ksermon needs the suid-bit set. This may be the case,
  when the process using the serial line has suid (i.e. pppd).
- Sometimes it is better to use /dev/cua[0-3] instead of /dev/ttyS[0-3]



Copyright
=========

This program and documentation is copyright B. Kuhn
(kuhn@eikon.e-technik.tu-muenchen.de) and distributed under the GPL
(see COPYING).

Copyright notices are not to be removed or altered.



Warranty
========

There is NO WARRANTY for this program.

This program has been compiled on my machine using gcc 2.7.2,3 Qt 1.40,
KDE-1.0, sermon-0.23 and linux-[2.0.36|2.2.0-pre1), and it seems to work
for me.

Thanks
======

Thanks to Peter Fox for his excelent serial device extension !


Bernhard Kuhn

Tue Jan 13 01:58:28 MET 1998



History
=======

0.2 	inital version
0.2.1	minor bugfixes
0.2.2	smif: reopen line, when have been hunged up
	pref: set correct initial values for sliders
	oszi: pixmap-resize is done nicer now 
0.2.3	minor changes - unofficial
0.2.4	ledtoolbar and texttoolbar digged out, bugfixes - unofficial
0.3.0	cleanups and bugfixes in pref
	Online-Timer depends on DCD-Signal now
0.3.1	smif,pref: RC-lowpass-filter implemented 
