/openhantek

OpenHantek is a free software for Hantek (Voltcraft/Darkwire/Protek/Acetech) USB DSOs based on HantekDSO.

Primary LanguageC++GNU General Public License v3.0GPL-3.0

OpenHantek Build Status

OpenHantek is a free software for Hantek (Voltcraft/Darkwire/Protek/Acetech) USB digital storage oscilloscopes based on HantekDSO and has started as an alternative to the official Hantek DSO software for Linux users.

Image of main window

Tested models so far:

  • DSO-2090

Supported operating systems:

  • Linux
  • MacOSX (The lack of udev requires you to load the firmware by hand for now)

Building OpenHantek from source

You need the following packages, to build OpenHantek from source:

  • CMake 2.8.12+
  • Qt 5+
  • FFTW 3+
  • libusb 1.x
  • binutils-dev

For debian based systems (Ubuntu, Mint) install named requirements like this:

apt-get install cmake qttools5-dev-tools libfftw3-dev binutils-dev libusb-1.0-0-dev

For rpm based distributions (Fedora) use this command:

dnf install cmake qt5-qtbase-gui qt5-qttools-devel qt5-qttranslations fftw-devel libusbx-devel binutils-devel libusb-1.0-0-devel

After you've installed the requirements run the following commands inside the directory of this package:

qmake
make
make install (optional, for installing only)

You can specify a prefix when running qmake:

qmake PREFIX=/usr

Firmware

Your DSO does not store its firmware permanently and have to be send to the device each time it is connected. Because of copyright reasons we cannot ship the firmware with this software. You have to extract the firmware using openhantek-extractfw and add some rules to udev.

Getting the Windows drivers

Before using OpenHantek you have to extract the firmware from the official Windows drivers. You can get them from the Hantek website or automatically download them with the script fwget.sh.

The firmware extraction tool

Install libbfd (Ubuntu) / binutils (Fedora) and build the tool by typing:

make

After building it, you can just run the fwget.sh script inside the openhantek-extractfw directory:

sudo ./fwget.sh /usr/local/share/hantek/

You can also do it manually by placing the DSO*1.SYS file into the same directory and running the built binary:

./openhantek-extractfw <driver file>

This should create two .hex files that should be placed into /usr/local/share/hantek/.

Installing the firmware

  • Copy the 90-hantek.rules file to /etc/udev/rules.d/.
  • install fxload (fxload is a program which downloads firmware to USB devices based on AnchorChips EZ-USB, Cypress EZ-USB FX, or Cypress EZ-USB FX2 microcontrollers.)
  • Add your current user to the plugdev group.

Contribute

Please use Github Issues to report any problems or enhancements or send us pull requests. Some random notes: