GARDUMP(1)

NAME
gardump - dump waypoints, routes, and tracks from a Garmin GPS unit

SYNOPSIS
gardump [-vwrtu] [-d debug-level] [-p port]

DESCRIPTION
gardump will dump (retrieve) waypoint, route, and/or tracking information from a Garmin GPS unit sending the data to standard out in a readable format. The output can be re-directed to a file, massaged with your favorite text editor, and then sent back to the GPS unit using the garload(1) program.

The options are as follows:

-v  Display the software version on stderr and exit with a return code of 1.

-w  Retrieve waypoints and write them to stdout.

-r  Retrieve routes and write them to stdout.

-t  Retrieve the track log and write it to stdout.

-u  Retrieve the UTC timesamp and write it to stdout.

-d debug-level
    Enable various levels of debugging output. Without this option debugging is disabled and only critical errors are written to stderr. Additional debug output at the various levels are:

    1   Write all error messages to stderr.

    2   Write status messages to stderr.

    3   Write Garmin application protocol status to stderr.

    4   Perform a dump of all data going in and out of the Garmin layer 2 protocol machine. Data sent to the GPS is prefixed by the symbol }. Data received from the GPS is prefixed by the symbol {. Data is written to stderr.

    5   Perform a dump of all data read from/written to the GPS unit. Data sent to the GPS is prefixed by the symbol >. Data received from the GPS is prefixed by the symbol <. Data is written to stderr.

-p port
    Use port as the device connected to the GPS unit. The default port is a compile time option that is typically set to /dev/tty00.

If no options are given gardump will retrieve the UTC time, waypoints, routes, and tracks, in that order. All are written to stdout.

EXAMPLES
The command:

    gardump -w

results in the output

    [gardump version 1.93]
    [product 155, version 207: GPS 5 Software Version 2.07]
    [waypoints, 3 records]
    # **n [route name]
    # lat long [A:alt] [S:sym] [D:display] [I:id] [C:cmnt] [W:wpt info] [L:link]
     37.109129 -121.016012 S:18 I:ANDRSN C:ANDERSEN'S SPLIT PEA
     36.524042 -118.765690 S:18 I:BCKEYE C:HWY 198
     38.667026 -120.122119 S:18 I:SILVER C:SILVER LAKE
    [end transfer, 3/3 records]

SEE ALSO
garload(1)

AUTHORS
Marco S. Hyman using information from the published GARMIN GPS Interface Specification, dated December 6, 1999 and the note OBSERVATIONS OF THE GARMIN-GARMIN PROTOCOL by william.soley@sun.com and werme@zk3.dec.com.

BUGS
Tested with a Garmin GPS III+ and GPS V using OpenBSD versions 2.3 through 3.3 running on SPARC and i386. May not work with other GPS units or operating systems