README

   1 ------------------------------------------------------------------------------
   2 fx2lafw
   3 ------------------------------------------------------------------------------
   4
   5 fx2lafw is a free/libre/open-source firmware for logic analyzers based on
   6 the Cypress EZ-USB FX2(LP) chip.
   7
   8 It is licensed under the terms of the GNU GPL (version 2 or later).
   9
  10
  11 Requirements
  12 ------------
  13
  14 In order to build fx2lafw you need the 'sdcc' compiler.
  15
  16 On Debian you can install it via:
  17
  18   $ apt-get install sdcc
  19
  20
  21 Building
  22 --------
  23
  24   $ git clone git://sigrok.git.sourceforge.net/gitroot/sigrok/fx2lafw
  25   $ cd fx2lafw
  26   $ git clone git://github.com/mulicheng/fx2lib.git
  27   $ make
  28
  29
  30 Usage
  31 -----
  32
  33 Copy the generated *.fw file for your device (e.g. fx2lafw-saleae-logic.fw)
  34 into the $prefix/share/sigrok-firmware directory (create it, if needed).
  35
  36 Replace $prefix with the install prefix of sigrok, e.g. /usr or /usr/local.
  37
  38 Example (assuming /usr/local as $prefix):
  39
  40   $ sudo mkdir /usr/local/share/sigrok-firmware
  41
  42   $ sudo cp hw/saleae-logic/build/fx2lafw-saleae-logic.fw \
  43             /usr/local/share/sigrok-firmware
  44
  45 The sigrok frontends (command-line or GUI) will automatically search for
  46 firmware files there and automatically use/upload them.
  47
  48
  49 Website
  50 -------
  51
  52 See the fx2lafw website for further information:
  53
  54   http://sigrok.org/wiki/Fx2lafw
  55