]> git.zerfleddert.de Git - usb-driver/blob - README
87fe8be309867cd7d781ef56d3be8c0573367a18
[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.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'
Impressum, Datenschutz