GPStrans-0.37
-------------

Code clean-up and some minor code correction.
Added command line time support for etrex (and other models like) 
Added install/uninstall
Documentation updated
Added a TODO 
Since i got no answer from mattes@ugraf.com and i had permission from the
author, i've decided to post this new version of gpstrans.

Bug reports are welcome to <seabra@ci.aac.uc.pt>

GPStrans-0.36
-------------

This implements german grid (aka Gauss-Krueger Grid) and 
adds the potsdam map datum. Contribution made by Andreas Lange 
<Andreas.Lange@Rhein-Main.de>.


GPStrans-0.35
-------------

includes adds functionality for Swedish grid coordinates 
to gpstrans. Thanks to Anders Lennartsson <abel@mech.kth.se>
for the contribution.



GPStrans-0.34
-------------

GPStrans-0.34 will allow you to exchange "routes" between
Mayko mXmap and the Garmin GPS receiver. 

You can create your 'route' easily within mXmap and 
save in a file to upload it later into your Garmin device. 
 
	gpstrans -m -ur your_mxmap_route.xrou

Note: the route will be saved as the default route (0) with the
name MAYKO MXMAP in the Garmin itself.
From there you can activate it or store (if available) in one 
of the route registers. It needs to be addressed that the Garmin
has some limitation for the route name and the route waypoints.
All routes appear in capital letters and spaces will be automatically
eliminated by gpstrans when saving the route.
Route names will be displayed with the max. length of your device.
Route waypoints are stripped down to 6 chars.

Vice versa you can save a route from the Garmin in a file "*.xrou"
and import this into mXmap to display the route on a map.

	gpstrans -m -dr fromgarmin.xrou

Bugfixes:
On saving routes a segmentation fault could happen, because
the record counter used to compute one route too much.


What is GPStrans-0.33
---------------------

This version (re-)support the '-i' option, which tells you
model name and software version from your Garmin GPS.
Thanks to Jim Van Zandt <jrv@vanzandt.mv.com>, who send the patch.
(see CHANGELOG for more details)

usage -	'gpstrans -i' will output the following for example:

      Connected GPS [/dev/cua0] is: Garmin GPS 38 - V3.04
or    Connected GPS [/dev/cua0] is: Garmin GPS II+ SOFTWARE - V3.00
 

What is GPStrans-0.32
---------------------

GPStrans-0.32-mk is a program which allows to download tracks 
from your Garmin GPS and save the data in the Mayko Xmap format.

Tracks retrieved from your Garmin GPS could be feed back into
Mayko Xmap application (see www.mayko.com/xmap) and replayed
with the "Track from log" feature.

This allows you to display your recorded track on your 
favorite map in Mayko Xmap.

It is tested on Intel-based Linux machines (2.0.33, gcc-2.7.2.1) 
with Garmin GPS II Plus. I haven't test it with other 
operating systems or with other GPS receivers. Please report
any problem to mxmap@mayko.com.

See the README of gpstrans-0.31b-js1 for further information.


Changes to GPStrans-0.32b-mk vs. GPStrans-0.32-mk
-------------------------------------------------

Version 0.32b-mk (versa 0.32-mk) will calculate speed
based on distance and time between two gps points.

Note, this speed is 'average' information and does not necessarily
reflect the 'real' speed expirienced at track time. 
Use Mayko's Xmap "track to log" feature to log more detailed
information.

Altitude data can not be generated. Unfortunately this
information (even if produced by certain Garmin GPSs) is
not natively saved by a Garmin GPS and the Garmin protocol
does not deliver such data either.
 

How to use GPStrans-0.32
------------------------

Gpstrans-0.32 includes a new option which needs to be applied to
save downloaded data in the Xmap format:

	gpstrans -s			// configure gpstrans
	gpstrans -m -dt >track.xlog	//download and save in Xmap format	

Note, the current version only allows to save 'track' information
of the Garmin GPS in Xmap-format. On interest we will follow up
with an updated version to utilize route data between Garmin
and Mayko-Xmap.


How to get GPStrans
-------------------

The Linux/Mayko-Xmap version of gpstrans-0.32-mk is available at:

        http://www.mayko.com/xmap
        ftp://ftp.mayko.com/pub/gpstrans

Gpstrans is based on the Linux/KKJ version (gpstrans-0.31b-js) 
and should be available at:

        http://www.psych.helsinki.fi/~janne/gps/


Modified and new sources are:
-----------------------------

	README.xmap
	CHANGELOG
	main.c
	gps/getgpsinfo.c
	include/defs.h


The diff-patch file was created using gnu's diff:

	diff -r -u -N gpstrans-0.31b-js1 gpstrans-0.32b-mk/


