NAME¶
gpsman - a (graphical) manager of GPS data
SYNOPSIS¶
gpsman [
-dev [usb=]DEVICE]
gpsman [
OPTIONS]
COMMAND [
COMMAND_ARGS]
DESCRIPTION¶
gpsman GPS Manager (GPSMan) is a graphical manager of GPS data that makes
possible the preparation, inspection and edition of GPS data in a friendly
environment. GPSMan supports communication and real-time logging with Garmin,
Lowrance and Magellan receivers and accepts real-time logging information in
NMEA 0183 from any GPS receiver.
To comunicate with the GPS port the user must have been granted read/write
permissions for the corresponding device.
For use in graphical mode GPSMan is normally invoked in the first form above,
where the
usb= prefix to the device path enforces the use of the Garmin
USB protocol. The use in this mode is not further described here, a full
description being given in the User Manual available along with the GPSMan
distribution.
GPSMan can also be used in command line mode (with no graphical interface except
with the
readstart travel commands), in which case it must be
invoked in the second form above. The sections below address this mode.
EXIT STATUS¶
In non-graphical mode GPSMan exits with either a 0 if
COMMAND was
successfully executed, or a 1 if not. Some commands will write information to
the standard output channel. Error messages can possibly be written to the
standard error channel, but most of the errors will not be explained. In case
of doubt the graphical mode should be used to see if there are problems with
files or the receiver.
OPTIONS¶
Apart from the
-dev option all other options are only for use in
non-graphical mode.
- -dev DEVICE gives the device path.
- -log creates a log file of the low-level
communication
- under the name logfile in the GPSMan user
directory.
- -rec Garmin | Lowrance | Magellan
- changes the brand of the receiver (NOTE: at present will
only work with Garmin); this option can be useful to override the
options in the preferences file; cannot be used with the readput
command, nor with the -prefs option, and cannot occur after the
-prot option.
- -prefs PREFSFILE
- gives the path for an alternative preferences file (read
after the user preferences file); cannot be used with the -rec
option.
- -prot PROTOCOL
- selects the protocol to be used for connecting to the
receiver; cannot occur before the -rec option; the show
protocols command can be used to find out which protocols are
available.
Options not related with
COMMAND will be silently ignored.
NAME=VALUE ARGUMENTS¶
Some commands accept parameters in the form
NAME=VALUE. The term
PARAM when used here referring to arguments of a command has always
this meaning. Care should be taken if the value part is a string with spaces
(or other characters with special meaning for the shell or system command
interpreter) in which case quotes or some other form of quoting should be
used.
GPSMAN COMMAND SUMMARY¶
There is no room in a manual page to describe in detail the available commands.
The following list gives a synopsis for all of them and the User Manual should
be consulted for more information.
- is available exits with 0.
- is connected
- exits with 0 if a connection check with the receiver
succeeds.
- show WHAT writes help information to the
standard output; WHAT is one of: datums, formats (data
file formats), help, projections, protocols,
symbols (waypoint symbols), transfs (coordinates
transformations).
- haslib LIBRARY checks availability of a
library
- getwrite INTYPES FORMAT
[OUTTYPES] [ OUTPARAMS] PATH transfers data from the
receiver to a file.
- readput FORMAT [INPARAMS]
[INTYPES] PATH [OUTTYPES] transfers data from a file to
the receiver.
- getrtimelog PATH [INTERVAL] gets the
real-time log from the receiver and saves it to a file.
- getfix PATH [TIMEOUT] gets the current
fix data from the receiver and saves it to a file.
- getalmanac PATH gets the current almanac data
from the receiver and saves it to a file.
- read IN-FORMAT [PARAMS] [TYPES]
PATH reads a data file and launches the graphical interface (in
GPSMan scripts the behaviour is different; see the exec command in
the User Manual).
- start travel [INTERVAL] launches the
graphical interface and starts real-time logging, animation and
travelling.
- translate FORMAT [INPARAMS]
[INTYPES] PATH [HOWPARAMS] FORMAT
[OUTPARAMS] [ OUTTYPES] PATH translates from a file
format to another.
- project LATD LONGD DATUM
PROJECTION [PARAMS] writes to the standard output the
projection of a point.
- georef IMGPATH TRANSF LATD
LONGD LATD LONGD [LATD LONGD] DATUM
X Y X Y [X Y] PROJECTION
[PARAMS] writes to the standard output a map information file.
- geopicts FORMAT [INPARAMS]
INTYPE PATH [PROCPARAMS] [FORMAT]
[OUTPARAMS] PATH PICTPATHS geo-references files either
based on their time-stamps and a given track, or by using the sequence of
waypoints in a group.
- source PATH executes a Tcl/Tk script.
- exec PATH executes a GPSMan script.
AUTHORS¶
This manual page was written by Miguel Filgueiras <mig_AT_portugalmail.pt>
using a previous version by Rogerio Reis <rvr_AT_debian.org>.
GPSMan: developed and maintained by Miguel Filgueiras, with contributions by
Brian Baulch, Rogerio Reis, Andreas Lange, Alessandro Palmas, Niki Hammler,
Martin Ostermann, Valere Robin, David Wolfskill, Rob Buitenhuis, Frank
Kujawski, Tri Agus Prayitno, Matt Martin, Stefan Heinen, Heiko Thede, Sabine
Broda, Alberto Morales, Martin Buck, David Kaplan, Jean H. Theoret, Paul
Scorer, Nigel Orr, David Gardner, Nikolai Kosyakoff, Benoit Steiner, Sandor
Laky, Alexander B. Preobrazhenskiy, Rudolf Martin.
REPORTING BUGS¶
Report bugs to <mig_AT_portugalmail.pt>.
COPYRIGHT¶
Copyright (C) 1998-2012 by Miguel Filgueiras <mig_AT_portugalmail.pt> and
Rogerio Reis <rvr_AT_debian.org>
This is free software distributed under the GNU General Public License; a copy
of this license is part of the distribution.
The two GPSMan logos used by
gpsman ara under Copyright (C) 1998-2012 by
Miguel Filgueiras and are distributed under a Creative Commons
Attribution-NonCommercial-NoDerivs 3.0 Unported License. To view a copy of
this license, visit
http://creativecommons.org/licenses/by-nc-nd/3.0/.
All other images used by
gpsman ara under Copyright (C) 1998-2012 by
Miguel Filgueiras and are distributed under a Creative Commons
Attribution-ShareAlike 3.0 Unported License. To view a copy of this license,
visit
http://creativecommons.org/licenses/by-sa/3.0/.
SEE ALSO¶
Miguel Filgueiras,
GPSMan User Manual, Version 6.4.3, April 2012
This manual, in both PDF and HTML, is part of the distribution of GPSMan and can
be retrieved from the GPSMan site at
http://sourceforge.net/projects/gpsman. It is distributed under a
Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License. To
view a copy of this license, visit
http://creativecommons.org/licenses/by-nc-nd/3.0/.