| Linux / Unix Command: pilot-link |
NAME
pilot-link - a suite of tools for communicating with Palm handheld devices, such as those made from Palm, Handspring, Handera, TRGPro, Sony or other Palm Compatible Handheld PDA deviceDESCRIPTION
The pilot-link suite of tools contains a series of conduits for moving information to and from your Palm device and your desktop or server/workstation system.TARGET DEVICE
All of the pilot-link programs will default to /dev/pilot as the default device used to communicate with a Palm. In general, if the environment variable $PILOTPORT is set, its value will override the default. A serial device specified on the command-line will be used regardless of any $PILOTPORT setting.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 Linux boxes if you've been using setserial to change the multiplier.)
USAGE
Here is a list of programs available from within the pilot-link package as of the date of this manpage.- addresses
-
dump the Palm address book into a generic text-output format
- debugsh
-
command-line interface to a Palm debug monitor
- dlpsh
-
command-line interface to Palm HotSync protocol. 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 more functions.
- getrom
-
program to fetch ROM using getrom.prc or getrom2.prc
- getrom.prc
-
Palm program to help dump a 512K ROM
- getrom2.prc
-
Palm program to help dump a 1024K ROM (used for PalmOS 2.x)
- ietf2datebook
-
convert IETF calendar to format used by install-datebook
- install-datebook
-
import datebook records from a text format into the Palm
- install-memo
-
import Memo records from a text format into the Palm
- install-todos
-
import ToDo records from a text format into the Palm
- install-user
-
modify User Preference settings and report additional intormation about
the Palm, such as the Network Hotsync ID and Username/UserID
- memos
-
export memos from the Palm in mailbox format into one file, or one of two
formats: one-file-per-record or one-directory-per-category
- pi-csd
-
this must be running to accept Network HotSync(tm) connects
- pi-getram
-
program that retrieves the RAM from Palm
- pi-getrom
-
program that retrieves ROM from Palm (without getrom.prc)
- pi-getromtoken
-
program that retrieves the ROM tokens from the Palm, such as the serial
number of the device, if available
- pi-nredir
-
program that accepts connections and redirects them via the Network
HotSync(tm) protocol
- pi-port
-
experimental program to abstract the serial layer from pilot-link
- pilot-addresses
-
import and export records from the Address Book (AddressDB.pdb) on your
Palm
- pilot-clip
-
experimental program to import and export data from Palm clipboard
- pilot-debug
-
graphical and command-line program to interface with Palm debug monitor
- pilot-dedupe
-
strips duplicate records from Palm databases
- pilot-file
-
dissect .prc and .pdb files to view header, app_info, and record
information
- pilot-mail
-
import mail from POP3 mailbox into Palm's default Mail application, and send
mail via sendmail. This has been replaced by
pilot-mailsync
from Hollis Blanchard <hollis@amulet.co.jp>. Please see the CREDITS
file for additional information on how to obtain this package.
- pilot-schlep
-
stores a single file of any data type (such as .zip or .mp3) on the Palm or
retrieves one from the Palm
- pilot-undelete
-
turn previously archived records into normal records by resetting the Dirty
bit
- pilot-xfer
-
back up, restore, install & delete Palm databases. The Swiss Army Chainsaw
of
pilot-link
- read-expenses
-
export Palm expense database into text format
- read-ical
-
export Palm Datebook and ToDo databases (DatebookDB.pdb and ToDoDB.pdb
respectively) into an Ical calendar (ical is required)
- read-notepad
-
reads record information and images created with the Palm OS4 and later
NotePad application
- read-palmpix
-
reads images created with the Kodak PalmPix "snap-on" camera
- read-todos
-
export Palm ToDo database into generic text format
- reminders
-
export Palm Datebook into a 'remind' data file
- sync-plan
-
completely synchronize the Palm datebook with the Plan calendar via netplan,
including authenticating to the netplan server
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.
- 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 following web site:
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 is:
- The pilot-unix mailing list is for discussion and idea-sharing for those interested in using your Palm PDA with UNIX systems. This includes people who are interested in helping to develop tools to allow the Palm to operate with UNIX, and possibly to develop an SDK for the Palm for Unix.
For more information, including how to subscribe to the list, please visit the following page: http://www.pilot-link.org/mailman/listinfo/pilot-unix-ng pilot-link specific mailing lists are also available for Development, General, and Announce topics, at the following:
SEE ALSO
dlpsh(1), ietf2datebook(1), install-datebook(1), install-hinote(1), install-memo(1), install-netsync(1), install-user(1), pilot-addresses(1), pilot-xfer(1), read-ical(1), read-notepad(1), 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/t1.html
Important: Use the man command (% man) to see how a command is used on your particular computer.
