GPSPOINT(1)

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>