AO40TLMVIEW - decoder and viewer for AO-40 telemetry
----------------------------------------------------

Copyright (C) 2001-2002, Pieter-Tjerk de Boer, pa3fwm@amsat.org

-----------------------------------------------------------------------
This program is free software; you can redistribute it and/or modify
it under the terms of version 2 of the GNU General Public License as
published by the Free Software Foundation.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
-----------------------------------------------------------------------


COMPILING & INSTALLING:
-----------------------
This should be simple on just about any unix-like system: type 'make'
in the directory where the source has been unpacked.
On non-Linux systems, you may need to make minor modifications to the
Makefile.
Next, you may want to copy the resulting binary 'ao40tlmview' to a
directory that is in your PATH, e.g. /usr/local/bin, and the man page
'ao40tlmview.1' where the 'man' command will find it, like
/usr/local/man/man1 .


USAGE:
------
See the manpage, and/or the online help obtained by typing 'h' after
starting ao40tlmview.


HISTORY:
--------
Version 1.0, 2001-08-25:
- initial release

Version 1.01, 2001-08-26:
- fixed a few portability issues and compile warnings

Version 1.02, 2001-10-26:
- fixed a bug that could cause a segfault when receiving wrong data over
  TCP; tnx Chuck Hemker N2POR for finding and fixing this.
- upon typing 'g' for making a graph, the display now switches to channel
  numbers.
- graph can now show two channels simultaneously.
- fixed some minor problems regarding the hiding of gnuplot messages,
  and handling of large terminal screens and terminal window resizes.
- added this README.

Version 1.03, 2002-04-23:
- upon startup, files .ao40tlmviewrc in the current and the home directory
  are read; they can contain addresses for TCP and UDP, so those no longer
  need to be specified on the command line.
- name of log file can automatically contain '@callsign', as needed for
  submission to the telemetry archive (thanks Bdale Garbee KB0G for proposing
  this); the callsign is specified in .ao40tlmviewrc .
- log file is now closed and new file opened when passing midnight UTC.
  However, by default this is postponed until no blocks have been received
  for an hour, so in practice no file change will be made within one pass.
  This timeout can be changed (and set to zero) from the .ao40tlmviewrc .
- added graph of Whole Orbit Data (keypress 'G').
- a few small bugfixes.

