Important

Not all strains of Linux are supported. Fedora 7 is known not to work, for example.

Only the 'usb:' device is supported. If you're on Windows, do not attempt to
run this through the serial driver.

On Linux, a name of the form 'hid:path-to-hidraw,path-to-hiddev' is also supported.
You will need to use this only if the HID device nodes on your system are not named
/dev/hidrawN and /dev/hiddevN or /dev/usb/hiddevN.

This module implements the (undocumented) waypoint extensions introduced
for enhanced geocaching mode in 2.5 for PN-40 and 1.6 for PN-20. As
these are reverse engineered, there may be issues with those modes
in particular.

If you receive a message that the device is busy, especially on Windows,
that could be because another program, likely Delorme's own, has the
device open even though it's not actively interacting with the GPS. In
Topo 8, on the GPS tab, look for GPS Options. Uncheck "Start GPS" and
"Automatically detect GPS". Then just click the Exchange button when
you're ready for Topo to interact with the GPS. Other Delorme software may
be similar.

The GPS should not be in 'map exchange' mode. When in that mode, it appears
as a disk to the USB system, thus GPSBabel will be unable to find the GPS.

get_posn option

Return current position as a waypoint.

This option returns the current position as a single waypoint.

logs option

Include groundspeak logs when writing.

When set to true, this includes Groundspeak logs from GPX pocket queries
when writing to Delorme devices that support the extended features introduced
in firmware version 2.5 for the PN-40 and PN-30 and in 1.6 for the PN-20.

long_notes option

Use long waypoint notes regardless of PN version.

Use long waypoint notes, overriding the built-in version check (which is
reverse engineered) that tests if the unit can handle the waypoint comments
longer than 800 bytes.

This option will probably go away in time as most units get upgraded to
the capabilities of the 2.5 version of the PN-40 and PN-30 or version 1.6
for the PN-20.

nukewpt option

Delete all waypoints before sending.

When present on the command line and sending waypoins (either explicitly
via -w or as the default), this will erase
all waypoints in the receiver before sending the new ones.

nuketrk option

Delete all tracks before sending.

When present on the command line and sending tracks with -t, this will erase
all tracks in the receiver before sending the new ones.

nukerte option

Delete all routes before sending.

When present on the command line and sending routes with -r, this will erase
all routes in the receiver before sending the new ones.

hint_at_end option

If true, geocache hint at end of text.

When set to true, this places the "HINT:" entry from a geocacching.com
pocket query at the end of the screen (scroll up for quick access) like
Cache Register and Topo7 do instead of at the top as Topo8 does.

gcsym option

If set to 0, prefer user-provided symbols over Groundspeaks ones for geocaches.

This 1/0 option, defaulting to if not provided, tells GPSBabel to
use its own logic when sending data it can deduce is a geocache to
the device. If false, any icon data present in the source data will
be used instead. If you've taken control of the icon data, you are
responsible for providing valid icons; GPSBabel will make no attempt
to purify what gets sent.