You should be able to apply the patch the following:

	cd you_gpstrans_direct
	patch -p1 yourpath/patch-0.31b_to_0.32b
   or	gzip -dc yourpath/patch-0.31b_to_0.32b.gz |patch -p1


------------- from here on, README of gpstrans-0.31b-js -----------------

What is GPStrans
----------------

GPStrans is a program which allows to up- and download waypoints,
route, almanac and trackroutes from you Garmin GPS. This version
(gpstrans-0.31b-js1) is pure ASCII and seems to work in Intel-based
Linux machines (2.0, gcc-2.7.2) with Garmin 45XL. I haven't test it in
other operating systems or with other GPS receivers. 

See Linux-diff-* files for differences between gpstrans-0.31b and
gpstrans-0.31b-js.

How to get GPStrans
-------------------

The Linux/KKJ version (gpstrans-0.31b-js) should be available in

	http://www.psych.helsinki.fi/~janne/gps/ 

and in Peter Bennett's GPS ftp directory:

	ftp://sundae.triumf.ca/pub/peter/index.html.


Software and Hardware Requirements
----------------------------------

To successfully compile GPStrans you'll need 'gcc' or another ansi-C
compatible Compiler.

GPStrans was developed using a Sun Workstation with SunOS 4.1.3.  The
Linux/KKJ version (gpstrans-0.31b-js) should work where the original
(gpstrans-0.31b-js) works, and in Linux as well. If you have problems
in Alpha-based machines for example, check the points of the code
where byte order is relevant (search for __LINUX__ and you find them).

Installation of GPStrans
------------------------

Check the Makefile and edit if necessary. Compile by writing
'make'. Install by hand - only the binary needs to be installed,
there's not even a manual page :). If you have problems, check your
serial port settings and hardware (see below).


Connection the GPS to the Workstation
-------------------------------------

You'll need a DB-25 connector. You'll need to connect pin 4, 5 and 6, 8, 20
together. This is used to set handshake and DTR to the correct value so that
your workstation can use the serial port to communicate with the GPS.

                        1     ### #####
                        o o o # # # o # o o o o o
                         o o o o o o # o o o o o


Connect the Garmin cable as follows:

                          2 3       7
                        o o o o o o o o o o o o o    2: TX   3: RD
                         o o o o o o o o o o o o     7: GND


	Pin 2 goes to DATA IN  (White)
	Pin 3 goes to DATA OUT (Brown)
	Pin 7 goes to GROUND   (Black)


If it doesn't work in this way, try to chance Pin 2 and 3 at the connector.

If you don't have any success at the first time, you might try it using a 
terminal program like Kermit and set the GPS to NMEA-Output. The GPS will
send a data record every 2 second. As long as you don't see any data on
your computer GPStrans won't work.

After finishing it, be sure to set you GPS receiver to GRMN/GRMN in the
I/O-Setup.


Using the program
-----------------

I think that the program is so easy to use that we don't need a
description about it here. A couple of hints: just run it to get help;
use the '-s' option at some point, it makes the use even easier.

The file format
---------------

If you're using GPStrans to upload data to you GPS be sure that the first
line of the datafile contains a line like (without the --- line)

-------8<-------------------8<------------------->8------------------->8-------
Format: DMS  UTC Offset:   2.00 hrs  Datum[100]: WGS 84
-------8<-------------------8<------------------->8------------------->8-------

GPStrans will need this line to interpret the following datalines. It gives 
information about the latitude/longitude format you used, the offset from 
local to UTC-time and the map-datum. Be sure you not change the position
of the the characters in this line.

After this line follows the data. Waypoints are marked with 'W',
Routes with 'R', Tracks with 'T' and Almanac Data with 'A'. Each field
in a line will be separated using a TAB-character and maybe some
spaces (experiment or read the code).

The simpliest way to understand the format is to just download data from
your GPS and look at them.



GPStrans Licensing Information
------------------------------

GPStrans is FreeWare. I'm releasing this source code to the public domain.
You can redistribute it as often as you want as long as you let the original
copyright notice in. If you like to do changes to GPStrans, please contact
me before so that we can coordinate the work.

GPStrans is Copyright 1995 by Carsten tschach (tschach@zedat.fu-berlin.de).
The datum translation-routines are based on the program MacGPS from John F.
Waers (jfwaers@csn.net).

Linux/KKJ modifications Copyright 1996 by Janne Sinkkonen (janne@iki.fi).

Modifications to read many more Garmin formats Copyright 2005 by Jim
Van Zandt <jrv@debian.org>, and can be redistributed or modified 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.
