OpenHantek6022

OpenHantek6022 is a free software for Hantek DSO6022 USB digital signal oscilloscopes that is actively developed on github.com/OpenHantek/OpenHantek6022 - but only for Hantek 6022BE/BL and compatible scopes (Voltcraft, Darkwire, Protek, Acetech, etc.).

This project gives no support for its currently unmaintained predecessor openhantek.

<p><img alt="Image of main window on linux" width="100%" src="docs/images/screenshot_mainwindow.png"></p>

Content

• About OpenHantek6022
• Features
• AC Coupling
• Continuous Integration
• Building OpenHantek6022 from source
• Install Prebuilt Binary Packages
• Run OpenHantek6022
  • Offset Calibration
  • OpenGL Support
  • USB Access
• Important!
• Specifications, Features, Limitations and Developer Documentation
• Contribute
• Other DSO Open Source Software
• Other Related Software
• History
• Donate

<!-- * [Donate for FSF](#donate-for-fsf) -->

About OpenHantek6022

• Supported devices:

  • Hantek 6022BE and 6022BL as well as compatible scopes (e.g. Voltcraft DSO-2020).
  • SainSmart DDS120 (thx msiegert) - this device has a different analog front end and uses the slightly improved sigrok firmware, which has some limitations compared to the Hantek scopes (see #69).

• Demo mode is provided by the -d or --demoMode command line option.

• Fully supported operating system: Linux; developed under debian stable (currently bookworm) for amd64 architecture.

• Raspberry Pi packages (raspbian stable) are available on the Releases page, check this setup requirement.

• Compiles under FreeBSD (packaging / installation: work in progress, thx tspspi).

• Other operating systems builds: Windows (mostly untested) & macOS (completely untested). No support for non-Linux related issues unless a volunteer steps in!

• Uses free open source firmware, no longer dependent on nonfree Hantek firmware.

• Extensive User Manual with technical specs and schematics.

Features

• Voltage and Spectrum view for all device supported channels.
• CH1 and CH2 name becomes red when input is clipped (bottom left).
• Settable probe attenuation factor 1..1000 to accommodate a variety of different probes.
• Measure and display Vpp, DC (average), AC, RMS and dB (of RMS) values as well as frequency of active channels. Display as dBV (0 dBV = 1 V rms), dBu (0 dBu = 1 mW @ 600 Ω) or dBm (0 dBu = 1 mW @ 50 Ω) can be selected in Oscilloscope/Settings/Analysis.
• Display the power dissipation for a load resistance of 1..1000 Ω (optional, can be set in Oscilloscope/Settings/Analysis).
• Display the THD of the signal (optional, can be enabled in Oscilloscope/Settings/Analysis).
• Show the note values and deviation in cent (twelve equal, A = 440 Hz) for audio frequencies (optional, can be enabled in Oscilloscope/Settings/Analysis). Useful to tune e.g. your electrical guitar.
• Math channel modes: CH1+CH2, CH1-CH2, CH2-CH1, CH1*CH2 and square, abs, sign, AC and DC part of CH1 or CH2.
• Time base 10 ns/div .. 10 s/div.
• Sample rates 100, 200, 500 S/s, 1, 2, 5, 10, 20, 50, 100, 200, 500 kS/s, 1, 2, 5, 10, 12, 15, 24, 30 MS/s (24 & 30 MS/s in CH1-only mode, 48 MS/s not supported due to unstable USB data streaming).
• Hardware input gain automatically selected based on vertical sensitivity: 1x (up to ±5 V for 1, 2 or 5 V/div), 2x (up to ±2.5 V for 500 mV/div), 5x (up to ±1 V for 200 mV/div) and 10x (up to ±500 mV for 20 or 50 mV/div).
• Downsampling (up to 200x) increases resolution and SNR.
• Calibration output square wave signal frequency can be selected between 32 Hz .. 100 kHz in small steps (poor person's signal generator). A little HW modification provides a jitter free HW-driven calibration output signal instead of the interrupt driven SW-output.
• Trigger modes: Normal, Auto and Single with green/red status display (top left).
• Untriggered Roll mode can be selected for slow time bases of 200 ms/div .. 10 s/div.
• Trigger filter HF (trigger also on glitches), Normal and LF (for noisy signals).
• Display interpolation modes Off, Linear, Step and Sinc.
• Calibration values loaded from eeprom or a model configuration file.
• Online offset calibration creates a configuration file for persistent data storage.
• Calibration program to create these values automatically.
• Digital phosphor effect to notice even short spikes; simple eye-diagram display with alternating trigger slope.
• Histogram function for voltage channels on right screen margin.
• A zoom view with a freely selectable range.
• Cursor measurement function for voltage, time, amplitude and frequency.
• Export of the graphs to JPG, PNG or PDF file or to the printer; data export as CSV or JSON.
• Freely configurable colors.
• Automatic adaption of iconset for light and dark themes.
• The dock views on the main window can be customized by dragging them around and stacking them. This allows a minimum window size of 800*300 for old laptops or workstation computers.
• All settings can be saved to a configuration file and loaded again.
• French, German, Russian and Spanish localisation complete; Chinese, Polish and Swedish is updated regularily; Italian and Portuguese translation ongoing - volunteers welcome!

AC Coupling

A little HW modification adds AC coupling. OpenHantek6022 supports this feature since v2.17-rc5 / FW0204.

Continuous Integration

Every commit triggers a workflow on GitHub Actions that builds and packages OpenHantek6022 for:

• Linux (*.deb, *.rpm, *.tar.gz)
• Windows (<!--`*_mingw_x64.zip`, -->*_msvc_x64.zip)
• macOS - (*_osx_arm64.dmg, *_osx_x86_64.dmg, *.tar.gz)

This status badge here (and on top) show the build status.

Building OpenHantek6022 from source

The preferred way to run OpenHantek6022 is to build it from source on your system, especially under Linux.

The easiest way to get an up-to-date working code base is to clone the code from here via

git clone https://github.com/OpenHantek/OpenHantek6022.git

and then build it locally, for this you will need the following software:

• CMake 3.12+
• Qt 6.2+
• FFTW 3+ (prebuild files will be downloaded on windows)
• libusb-1.0, version >= 1.0.16 (prebuild files will be used on windows)
• A compiler that supports C++11 - tested with gcc, clang and msvc

We have build instructions available for Linux, Raspberry Pi, FreeBSD, Apple macOS and Microsoft Windows.

To make building for Linux even easier, I provide two shell scripts:

• LinuxSetup_AsRoot, which installs all build requirements. You only need to call this script once (as root) if you have cloned