- ready to publish

This commit is contained in:
redbug 2002-02-10 19:00:33 +00:00
parent b444ed2f08
commit 9c26546a29
1 changed files with 516 additions and 44 deletions

View File

@ -19,7 +19,7 @@
<contrib> Original version</contrib>
</othercredit>
<pubdate>v2.0.0, 6 January 2002</pubdate>
<pubdate>v2.0.1, 27 January 2002</pubdate>
<abstract>
@ -95,7 +95,14 @@ detailed below.
<para>
<revhistory>
<revision><revnumber>2.0</revnumber> <date>2002-01-06</date>
<revision><revnumber>2.0.1</revnumber> <date>2002-01-27</date>
<revremark>
Added info about various software that I hadn't even heard of before I
got feedback from 2.0.0.
</revremark>
</revision>
<revision><revnumber>2.0.0</revnumber> <date>2002-01-06</date>
<revremark>
Major rewrite to include USB connections and recent PalmOS devices
</revremark>
@ -209,6 +216,9 @@ users to the user list for the group (see <literal remap="tt">man
group</literal>). (TODO: More detail).
</para>
</sect2>
<sect2 id="devfs"><title>Devfs device naming</title>
<para>
Recent Linux distributions may use devfs for device naming. In
@ -218,6 +228,33 @@ a new naming scheme brought in with the 2.4 kernel. Simply replace all
references to <literal remap="tt">/dev/ttyS0</literal> with <literal
remap="tt">/dev/tts/0</literal>.
</para>
<para>
If you use symbolic links with devfs, you may find that the links do not persist
correctly after you reboot. The <computeroutput>/etc/devfsd.conf</computeroutput>
file controls the creation of symbolic links to dynamically created devices.
</para>
<para>
As always, the operation seems to be set up differently under different
distributions.
</para>
<itemizedlist>
<listitem>
<para>
Manrake 8.1 creates a link from /dev/usb/tts/1 to /dev/pilot when the hotsync
button is pressed on the cradle.
</para>
</listitem>
<listitem>
<para>
RedHat 7.2 requires the link to be created manually. The link is then persistent
across boots (thanks to Jim Mueller for this information).
</para>
</listitem>
</itemizedlist>
</sect2>
@ -228,7 +265,9 @@ remap="tt">/dev/tts/0</literal>.
USB access to Palm devices is relatively new. The Handspring
Visor seems to be well supported, and works with the pilot-link
suite. Currently, the Palm m500 series only works with coldsync, although
pilot-link support is in active development.
pilot-link support is in active development. <emphasis>Update:</emphasis>
the current development version of pilot-link, 0.10.x, has support for
USB devices. See the pilot-link section for more about this release.
</para>
<para>
@ -258,7 +297,7 @@ modprobe usbserial
<para>
This is used by some distributions, such as
Redhat 7.0. (TODO: Mandrake seems to use both, so what's the difference?)
Redhat 7.0.
</para>
<para>
@ -276,6 +315,14 @@ to communicate with your PDA. Note that this device name only exists
cradle. You must press the button before running the connection software.
</para>
<para>
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.
</para>
</sect2>
<sect2 id="pc-connect-infrared"> <title>IR Connection</title>
@ -376,6 +423,15 @@ information, see the README file that comes with pilot-link.
<sect2 id="pilotlink-using"><title>Using the pilot-link software</title>
<para>
<emphasis>Note:</emphasis> Unless otherwise specified, the details below refer
to the 0.9.x release of
pilot-link. The version in development is 0.10.x. This version contains
support for USB devices, and has been updated to ensure greater consistency
between the various utilities. Once 0.10.x is officially released, this
document will be updated for the new version.
</para>
<para>
Most of the programs in the <Literal
remap="tt">pilot-link</Literal> suite are <emphasis>conduits</emphasis>,
@ -384,7 +440,7 @@ that is they transfer data into or out of your Palm OS device.
<para>
Each time you use of one of the programs, press the HotSync button
Each time you use of one of the programs, press the HotSync button
on your PDA's cradle. This will initiate the PDA
side of the data transfer. Note that not all of these programs prompt
you to press the `HotSync' button, so you may have to remember to do
@ -817,10 +873,145 @@ http://www.gnome.org/projects/gnome-pilot/</ulink>.
</para>
<para>
TODO: The above is based on a glance at the website. I use JPilot,
but when I get time I'll give gnome-pilot a proper try.
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.
</para>
<sect3 id="gnome-pilot-link"><title>The Pilot Link Applet</title>
<para>
The Gnome control panel Pilot Link applet allows you to configure your PDA for
use with Gnome. You must set up your PDA before you can use any of the Gnome
conduits.
</para>
<para>
The first step is to add a device. Start the Gnome control centre, and click on
"Pilot Link" in the left hand pane. The right hand pane should show the pilot
link applet.
</para>
<para>
<itemizedlist>
<listitem>
<para>
Click on the devices tab, then click "Add". You should see the "Device Settings"
dialog box.
</para>
</listitem>
<listitem>
<para>
The "Name" field can contain anything to help you identify the port that you
create.
</para>
</listitem>
<listitem>
<para>
The "Port" field should contain the port to which you attach your PDA. The port
should be the same as you use for pilot-link.
</para>
</listitem>
<listitem>
<para>
The speed and timeout values will depend on your device. Try the defaults, and
change them if you have problems synchronising.
</para>
</listitem>
<listitem>
<para>
The "Type" should be set to your device type.
</para>
</listitem>
</itemizedlist>
</para>
<para>
Once you have configured the device, you can configure the actual PDA:
</para>
<para>
<itemizedlist>
<listitem>
<para>
Click on the "Pilots" tab, then click on "Add...". You should then see the
"Pilot Settings" dialog box.
</para>
</listitem>
<listitem>
<para>
If you already have a user
name set up on the PDA, click "Get from pilot" to download the username and ID.
Otherwise, click "Send to pilot" to set up your username on the PDA.
</para>
</listitem>
<listitem>
<para>
The "Pilot Attributes" allow you to name your PDA and set a local directory to
use for the conduits.
</para>
</listitem>
<listitem>
<para>
The "Sync action" determines what happens when you press the hotsync button on
your PDA. The default is "Use conduit settings". This allows you to customise
set different sync actions for each conduit.
</para>
</listitem>
</itemizedlist>
</para>
<para>
Once you have configured your PDA, you need to configure the conduits.
</para>
</sect3>
<sect3 id="gnome-pilot-conduits"><title>The Pilot Conduits Applet</title>
<para>
Start the Gnome control centre, then click on "Pilot Conduits" in the left hand
pane. If you have a PDA configured in the pilot link applet, you will see a
list of available conduits. If you have more than one PDA, you can use the
drop down list to select the one that you wish to configure.
</para>
<para>
Each available conduit starts out disabled. To enable a conduit, select it in
the list and click on "Enable". You will then be given a choice of methods for
synchronisation.
</para>
</sect3>
</sect2>
<sect2 id="evolution"><title>Evolution</title>
<para>
Evolution is a Microsoft Outlook clone for Gnome from Ximian. Evolution comes
with a conduit for gnome-pilot. The conduit can be configured through the
gnome-pilot conduits control centre applet described above.
</para>
<para>
<emphasis role="strong">Warning:</emphasis> Mandrake 8.1 comes with a beta
version of Evolution. This version seems
to have a bug whereby it does not correctly identify records when synching.
This can lead to records being duplicated on the PDA.
</para>
<para>
The latest version of Evolution can be downloaded from <ulink
url="http://www.ximian.com/">http://www.ximian.com</ulink>. Evolution is
designed mainly for use with Ximian Gnome, and installing it independently
involves resolving a number of dependencies.
</para>
</sect2>
<sect2 id="kpilot"> <title>KPilot</title>
@ -849,7 +1040,7 @@ a spin.
</sect2>
<sect2 id="XNotesPlus"> <title>XNotesPlus</title>
<para>
@ -857,18 +1048,17 @@ a spin.
post small notes on your X-Windows desktop. These notes can be shared
as memos with your PalmOS device.
</para>
<para>
In addition to the notes, XNotesPlus provides PIM features, and integrates
the notes feature with the todo list and addressbook. Note that XNotesPlus
does not perform a true synchronisation, but simply replaces changed
databases.
</para>
<para>
The XNotesPlus web
page at <ulink URL="http://www.graphics-muse.org/xnotes/xnotes.html"
>http://www.graphics-muse.org/xnotes/xnotes.html</ulink > contains full
installation and use instructions. I suggest using the prebuilt binaries
if you can.
</para>
<para>
One caveat is that you need to create an "Xnotes" category on
your PalmOS device, if you intend to export notes.
installation and use instructions.
</para>
<para>
@ -876,20 +1066,80 @@ XNotes is shareware, and not freely distributable.
</para>
</sect2>
<sect2 id="wmsync"><title>WMSync</title>
<para>
If you use WindowMaker, this might be useful. From the website:
</para>
<para>
Wmsync is a WindowMaker dockapp that starts your favourite sync program
for your Palm(TM) PDA. It displays a small animation when syncing.
It is controlled by a small perl script via SIGUSR1 and SIGUSR2 so it
is highly customizable. That´s all.
</para>
<para>
Wmsync is available from <ulink URL="http://home.t-online.de/home/db7ne/wmsync.html">
http://home.t-online.de/home/db7ne/wmsync.html</ulink>
</para>
</sect2>
</sect1>
<sect1 id="othersoftware"><title>Other Software</title>
<sect2 id="pyrite"><title>The Pyrite Project</title>
<para>
TODO:
Pyrite Publisher is a tool to convert documents to and from the Doc format used
by electronic books for the Palm PDA. Compressed zTXT files are also supported.
Pyrite Publisher is written in Python, with an optional module in C for enhanced
data compression performance.
</para>
<para>
So what's happened to the makedoc section? Well,
the links didn't work, so I need to spend some time looking for it and
seeing if it still works.
The library used to communicate with the Palm is available separately, as
python-libpisock. The library is a python binding for the pilot-unix libpisock
library.
</para>
<para>
Pyrite is available from <ulink url="http://www.pyrite.org/">http://www.pyrite.org
</ulink>
</para>
</sect2>
<sect2 id="other-malsync"><title>MalSync</title>
<para>
Malsync is a command line tool for synchronising Palm PDAs with the AvantGo
server. AvantGo is a - well, you'll know what it is if you use it. Unfortunately
the website is a masterpiece of marketspeak.
</para>
<para>
Malsync is available from <ulink URL="http://www.tomw.org/malsync/">
http://www.tomw.org/malsync</ulink>
</para>
</sect2>
<sect2 id="other-palmpix"><title>PalmPix Decoder</title>
<para>
The PalmPix decoder extracts pictures from a PalmPix database. The PalmPix is a
digital camera attachment for Palm PDAs.
</para>
<para>
The PalmPix decoder is available from
<ulink URL="http://www.geocities.com/aa_soft/PalmPix.html">
http://www.geocities.com/aa_soft/PalmPix.html</ulink>
</para>
</sect2>
</sect1>
<APPENDIX id="appendix"><title>Appendix</title>
@ -907,24 +1157,83 @@ Information resources for Linux/Palm applications
<listitem>
<para>
Website <ulink
<emphasis role="strong">Website</emphasis> <ulink
url="http://www.pilot-link.org/">http://www.pilot-link.org</ulink>
</para>
</listitem>
<listitem>
<para>
Mailing list <ulink
url="http://hcirisc.cs.binghamton.edu/mailman/listinfo/pilot-unix">
http://hcirisc.cs.binghamton.edu/mailman/listinfo/pilot-unix</ulink>
<emphasis role="strong">General mailing list</emphasis> <ulink
url="http://www.pilot-link.org/mailman/listinfo/pilot-link-general/">
http://www.pilot-link.org/mailman/listinfo/pilot-link-general/</ulink>
.General discussions about pilot-link, conduit ideas, wish list items and
anything else.
</para>
</listitem>
<listitem>
<para>
Mailing list archive: <ulink
url="http://hcirisc.cs.binghamton.edu/pipermail/pilot-unix/">
http://hcirisc.cs.binghamton.edu/pipermail/pilot-unix</ulink>
<emphasis role="strong">General mailing list archive</emphasis> <ulink
url="http://www.pilot-link.org/pipermail/pilot-link-general/">
http://www.pilot-link.org/pipermail/pilot-link-general/</ulink>
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Announcement mailing list</emphasis> <ulink
url="http://www.pilot-link.org/mailman/listinfo/pilot-link-announce/">
http://www.pilot-link.org/mailman/listinfo/pilot-link-announce/</ulink>
. Announcements for pilot-link releases, conduits, third-party tools and
applications.
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Announcement mailing list archive</emphasis> <ulink
url="http://www.pilot-link.org/pipermail/pilot-link-announce/">
http://www.pilot-link.org/pipermail/pilot-link-announce/</ulink>
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Development mailing list</emphasis> <ulink
url="http://www.pilot-link.org/mailman/listinfo/pilot-link-devel/">
http://www.pilot-link.org/mailman/listinfo/pilot-link-devel/</ulink>
. Development list for pilot-link code, releases, patches, conduits, bugs,
testing.
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Development mailing list archive</emphasis> <ulink
url="http://www.pilot-link.org/pipermail/pilot-link-devel/">
http://www.pilot-link.org/pipermail/pilot-link-devel/</ulink>
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">"Next Generation" pilot-unix mailing list
</emphasis> <ulink
url="http://www.pilot-link.org/mailman/listinfo/pilot-unix-ng/">
http://www.pilot-link.org/mailman/listinfo/pilot-unix-ng/</ulink>
. Development list for pilot-link code, releases, patches, conduits, bugs,
testing.
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">"Next Generation" pilot-unix mailing list archive
</emphasis> <ulink
url="http://www.pilot-link.org/pipermail/pilot-unix-ng/">
http://www.pilot-link.org/pipermail/pilot-unix-ng/</ulink>
. Replaces the old pilot-unix list that is now offline.
</para>
</listitem>
@ -940,7 +1249,7 @@ http://hcirisc.cs.binghamton.edu/pipermail/pilot-unix</ulink>
<listitem>
<para>
Website: <ulink
<emphasis role="strong">Website:</emphasis> <ulink
url="http://www.ooblick.com/software/coldsync/">
http://www.ooblick.com/software/coldsync</ulink>
</para>
@ -948,7 +1257,7 @@ http://www.ooblick.com/software/coldsync</ulink>
<listitem>
<para>
Mailing list: send an email to <ulink
<emphasis role="strong">Mailing list:</emphasis> send an email to <ulink
url="mailto:coldsync-hackers-request@lusars.net?body=subscribe">
coldsync-hackers-request@lusars.net</ulink>
with the word subscribe in the body.
@ -957,7 +1266,7 @@ with the word subscribe in the body.
<listitem>
<para>
Mailing list archive: <ulink
<emphasis role="strong">Mailing list archive:</emphasis> <ulink
url="http://www.thedotin.net/maillists/coldsync-hackers/">
http://www.thedotin.net/maillists/coldsync-hackers</ulink>
</para>
@ -973,14 +1282,14 @@ http://www.thedotin.net/maillists/coldsync-hackers</ulink>
<itemizedlist>
<listitem> <para>
Website: <ulink
<emphasis role="strong">Website:</emphasis> <ulink
url="http://www.jpilot.org/">http://www.jpilot.org</ulink>
</para>
</listitem>
<listitem>
<para>
Mailing list: send an email to <ulink
<emphasis role="strong">Mailing list: </emphasis>send an email to <ulink
url="mailto:listar@moongroup.com?subject=subscribe">listar@moongroup.com</ulink>
with the word subscribe in the subject.
</para>
@ -988,7 +1297,7 @@ with the word subscribe in the subject.
<listitem>
<para>
Mailing list archive: <ulink
<emphasis role="strong">Mailing list archive: </emphasis><ulink
url="http://www.moongroup.com/archives/jpilot/">
http://www.moongroup.com/archives/jpilot</ulink>
</para>
@ -1006,7 +1315,7 @@ http://www.moongroup.com/archives/jpilot</ulink>
<listitem>
<para>
Website: <ulink
<emphasis role="strong">Website: </emphasis><ulink
url="http://www.gnome.org/projects/gnome-pilot/">
http://www.gnome.org/projects/gnome-pilot</ulink>
</para>
@ -1014,12 +1323,14 @@ http://www.gnome.org/projects/gnome-pilot</ulink>
<listitem>
<para>
Mailing list <ulink
<emphasis role="strong">Mailing list: </emphasis><ulink
url="http://mail.gnome.org/mailman/listinfo/gnome-pilot-list">http://mail.gnome.org/mailman/listinfo/gnome-pilot-list</ulink>
</para>
</listitem> <listitem> <para>
Mailing list archive: <ulink
</listitem>
<listitem>
<para>
<emphasis role="strong">Mailing list archive: </emphasis><ulink
url="http://mail.gnome.org/archives/gnome-pilot-list/">http://mail.gnome.org/archives/gnome-pilot-list/</ulink>
</para>
</listitem>
@ -1034,7 +1345,7 @@ url="http://mail.gnome.org/archives/gnome-pilot-list/">http://mail.gnome.org/arc
<itemizedlist>
<listitem>
<para>
Website: <ulink
<emphasis role="strong">Website: </emphasis><ulink
url="http://www.slac.com/pilone/kpilot_home/">
http://www.slac.com/pilone/kpilot_home</ulink>
</para>
@ -1042,7 +1353,7 @@ http://www.slac.com/pilone/kpilot_home</ulink>
<listitem>
<para>
Mailing list:
<emphasis role="strong">Mailing list: </emphasis>
There is no specific KPilot list, but you can use
the kde-pim list. To subscribe, send an email to <ulink
url="mailto:kde-pim-request@kde.org">kde-pim-request@kde.org</ulink>
@ -1052,7 +1363,7 @@ with subscribe followed by your email address in the subject.
<listitem>
<para>
Mailing list archive: <ulink
<emphasis role="strong">Mailing list archive: </emphasis><ulink
url="http://lists.kde.org/?l=kde-pim&amp;r=1&amp;w=2">
http://lists.kde.org/?l=kde-pim&amp;r=1&amp;w=2</ulink>
</para>
@ -1068,13 +1379,51 @@ http://lists.kde.org/?l=kde-pim&amp;r=1&amp;w=2</ulink>
<itemizedlist>
<listitem>
<para>
XNotesPlus website:
<emphasis role="strong">XNotesPlus website:</emphasis>
<ulink url="http://www.graphics-muse.org/xnotes/xnotes.html">
http://www.graphics-muse.org/xnotes/xnotes.html
</ulink>
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">WMSync website:</emphasis>
<ulink url="http://home.t-online.de/home/db7ne/wmsync.html">
http://home.t-online.de/home/db7ne/wmsync.html
</ulink>
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">The Pyrite Project website:</emphasis>
<ulink url="http://www.pyrite.org/">
http://www.pyrite.org/
</ulink>
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Malsync website:</emphasis>
<ulink url="http://www.tomw.org/malsync/">
http://www.tomw.org/malsync/
</ulink>
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">PalmPix decoder website:</emphasis>
<ulink url="http://www.geocities.com/aa_soft/PalmPix.html">
http://www.geocities.com/aa_soft/PalmPix.html
</ulink>
</para>
</listitem>
</itemizedlist>
</para>
@ -1083,13 +1432,136 @@ http://www.graphics-muse.org/xnotes/xnotes.html
</sect1>
<sect1 id="devices"><title>Devices that use the Palm OS</title>
<sect1 id="history"> <title>A History of Palm OS devices.</title <para>
<para>
This is an overview of the range of devices that work with the software
detailed in this HOWTO.
</para>
TODO: This section is included unchanged from the original document. It's
<sect2 id="devices-palm"><title>Palm</title>
<para>
<itemizedlist>
<listitem>
<para>
<emphasis role="strong">Pilot 1000, 5000, PalmPilot Personal, PalmPilot Pro.
</emphasis> The original Palm PDAs, no longer in production. These should
work over a serial port connection.
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Palm IIIe, IIIx, IIIxe, IIIc.
</emphasis> The III series, again no longer in production. These should
work over a serial port connection. The first colour Palm, the IIIc, had an
optional USB connection, but the serial interface is required for Linux.
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Palm V, Vx.
</emphasis> The V series, again no longer in production. These introduced the
IR interface, and it should be possible to synch them via an IR port on a
suitably equipped PC. They also work over the serial port connection.
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Palm VII, VIIx.
</emphasis> The VII series, again no longer in production. These introduced the
built in wireless connection. They feature an optional USB connection, but the
serial interface is required for Linux.
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Palm VII, VIIx.
</emphasis> The VII series, again no longer in production. These introduced the
built in wireless connection. They feature an optional USB connection, but the
serial interface is required for Linux.
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Palm m100, m105.
</emphasis> The current entry level Palm PDAs. These should
work over a serial port connection.
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Palm m500, m505.
</emphasis> The latest version of the IR connection enabled Palm. They come with
USB cradles as standard, and should synch over USB. An optional serial cable is
available if USB synchronisation is not possible,
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">Palm i705.
</emphasis> The latest Palm with wireless network connection capability. It
synchronises via USB. No reports yet on whether it works with Linux over USB.
</para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="devices-handspring"><title>Handspring</title>
<para>
<itemizedlist>
<listitem>
<para>
<emphasis role="strong">Visor.
</emphasis> The Handspring Visor series of PDAs come with USB cradles. Serial
cables are also available. USB is better supported under Linux for the Visor
than for Palm PDAs, so USB should work with few problems.
</para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="devices-sony"><title>Sony</title>
<para>
<itemizedlist>
<listitem>
<para>
<emphasis role="strong">Clie.
</emphasis> Sony's higher resolution version of the Palm PDA.
</para>
</listitem>
</itemizedlist>
</para>
</sect2>
</sect1>
<sect1 id="history"><title>A History of Palm OS devices.</title>
<para>
This section is included unchanged from the original document. It's
clearly out of date, and I'm not sure if it's worth keeping in. It's a
bit offtopic for a Linux howto, and the effort of keeping it current
seems a bit pointless.
seems a bit pointless. Instead I've added a section detailing devices
that use the Palm operating system, and which therefore should work with
the instructions in this HOWTO.
</para>
<para>