Technical Articles

Downloading a Custom Waveform to an Arbitrary Waveform Generator

By Adarsh Narasimhamurthy, MathWorks and Eric Wetjen, MathWorks


Function generators are commonly used for testing physical devices, hardware designs, or receiver algorithms. However, they may not always provide the test signal required. In this case, it is necessary to create a custom waveform. With a custom waveform you can incorporate real-world conditions into the device under test. For example, you can generate signals corrupted by noise, or precisely delayed signals.

While creating a custom waveform in MATLAB® is straightforward, downloading it for use can be challenging. One option is to save the custom waveform onto a USB flash drive and transfer it to the instrument. While this procedure works, it cannot be automated. A more efficient approach uses a single MATLAB script to both create a custom waveform and download it to the instrument. However, such a MATLAB script involves writing Standard Command for Programmable Instruments (SCPI) code or using Interchangeable Virtual Instruments (IVI) drivers to connect to and set up the instrument and download the custom signal. Other challenges include the need to identify the right set of SCPI commands, the non-portability of SCPI commands across instruments, and the difficulty of importing and calling functions provided by the IVI driver.

The Quick-Control Function Generator in Instrument Control Toolbox™ greatly simplifies the task of downloading the custom waveform. It provides a simple interface that lets you download a custom waveform to an instrument without programming with an IVI driver or using SCPI commands.

This article demonstrates a simple workflow for creating and downloading custom waveforms to an arbitrary waveform generator (AWG) using MATLAB and Quick-Control Function Generator.

Sample Application: Testing Bandpass Filter Performance Using a Chirp Signal

A quadratic chirp signal is used to characterize and test the response of a bandpass filter hardware prototype to a periodically waxing and waning frequency signal. Using a quadratic chirp avoids the need for manual frequency adjustment, and enables a smooth characterization of the frequency response of the hardware prototype.

Our sample application requires the following quadratic chirp signal:

\[f_i(t)=f_0 + \beta t^2\]

where \(\beta=(f_1-f_0)/t^2\), \(f_i\) is the instantaneous frequency at time \(t\), \(f_0\) is the frequency at time \(t=0\), and \(f_1\) is the frequency at time \(t_1\) specified by the user.

To subject the hardware prototype to real-world conditions, we need to characterize its performance in the presence of additive noise. We create a custom waveform in MATLAB, and then use Quick-Control Function Generator to download and generate this waveform from an off-the-shelf AWG (Figure 1).

Block diagram of Quick Control Function Generator interfacing layers. Contents of dotted line box are abstracted from the user.
Figure 1. Block diagram of Quick-Control Function Generator interfacing layers. Contents of dotted line box are abstracted from the user.

While you can use Quick-Control Function Generator with any AWG that has an IVI-C driver, you do not need to program with the IVI driver. This simplifies the process of writing code to remotely connect to and control the instrument.

The workflow consists of four steps:

  1. Create the signal in MATLAB.
  2. Establish communication with the AWG.
  3. Upload the waveform to the AWG.
  4. Start the waveform generation.

Creating a Signal in MATLAB

The chirp function in Signal Processing Toolbox™ can generate samples of a frequency-swept cosine signal at the time instances defined in array \(t\). To use the chirp function, we need to define the instantaneous frequency at time \(0\), \(f_0\), and the instantaneous frequency at time \(t_1\), \(f_1\). We also have the option of setting the sweep method. We select the quadratic method.

The following MATLAB script generates the chirp signal.

Waveform_fig1a_wl.jpg

The spectrogram command lets us visualize the amplitude and frequency of the signal as a function of time (Figure 2). As the red coloring in the plot shows, the signal energy is most intense at 100 Hz and the frequency ramps down to 50 Hz after 1 second, as we would expect from our signal definition.

Figure 2: Spectrogram of the quadratic chirp signal generated in MATLAB.
Figure 2. Spectrogram of the quadratic chirp signal generated in MATLAB.

To simulate real-world conditions, we inject additive white Gaussian noise into the chirp signal. To do this, we call the randn function, which returns standard normal distributed pseudorandom numbers. We use the following MATLAB code to generate and plot the spectrogram of the noisy signal.

Waveform_fig2a_wl.jpg

The spectrogram plot of the noise-injected quadratic signal shows that the addition of white noise makes the signal energy non-zero at frequencies outside the chirp frequency (Figure 3).

Figure 3: Spectrogram of the noise-injected quadratic chirp signal.
Figure 3. Spectrogram of the noise-injected quadratic chirp signal.

Finally, we use the following MATLAB code to visualize the pure and noise-injected chirp signal in the time domain.

Waveform_fig3a_wl.jpg

While the time domain visualization is an accurate representation of the signal that will come from the AWG (Figures 4 and 5), it is much easier to verify that the signal is correct from the frequency domain spectrogram plots shown in Figure 3. Note that we normalize the noisy waveform to limit the maximum voltage to ±1 V.

Figure 4: Time-domain visualization of the quadratic chirp signal.
Figure 4. Time-domain visualization of the quadratic chirp signal.
Figure 5: Time domain visualization of the noise-injected quadratic chirp signal.
Figure 5. Time-domain visualization of the noise-injected quadratic chirp signal.

Establishing Communication with the AWG

After creating the signal in MATLAB, we create a Quick-Control Function Generator object. We first locate and then connect to the AWG—in our case, an Agilent 33220A Function/Arbitrary Waveform Generator.

To locate the available function generators, we first create an fgen object. We then use the Instrument Control Toolbox getResources function to list the available function generator resources.

Waveform_fig5a_wl.jpg
Waveform_fig5b_wl.jpg

getResources returns all resources available to MATLAB. The GPIB resource GPIB0::10::INSTR corresponds to the AWG. We assign the resource string of the AWG to the Resource property of the object.

Waveform_fig5c_wl.jpg

We can now establish a connection from MATLAB to the AWG.

Waveform_fig5d_wl.jpg
Waveform_fig5e_wl.jpg

Uploading the Waveform to the AWG

Once the connection has been established, we can configure AWG settings such as offset and load impedance to suit the application requirements. We need to configure the instrument to output an arbitrary custom waveform from channel 1.

Waveform_fig5f_wl.jpg

Starting the Waveform Generation from MATLAB

Without Quick-Control Function Generator, it would take many lines of SCPI code or IVI driver code to assign and enable the generation of a custom waveform. With Quick-Control Function Generator it takes a single function call. Further, the same function can be used for any AWG supported by Quick-Control Function Generator.

Waveform_fig5g_wl.jpg

We close the session and remove it from the workspace, first disconnecting the object and then deleting it from MATLAB memory.

Waveform_fig5h_wl.jpg

Unlike SCPI commands, which are not always portable, Quick-Control Function Generator lets you reuse the same code to control an AWG from a different manufacturer by changing only the resource string and driver. Quick-Control Function Generator also provides a simple, high-level interface that lets you download a custom waveform to an instrument without having to learn programming with IVI driver or SCPI commands. The MATLAB script can be reused with any instrument that satisfies the requirements of Quick-Control Function Generator, and it can be shared with other engineers and technicians who have a similar workflow.

Published 2013 - 92074v00

View Articles for Related Capabilities

View Articles for Related Industries