git.zerfleddert.de Git - usb-driver/blob - README

   1 This library emulates Jungo Windrvr USB functions in userspace which are
   2 required by XILINX impact to access the Platform cable USB. With this library
   3 it is possible to access the cable without loading a proprietary kernel module
   4 which breaks with every new kernel release. It uses the USB functions provided
   5 by the libusb userspace library instead and should work on every kernel version
   6 which is supported by libusb. It was written against impact from ISE Webpack
   7 9.1SP1 and tested with the following software:
   8
   9  * ISE Webpack 9.1SP2
  10  * ISE Webpack 9.1SP1
  11  * ISE Webpack 8.1SP3
  12  * ChipScope 9.1.02i
  13
  14 Build the library by calling `make'.
  15
  16 To use this library you have to preload the library before starting impact:
  17
  18 $ LD_PRELOAD=/path/to/libusb-driver.so impact
  19 or
  20 $ export LD_PRELOAD=/path/to/libusb-driver.so  (for sh shells)
  21 $ setenv LD_PRELOAD /path/to/libusb-driver.so  (for csh shells)
  22 $ impact
  23
  24 To use the device as ordinary user, put the following line in a new
  25 file in /etc/udev/rules.d/ and restart udev:
  26 ACTION=="add", BUS=="usb", SYSFS{idVendor}=="03fd", MODE="666"
  27
  28
  29 If your cable does not have the ID 03fd:0008 in the output of lsusb,
  30 the initial firmware has not been loaded (loading it changes the
  31 product-ID from another value to 8). To load the firmware follow
  32 these steps:
  33
  34 1. If you have no /etc/udev/rules.d/xusbdfwu.rules file, copy it from
  35    /path/to/ISE/bin/lin/xusbdfwu.rules to /etc/udev/rules.d/xusbdfwu.rules
  36
  37 2. Install the package containing /sbin/fxload from your linux distribution.
  38    It is usually called "fxload"
  39
  40 3. copy the file /path/to/ISE/bin/lin/xusbdfwu.hex to /usr/share/xusbdfwu.hex
  41
  42 4. restart udev and re-plug the cable