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   $ make
  27
  28
  29 Usage
  30 -----
  31
  32 Copy the generated *.fw file for your device (e.g. fx2lafw-saleae-logic.fw)
  33 into the $prefix/share/sigrok-firmware directory (create it, if needed).
  34
  35 Replace $prefix with the install prefix of sigrok, e.g. /usr or /usr/local.
  36
  37 Example (assuming /usr/local as $prefix):
  38
  39   $ sudo mkdir /usr/local/share/sigrok-firmware
  40
  41   $ sudo cp hw/saleae-logic/build/fx2lafw-saleae-logic.fw \
  42             /usr/local/share/sigrok-firmware
  43
  44 The sigrok frontends (command-line or GUI) will automatically search for
  45 firmware files there and automatically use/upload them.
  46
  47
  48 Website
  49 -------
  50
  51 See the fx2lafw website for further information:
  52
  53   http://sigrok.org/wiki/Fx2lafw
  54