Introduction
=========================

gpsutils will be a set of GPS related utilities ard libraries. The software
suite will be a written in Java, C and Perl. I'm developing on the Linux OS
(Redhat 6.0 i386). Windows users may need to hack the code a little to get
it to work (patches welcome).

See COPYING for licence information. 

I have quite a bit if stuff under development, much is not ready to be
released yet, but I hope to make a major release before Christmas 1999.

Some of the code is based on Pascal code written by samsvl@nlr.nl and
C code by djjohn@essex.ac.uk.

Latest release of this software available from
http://www.wombat.ie/gps/

Current release: Version 0.4.0  (20 Dec 1999)
============================

To build on unix style systems enter 'make' from the src directory.

* capture

'capture' is a utility that grabs binary data from a Garmin GPS35 and at a
specified interval downloads satellite ephemeris. For example:

capture -p /dev/ttyS0 -t 900 | garminbin 

will capture data from a Garmin GPS35/GPS25 on /dev/ttyS0 and output
to stdout. Every 900 seconds the ephemeris will be downloaded.


* garminbin 

garminbin is a utility that takes binary data from Garmin OEM units (eg the
GPS35 TracPak) and converts it into a printable format. Several formats
available: A output similar to the output 
from Garmin's GPS25PM.EXE DOS utility:

TIM <GPS time of week (seconds)> <GPS week number>
RCV <prn> <snr> <slip> <pseudorange (meters)> <cycles>

The RCV record is repeated for each SV being tracked. 

To test garminbin do 

make
./garminbin < sample.bin | more

Ephemeris records are output in a format similar to the GPS25PM.EXE DOS
program from Garmin.



* gbindiff 

Utility that takes two Garmin binary files -- one from a reference
position, the other from a moving receiver and do post processed DGPS.
Its currently not working properly. This should be working for 
version 0.4.1.  There are two sample files dgps-a.bin and dgps-b.bin. 
Both are dumps from Garmin GPS35 units which were sitting side by side.


Enjoy,

Joe Desbonnet, joe@wombat.ie
20 Dec 1999.
