1 -------------------------------------------------------------------------------
3 -------------------------------------------------------------------------------
5 The sigrok project aims at creating a portable, cross-platform,
6 Free/Libre/Open-Source signal analysis software suite that supports various
7 device types (such as logic analyzers, oscilloscopes, multimeters, and more).
9 fx2lafw is a Free/Libre/Open-source firmware for logic analyzers based on
10 the Cypress EZ-USB FX2(LP) chip.
12 It is licensed under the terms of the GNU GPL (version 2 or later), and uses
13 additional helper code (fx2lib), licensed under the GNU LGPL (version 2.1
20 sigrok-firmware-fx2lafw is in a usable state and has had official
27 - In order to build fx2lafw you need the 'sdcc' compiler (>= 2.8.0).
28 On Debian you can install it via:
30 $ apt-get install sdcc
32 This project has been tested to work with sdcc 2.8, 2.9, and 3.x.
34 - You need libsigrok >= 0.1.1 in order to make use of fx2lafw. Earlier
35 versions didn't have support for FX2 devices using this firmware.
38 Building and installing
39 -----------------------
41 In order to get the sigrok-firmware-fx2lafw source code and build it, run:
43 $ git clone git://sigrok.org/sigrok-firmware-fx2lafw
44 $ cd sigrok-firmware-fx2lafw
49 For installing sigrok-firmware-fx2lafw:
53 The generated *.fw files are installed into /usr/local/share/sigrok-firmware.
55 You can override the install location like this:
57 $ ./configure --prefix=/usr
59 Please see the following wiki pages for more detailed instructions:
61 http://sigrok.org/wiki/Linux
62 http://sigrok.org/wiki/Mac_OS_X
63 http://sigrok.org/wiki/Windows
64 http://sigrok.org/wiki/FreeBSD
70 The fx2lafw code uses a (slightly modified) "fx2lib" helper library.
72 It was imported into fx2lafw from
74 git://github.com/ubixum/fx2lib.git
76 as of Feb 12, 2012 (git hash "416c104cbd").
78 The following files/directories were removed, as they're not needed
79 for our purposes: CHANGELOG, COPYING*, docs/, examples/, fw/, and utils/.
85 There are two mailing lists for sigrok/sigrok-firmware-fx2lafw:
87 https://lists.sourceforge.net/lists/listinfo/sigrok-devel
88 https://lists.sourceforge.net/lists/listinfo/sigrok-commits
94 You can find the sigrok developers in the #sigrok IRC channel on Freenode.
100 http://sigrok.org/wiki/Fx2lafw