X-Git-Url: http://sigrok.org/gitweb/?a=blobdiff_plain;f=README;h=e0d25a11dff67046c526ea6b9e8293ad1dd4803d;hb=02d3622255a4eee3aa6ed3ab86b24885cef92544;hp=2295a7ecb7a5c0a91bdf05ab554745bf14e6e881;hpb=d5f5ea7394647699061f7185c884328defff9b7d;p=sigrok-firmware-fx2lafw.git diff --git a/README b/README index 2295a7ec..e0d25a11 100644 --- a/README +++ b/README @@ -1,45 +1,163 @@ ------------------------------------------------------------------------------- -fx2lafw ------------------------------------------------------------------------------- +------------------------------------------------------------------------------- +README +------------------------------------------------------------------------------- -fx2lafw is a free/libre/open-source firmware for logic analyzers based on -the Cypress EZ-USB FX2(LP) chip. +The sigrok project aims at creating a portable, cross-platform, +Free/Libre/Open-Source signal analysis software suite that supports various +device types (such as logic analyzers, oscilloscopes, multimeters, and more). + +sigrok-firmware-fx2lafw is a Free/Libre/Open-source firmware for logic +analyzers based on the Cypress EZ-USB FX2(LP) chip, as well as the +Hantek 6022BE and Sainsmart DDS120 USB oscilloscopes. + + +Status +------ + +sigrok-firmware-fx2lafw is in a usable state and has had official +tarball releases. -It is licensed under the terms of the GNU GPL (version 2 or later). Requirements ------------ -In order to build fx2lafw you need the 'sdcc' compiler. + - git + - make + - autoconf >= 2.63 + - automake >= 1.11 + - sdcc (>= 2.9.0) + +Notes: + + - In order to build fx2lafw you need the 'sdcc' compiler (>= 2.9.0). + On Debian you can install it via: + + $ apt-get install sdcc + + This project has been tested to work with sdcc 2.9 and 3.x. + + +Building and installing +----------------------- + +In order to get the sigrok-firmware-fx2lafw source code and build it, run: + + $ git clone git://sigrok.org/sigrok-firmware-fx2lafw + $ cd sigrok-firmware-fx2lafw + $ ./autogen.sh + $ ./configure + $ make + +For installing sigrok-firmware-fx2lafw: + + $ make install + +The generated *.fw files are installed into /usr/local/share/sigrok-firmware. + +You can override the install location like this: + + $ ./configure --prefix=/usr + +See INSTALL or the following wiki page for more (OS-specific) instructions: + + http://sigrok.org/wiki/Building + + +Pre-built firmware files +------------------------ + +There are also pre-built firmware files that can be used without having +to build them from source. You can download those from: + + http://sigrok.org/download/binary/sigrok-firmware-fx2lafw/ + + +fx2lib +------ + +The fx2lafw code uses a (slightly modified) "fx2lib" helper library. -On Debian you can install it via: +It was imported into fx2lafw from - $ apt-get install sdcc + git://github.com/ubixum/fx2lib.git -In order to transfer the firmware onto the FX2 chip, you can use cycfx2prog: +as of Feb 12, 2012 (git hash "416c104cbd"). - $ apt-get install cycfx2prog +The following files/directories were removed, as they're not needed +for our purposes: CHANGELOG, COPYING*, docs/, examples/, fw/, and utils/. -Building --------- - $ git clone ... - $ cd fx2lafw - $ git clone git://github.com/mulicheng/fx2lib.git - $ make +Hantek 6022BE firmware +---------------------- -Usage ------ +The Hantek 6022BE firmware was originally created by Jochen Hoenicke in +05/2015 for the Hantek6022API github project by Robert Cope. Full credit +for the implementation of the firmware goes to Jochen Hoenicke, thanks! - $ cycfx2prog -id=vvvv:pppp prg:build/fx2lafw.ihx reset run delay:100 +Github project: + + https://github.com/rpcope1/Hantek6022API + +We've incorporated the Hantek 6022BE firmware into the sigrok-firmware-fx2lafw +repo/tarball for convenience of sigrok users. E.g. so that they can +easily get it with the other fx2lafw firmware files from distro +packages, the build scripts in sigrok-util automatically build/install +it, the sigrok Windows installers automatically ship it, the sigrok +Android APKs automatically ship it, etc. etc. + +The files we've integrated into fx2lafw from Hantek6022API were taken from +the PyHT6022/HantekFirmware/custom directory of that repo, using the state +as of 03/2016 (the files were last modified in 05/2015, though). + +The git hash of the last relevant commit there was: + + 0498e2ab239aabb1084c19e1e24faf56764b217e + +Files integrated into fx2lafw: + + - hw/hantek-6022be/dscr.a51: Copied unmodified. + + - hantek_6022be.c: This file was originally created by appending the + contents of the original device.c and fw.c together. + + +Sainsmart DDS120 firmware +------------------------- + +The Sainsmart DDS120 firmware is heavily based upon the original Hantek 6022BE +firmware, so the items mentioned above apply here as well. + + +Copyright and license +--------------------- + +sigrok-firmware-fx2lafw is licensed under the terms of the GNU General Public +License (GPL), version 2 or later. + +It uses additional helper code (fx2lib, Hantek 6022BE, and Sainsmart DDS120 +firmware), licensed under the GNU LGPL (version 2.1 or later). + +While some individual source code files are licensed under the LGPLv2.1+, and +some files are licensed under the GPLv2+, this doesn't change the fact that +the firmware as a whole is licensed under the terms of the GPLv2+. + +Please see the individual source files for the full list of copyright holders. + + +Mailing list +------------ + + https://lists.sourceforge.net/lists/listinfo/sigrok-devel + + +IRC +--- + +You can find the sigrok developers in the #sigrok IRC channel on Freenode. -You have to provide the USB VID/PID of the FX2 device (before firmware -upload) using the -id parameter. Website ------- -See the fx2lafw website for further information: - - http://sigrok.org/wiki/Fx2lafw + http://sigrok.org/wiki/Fx2lafw