# DSRemote
Operate your Rigol oscilloscope from your Linux desktop.
========================================================

webpage and info: https://www.teuniz.net/DSRemote/


Requirements
------------

DSRemote is a GNU/Linux & GCC & GNU Make project. Other platforms, tools or compilers are not supported.
This is not going to change. I mean it.

DSRemote requires a little-endian system. DSRemote does not work with a CPU with a big-endian architecture.
This is also not going to change.


Warning
-------
This is a private project made available to the public. No pullrequests!
If you believe you found a bug or want to add some feature, open an issue on Gitlab or send me an email.
In case you want to add some code, send me a diff, no pull requests, they will be ignored.
Also, all requests regarding to support other platforms and/or other tools will be ignored.
Again, this a Linux & GCC & Make project. That means no Mac/windows/Clang/CMake etc.


Compiling and installing on Debian Linux and derivatives (Ubuntu, Mint, Raspberry Pi OS, etc.)
----------------------------------------------------------------------------------------------

sudo apt update
sudo apt install build-essential g++ make git qtbase5-dev-tools qtbase5-dev
git clone https://gitlab.com/Teuniz/DSRemote.git
cd DSRemote
qmake
make -j8
sudo make install
dsremote


Compiling and installing on Fedora
----------------------------------

sudo dnf update
sudo dnf group install "development-tools"
sudo dnf install g++ qt5-qtbase qt5-qtbase-devel
git clone https://gitlab.com/Teuniz/DSRemote.git
cd DSRemote
qmake
make -j8
sudo make install
dsremote


Compiling and installing on OpenSuse
------------------------------------

sudo zypper refresh
sudo zypper install -t pattern devel_basis devel_C_C++ devel_qt5
git clone https://gitlab.com/Teuniz/DSRemote.git
cd DSRemote
qmake-qt5
make -j8
sudo make install
dsremote


For USB connection setup use the following commands:
----------------------------------------------------

sudo groupadd usbtmc
sudo usermod -a -G usbtmc <username>
reboot

Now you can run the program by typing: dsremote

(USB connection does not work on modern USB host controllers thanks to
a bug in the scopes' firmware that Rigol does not want to fix.)

 Read also the file readme_usbtcm_driver.txt
 and the file notes.txt.


Supported devices
---------------

DS6000 and DS1000Z series oscilloscopes.

### MSO4000/DS4000 series

There is some basic support like capturing screenshots.

Not tested yet:

* Record & Playback function
* Wave Inspector
* serial decoding.