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 will very probably not work with older impact versions (<9.1).
   8
   9 Build the library by calling `make'.
  10
  11 To use this library you have to preload the library before starting impact:
  12
  13 $ LD_PRELOAD=/path/to/libusb-driver.so impact
  14 or
  15 $ export LD_PRELOAD=/path/to/libusb-driver.so  (for sh shells)
  16 $ setenv LD_PRELOAD /path/to/libusb-driver.so  (for csh shells)
  17 $ impact
  18
  19 To use the device as ordinary user, put the following line in a new
  20 file in /etc/udev/rules.d/ and restart udev:
  21 ACTION=="add", BUS=="usb", SYSFS{idVendor}=="03fd", MODE="666"
  22
  23
  24 If your cable does not have the ID 03fd:0008 in the output of lsusb,
  25 the initial firmware has not been loaded (loading it changes the
  26 product-ID from another value to 8). To load the firmware follow
  27 these steps:
  28
  29 1. If you have no /etc/udev/rules.d/xusbdfwu.rules file, copy it from
  30    /path/to/ISE/bin/lin/xusbdfwu.rules to /etc/udev/rules.d/xusbdfwu.rules
  31
  32 2. Install the package containing /sbin/fxload from your linux distribution.
  33    It is usually called "fxload"
  34
  35 3. copy the file /path/to/ISE/bin/lin/xusbdfwu.hex to /usr/share/xusbdfwu.hex
  36
  37 4. restart udev and re-plug the cable