pilot-link/README.fedora

Additional information for Fedora pilot-link users
==================================================

pilot-link-0.12.2-10.fc8 and later versions are configured to enable 
the use of libusb for console users - permissions are now handled by
PolicyKit. For more information on libusb see README.libusb.

pilot-link libusb support is relatively new and may still be 
incompatible with some handheld devices. If you experience such a
problem you may want to try the older "visor module" USB method 
described below. If possible please report device incompatibility to:
https://bugzilla.redhat.com/show_bug.cgi?id=280251


Visor module setup
------------------

The Visor module is a backwards compatibility solution to expose the USB
connection of newer Palm handhelds as a serial device, which is what
older versions of pilot-link and dependent packages require to work.

Unfortunately this solution is inherently imperfect when used with udev
(as Fedora does) - you may have to tweak your individual setup.

1) disable libusb: remove (or comment out the contents) of
/etc/modprobe.d/blacklist-visor

2) Configure udev to detect the Palm and create /dev/pilot: copy
60-pilot.rules from /usr/share/pilot-link/udev/ to /etc/udev/rules.d/

3) Configure permissions so that a console user can access /dev/pilot:
copy 60-pilot.perms from /usr/share/pilot-link/udev/ to
/etc/security/console.perms.d/

For a discussion of the inherent problems related to the Visor module,
see:
https://bugzilla.redhat.com/show_bug.cgi?id=158809


Old serial (non-USB) handhelds
------------------------------

Older serial (non-USB) handhelds can be directly addressed by pilot link
on their serial port (e.g. /dev/ttyS0) or /dev/pilot can be symlinked to
the serial port.

Kevin R. Page, 2007-12-11