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.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'