gpsman(1)

1GPSMAN(1)                        User Commands                       GPSMAN(1)
2
3
4

NAME

6       gpsman - a (graphical) manager of GPS data
7

SYNOPSIS

9       gpsman [-dev [usb=]DEVICE]
10       gpsman [OPTIONS] COMMAND [COMMAND_ARGS]
11

DESCRIPTION

13       gpsman  GPS  Manager  (GPSMan)  is a graphical manager of GPS data that
14       makes possible the preparation, inspection and edition of GPS data in a
15       friendly  environment. GPSMan supports communication and real-time log‐
16       ging with Garmin, Lowrance and Magellan receivers and accepts real-time
17       logging information in NMEA 0183 from any GPS receiver.
18
19       To  comunicate  with  the  GPS  port  the  user  must have been granted
20       read/write permissions for the corresponding device.
21
22       For use in graphical mode GPSMan must be invoked as in the  first  form
23       above, where the usb= prefix to the device path enforces the use of the
24       Garmin USB protocol. The use in this  mode  is  not  further  described
25       here, a full description being given in the User Manual available along
26       with the GPSMan distribution.
27
28       GPSMan can also be used in command line mode (with no graphical  inter‐
29       face),  in  which  case it must be invoked as in the second form above.
30       The sections below address this mode.
31

EXIT STATUS

33       In non-graphical mode GPSMan exits with either a 0 if COMMAND was  suc‐
34       cessfully executed, or a 1 if not. Some commands will write information
35       to the standard output channel. Error messages can possibly be  written
36       to  the  standard  error  channel,  but  most of the errors will not be
37       explained. In case of doubt the graphical mode should be used to see if
38       there are problems with files or the receiver.
39

OPTIONS

41       Apart  from  the -dev option all other options are only for use in non-
42       graphical mode.
43
44       -dev DEVICE gives the device path.
45
46       -log creates a log file of the serial communication
47              under the name logfile in the GPSMan user directory.
48
49       -rec Garmin | Lowrance | Magellan
50              changes the brand of the receiver (NOTE: at  present  will  only
51              work  with  Garmin);  this  option can be useful to override the
52              options in the preferences file; cannot be used with the readput
53              command,  nor with the -prefs option, and cannot occur after the
54              -prot option.
55
56       -prefs PREFSFILE
57              gives the path for an alternative preferences file  (read  after
58              the user preferences file); cannot be used with the -rec option.
59
60       -prot PROTOCOL
61              selects  the protocol to be used for connecting to the receiver;
62              cannot occur before the -rec option; the show protocols  command
63              can be used to find out which protocols are available.
64
65       Options not related with COMMAND will be silently ignored.
66

NAME=VALUE ARGUMENTS

68       Some  commands accept parameters in the form NAME=VALUE. The term PARAM
69       when used here referring to arguments of  a  command  has  always  this
70       meaning. Care should be taken if the value part is a string with spaces
71       (or other characters with special meaning for the shell or system  com‐
72       mand  interpreter)  in  which case quotes or some other form of quoting
73       should be used.
74

GPSMAN COMMAND SUMMARY

76       There is no room in a manual page to describe in detail  the  available
77       commands. The following list gives a synopsis for all of them:
78
79       is available exits with 0.
80
81       is connected
82              exits with 0 if a connection check with the receiver succeeds.
83
84       show  WHAT  writes help information to the standard output; WHAT is one
85       of: datums, formats (data file formats), help, projections,  protocols,
86       symbols (waypoint symbols), transfs
87              (coordinates transformations).
88
89       haslib LIBRARY checks availability of library
90
91       getwrite INTYPES FORMAT [OUTTYPES] [OUTPARAMS] PATH transfers data from
92       the receiver to a file.
93
94       readput FORMAT [INPARAMS] [INTYPES] PATH [OUTTYPES] transfers data from
95       a file to the receiver.
96
97       getrtimelog  PATH  [INTERVAL]  gets the real-time log from the receiver
98       and saves it to a file.
99
100       getfix PATH [TIMEOUT] gets the current fix data from the  receiver  and
101       saves it to a file.
102
103       getalmanac  PATH  gets  the  current almanac data from the receiver and
104       saves it to a file.
105
106       read IN-FORMAT [PARAMS] [TYPES] PATH reads a data file and launches the
107       graphical  interface (in GPSMan scripts the behaviour is different; see
108       the exec command in the user manual).
109
110       start travel [INTERVAL] launches the  graphical  interface  and  starts
111       real-time logging, animation and travelling.
112
113       translate FORMAT [INPARAMS] [INTYPES]PATH FORMAT [OUTPARAMS] [OUTTYPES]
114       PATH translates from a file format to another.
115
116       project LATD LONGD DATUM PROJECTION [PARAMS]  writes  to  the  standard
117       output the projection of a point.
118
119       georef  IMGPATH TRANSF LATD LONGD LATD LONGD [LATD LONGD] DATUM X Y X Y
120       [X Y] PROJECTION [PARAMS] writes to the standard output a map  informa‐
121       tion file.
122
123       geopicts  IN-FORMAT [IN-PARAMS] IN-TYPE IN-PATH [PROC-PARAMS] [OUT-FOR‐
124       MAT] [OUT-PARAMS] OUT-PATH PICT-PATHS geo-references files either based
125       on  their  time-stamps  and  a given track, or by using the sequence of
126       waypoints in a group.
127
128       source PATH executes a Tcl/Tk script.
129
130       exec PATH executes a GPSMan script.
131

AUTHORS

133       This manual page was written by Miguel Filgueiras <mig@ncc.up.pt> using
134       a previous version by Rogerio Reis <rvr@ncc.up.pt>.
135
136       GPSMan:  developed  and maintained by Miguel Filgueiras, with contribu‐
137       tions by Brian Baulch, Rogerio Reis, Andreas Lange, Alessandro  Palmas,
138       Niki  Hammler,  Martin  Ostermann,  Valere  Robin, David Wolfskill, Rob
139       Buitenhuis, Frank Kujawski, Tri  Agus  Prayitno,  Matt  Martin,  Stefan
140       Heinen,  Heiko Thede, Sabine Broda, Alberto Morales, Martin Buck, David
141       Kaplan, Jean H. Theoret, Paul Scorer, Nigel Orr, David Gardner.
142

REPORTING BUGS

144       Report bugs to <mig_AT_ncc.up.pt>.
145

COPYRIGHT

147       Copyright (C) 1998-2007 Miguel Filgueiras and Rogerio Reis
148       LIACC & DCC Faculdade de Ciencias/ University of Porto
149
150       This is free software; see the source for copying conditions. There  is
151       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
152       PURPOSE.
153