readme

This a support library and assorted sample programs for interfacing

COPYRIGHT
=========

This is a support library and assorted sample programs for interfacing
with an AISIN SEIKI D8120-2041 "GPS RECEIVER"

Copyright (C) 1999 by Tracy Harton

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

This library 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
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

GENERAL
=======

Not much in the way of documentation, but this should get you going:

./configure
make

This should build:

as_gps.o / libasgps.a : The AS-GPS library

Included are a couple of sample programs:

gps_test:      Prints GPS position info received each second - get your GPS up
                 and running!  Also prints Satellite and Almanac Status!

gps_settime:   Once it finds and decodes a satellite, it sets the system
                 time.  Keep your system time in sync!

gps_average:   Keeps a running average of your LAT/LGT

gps_test_send: Test program to send commands to unit

gps_printloc:  Usage:  gps_printloc [#samples]
               Prints UTCtime, lat, long, height in meters
               until #samples lines are printed.  If #samples is zero, or missing,
               gps_printloc continues until interrupted.  Also, repeated identical
               samples are discarded (but a time discontinuity will be observed).
               Normally one sample per second is printed.
               Written 10-29-99 by [e-mail] (adapted from gps_average.c).
               Note: a neat way to show the effects of SA, is to graph via gnuplot:
                  gps_printloc > gps_printloc.out    [kill after sufficient samples written]
                  plot "gps_printloc.out" using ($2):($3)
                  pause -1 "Press CR to continue"
                  splot "gps_printloc.out" using ($2):($3):($4)
                  pause -1 "Press CR to continue"

gps_reset:     Sets lat/long of unit
               Usage:  gps_reset [options] 
               options include: 
               -L longitude [ set longitude ] 
               -h           [ help message ] 
               -l latitude  [ set latitude ] 

Note:  All these try to open /dev/gps as the serial port connected
to the GPS.

NOTE:  You _must_ modify your GPS board to get it functioning.  By default,
the GPS output is modified and does not match the spec.  Directions
can be found on Tim Laren's page at http://gps.instanet.com/

I also have support almost integrated into gpsd (http://www.mayko.com/gpsd.html)

THANKS
======

Extra special thanks to James Dugal <[e-mail]> for fixing and expanding on
version 0.1, as well as adding the gps_printloc and gps_reset programs.
Everything from 0.1 to 0.2 is from him!

Also thanks to Quozl <[e-mail]>, Tim Laren <[e-mail]> 
Dave Platt <[e-mail]>, Jac Kersing <[e-mail]>,
Juha Nurmela <[e-mail]> and anyone else I have left out
for info and code!

SUPPORTED PLATFORMS
===================

Developed and tested on Linux 2.3.14 w/ glibc 2.1
Test compiled on Solaris 5.5.1

Should be pretty generic other than termios stuff.

OTHER
=====

Up-to-date versions of this software are maintained at
http://www.amphibious.org/gps.html.

I can be reached at [e-mail]

BAD NEWS
========

Well, I guess it was just too good to last!  mavin.com has sold out of these
units, so count yourself lucky if you got one!