Add hack to force the detection of a parallel cable by Stefan Ziegenbalg.

[usb-driver] / README

diff --git a/README b/README
index ae60eebdc5e973a112a752da71c46ad5feaf3d5a..fcf211a6450369653ae4ee429d1f8538c18c096e 100644 (file)
--- a/README
+++ b/README
@@ -3,16 +3,19 @@ userspace which are required by XILINX impact to access the Platform cable USB
 and Parallel Cable III.
 With this library it is possible to access the cables without loading a
 proprietary kernel module which breaks with every new kernel release. It uses
-the functions provided by the libusb userspace library for USB access and
+the functionality provided by the libusb userspace library for USB access and
 the kernel interface at /dev/parport0 for parallel port access instead and
 should work on every kernel version which is supported by libusb and supports
 ppdev. It was written against impact from ISE Webpack 9.1SP1 and tested with
 the following software:
 
+ * ISE Webpack 9.1SP3
  * ISE Webpack 9.1SP2
  * ISE Webpack 9.1SP1
+ * ISE Webpack 8.2SP3
  * ISE Webpack 8.1SP3
  * ChipScope 9.1.02i
+ * EDK 8.2.02i
 
 Build the library by calling `make'.
 
@@ -24,6 +27,9 @@ $ export LD_PRELOAD=/path/to/libusb-driver.so  (for sh shells)
 $ setenv LD_PRELOAD /path/to/libusb-driver.so  (for csh shells)
 $ impact
 
+The source for this library can be found at:
+http://cvs.zerfleddert.de/cgi-bin/viewcvs.cgi/usb-driver/
+
 
 Notes for the USB cable
 =======================
@@ -64,3 +70,23 @@ ppdev
 
 
 To use the device as an ordinary user, put the user in the group 'lp'
+
+
+If you have an almost compatible cable which works with other software but not
+with Impact, try preloading libusb-driver-trenz.so instead of libusb-driver.so.
+It includes a hack by Stefan Ziegenbalg to force detection of a parallel cable.
+
+
+Parallel Cable IV is currently only supported in 'compatibility mode', as no
+attempt to configure the ECP registers is done by this library.
+
+
+If you get "Programming failed" or "DONE did not go high" when programming
+through the parallel cable with Impact 9.1, make sure to have the option "Use
+HIGHZ instead of BYPASS" enabled in Edit -> Preferences -> iMPACT Configuration
+Preferences.
+If you are using batch mode, add the following line to your cmd file:
+setPreference -pref UseHighz:TRUE
+(This problem also occurs on windows and when using the real windrvr in linux and
+is solved with the same workaround. Impact 8.2 is working fine with the same
+boards and designs)