X-Git-Url: http://sigrok.org/gitweb/?a=blobdiff_plain;f=README;h=e0d25a11dff67046c526ea6b9e8293ad1dd4803d;hb=cf43e09a111d7d6bf482521149bd33d85947dede;hp=7c1e6e758d601af4faa3462c649731c8bbb0d656;hpb=05f4369545dad41969b112893a8bb4146e98fc0a;p=sigrok-firmware-fx2lafw.git diff --git a/README b/README index 7c1e6e75..e0d25a11 100644 --- a/README +++ b/README @@ -7,7 +7,8 @@ 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. +analyzers based on the Cypress EZ-USB FX2(LP) chip, as well as the +Hantek 6022BE and Sainsmart DDS120 USB oscilloscopes. Status @@ -35,9 +36,6 @@ Notes: This project has been tested to work with sdcc 2.9 and 3.x. - - You need libsigrok >= 0.1.1 in order to make use of fx2lafw. Earlier - versions didn't have support for FX2 devices using this firmware. - Building and installing ----------------------- @@ -89,14 +87,55 @@ The following files/directories were removed, as they're not needed for our purposes: CHANGELOG, COPYING*, docs/, examples/, fw/, and utils/. +Hantek 6022BE firmware +---------------------- + +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! + +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), licensed under the GNU LGPL -(version 2.1 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