From 60cacea6b325c9982b57521b7ef06a6180d71dcb Mon Sep 17 00:00:00 2001
From: alexlan <alexlan@fedoraproject.org>
Date: Fri, 4 Jan 2008 09:21:48 +0000
Subject: [PATCH] - Add README.fedora and visor configs as fallbacks (#280251:
 thanks Kevin     Page)

---
 60-pilot.perms  |  2 ++
 60-pilot.rules  |  1 +
 README.fedora   | 50 +++++++++++++++++++++++++++++++++++++++++++++++++
 pilot-link.spec | 14 ++++++++++++--
 4 files changed, 65 insertions(+), 2 deletions(-)
 create mode 100644 60-pilot.perms
 create mode 100644 60-pilot.rules
 create mode 100644 README.fedora

diff --git a/60-pilot.perms b/60-pilot.perms
new file mode 100644
index 0000000..30cbd6b
--- /dev/null
+++ b/60-pilot.perms
@@ -0,0 +1,2 @@
+<ttyUSB>=/dev/ttyUSB*
+<console>  0660 <ttyUSB> 0660 root.uucp
diff --git a/60-pilot.rules b/60-pilot.rules
new file mode 100644
index 0000000..291d0ce
--- /dev/null
+++ b/60-pilot.rules
@@ -0,0 +1 @@
+BUS=="usb", SYSFS{product}=="Palm Handheld*|Handspring*",KERNEL=="ttyUSB[13579]", SYMLINK="pilot", GROUP="uucp", MODE="0660"
diff --git a/README.fedora b/README.fedora
new file mode 100644
index 0000000..a01bdad
--- /dev/null
+++ b/README.fedora
@@ -0,0 +1,50 @@
+
+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/doc/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, 20071211
+
diff --git a/pilot-link.spec b/pilot-link.spec
index 5db87b1..4636ebd 100644
--- a/pilot-link.spec
+++ b/pilot-link.spec
@@ -3,7 +3,7 @@
 
 Name: pilot-link
 Version: 0.12.2
-Release: 11%{?dist}
+Release: 12%{?dist}
 Epoch: 2
 License: GPLv2 and GPLv2+ and LGPLv2+ and TCL
 Group: Applications/Communications
@@ -14,6 +14,9 @@ Source0: pilot-link-%{version}.tar.bz2
 Source1: 19-pam-acl-management.fdi
 Source2: pilot-device-file.policy
 Source3: blacklist-visor
+Source4: README.fedora
+Source5: 60-pilot.perms
+Source6: 60-pilot.rules
 
 ExcludeArch: s390 s390x
 #Patch1: pilot-link-0.11.0-perlmd5.patch  # May be still applied
@@ -147,6 +150,10 @@ install -p -m644 %{SOURCE2} %{buildroot}%{_datadir}/PolicyKit/policy/pilot-devic
 mkdir -p %{buildroot}%{_sysconfdir}/modprobe.d/
 install -p -m644 %{SOURCE3} %{buildroot}%{_sysconfdir}/modprobe.d/blacklist-visor
 
+# install visor configs to share/udev
+install -p -m644 %{SOURCE4} %{buildroot}%{_datadir}/pilot-link/udev
+install -p -m644 %{SOURCE5} %{buildroot}%{_datadir}/pilot-link/udev
+
 %post -p /sbin/ldconfig
 
 %postun -p /sbin/ldconfig
@@ -156,7 +163,7 @@ rm -rf %{buildroot}
 
 %files
 %defattr(-,root,root,-)
-%doc COPYING ChangeLog README NEWS doc/README.usb doc/README.debugging doc/README.libusb
+%doc COPYING ChangeLog README NEWS doc/README.usb doc/README.debugging doc/README.libusb README.fedora
 %{_libdir}/*.so.*
 %if %{support_perl}
 %{perl_vendorarch}/auto/*
@@ -178,6 +185,9 @@ rm -rf %{buildroot}
 %{_datadir}/aclocal/*.m4
 
 %changelog
+* Fri Jan  4 2008 Alex Lancaster <alexlan[AT]fedoraproject org> - 2:0.12.2-12
+- Add README.fedora and visor configs as fallbacks (#280251: thanks Kevin Page)
+
 * Tue Dec 11 2007 Ivana Varekova <varekova@redhat.com> - 2:0.12.2-11
 - fix md5 header file (#403641)