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 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 |