GARMIN upload/download utilities for older Garmin units such as the
GPS 12, 12XL, 48, III, and older III+ units.  Starting with version 1.9
the eMap, eTrex, V and some other units are supported.  The software
has not been modified to work with modern units using USB instead
of RS-232 serial I/O.

These utilities compiled/worked on OpenBSD, NetBSD, and Linux when I
last checked.  I now use gps units with a USB interface and my desktop
runs OS X -- I've not used the code in quite a while.  It still compiles
under OpenBSD (last checked with 5.0).

All original code is placed in the Public Domain.

GNUmakefiles and Linux support was added by Vladislav Zavjalov.
Grigory Pupkov added code for a Y2K fix and support for the different
waypoint data found in the Garmin GPS 12/12XL/48 devices. They hold the
copyrights on their changes.

GPSmap 76CS screendump support was added by Wolfgang Baudler.

To install (BSD):

 1) Look at Makefile.inc in this directory.  This is where install locations
    and default serial port may be modified.  Or, on BSD, set
    GPS_SERIAL_PORT in /etc/mk.conf.  Linux/BSD selection may be
    modified here, too.

 2) make depend && make
    This generates libgarmin and the gardump and garload utilities

 3) make install
    this installs the upload/download utilities as well as their man
    pages.  You may need root access to perform this step.

To install (Linux)

 1) Edit GNUmakefile.inc in this directory.   This is where
    install locations and the default serial port may be modified.
    Linux/BSD selection may be modified here, too.

 2) make
    This generates libgarmin and the gardump and garload utilities

 3) Copy binaries and man pages to their locations.

 The code assumes that Linux does not have strlcpy, so the bsd version
 is included in libgarmin.   If your version of Linux has strlcpy remove
 references to strlcpy.o from lib/GNUmakefile and lib/gpslib.h.

See the man pages for instructions on use.  Unless changed in step 1,
both programs look for "/dev/tty00" (BSD) or "/dev/gps" (Linux).

Questions/comments/bitches to [email protected].  Note: these do what
I want them to do.  Grigory, Vladislav, and Wolfgang added code to
make it do what they wanted.   If the programs don't do what you want
start writing code :-)   If you feed the patches back to me I'll most
likely fold them back in and create a new release.

*****
THE DATA FORMAT OF THIS VERSION IS INCOMPATIBLE WITH VERSIONS PRIOR TO 1.91.
You will not be able to upload data saved with previous versions of the
software.   The easiest way to convert the data formats is to upload using
an older version of the software then download using this version.
*****