]>
Commit | Line | Data |
---|---|---|
d5f5ea73 UH |
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 | ||
c7e02d8c UH |
8 | It is licensed under the terms of the GNU GPL (version 2 or later), and uses |
9 | additional helper code licensed under the GNU LGPL (version 2.1 or later). | |
d5f5ea73 | 10 | |
8b13135e | 11 | |
d5f5ea73 UH |
12 | Requirements |
13 | ------------ | |
14 | ||
c7e02d8c UH |
15 | - In order to build fx2lafw you need the 'sdcc' compiler. |
16 | On Debian you can install it via: | |
d5f5ea73 | 17 | |
c7e02d8c | 18 | $ apt-get install sdcc |
d5f5ea73 | 19 | |
c7e02d8c UH |
20 | - You need libsigrok >= 0.1.1 in order to make use of fx2lafw. Earlier |
21 | versions didn't have support for FX2 devices using this firmware. | |
d5f5ea73 | 22 | |
d5f5ea73 UH |
23 | |
24 | Building | |
25 | -------- | |
26 | ||
060dc3fe | 27 | $ git clone git://sigrok.git.sourceforge.net/gitroot/sigrok/fx2lafw |
d5f5ea73 | 28 | $ cd fx2lafw |
d5f5ea73 UH |
29 | $ make |
30 | ||
8b13135e | 31 | |
d5f5ea73 UH |
32 | Usage |
33 | ----- | |
34 | ||
8b13135e UH |
35 | Copy the generated *.fw file for your device (e.g. fx2lafw-saleae-logic.fw) |
36 | into the $prefix/share/sigrok-firmware directory (create it, if needed). | |
37 | ||
38 | Replace $prefix with the install prefix of sigrok, e.g. /usr or /usr/local. | |
39 | ||
40 | Example (assuming /usr/local as $prefix): | |
41 | ||
42 | $ sudo mkdir /usr/local/share/sigrok-firmware | |
d5f5ea73 | 43 | |
8b13135e UH |
44 | $ sudo cp hw/saleae-logic/build/fx2lafw-saleae-logic.fw \ |
45 | /usr/local/share/sigrok-firmware | |
d5f5ea73 | 46 | |
8b13135e UH |
47 | The sigrok frontends (command-line or GUI) will automatically search for |
48 | firmware files there and automatically use/upload them. | |
49 | ||
91f1e17f | 50 | |
d5f5ea73 UH |
51 | Website |
52 | ------- | |
53 | ||
54 | See the fx2lafw website for further information: | |
55 | ||
56 | http://sigrok.org/wiki/Fx2lafw | |
57 |