                                GPSUTIL v0.10
-------------------------------------------------------------------------------
    GPSUTIL a program to interact with NMEA compatible and other
      supported GPS units.

    Copyright (C) 2000  Brian J. Hennings

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    I can be contacted at hennings@cs.uakron.edu or by US mail at:

    Brian Hennings
    114 Rex Ave.
    Wintersville, OH 43953
-------------------------------------------------------------------------------
Credits:
  Thomas Schank -- author of gpspoint. I used his code for some of the
        linux serial code(setting the port speed and parameters).
  Sean O'Rourke -- For help in fixing the checksum problem.  The Magellan
        protocol document is wrong about how to compute their checksums.  Sean
        also helped proof read this document.
  Jason Bowling -- For his great circle distance function.
  Robert Lipe   -- Delete waypoint code, improved serial routines, and other
        suggestions.

GPSUTIL was written by Brian Hennings <hennings@cs.uakron.edu>
GPSUTIL home page: http://www.cs.uakron.edu/~hennings/gpsutil/

Please send any bug reports, feature requests, or comments to
  hennings@cs.uakron.edu .  All feedback is greatly appreciated.

GPSUTIL is a program to communicate with a GPS unit.  It supports several
  NMEA (National Marine Electronics Association) v2.1 messages.  GPSUTIL
  also supports downloading and uploading waypoints from a Magellan GPS.

Currently supported NMEA messages:
GLL  -  Current latitude and longitude
RMB  -  Information about current waypoint destination
RMC  -  Speed (in knots) and current heading

**NOTE** GPSUTIL requires read/write access to the serial point.  In Linux
  this means root or changing the permissions on the /dev entry.

Currently supported options:
  -?            Display usage / option help
  -v            Print current version information
  -p Port       Serial Port Name                   -- default is /dev/ttyS1
  -D [Level]    Set Debugging level                -- default 0
  -g            Get current latitude / longitude (NMEA)
  -w            Heading and range to current waypoint (NMEA)
  -d FILENAME   Download waypoint list to FILENAME -- Magellan Only
  -u FILENAME   Upload waypoint list from FILENAME -- Magellan Only
  -e WPT1[,WPT2,...] Delete waypoints              -- Magellan Only

some examples:

`gpsutil -p /dev/ttyS2 -d wpts.out` will download your waypoint list and place
  them in a file named wpts.out.  The GPS is attached to COM3.

`gpsutil -p /dev/ttyS1 -u wpts.in` will add all waypoints found in the file
  named wpts.in.  The GPS is attached to COM2.

`gpsutil -g -d wpts.out` will download your waypoint list and place
  them in a file named wpts.out and display the current coordinates.
  The GPS is attached to COM2.

`gpsutil -w` will display the current latitude and longitude, name of the
  destination waypoint, its latitude and longitude, the bearing to the
  waypoint, and the distance to the waypoint.  The GPS is attached to COM2.

'gpsutil -e abc,def' will delete waypoints named abc and def.  The GPS is
  attached to COM2.

*NOTE*
  When my GPS is not moving the heading is reported as 0.  Even though the
    compass display screen does not.

GPSUTIL was designed to be useful in other projects.  One project that it is
  being used for is to guide a linux powered remote controlled car between
  2 NAV points.

Files in the distribution:
readme          This document
changelog       Whats new / fixed down through the versions
license.txt     Copy of the GPL license that this project is distributed under
todo.txt        List of planned features/known problems
example.wpts    An example waypoint file
GPSUTIL.EXE     WIN32 executable
GPSUTIL         Linux ELF executable
main.c          Contains the entry point and driver functions for the project
gps.h           POS and CooRD structs and some global defines
nmea.c          Functions for decoding NMEA messages
nmea.h          Function prototypes for NMEA messages
serial.c        Functions used to interact with serial port (contains
                both WIN32 and Linux code)
serial.h        Function prototypes and global defines
magellan.c      Functions for decoding/sending Magellan GPS messages
magellan.h      Function prototypes and defines
makefile        A make script to compile GPSUTIL
makefile.win32  A nmake(microsoft visual studio) makefile

To compile for linux:
  1.  Run `make` command in that directory.

GPSUTIL was developed and tested on a RedHat 6.2 machine with GCC 2.95.
  It should work on almost any linux distribution with GCC 2.81 or later.

To compile for WIN32:
  1.  Requires Visual C (Tested with 6.0).
  2.  Run `nmake -f makefile.win32`

