GARLOAD(1)

NAME
garload - load waypoints, routes, and tracks to a Garmin GPS unit

SYNOPSIS
garload [-v] [-d debug-level] [-p port]

DESCRIPTION
garload will load waypoint, route, and/or tracking information to a Garmin GPS unit from standard input. The data is expected to be in the format dumped by gardump(1). The input can be re-directed from a file, loading data that was dumped using gardump.

The options are as follows:

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

-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.

garload reads stdin and determines what to do based upon the data read. Data is assumed to be in the format created by gardump(1). That program outputs waypoints, routes, and track logs, preceding each section by a ``comment'' in square brackets. garload uses the ``comment' to determine what data to upload. The ``comments'' acted upon are:

[waypoints, n records]
    Begin upload of waypoints. The number of records is ignored.

[routes, n records]
    Begin upload of routes. The number of records is ignored. Routes are composed of a route header followed by route waypoints.

[tracks, n records]
    Begin upload of a track log. The number of records is ignored. The time/date field in track log entries, if present, is ignored on upload.

[end transfer, n/m records]
    Terminate any existing upload.

Each tranfer should be terminated by an `[end transfer...] record before the next transfer is started. garload will ignore any line where the first non-blank character is ``#''. This allows comments to be added to files that will be processed by garload. A brief description of the record format for waypoints, routes, and tracks is output by gardump(1) in the form of a comment as part of each download.

SEE ALSO
gardump(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