Oscilloscope

KO | EN

gitlite — search

#hacktoberfest #api #php #golang #css #c-sharp #discourse-plugin #rails #drupal #jekyll #information-retrieval #vim

★ 42 Open GitHub ↗

C# Oscilloscope Library and GUI (tested with Rigol DS1102E)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# C# Oscilloscope Library and GUI (tested with Rigol DS1102E)

Remote control your oscilloscope, configure settings and acquire data points

## Projects

- OscilloscopeLib is an object-oriented library for managing Rigol's Oscilloscopes (tested with DS1102E only, but should works with other models too)

- OscilloscopeCLI is a command line sample, showing how to use OscilloscopeLib

- OscilloscopeGUI is a GUI for easy data acquisition and display

- OscilloscopeTest contains Unit Tests for easily checking if your own oscilloscope model is compliant with library

## Requirements

To compile the project you need:

- .NET Framework 4.8

- Visual Studio 2022 with .NET desktop development workload installed

- NI-VISA .NET SDK 2024 Q4 [http://www.ni.com/download/ni-visa-run-time-engine](https://www.ni.com/en/support/downloads/drivers/download.ni-visa.html)

To run the project you need:

- NI-VISA .NET Runtime 2024 Q4 [http://www.ni.com/download/ni-visa-run-time-engine](https://www.ni.com/en/support/downloads/drivers/download.ni-visa.html)

- Gnuplot 5.2 (optional for graphs, 25 MB) http://www.gnuplot.info/ see GNUPLOT section for more informations

## Screenshoots

![alt text](https://raw.githubusercontent.com/electro-logic/Oscilloscope/master/Docs/gui.png)

*OscilloscopeGUI*

![alt text](https://raw.githubusercontent.com/electro-logic/Oscilloscope/master/Docs/gnuplot.png)

*Automatically generated Gnuplot graph (zoomable)*

## Example of OscilloscopeLib usage (from OscilloscopeCLI)

```
// 1M data point acquisition
void LongMemoryAcquisitionExample()
{
    var rigol = new Oscilloscope();
    rigol.Run();
    rigol.SetWaveformPointsMode(PointsMode.Maximum);
    rigol.SetAcquireMemoryDepth(AcquireMemoryDepth.Long);
    rigol.SetTriggerSweep(TriggerSweep.Single);
    rigol.WaitTriggerStop();
    rigol.Stop();
    var wave = rigol.Channel1.GetWaveform();
    wave.SaveCSV(csvFileName);
    rigol.Close();
}
```

Then you can graph your acquired data with Excel or GnuPlot

```
// Display acquired data with Excel (or any other installed software that can handle CSV)
Process.Start(csvFileName);

// Draw a graph with GNU Plot and save it as .png image
GnuPlot gnuPlot = new GnuPlot();
gnuPlot.DrawGraph(csvFileName, 1);   // only channel 1
```

## Notes

This project started as auxiliary tool for a bigger project, so code may not be production-quality. If there is interest I can improve it, anyway any contribution is welcome.

I initially wrote this library in 2014 to track the velocity profile of a stepper motor, driven by a real-time driver that I have built.

I think that this project can be useful to people who own a Rigol oscilloscope, so I updated it with NI-VISA 2024 Q4 to support Windows 11.

Here are some images to better understand what this library allow you to do with very little work.

![alt text](https://raw.githubusercontent.com/electro-logic/Oscilloscope/master/Docs/oscilloscope.png)

*Oscilloscope display*

![alt text](https://raw.githubusercontent.com/electro-logic/Oscilloscope/master/Docs/speed_graph.png)

*Data acquired and processed with the aid of this library and a graph of velocity of the system produced*

You can also write some C# code to post-process CSV data and extrapolate relevant information for your application (ex. I used it to get velocity profile of my system from the waveform of a revolution detector).

## VISA SDK

Rigol oscilloscope support Virtual Instrument Software Architecture (VISA) standard for configuring, programming, and troubleshooting instrumentation systems.

To create software that support VISA devices you need to install the NI-VISA SDK:

Assembly referenced by OscilloscopeLib are located into:

- C:\Program Files (x86)\IVI Foundation\VISA\Microsoft.NET\Framework32\v2.0.50727\VISA.NET Shared Components 7.2.0\Ivi.Visa.dll     v7.2.0.0

- C:\Program Files (x86)\IVI Foundation\VISA\Microsoft.NET\Framework32\v4.0.30319\NI VISA.NET 23.3\NationalInstruments.Visa.dll     v23.3.0.49276

Documentation and Programming Guide:

[Rigol Prograrmming Guide](https://eu.rigol.com/eu/Images/DS1000E_ProgrammingGuide_EN_tcm30-2863.pdf)

[DS1000E Waveform Data Formatting Guide](https://rigol.my.site.com/support/s/article/DS1000E-Waveform-Data-Formatting-Guide)

## GNUPLOT

Graphs are generated with Gnuplot to avoid reinventing the wheel. Data can be analyzed and graphed also with Excel or any software that can open CSV files.

Gnuplot 5.2 (for graphs, optional)

http://www.gnuplot.info/

**NB:** Gnuplot keyboard commands to interact with graph are available at Gnuplot command line (just launch gnuplot.exe from Start) with the command "show bind", here are reported some:

- a		autoscale
- \+	zoom in
- \-	zoom out

Right click with the mouse to zoom a section of the graph

*Warning:* Graph with 1M points can be slow to display and interact, another way can be analyzing data with Excel or another software

## ADDITIONAL NOTES

For legacy systems (Windows XP, etc..) an old NI-VISA 3.0 Runtime download (3 MBytes) is distributed by Rigol with the UltraSigma software and can avoid downloading the most recent package that is much larger. NI-VISA 5.4.1 Runtime download (74 MBytes) is available for OS up to Windows 8. To avoid the NI-VISA Runtime (few Gigabytes), please have a look at the branch https://github.com/electro-logic/Oscilloscope/tree/TinyDriver that needs a tiny driver (24 KBytes) only.

DS1102E firmware v00.04.04.00.00 (AUG 2020) is breaking the "Long Memory", it's advised to NOT update the firmware. Please also see https://www.eevblog.com/forum/testgear/rigol-ds1052e-firmware-v00-04-04-00-00-from-20200827

## OSZI WAVEFORM ANALYZER

Another interesting project to capture and analyze data from Rigol oscilloscopes: https://github.com/Elmue/Oszi-Waveform-Analyzer

Oscilloscope

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README