54357994 |
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 |
6f766a61 |
6 | the functionality provided by the libusb userspace library for USB access and |
54357994 |
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: |
0b50c513 |
11 | |
7824bbf6 |
12 | * ISE Webpack 9.1SP3 |
0b50c513 |
13 | * ISE Webpack 9.1SP2 |
14 | * ISE Webpack 9.1SP1 |
54fc4508 |
15 | * ISE Webpack 8.2SP3 |
0b50c513 |
16 | * ISE Webpack 8.1SP3 |
3b1b5fa8 |
17 | * ChipScope 9.1.03i |
0b50c513 |
18 | * ChipScope 9.1.02i |
3b1b5fa8 |
19 | * ChipScope 8.2.04i |
54fc4508 |
20 | * EDK 8.2.02i |
5649925c |
21 | * EDK 8.1.02i |
113af964 |
22 | |
7606d470 |
23 | In addition to the XILINX USB and parallel cables, devices based on the FTDI |
24 | 2232 serial converter chip are also experimentally supported. This includes |
25 | devices like the Amontec JTAGkey(-Tiny). |
26 | |
113af964 |
27 | Build the library by calling `make'. |
28 | |
29 | To use this library you have to preload the library before starting impact: |
30 | |
31 | $ LD_PRELOAD=/path/to/libusb-driver.so impact |
32 | or |
33 | $ export LD_PRELOAD=/path/to/libusb-driver.so (for sh shells) |
34 | $ setenv LD_PRELOAD /path/to/libusb-driver.so (for csh shells) |
35 | $ impact |
fdd05738 |
36 | |
45b9b80b |
37 | The source for this library can be found at: |
badd6a82 |
38 | http://git.zerfleddert.de/cgi-bin/gitweb.cgi/usb-driver |
45b9b80b |
39 | |
32e2af23 |
40 | The main website is located at: |
41 | http://www.rmdir.de/~michael/xilinx/ |
42 | |
54357994 |
43 | |
44 | Notes for the USB cable |
45 | ======================= |
46 | |
47 | To use the device as an ordinary user, put the following line in a new |
fdd05738 |
48 | file in /etc/udev/rules.d/ and restart udev: |
49 | ACTION=="add", BUS=="usb", SYSFS{idVendor}=="03fd", MODE="666" |
979132fe |
50 | |
51 | |
52 | If your cable does not have the ID 03fd:0008 in the output of lsusb, |
53 | the initial firmware has not been loaded (loading it changes the |
54 | product-ID from another value to 8). To load the firmware follow |
55 | these steps: |
56 | |
c2e95a30 |
57 | 1. If you have no /etc/udev/rules.d/xusbdfwu.rules file, copy it from |
58 | /path/to/ISE/bin/lin/xusbdfwu.rules to /etc/udev/rules.d/xusbdfwu.rules |
979132fe |
59 | |
60 | 2. Install the package containing /sbin/fxload from your linux distribution. |
61 | It is usually called "fxload" |
62 | |
63 | 3. copy the file /path/to/ISE/bin/lin/xusbdfwu.hex to /usr/share/xusbdfwu.hex |
64 | |
65 | 4. restart udev and re-plug the cable |
54357994 |
66 | |
67 | |
68 | Notes for the parallel cable |
69 | ============================ |
70 | |
71 | To access the parallel port from userspace, the kernel needs to be built with |
72 | the features "Parallel port support" (CONFIG_PARPORT), "PC-style hardware" |
73 | (CONFIG_PARPORT_PC) and "Support for user-space parallel port device drivers" |
74 | (CONFIG_PPDEV) builtin or as modules. If these features are built as modules, |
75 | they need to be loaded before using this library. |
76 | These modules are called: |
77 | parport |
78 | parport_pc |
79 | ppdev |
80 | |
81 | |
82 | To use the device as an ordinary user, put the user in the group 'lp' |
6f766a61 |
83 | |
84 | |
cdc9c5bf |
85 | If you have an almost compatible cable which works with other software but not |
05e1bfcd |
86 | with Impact, try adding -DFORCE_PC3_IDENT to the CFLAGS line in the Makefile. |
87 | This enables a hack by Stefan Ziegenbalg to force detection of a parallel cable. |
cdc9c5bf |
88 | |
89 | |
6f766a61 |
90 | Parallel Cable IV is currently only supported in 'compatibility mode', as no |
91 | attempt to configure the ECP registers is done by this library. |
0c71f276 |
92 | |
93 | |
94 | If you get "Programming failed" or "DONE did not go high" when programming |
95 | through the parallel cable with Impact 9.1, make sure to have the option "Use |
96 | HIGHZ instead of BYPASS" enabled in Edit -> Preferences -> iMPACT Configuration |
97 | Preferences. |
98 | If you are using batch mode, add the following line to your cmd file: |
99 | setPreference -pref UseHighz:TRUE |
7606d470 |
100 | (This problem also occurs on windows and when using the real windrvr in linux |
101 | and is solved with the same workaround. Impact 8.2 is working fine with the same |
0c71f276 |
102 | boards and designs) |
7606d470 |
103 | |
104 | |
105 | Notes for FTDI 2232 based cables |
106 | ================================ |
107 | |
108 | To build the driver with FTDI 2232 support, you need to have libftdi and |
109 | the libftdi development package installed. On debian, you can install both |
110 | by installing 'libftdi-dev'. |
111 | |
112 | To set-up the device: |
113 | 1. Find out the vendor and product id of your cable using lsusb: |
114 | Bus 003 Device 005: ID 0403:cff8 Future Technology Devices ... |
115 | ~~~~~~~~~ |
116 | |
117 | 2. Copy the sample libusb-driverrc to ~/.libusb-driverrc, edit it and replace |
19020bc5 |
118 | the vendor and product-id in the example file with the values provided in |
119 | the lsusb-output. You can also change the 'parallel port' which is mapped to |
120 | this cable. Impact sees the device at that port as a Parallel Cable III. |
7606d470 |
121 | |
122 | 3. To use the device as an ordinary user, put the following line in a new file |
123 | in /etc/udev/rules.d/ and restart udev: |
124 | ACTION=="add", BUS=="usb", SYSFS{idVendor}=="0403", SYSFS{idProduct}=="cff8", MODE="666" |
125 | (replace the vendor and product id with your values) |
126 | |
dc587d11 |
127 | The support for FTDI 2232 based devices is experimental and they are currently |
1830118e |
128 | significantly slower than the other supported cables. |