gpspoint

Langue: en

Version: 111721 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

NAME

gpspoint - exchange data with a (garmin) gps receiver

SYNOPSIS

gpspoint COMMAND(S) [OPTION(S)]

DESCRIPTION

gpspoint is a program to exchange data with a (garmin) gps receiver. You can upload and download waypoints, routes, tracks and various other data.

COMMAND(S)

-dw, --download-waypoints
download waypoints
-dr, --download-routes
download routes
-dt, --download-tracks
download tracks
-uw, --upload-waypoints
upload waypoints
-ur, --upload-routes
upload routes
-ut, --upload-tracks
upload tracks
-at, --abort-transfer
abort transfer, this is usefull if some previous data exchange failed an the gps device serial port doesn't reply anymore; see also SIGNALS
-o, --off
turn off receiver
-t, --test
test connection to gps device and printout info about device
-h, --help
print out commands and options

OPTIONS(S)

-d port
port, e.g. /dev/ttyS0; the default port is /dev/gps, which is overwritten by the environment variable GPSPORT, finally giving option -p port overwrites both former methods
-if, --input-file filename
read from filename instead from stdin
-of, --output-file filename
write to filename instead to stdout (overwrites existing files)

SIGNALS

gpspoint responds to SIGTERM (usually invoked by CTRL-C ) and tries to terminate current data exchange graciously; useful if some download is taking too long.

Stopping gpspoint with other methods might leave the port locked and the receiver in a state where it will not response. You can then use the -at command or reset it by hand of course.

ENVIRONMENT

GPSPORT
see option -d port and examples

EXAMPLES

gpspoint -t -d /dev/ttyS0
tries to connec to to a (gramin) gps receiver on /dev/ttyS0 and prints out some helpful information, probably a good thing to start with
gpspoint -dw -d /dev/ttyS0 -of my_waypoints.gpd
downloads the waypoints from your gps and stores them in my_waypoints.gpd
gpspoint -dw -d /dev/ttyS0
same as above but writes to stdout
gpspoint -dw -dr -dt
downloads waypoints, routes and tracks; if set the environment variable GPSPORT is evaluated for port; otherwise a default value will be used
gpspoint -uw -dr -d /dev/ttyS0 -if my_waypoints.gpd -of tracks.gpd
uploads waypoints stored in the file my_waypoints.gpd and download all tracks and stores them in the file tracks.gpd

SEE ALSO

mgpspoint

RESOURCES

http://gpspoint.dnsalias.net

AUTHOR

Thomas Schank <schankATinfDOTuni-konstanzDOTde>