projects / sigrok-firmware-fx2lafw.git / blame
| 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 |