]>
Commit | Line | Data |
---|---|---|
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.1SP3 | |
13 | * ISE Webpack 9.1SP2 | |
14 | * ISE Webpack 9.1SP1 | |
15 | * ISE Webpack 8.2SP3 | |
16 | * ISE Webpack 8.1SP3 | |
17 | * ChipScope 9.1.02i | |
18 | * EDK 8.2.02i | |
19 | ||
20 | Build the library by calling `make'. | |
21 | ||
22 | To use this library you have to preload the library before starting impact: | |
23 | ||
24 | $ LD_PRELOAD=/path/to/libusb-driver.so impact | |
25 | or | |
26 | $ export LD_PRELOAD=/path/to/libusb-driver.so (for sh shells) | |
27 | $ setenv LD_PRELOAD /path/to/libusb-driver.so (for csh shells) | |
28 | $ impact | |
29 | ||
30 | The source for this library can be found at: | |
31 | http://cvs.zerfleddert.de/cgi-bin/viewcvs.cgi/usb-driver/ | |
32 | ||
33 | ||
34 | Notes for the USB cable | |
35 | ======================= | |
36 | ||
37 | To use the device as an ordinary user, put the following line in a new | |
38 | file in /etc/udev/rules.d/ and restart udev: | |
39 | ACTION=="add", BUS=="usb", SYSFS{idVendor}=="03fd", MODE="666" | |
40 | ||
41 | ||
42 | If your cable does not have the ID 03fd:0008 in the output of lsusb, | |
43 | the initial firmware has not been loaded (loading it changes the | |
44 | product-ID from another value to 8). To load the firmware follow | |
45 | these steps: | |
46 | ||
47 | 1. If you have no /etc/udev/rules.d/xusbdfwu.rules file, copy it from | |
48 | /path/to/ISE/bin/lin/xusbdfwu.rules to /etc/udev/rules.d/xusbdfwu.rules | |
49 | ||
50 | 2. Install the package containing /sbin/fxload from your linux distribution. | |
51 | It is usually called "fxload" | |
52 | ||
53 | 3. copy the file /path/to/ISE/bin/lin/xusbdfwu.hex to /usr/share/xusbdfwu.hex | |
54 | ||
55 | 4. restart udev and re-plug the cable | |
56 | ||
57 | ||
58 | Notes for the parallel cable | |
59 | ============================ | |
60 | ||
61 | To access the parallel port from userspace, the kernel needs to be built with | |
62 | the features "Parallel port support" (CONFIG_PARPORT), "PC-style hardware" | |
63 | (CONFIG_PARPORT_PC) and "Support for user-space parallel port device drivers" | |
64 | (CONFIG_PPDEV) builtin or as modules. If these features are built as modules, | |
65 | they need to be loaded before using this library. | |
66 | These modules are called: | |
67 | parport | |
68 | parport_pc | |
69 | ppdev | |
70 | ||
71 | ||
72 | To use the device as an ordinary user, put the user in the group 'lp' | |
73 | ||
74 | ||
75 | If you have an almost compatible cable which works with other software but not | |
76 | with Impact, try adding -DFORCE_PC3_IDENT to the CFLAGS line in the Makefile. | |
77 | This enables a hack by Stefan Ziegenbalg to force detection of a parallel cable. | |
78 | ||
79 | ||
80 | Parallel Cable IV is currently only supported in 'compatibility mode', as no | |
81 | attempt to configure the ECP registers is done by this library. | |
82 | ||
83 | ||
84 | If you get "Programming failed" or "DONE did not go high" when programming | |
85 | through the parallel cable with Impact 9.1, make sure to have the option "Use | |
86 | HIGHZ instead of BYPASS" enabled in Edit -> Preferences -> iMPACT Configuration | |
87 | Preferences. | |
88 | If you are using batch mode, add the following line to your cmd file: | |
89 | setPreference -pref UseHighz:TRUE | |
90 | (This problem also occurs on windows and when using the real windrvr in linux and | |
91 | is solved with the same workaround. Impact 8.2 is working fine with the same | |
92 | boards and designs) |