GARDUMP(1)

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

SYNOPSIS
gardump [-vwrtus] [-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.

-s  Print a screenshot in PPM format. This option has only been tested on the GPSmap 76CS. If the 76CS has the Altimeter screen displayed with Display Mode set to Daytime and pressure units set to Inches (Hg) the program does some simple character recognition to get the value of either the Amb. Pressure or Barometer field (since there is no documented way to read out the pressure values directly). The pressure value is derived from the top left data field of the Altimeter screen. It prints a line like

        [Altimeter Screen, top left field: 27.44 inHg]

    to stderr.

-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