File: README

package info (click to toggle)
gpstrans 0.31b-5
  • links: PTS
  • area: main
  • in suites: hamm
  • size: 480 kB
  • ctags: 520
  • sloc: ansic: 4,250; makefile: 127
file content (110 lines) | stat: -rw-r--r-- 3,820 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
What is GPStrans
----------------

GPStrans is a program which allows to up- and download waypoints, route,
almanac and trackroutes from you Garmin GPS. There is a ASCII-Version
wish will allow to use the basic up-/download features of the program without
having access to a graphic screen. The X11-Verion will soon allow to view
the track-log and waypoints, also allow the edit data.



Software-Requirements
---------------------

To successfully compile GPStrans you'll need 'gcc' or another ansi-C compatible
Compiler. For the X11-Version you also need the xview-package distributed by 
Sun Microsystems as source-code. Be sure to use Version 3.2 or later because I
take use of the new feature like filechooser.



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

GPStrans was developed using a Sun Workstation with SunOS 4.1.3. If you're
using a SUN-Workstation you should only need to check the paths in the 
Makefile to point to the new xview-libraries.

I haven't tried to compile GPStrans on any other machine yet. Please let me
know if it works or not.



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.


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.

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).