git.zerfleddert.de Git - usb-driver/blob - 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'