VirtualInstruments < IoT_Course

---+ Virtual Instruments
---++ Introduction

Measurement instruments like multi-meters, pulse generators or oscilloscopes can be rather costly and the requirements for the !IoT course are rather modest with respect to signal height (we have either digital signals of 0 or 3.3V or analogue signals in the same range) or with respect to frequency (a few kHz max).

The ESP32 has a Digital to Analogue Converter (DAC), which can be uses to generate signals of any shape, and it has an ADC which can be used to sample analogue signals.

Three types of instruments have been implemented:
   * a signal generator
   * a voltmeter
   * an oscilloscope
Of course all of these instruments are extremely basic, but they fulfil the requirements of this course.

Each of the instruments consists of a TCP server running of the ESP. This server generates the analogue signal for the pulse generator using the 8-bit DAC provided by the ESP32 or samples the analogue signal to be measured using its ADC in case of the voltmeter and the oscilloscope.

An application with a <b>G</b>raphical <b>U</b>ser <b>I</b>nterface (GUI), created with the Qt5 library implements a TCP client that connects to the server, gets the measured data from it and displays them in a user-friendly manner. Measurement parameters, like the pulse shape and frequency in case of the pulse generator can also be set using GUI elements.
---++ A Virtual Voltmeter

The simplest of the virtual instruments is certainly the Voltmeter. The analogue signal level must be connected to GPIO 36 (first ADC channel). Then the <i>voltmeterServer.py </i>must be started on the ESP32:

<img alt="voltmeter_server.png" height="216" src="%ATTACHURL%/voltmeter_server.png" title="voltmeter_server.png" width="704" />

As you can see, the server has IP: 192.168.1.98 (this will very probably be different on your machine) and it waits for connections requests on port 5000.

Once the server is running you can start the GUI application on the PC and connect to the server (in the example above the PC has IP 192.168.1.36). Once the connection is established the signal level is shown in analogue form (the gauge) as well as in digital form. The values are in volts.

<img alt="voltmeter.png" height="352" src="%ATTACHURL%/voltmeter.png" title="voltmeter.png" width="448" />
---++ The pulse generator

The pulse generator provides 4 different pulse shapes:
   * rectangular
   * triangular
   * sawtooth
   * sine wave
It works on the same principles as the voltmeter: The _pulseGenServer.py_ is a TCP server which allows connection from a GUI application _pulseGenGUI.py_ serving as TCP client. This application controls the settings of the pulse generator sending commands to the _pulseGenServer_:
   * select pulse shape
   * select frequency
   * select pulse height
   * start pulse generation
It has a display that shows how the signal will look like if measured on an oscilloscope.
| <img alt="pulseGenRectsmall.png" height="246" src="%ATTACHURL%/pulseGenRectsmall.png" title="pulseGenRectsmall.png" width="400" /> | <img alt="pulseGenTriagsmall.png" height="246" src="%ATTACHURL%/pulseGenTriagsmall.png" title="pulseGenTriagsmall.png" width="400" /> |
| <img alt="pulseGenSawsmall.png" height="246" src="%ATTACHURL%/pulseGenSawsmall.png" title="pulseGenSawsmall.png" width="400" /> | <img alt="pulseGenSinsmall.png" height="246" src="%ATTACHURL%/pulseGenSinsmall.png" title="pulseGenSinsmall.png" width="400" /> |
As we can see, there is an additional knob to control the pulse height and there are 2 menus, the first of which controls the sample frequency of the generator, while the other one controls the simulated sampling frequency of an oscilloscope. In the above examples the generator works at 5 kHz while the simulated oscilloscope takes samples at 2 KHz which means that 2.5 complete signal pulses are seen.

A pulse consists of 500 samples and is constantly repeated. The generator sample frequency is the frequency at which samples are emitted. These frequencies are pretty low, but they are adapted to the analogue bandwidth of the ESP32 ADC channels which will be used for the virtual oscilloscope application. The maximum sample frequency is 5 kHz, which corresponds to 200 us between samples, and a pulse length of 500 * 0.2 ms = 100 ms and therefore a pulse frequency of 10 Hz.

The generator pulse frequency is entirely controlled by software delays, which have been calibrated with a physical oscilloscope:

<img alt="rect.png" height="677" src="%ATTACHURL%/rect.png" title="rect.png" width="820" />

The image shows the oscilloscope trace for a square pulse at 5 kHz. A pulse length of 100 ms is expected, and we can see that the time between the markers, corresponding to 2 pulses, reads 201 ms.

-- %USERSIG{UliRaich - 2021-05-15}%

---++ Comments

%COMMENT%

Attachments

Topic attachments
I	Attachment	History	Action	Size	Date	Who
png	pulseGenRectsmall.png	r1	manage	30.7 K	2021-05-16 - 11:54	UliRaich
png	pulseGenSawsmall.png	r1	manage	34.0 K	2021-05-16 - 11:54	UliRaich
png	pulseGenSinsmall.png	r1	manage	35.6 K	2021-05-16 - 11:54	UliRaich
png	pulseGenTriagsmall.png	r1	manage	35.7 K	2021-05-16 - 11:54	UliRaich
png	rect.png	r1	manage	80.0 K	2021-05-16 - 12:08	UliRaich
png	voltmeter.png	r1	manage	25.9 K	2021-05-16 - 08:30	UliRaich
png	voltmeter_server.png	r1	manage	26.5 K	2021-05-16 - 08:31	UliRaich

This topic: IoT_Course_English > WebHome > VirtualInstruments
Topic revision: r3 - 2021-05-16 - UliRaich