| | 1 | This library emulates Jungo Windrvr USB and parallel port functions in |
| | 2 | userspace which are required by XILINX impact to access the Platform cable USB |
| | 3 | and Parallel Cable III. |
| | 4 | With this library it is possible to access the cables without loading a |
| | 5 | proprietary kernel module which breaks with every new kernel release. It uses |
| | 6 | the functionality provided by the libusb userspace library for USB access and |
| | 7 | the kernel interface at /dev/parport0 for parallel port access instead and |
| | 8 | should work on every kernel version which is supported by libusb and supports |
| | 9 | ppdev. It was written against impact from ISE Webpack 9.1SP1 and tested with |
| | 10 | the following software: |
| | 11 | |
| | 12 | * ISE Webpack 9.1SP2 |
| | 13 | * ISE Webpack 9.1SP1 |
| | 14 | * ISE Webpack 8.2SP3 |
| | 15 | * ISE Webpack 8.1SP3 |
| | 16 | * ChipScope 9.1.02i |
| | 17 | * EDK 8.2.02i |
| | 18 | |
| | 19 | Build the library by calling `make'. |
| | 20 | |
| | 21 | To use this library you have to preload the library before starting impact: |
| | 22 | |
| | 23 | $ LD_PRELOAD=/path/to/libusb-driver.so impact |
| | 24 | or |
| | 25 | $ export LD_PRELOAD=/path/to/libusb-driver.so (for sh shells) |
| | 26 | $ setenv LD_PRELOAD /path/to/libusb-driver.so (for csh shells) |
| | 27 | $ impact |
| | 28 | |
| | 29 | |
| | 30 | Notes for the USB cable |
| | 31 | ======================= |
| | 32 | |
| | 33 | To use the device as an ordinary user, put the following line in a new |
| | 34 | file in /etc/udev/rules.d/ and restart udev: |
| | 35 | ACTION=="add", BUS=="usb", SYSFS{idVendor}=="03fd", MODE="666" |
| | 36 | |
| | 37 | |
| | 38 | If your cable does not have the ID 03fd:0008 in the output of lsusb, |
| | 39 | the initial firmware has not been loaded (loading it changes the |
| | 40 | product-ID from another value to 8). To load the firmware follow |
| | 41 | these steps: |
| | 42 | |
| | 43 | 1. If you have no /etc/udev/rules.d/xusbdfwu.rules file, copy it from |
| | 44 | /path/to/ISE/bin/lin/xusbdfwu.rules to /etc/udev/rules.d/xusbdfwu.rules |
| | 45 | |
| | 46 | 2. Install the package containing /sbin/fxload from your linux distribution. |
| | 47 | It is usually called "fxload" |
| | 48 | |
| | 49 | 3. copy the file /path/to/ISE/bin/lin/xusbdfwu.hex to /usr/share/xusbdfwu.hex |
| | 50 | |
| | 51 | 4. restart udev and re-plug the cable |
| | 52 | |
| | 53 | |
| | 54 | Notes for the parallel cable |
| | 55 | ============================ |
| | 56 | |
| | 57 | To access the parallel port from userspace, the kernel needs to be built with |
| | 58 | the features "Parallel port support" (CONFIG_PARPORT), "PC-style hardware" |
| | 59 | (CONFIG_PARPORT_PC) and "Support for user-space parallel port device drivers" |
| | 60 | (CONFIG_PPDEV) builtin or as modules. If these features are built as modules, |
| | 61 | they need to be loaded before using this library. |
| | 62 | These modules are called: |
| | 63 | parport |
| | 64 | parport_pc |
| | 65 | ppdev |
| | 66 | |
| | 67 | |
| | 68 | To use the device as an ordinary user, put the user in the group 'lp' |
| | 69 | |
| | 70 | |
| | 71 | Parallel Cable IV is currently only supported in 'compatibility mode', as no |
| | 72 | attempt to configure the ECP registers is done by this library. |
| | 73 | |
| | 74 | |
| | 75 | If you get "Programming failed" or "DONE did not go high" when programming |
| | 76 | through the parallel cable with Impact 9.1, make sure to have the option "Use |
| | 77 | HIGHZ instead of BYPASS" enabled in Edit -> Preferences -> iMPACT Configuration |
| | 78 | Preferences. |
| | 79 | If you are using batch mode, add the following line to your cmd file: |
| | 80 | setPreference -pref UseHighz:TRUE |
| | 81 | (This problem also occurs on windows and when using the real windrvr in linux and |
| | 82 | is solved with the same workaround. Impact 8.2 is working fine with the same |
| | 83 | boards and designs) |
projects / usb-driver / blame_incremental