dsoc
============================
'dsoc' - DSO _control - is a small command line utility to remotely control a Tekway/Hantek DSO of the DSO5x02(B) series. It is written in python.
Prerequisite python libraries: pyusb, numpy and PIL (to save screenshots)
The functionality is based on the reverse-engineered USB protocol which can be seen at mikrocontroller.net (German) and elinux.org (English).
It can be invoked as it can be seen below (from running ./dsoc --help). Each sub-command has it's own help page which can be displayed by adding '--help' to the command line.
usage: dsoc [-h] [--show-comm] [--verbose]
{ping,reset,cat,sh,screenshot,beep,samples,settings} ...
Control a Tekway/HANTEK DSO through USB
positional arguments:
{ping,reset,cat,sh,screenshot,beep,samples,settings}
ping Test two-way communication with scope. Return code of
this command is zero when the scope is ready to accept
data.
reset Initialize/reset scope to power-on defaults.
cat Get a file from the scope's internal linux file
system.
sh Execute a command on the scope. WARNING: This command
is VERY DANGEROUS. It is easy to brick the scope and
things like 'r m -rf /' are NOT filtered. You have
been warned!
screenshot Take a screenshot on the scope and save it into a
file.
beep Turn on the buzzer on the scope.
samples Acquire sample data from the scope. Unless selected
otherwise, the output will be two-column ASCII data,
with the first column being time in second and the
second ADC values in volts.
settings Get a description of the current settings from the
scope as a list of keys and values.
optional arguments:
-h, --help show this help message and exit
--show-comm, -c Show communication with DSO on stderr.
--verbose, -v Be verbose about the results of commands.
-- Onno Kortmann onno@gmx.net