sean@redbug.uklinux.net
David H. Silber palm@orbits.com - Original version
v2.0.1, 03 March 2002
The latest "work in progress" version of this document can be found at http://www.redbug.uklinux.net/palm/index.html.
This document was originally called the Palm Howto. Major changes are detailed below.
Revision History | ||
---|---|---|
Revision 2.0.1 | 2002-03-03 | |
Added info about various software that I hadn't even heard of before I got feedback from 2.0.0. | ||
Revision 2.0.0 | 2002-01-06 | |
Major rewrite to include USB connections and recent PalmOS devices | ||
Revision 1.1.1 | 1999-02-28 | |
Last version maintained by David Silber. |
This document is copyright � 2001 Sean Buckley and copyright � 1997, 1998 & 1999 David H. Silber.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. The full text of the license can be found at http://www.gnu.org/copyleft/fdl.html
To create the link, log on as root and enter the following command:
ln -s /dev/ttyS0 /dev/pilot |
chmod a+rw /dev/ttyS0 |
As always, the operation seems to be set up differently under different distributions.
modprobe visor |
modprobe usbserial |
This is used by some distributions, such as Redhat 7.0.
If you need to set up USB support in your kernel, the Handspring Visor with Linux mini-HOWTO provides instructions. (TODO: Incorporate into this HOWTO?)
Once USB support is set up, you should use device /dev/ttyUSB1 to communicate with your PDA. Note that this device name only exists after you have pressed the hotsync button on the cradle. You must press the button before running the connection software.
If you have problems synchronising via USB, try an updated kernel. There may be some timing issues with the USB driver. For example, I found that stock Mandrake 8.1 did not work on one PC, but worked first time on a faster PC. Upgrading to a stock 2.4.17 kernel solved the problem and worked fine on both PCs.
David A. Desrosiers has written a comprehensive HOWTO on the subject. (TODO: Include this inline?)
Once again David A. Desrosiers has written a (less comprehensive) HOWTO on the subject. (TODO: Include this inline? Not convinced of the value of this method - anyone care to comment?)
If you use a distribution that does not come with pilot-link, or you need a more recent version, you can find the latest release at www.pilot-link.org. As well as the current version, you will find a link to the latest CVS snapshot.
Once you have the downloaded the source, unpack and compile it as follows:
tar -zxvf pilot-link.0.9.5.tar.gz cd pilot-link.0.9.5 ./configure make make install |
The programs can be run directly from the directory in which they were compiled. You may wish to test them before running make install. For more information, see the README file that comes with pilot-link.
The pilot-link programs all use the same method of determining the location of your PDA:
pilot-xfer /dev/pilot -i program.prc |
To backup your Palm OS device:
pilot-xfer /dev/pilot -b backup-directory |
To restore data to Palm OS device:
pilot-xfer /dev/pilot -r backup-directory |
To list the programs on your Palm OS device:
pilot-xfer /dev/pilot -l |
To install a memo into your (already existing) project category:
install-memo /dev/pilot -c project project.memo |
This program grabs each memo from the Palm OS device and prints it out in standard mailbox format.
memos /dev/pilot |
Transfer the address database to or from your PDA.
To write your address data to a Linux file from your PDA:
pilot-addresses /dev/pilot -w storage.file |
To read your address data from a Linux file onto your PDA:
pilot-addresses /dev/pilot -r file |
You can find the latest release of coldsync at www.ooblick.com/software/coldsync. As well as the current version, you will find a link to the latest CVS snapshot.
Once you have the downloaded the source, compile it as follows:
tar -xvzf colsync-2.2.5.tar.gz cd coldsync-2.2.5 ./configure make make install |
You can run coldsync directly from the src directory. For more information, see the README file that comes with coldsync.
The following is an example of a .coldsyncrc file:
listen serial { device: "/dev/palm"; protocol: default; transient; } pda "My Palm" { snum: "L0PK17C13832-M"; username: "Sean"; userid: 1234; directory: "/home/sean/m505"; default; } |
tar -zxvf p5-Palm-1.2.4.tar.gz cd p5-Palm-1.2.4 perl Makefile.PL make make install |
The list of conduits is available at http://www.ooblick.com/software/coldsync/conduits/.
The conduits require an entry in your .coldsyncrc configuration file. To find out what should be entered, run /path/conduit -config, where path is the location of the conduit.
JPilot is available with most Linux distributions. You can also download JPilot from http://www.jpilot.org. To use JPilot you must have pilot-link installed. As JPilot is a gtk+ application, you will also need gtk+.
Gnome-pilot should be available as part of Gnome. The home page for the project is at http://www.gnome.org/projects/gnome-pilot/.
Gnome-pilot configuration is done through the Gnome control centre. If you have gnome-pilot installed, you should have a "Pilot Link" section under the peripherals section of the control centre.
Click on the devices tab, then click "Add". You should see the "Device Settings" dialog box.
The "Name" field can contain anything to help you identify the port that you create.
Once you have configured the device, you can configure the actual PDA:
The "Pilot Attributes" allow you to name your PDA and set a local directory to use for the conduits.
Once you have configured your PDA, you need to configure the conduits.
The latest version of Evolution can be downloaded from http://www.ximian.com. Evolution is designed mainly for use with Ximian Gnome, and installing it independently involves resolving a number of dependencies.
As with gnome-pilot, kpilot uses a pilot-link via a daemon process.
KPilot is available from http://www.slac.com/pilone/kpilot_home
TODO: Again, I don't really use KDE, but will give it a spin.
The XNotesPlus web page at http://www.graphics-muse.org/xnotes/xnotes.html contains full installation and use instructions.
XNotes is shareware, and not freely distributable.
Information resources for Linux/Palm applications
General mailing list http://www.pilot-link.org/mailman/listinfo/pilot-link-general/ .General discussions about pilot-link, conduit ideas, wish list items and anything else.
General mailing list archive http://www.pilot-link.org/pipermail/pilot-link-general/
Announcement mailing list http://www.pilot-link.org/mailman/listinfo/pilot-link-announce/ . Announcements for pilot-link releases, conduits, third-party tools and applications.
Announcement mailing list archive http://www.pilot-link.org/pipermail/pilot-link-announce/
Development mailing list http://www.pilot-link.org/mailman/listinfo/pilot-link-devel/ . Development list for pilot-link code, releases, patches, conduits, bugs, testing.
Development mailing list archive http://www.pilot-link.org/pipermail/pilot-link-devel/
"Next Generation" pilot-unix mailing list http://www.pilot-link.org/mailman/listinfo/pilot-unix-ng/ . Development list for pilot-link code, releases, patches, conduits, bugs, testing.
"Next Generation" pilot-unix mailing list archive http://www.pilot-link.org/pipermail/pilot-unix-ng/ . Replaces the old pilot-unix list that is now offline.
Mailing list: send an email to coldsync-hackers-request@lusars.net with the word subscribe in the body.
Mailing list archive: http://www.thedotin.net/maillists/coldsync-hackers
Mailing list: send an email to listar@moongroup.com with the word subscribe in the subject.
Mailing list archive: http://www.moongroup.com/archives/jpilot
Mailing list: http://mail.gnome.org/mailman/listinfo/gnome-pilot-list
Mailing list archive: http://mail.gnome.org/archives/gnome-pilot-list/
Mailing list: There is no specific KPilot list, but you can use the kde-pim list. To subscribe, send an email to kde-pim-request@kde.org with subscribe followed by your email address in the subject.
Mailing list archive: http://lists.kde.org/?l=kde-pim&r=1&w=2
XNotesPlus website: http://www.graphics-muse.org/xnotes/xnotes.html
WMSync website: http://home.t-online.de/home/db7ne/wmsync.html
The Pyrite Project website: http://www.pyrite.org/
Malsync website: http://www.tomw.org/malsync/
PalmPix decoder website: http://www.geocities.com/aa_soft/PalmPix.html
This is an overview of the range of devices that work with the software detailed in this HOWTO.