|
|
|
|
KPILOT 4.0.0 by Dan Pilone
|
|
|
|
|
===========================
|
|
|
|
|
Additional work by Robert Ambrose,
|
|
|
|
|
Preston Brown, Adriaan de Groot,
|
|
|
|
|
and probably many more.
|
|
|
|
|
|
|
|
|
|
KPilot is software for syncing the 3Com Palm Pilot and IBM Workpad
|
|
|
|
|
(UNTESTED!) with a machine running some flavor of unix. The actual PC->PP
|
|
|
|
|
communcations was originally based on pilot-link.0.8.7. By default it
|
|
|
|
|
attempts to connnect using /dev/pilot which should be a link to the actual
|
|
|
|
|
serial port, however this is configurable in the settings dialog.
|
|
|
|
|
|
|
|
|
|
Additional release notes can be found in the user documentation.
|
|
|
|
|
The user documentation (translations in: en and de) can be found
|
|
|
|
|
under kpilot/doc in this directory or in the KDE documentation directory
|
|
|
|
|
under kpilot. Or run kpilot --htmlhelp to start the KDE help browser.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Current features include:
|
|
|
|
|
* Now a KDE2 application.
|
|
|
|
|
o Plug in conduit support, currently including
|
|
|
|
|
KOrganizer, todolist, null and PopMail
|
|
|
|
|
o Hot-Sync daemon. - Now hot-sync with just the push of the
|
|
|
|
|
Hot-Sync button on your cradle. No need to launch KPilot.
|
|
|
|
|
o Add/Delete/Edit memos.
|
|
|
|
|
o Add/Delete/Edit addresses.
|
|
|
|
|
o Full Category support for both memos and addresses.
|
|
|
|
|
o KPilot now respects secret data.
|
|
|
|
|
o More configuration options including port speed and
|
|
|
|
|
docking control.
|
|
|
|
|
o Now supports signature files for email.
|
|
|
|
|
o Drag and drop to docked icon for file install.
|
|
|
|
|
o International Support
|
|
|
|
|
o Full Backup/Restore capabilities of Palm Pilot
|
|
|
|
|
o File (prc,pdb) installation
|
|
|
|
|
o Email syncing capabilities (via POP3 & sendmail)
|
|
|
|
|
o SmartSync backing up modified data even
|
|
|
|
|
for databases KPilot doesn't recognize
|
|
|
|
|
o Import/Export to/from virtually any text format for
|
|
|
|
|
Addresses.
|
|
|
|
|
o Import/Export to/from text files for memos
|
|
|
|
|
o Sort and display addresses in different ways
|
|
|
|
|
o A null conduit (programming example)
|
|
|
|
|
o Syncing with UNIX mailboxes
|
|
|
|
|
o Database dispositions (sync, backup only, or ignore)
|
|
|
|
|
|
|
|
|
|
(* = new in this release)
|
|
|
|
|
|
|
|
|
|
INSTALLATION
|
|
|
|
|
============
|
|
|
|
|
KPilot 4.0.0 _REQUIRES_ KDE 2 (http://www.kde.org/) and
|
|
|
|
|
v2.2.0 or better of the QT widget set (http://www.troll.no/).
|
|
|
|
|
KPilot also _REQUIRES_ pilot-link, which is not distributed with
|
|
|
|
|
all the linux distro's out there. You may have to go looking.
|
|
|
|
|
|
|
|
|
|
If you have these packages, a simple (see *NOTE*):
|
|
|
|
|
|
|
|
|
|
./configure
|
|
|
|
|
make
|
|
|
|
|
make install
|
|
|
|
|
|
|
|
|
|
from the kpilot-4.0.0 directory should configure and install KPilot.
|
|
|
|
|
If you are using KPanel (the panel that comes with KDE) restarting it
|
|
|
|
|
should insert an icon into the Utilities submenu. If you are not using
|
|
|
|
|
KPanel, the executable is named kpilot and will be installed in either
|
|
|
|
|
/opt/kde/bin/ or /usr/local/kde/bin (whichever is appropriate for your
|
|
|
|
|
system).
|
|
|
|
|
|
|
|
|
|
In some cases KPilot will not compile due to configuration
|
|
|
|
|
differences; in this case a less simple
|
|
|
|
|
|
|
|
|
|
autoconf
|
|
|
|
|
automake
|
|
|
|
|
./configure
|
|
|
|
|
make
|
|
|
|
|
make install
|
|
|
|
|
|
|
|
|
|
should do the trick. If this fails as well, you can subscribe to the
|
|
|
|
|
KPilot mailing list and state the nature of the failure there.
|
|
|
|
|
|
|
|
|
|
*NOTE* that KPilot makes assumptions about where pilot-link and
|
|
|
|
|
the Qt libraries are; in particular it is important to set TQTDIR correctly
|
|
|
|
|
(to the Qt 1.44 directories) when compiling KPilot. On many systems the
|
|
|
|
|
command to do this will be
|
|
|
|
|
|
|
|
|
|
export TQTDIR=/usr/lib/qt-2*
|
|
|
|
|
|
|
|
|
|
but your mileage may vary. RedHat 6.2 systems ship with Qt 1.45 and Qt 2.1,
|
|
|
|
|
in which case it is doubly important to set TQTDIR properly.
|
|
|
|
|
|
|
|
|
|
USING THE SOFTWARE
|
|
|
|
|
==================
|
|
|
|
|
The user's documentation in the kpilot/doc directory is the
|
|
|
|
|
best source for information on using KPilot.
|
|
|
|
|
When KPilot is run for the first time it will display the settings
|
|
|
|
|
dialog. The default device is /dev/pilot (which should be a link to the
|
|
|
|
|
proper device for the pilot) though this is configurable. Please verify
|
|
|
|
|
this is correct.
|
|
|
|
|
IMPORTANT NOTE: the KPilot installation DOES NOT setup the serial
|
|
|
|
|
link; your OS installation may also require special handling. See the
|
|
|
|
|
section "Troubleshooting," below.
|
|
|
|
|
Other settings can be configured at this time but are
|
|
|
|
|
not mandatory (though HIGHLY recommended). The one setting that you might
|
|
|
|
|
want to take notice of is "Local overrides pilot". Setting this to true
|
|
|
|
|
means that if both the local record and the pilot record are modified,
|
|
|
|
|
during the next hot sync the local record will be considered the valid one
|
|
|
|
|
and both will be set to that. By default the Pilot is considered to be the
|
|
|
|
|
valid record and if both the local record and the pilot record have been
|
|
|
|
|
modified the local is overwritten by the pilot copy.
|
|
|
|
|
Hitting "OK" will continue to the main KPilot screen.
|
|
|
|
|
It is recommended you preform a full backup of your Pilot at this
|
|
|
|
|
point so that all of the data visible in KPilot is accurate and any
|
|
|
|
|
importing or exporting is properly merged the next time you hot-sync.
|
|
|
|
|
You can do a full backup of your Pilot by selecting Backup from the File
|
|
|
|
|
Menu.
|
|
|
|
|
|
|
|
|
|
TROUBLESHOOTING
|
|
|
|
|
===============
|
|
|
|
|
The default serial device (/dev/pilot) does not exist on
|
|
|
|
|
most systems. Be SURE to either (a) use the actual serial port the Pilot
|
|
|
|
|
is attached to (i.e. /dev/ttyS0 for the device DOS calls COM1:) OR (b) set
|
|
|
|
|
up the link to the actual serial port by running (as root) "ln -s
|
|
|
|
|
/dev/ttySx /dev/pilot", where x is the number of the serial port. Note
|
|
|
|
|
that some older Linux setups use /dev/cuax instead of /dev/ttySx.
|
|
|
|
|
If you're running Mandrake 7 and having trouble getting the
|
|
|
|
|
daemon to start or KPilot can't connect to the daemon, check the system
|
|
|
|
|
security setting. Sometimes local processes can't connect to *any*
|
|
|
|
|
local ports.
|
|
|
|
|
More information is available in the user documentation.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
STANDARD DISCLAIMER, WARNINGS, ETC..
|
|
|
|
|
====================================
|
|
|
|
|
THIS SOFTWARE HAS BUGS. Use at your own risk. It has not even
|
|
|
|
|
been tested anywhere but on my machine and only with my Palm Pilot. I
|
|
|
|
|
have been using it against XCopilot for development then verifying it
|
|
|
|
|
works with a real pilot with my Palm Pilot Professional running OS v2.0.4.
|
|
|
|
|
I make no claims that it will work, or even try to work. I take no
|
|
|
|
|
responsibility for any data loss, damage, etc. done by this software.
|
|
|
|
|
ie: Should your pilot burst into flames while trying to sync a new game..
|
|
|
|
|
sorry.
|
|
|
|
|
That being said, I _really_ want comments regarding the software
|
|
|
|
|
as well as suggestions. Bug fixes are even snazzier and code
|
|
|
|
|
contributions are welcome. :)
|
|
|
|
|
|
|
|
|
|
Dan Pilone
|
|
|
|
|
pilone@slac.com
|
|
|
|
|
http://www.slac.com/pilone/kpilot_home/
|
|
|
|
|
July 20, 2000
|
|
|
|
|
|
|
|
|
|
Adriaan de Groot
|
|
|
|
|
adridg@cs.kun.nl
|
|
|
|
|
http://www.cs.kun.nl/~adridg/kpilot-bugs.html
|
|
|
|
|
July 20, 2000
|
