]> git.zerfleddert.de Git - usb-driver/blob - README
cleanup parallel support a bit
[usb-driver] / README
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 functions 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.1SP3
15 * ChipScope 9.1.02i
16
17 Build the library by calling `make'.
18
19 To use this library you have to preload the library before starting impact:
20
21 $ LD_PRELOAD=/path/to/libusb-driver.so impact
22 or
23 $ export LD_PRELOAD=/path/to/libusb-driver.so (for sh shells)
24 $ setenv LD_PRELOAD /path/to/libusb-driver.so (for csh shells)
25 $ impact
26
27
28 Notes for the USB cable
29 =======================
30
31 To use the device as an ordinary user, put the following line in a new
32 file in /etc/udev/rules.d/ and restart udev:
33 ACTION=="add", BUS=="usb", SYSFS{idVendor}=="03fd", MODE="666"
34
35
36 If your cable does not have the ID 03fd:0008 in the output of lsusb,
37 the initial firmware has not been loaded (loading it changes the
38 product-ID from another value to 8). To load the firmware follow
39 these steps:
40
41 1. If you have no /etc/udev/rules.d/xusbdfwu.rules file, copy it from
42 /path/to/ISE/bin/lin/xusbdfwu.rules to /etc/udev/rules.d/xusbdfwu.rules
43
44 2. Install the package containing /sbin/fxload from your linux distribution.
45 It is usually called "fxload"
46
47 3. copy the file /path/to/ISE/bin/lin/xusbdfwu.hex to /usr/share/xusbdfwu.hex
48
49 4. restart udev and re-plug the cable
50
51
52 Notes for the parallel cable
53 ============================
54
55 To access the parallel port from userspace, the kernel needs to be built with
56 the features "Parallel port support" (CONFIG_PARPORT), "PC-style hardware"
57 (CONFIG_PARPORT_PC) and "Support for user-space parallel port device drivers"
58 (CONFIG_PPDEV) builtin or as modules. If these features are built as modules,
59 they need to be loaded before using this library.
60 These modules are called:
61 parport
62 parport_pc
63 ppdev
64
65
66 To use the device as an ordinary user, put the user in the group 'lp'
Impressum, Datenschutz