]>
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 | 8 | It is licensed under the terms of the GNU GPL (version 2 or later), and uses |
94ca1bed UH |
9 | additional helper code (fx2lib), licensed under the GNU LGPL (version 2.1 |
10 | or later). | |
d5f5ea73 | 11 | |
8b13135e | 12 | |
d5f5ea73 UH |
13 | Requirements |
14 | ------------ | |
15 | ||
c7e02d8c UH |
16 | - In order to build fx2lafw you need the 'sdcc' compiler. |
17 | On Debian you can install it via: | |
d5f5ea73 | 18 | |
c7e02d8c | 19 | $ apt-get install sdcc |
d5f5ea73 | 20 | |
c7e02d8c UH |
21 | - You need libsigrok >= 0.1.1 in order to make use of fx2lafw. Earlier |
22 | versions didn't have support for FX2 devices using this firmware. | |
d5f5ea73 | 23 | |
d5f5ea73 UH |
24 | |
25 | Building | |
26 | -------- | |
27 | ||
060dc3fe | 28 | $ git clone git://sigrok.git.sourceforge.net/gitroot/sigrok/fx2lafw |
d5f5ea73 | 29 | $ cd fx2lafw |
d5f5ea73 UH |
30 | $ make |
31 | ||
8b13135e | 32 | |
de1a2178 UH |
33 | Installation |
34 | ------------ | |
8b13135e | 35 | |
de1a2178 | 36 | $ sudo make install |
8b13135e | 37 | |
de1a2178 | 38 | The generated *.fw files are installed into /usr/local/share/sigrok-firmware. |
d5f5ea73 | 39 | |
de1a2178 | 40 | You can override the install location like this: |
d5f5ea73 | 41 | |
de1a2178 | 42 | $ sudo make install DESTDIR=/usr/share/sigrok-firmware |
94ca1bed UH |
43 | |
44 | ||
45 | fx2lib | |
46 | ------ | |
47 | ||
48 | The fx2lafw code uses a (slightly modified) "fx2lib" helper library. | |
49 | ||
50 | It was imported into fx2lafw from | |
51 | ||
52 | git://github.com/ubixum/fx2lib.git | |
53 | ||
54 | as of Feb 12, 2012 (git hash "416c104cbd"). | |
55 | ||
56 | The following files/directories were removed, as they're not needed | |
57 | for our purposes: CHANGELOG, COPYING*, docs/, examples/, fw/, and utils/. | |
58 | ||
91f1e17f | 59 | |
d5f5ea73 UH |
60 | Website |
61 | ------- | |
62 | ||
63 | See the fx2lafw website for further information: | |
64 | ||
65 | http://sigrok.org/wiki/Fx2lafw | |
66 |