DeLorme PN-20/PN-30/PN-40 USB protocol (delbin)
Prev | Chapter 3. The Formats | Next

## DeLorme PN-20/PN-30/PN-40 USB protocol (delbin)

This format can...

- read and write waypoints

- read and write tracks

- read and write routes

This format has the following options: get_posn, logs, long_notes, nukewpt, nuketrk, nukerte, hint_at_end, gcsym .

The 'delbin' module supports DeLorme PN-20™, DeLorme PN-30™, DeLorme PN-40™, DeLorme PN-40 SE™, and DeLorme PN 60 ™receivers.

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

Example 3.5. Command to send a pocket query (GPX) to a Delorme PN device

`gpsbabel -i gpx -f "My Caches.gpx" -o delbin -F usb:`

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.

Prev | Up | Next
DeLorme GPL (gpl) | Home | DeLorme Street Atlas Plus (saplus)