NAME
pilot-link - A suite of tools for communicating with Palm handhelds,
such as those made by Palm, Handspring, Handera, TRGPro, Sony or other
Palm Compatible Handheld PDA device.
SECTION
Pilot-link: Overview
DESCRIPTION
The pilot-link suite of tools contains a series of conduits, libraries,
and language bindings for moving information to and from your Palm
device and your desktop or server/workstation system, as well as across
the network.
TARGET DEVICE
The /dev/pilot fallback has been removed in v0.12. The environment
variable $PILOTPORT can be set in your shell, to save specifying the
port each time. A serial device specified on the command-line will be
used regardless of any $PILOTPORT setting. If $PILOTPORT is not set,
and -p is not supplied, all conduits in pilot-link will print the usage
information. The default connection rate is 9600 baud. You are welcome
to try higher baud rates (19200, 38400, 57600 or higher) by setting the
$PILOTRATE environment variable, but various machines have various
limitations. (Be careful about values higher than 115200 on older Linux
boxes if you’ve been using setserial to change the multiplier).
CONDUITS
A complete list of conduits available from within the pilot-link
package as of the date of this manpage. If you invoke any of the
conduits from pilot-link with no command-line arguments at all, the
usage summary will be printed.
Note that there are widespread changes in this release - some conduits
have been merged, a lot have had new options added and some options
have been renamed or removed.
addresses
DEPRECATED: Use pilot-addresses --write|--human-readable instead.
pilot-hinotes
Syncihronize your Hi-Notes database with your desktop machine.
install-datebook
installs a new datebook entry onto your Palm handheld.
pilot-install-expenses
Install an expense record from various parameters and arguments passed
at connection time.
install-hinote
Install local files into your Hi-Note database on your Palm handheld.
install-memo
Installs a new Memo Pad entry onto your Palm handheld.
pilot-install-netsync
reads or sets the Network Preferences information on a Palm Device.
Modifies the "Network Preference" settings and reports additional
intormation about the Palm, such as the IP, hostname, and other
information as they are set on the Palm.
install-todo
Updates the Palm ToDo list with one new entry.
install-todos
Updates the Palm ToDo list with entries from a local file.
install-user
Reads or sets a Palm User and UserID on a Palm Device. Modifies the
"User Preference" settings and reports additional intormation about the
Palm, such as the Username and UserID as they are set on the Palm
pilot-memos
Manipulate Memo entries from a file or your Palm device.
pilot-addresses
Read and write address book databases to and from a Palm handheld.
Changes in 0.12: Incorporates functionality from the now deprecated
addresses conduit.
pilot-archive
DEPRECATED: Use pilot-read-todos -w --archived instead.
pilot-clip
Get or Set the Palm Clipboard contents from STDOUT/STDIN.
pilot-dedupe
Removes duplicate records from any Palm database.
pilot-file
Dump application and header information from your local PRC/PDB files.
pilot-foto
Palm ’Foto’ Image Installer/Remover/Fetcher/Converter
pilot-read-screenshot
Read screenshots from Palm (ScreenShotDB).
pilot-schlep
Package up any arbitrary file and sync it to your Palm device.
pilot-foto-treo600
Copies Treo 600 foto databases to current directory and extracts .jpg
files from them.
pilot-foto-treo650
Copies Treo 600 images and videos to the current directory
pilot-wav
Decodes Palm Voice Memo files to wav files you can read
pilot-xfer
Backup, sync, and restore databases from a Palm handheld device.
pilot-read-expenses
Export Palm Expense application data in a text format.
pilot-read-ical
Exports the DatebookDB and/or ToDo applications (DatebookDB.pdb and
ToDoDB.pdb respectively) to Ical format. (The ical application must be
installed and working on your system first. This is NOT the same thing
as the iCal Calendar format, however).
pilot-read-notepad
List the record information found in the Palm Notepad (Palm OS4 and
later) application.
pilot-read-palmpix
Convert all pictures in the files given or found on a Palm handheld.
pilot-read-todos
Synchronize your Palm ToDo application’s database with your desktop
machine.
pilot-read-veo
Synchronize your Veo Traveler databases
pilot-reminders
Exports your Palm Datebook database into a ’remind’ data file format.
TOOLS
pilot-debugsh
Simple debugging console for a Palm Handheld device (deprecated).
pilot-dlpsh
An interactive Desktop Link Protocol (DLP) Shell for your Palm device.
This is very useful for debugging potential problems with your serial
port. Query the RAM/ROM, list databases, change your UserID or
Username, and many other useful functions. This is the "Swiss Army
Knife" of any of pilot-link’s tools.
pilot-csd
Connection Service Daemon for Palm Devices
pilot-getram
Retrieves the RAM image from your Palm device for use in debugging.
pilot-getrom
Retrieves the ROM image from your Palm device for use in debugging.
pilot-getromtoken
Reads a ROM token from a Palm Handheld device.
pilot-nredir
Accept connection and redirect via Network Hotsync Protocol.
PERL SCRIPTS
(Available from the source code, not always installed from packages).
pilot-ietf2datebook.pl
Converts IETF agenda format to install-datebook format
pilot-undelete.pl
Turn previously archived records into normal (non-archived) records by
resetting the "dirty" bit.
pilot-sync-plan.pl
completely synchronize the Palm datebook with the "plan" calendar via
netplan, including authenticating to the netplan server itself.
ADVANCED PROGRAMS
Some of these programs are not intended for general end-users. More
detailed documentation on their usage can be obtained by reading the
source of the application itself.
ccexample
test program demonstrating C++ interface.
iambicexample
test program demonstrating C++ interface.
validate
experimental program to test C++ features.
OBTAINING
The most current version of the pilot-link suite of tools can be found
at the pilot link homepage: http://www.pilot-link.org/
MAILING LIST
The original pilot-unix mailing list has been taken offline, and is now
being hosted and maintained by David A. Desrosiers
<desrod@gnu-designs.com>. The original pilot-unix mailing list was
maintained by Matthew Cravit. Its mandate was:
The pilot-unix mailing list is for discussion and "idea-sharing" for
those interested in using your Palm handheld with UNIX systems. This
includes people who are interested in helping to develop tools to allow
the Palm to operate with UNIX and other POSIX systems, and possibly to
develop an SDK (Software Development Kit) for the Palm for Unix.
For more information, including how to subscribe to the pilot-link
mailing lists, please visit the pilot-link mailing list subscription
page:
http://lists.pilot-link.org/
pilot-link specific mailing lists are also available for Development,
General, and Announce topics, at the following:
http://lists.pilot-link.org/mailman/listinfo/pilot-link-devel
http://lists.pilot-link.org/mailman/listinfo/pilot-link-general
http://lists.pilot-link.org/mailman/listinfo/pilot-link-announce
AUTHOR
Most of the pilot-link tools were written by Kenneth Albanowski. This
manual page was written by David H. Silber <pilot@orbits.com>, and
updated for version 0.12 of pilot-link by Neil Williams <
linux@codehelp.co.uk > .
Current maintainer of pilot-link as of the authoring of this manpage is
David A. Desrosiers <desrod@gnu-designs.com>.
Any questions or problems with pilot-link should be directed at the
various pilot-link mailing lists or to the irc channel dedicated to
supporting pilot-link at irc.pilot-link.org in your irc application
(not a web browser).
PATCHES
All patches you wish to submit should be sent to
<patches@pilot-link.org> directly, with a brief explanation of what the
patch adds or fixes. Please make sure to send your patched in unified
diff format (diff -u).
SEE ALSO
pilot-addresses(1), pilot-dlpsh(1), pilot-hinotes(1),
pilot-ietf2datebook(1), pilot-install-datebook(1),
pilot-install-expenses(1), pilot-install-hinote(1),
pilot-install-memo(1), pilot-install-netsync(1), pilot-install-user(1),
pilot-getrom(1), pilot-getram(1), pilot-addresses(1), pilot-xfer(1),
pilot-read-ical(1), pilot-read-notepad(1), pilot-read-palmpix(1)
David Silber <pilot@orbits.com> has written a Pilot HOWTO, which you
can find at http://www.sgmltools.org/HOWTO/Pilot-HOWTO/.html