Installation
You are here: Home > Documentation > Installation

Installation

Ubuntu repository

When using Ubuntu, OpenHantek can be easily installed from it's launchpad repository. To add the repository just execute the following command: 

$ sudo add-apt-repository ppa:oliverhaag/openhantek

After adding the repository just do an update in the package manager and install the package openhantek.

Compiling from source

Getting the code

The latest stable release is available on sourceforge.net as tar.bz2 archive.

If you prefer to try out the latest features you can also check out the current svn snapshot by running: 

$ svn checkout svn://svn.code.sf.net/p/openhantek/code/trunk openhantek

Dependencies

You need the development packages for the following libraries to build OpenHantek from source:

Building

After installing these you can build it by running: 

$ qmake
$ make
$ sudo make install

Build options

You can set environment variables to set various build options (Done best by prepending env VARIABLE=value to the qmake command). The known environment variables are:

It is also possible to build a debug version instead by appending CONFIG+=debug to the qmake command.

Installation of the firmware

Gettings 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

You need the tool dsoextractfw from the sourceforge page too extract the firmware. You have to install libbfd development files and build it by typing: 

$ ./configure
$ 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/. To load the firmware you have to install fxload.

After restarting udev your oscilloscope should be initialized automatically after connecting it to the computer (You have to reconnect it after installing this package).

If you can't run OpenHantek as normal user, you have too add your user to the plugdev group: 

$ adduser <username> plugdev

After logging off and on again you should be able to run OpenHantek with the user <username>.