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 sigrok-firmware-fx2lafw is a Free/Libre/Open-source firmware for logic
10 analyzers based on the Cypress EZ-USB FX2(LP) chip.
16 sigrok-firmware-fx2lafw is in a usable state and has had official
31 - In order to build fx2lafw you need the 'sdcc' compiler (>= 2.9.0).
32 On Debian you can install it via:
34 $ apt-get install sdcc
36 This project has been tested to work with sdcc 2.9, 3.0, 3.1, and 3.2.
38 - You need libsigrok >= 0.1.1 in order to make use of fx2lafw. Earlier
39 versions didn't have support for FX2 devices using this firmware.
42 Building and installing
43 -----------------------
45 In order to get the sigrok-firmware-fx2lafw source code and build it, run:
47 $ git clone git://sigrok.org/sigrok-firmware-fx2lafw
48 $ cd sigrok-firmware-fx2lafw
53 For installing sigrok-firmware-fx2lafw:
57 The generated *.fw files are installed into /usr/local/share/sigrok-firmware.
59 You can override the install location like this:
61 $ ./configure --prefix=/usr
63 See INSTALL or the following wiki page for more (OS-specific) instructions:
65 http://sigrok.org/wiki/Building
68 Pre-built firmware files
69 ------------------------
71 There are also pre-built firmware files that can be used without having
72 to build them from source. You can download those from SourceForge:
74 http://sourceforge.net/projects/sigrok/files/binary/sigrok-firmware-fx2lafw/
80 The fx2lafw code uses a (slightly modified) "fx2lib" helper library.
82 It was imported into fx2lafw from
84 git://github.com/ubixum/fx2lib.git
86 as of Feb 12, 2012 (git hash "416c104cbd").
88 The following files/directories were removed, as they're not needed
89 for our purposes: CHANGELOG, COPYING*, docs/, examples/, fw/, and utils/.
95 sigrok-firmware-fx2lafw is licensed under the terms of the GNU General Public
96 License (GPL), version 2 or later.
98 It uses additional helper code (fx2lib), licensed under the GNU LGPL
99 (version 2.1 or later).
101 While some individual source code files are licensed under the LGPLv2.1+, and
102 some files are licensed under the GPLv2+, this doesn't change the fact that
103 the firmware as a whole is licensed under the terms of the GPLv2+.
105 Please see the individual source files for the full list of copyright holders.
111 https://lists.sourceforge.net/lists/listinfo/sigrok-devel
117 You can find the sigrok developers in the #sigrok IRC channel on Freenode.
123 http://sigrok.org/wiki/Fx2lafw