WaveForms Getting Started Guide

Overview

WaveForms is the virtual instrument suite for Electronics Explorer, Digital Discovery, Analog Discovery, Analog Discovery 2 and Analog Discovery Studio devices.
It configures, calibrates, and controls the Test and Measurements various devices. Through WaveForms you have access to all the board's Instruments. Go to the WaveForms Resource Center and download the latest version of WaveForms.

Guide

Download and Install Waveforms

Windows

Open the Executable File

Open the executable file that you downloaded.


Welcome

Launch the WaveForms installer, by clicking on it in the Downloads folder. Upon launching the WaveForms installer, the welcome page will be seen. Click Next.


License Agreement

Read the license agreement on this screen, then, if in agreement to it, click I Agree to continue.


Choose Components

In the “Choose Components” screen, a list is presented of each of the things that can be installed. In order to use the Analog Discovery 2 with the WaveForms application, the Adept Runtime, WaveForms Runtime, and WaveForms Application are required.

  • The Adept Runtime allows WaveForms to communicate with the Analog Discovery 2, Analog Discovery, Analog Discovery Studio, Digital Discovery, and Electronics Explorer Board.
  • The WaveForms Runtime contains a library and device support files needed to run custom applications.
  • The WaveForms Application is the Digilent virtual instrumentation interface.
  • The WaveForms SDK is the software development kit for creating custom applications

Note: Even with all components selected, the WaveForms install does not take much hard drive space (<200MB). Digilent recommends that all components are installed.


Shortcut Options

Click Next.


Choose Install Location

  • You'll need to choose an installation destination or just leave it at the default.
  • Click “Install”.


Installing / Installation Complete

  • WaveForms will be installed as indicated by the progress bar.
  • Click “Next”.


Complete

  • Check or uncheck the boxes to open WaveForms and the readme.
  • Click “Finish”.


Mac

Download WaveForms

This tutorial will guide you through the steps involved in the installation process on Windows after downloading it.


Expand your downloads and open the .dmg file that you have downloaded.

Open the DMG File.


From the desktop, open the WaveForms drive.

Open the New Drive.


Drag the WaveForms icon into the Applications folder.
This will install the following components in Applications:

  • WaveForms Runtime contains a library and device support files needed to run custom applications.
  • WaveForms Application is the Digilent virtual instrumentation interface.
  • WaveForms SDK is the software development kit for creating custom applications


Install Drivers : Only for OS-X 10.13 or earlier

Double click the FTDI driver icon to start the installation process.
On MacOS (10.13) Sierra High and older versions the device driver should be installed to support Analog Discovery 1 & 2 and Digital Discovery devices.
On MacOS (10.14) Mojave, the device driver is not required. According to some reports, on new MacBook machines the device is not detected if the driver is installed, so uninstall the driver if the device does not connect.

Open the FTDI Diver Install.


Launch Installer

Double click DigilentFtdiDriver.pkg to open the FTDI Driver Installer.


The OS may block the launch of the driver installer. If this is the case, go into the System Preferences' Security and Privacy page and click Open Anyway.


Introduction

Click Continue.


Read Me

Click Continue.


License

Read the license, then if in agreement, click Continue, then click Agree in the popup.


Destination Select

Pick the users to install the drivers for, then click Continue.


Installation Type

Click Install.


Summary

Once the installation has completed, click Close.

The OS may block the launch of the Waveforms . If this is the case, go into the System Preferences' Security and Privacy page and click Open Anyway.

Linux

Download WaveForms

This tutorial will guide you through the steps involved in the installation process on Windows after downloading it.

First, download the package for the Adept Runtime. This program is required for WaveForms to connect to the Analog Discovery 2 and must be installed prior to installing WaveForms.
For systems using .deb packages, (Ubuntu, Fedora, etc), use the built-in package manager to install the Adept Runtime and then WaveForms - typically, a package manager can be opened by double-clicking on the file in question.

Download Adept Runtime

  • Download the correct version of Adept. The link for Adept downloads is located here.
  • Make sure the version of the Adept install file is the same as WaveForms. I used the 64 bit RPM for WaveForms so I will use the 64 bit RPM for Adept.

Download Adept.


Install Files using built-in Package Manager

Open the Adept File

Open the file you downloaded for Adept in the previous step.

Open the Adept File.


Click Install

Click “Install” on the window that pops up.

Click Install.



Open the WaveForms File

Open the file you downloaded to install WaveForms.

Open the WaveForms File.


Click Install

Click Install in the window that pops up.
This will install the following components:

  • WaveForms Runtime contains a library and device support files needed to run custom applications.
  • WaveForms Application is the Digilent virtual instrumentation interface.
  • WaveForms SDK is the software development kit for creating custom applications

Click Install.


Install Files using command line
Alternatively, use the following set of commands in the terminal to install the Adept Runtime and WaveForms from the downloaded packages:
sudo dpkg -i <path to Adept Runtime .deb file>
sudo dpkg -i <path to WaveForms .deb file>
sudo apt-get install -f

For systems using .rpm packages, (Red Hat Linux, etc), use the following set of commands in the terminal to install the Adept Runtime and WaveForms from the downloaded packages:

sudo rpm -i <path to Adept Runtime .rpm file>
sudo rpm -i <path to WaveForms .rpm file>

If WaveForms has already been installed on the system, replace the “-i” flag passed to the rpm command with “-U” to upgrade the existing installation.

For technical support with installing WaveForms on various Linux distributions, please visit to the Scopes and Instruments section of the Digilent Forum.

Raspberry Pi 4 Model B
This tutorial will guide you through the steps involved in the installation process on a Raspberry Pi 4 Model B after downloading it from the website. We will be using Raspberry Pi 4 Model B 1 GB version in this tutorial. The 2 GB and 4 GB versions of the Raspberry Pi 4 Model B also work with this tutorial.

Download WaveForms

Download the correct installation file for WaveForms for your distribution of Linux. Since we are using a Raspberry Pi 4 Model B with the Raspbian OS, we will choose the Debian flavor of the ARM build.

Select installation file.


Download Adept 2

Download the correct version of Adept 2. Make sure that the version of the Adept install file is the same as WaveForms. We chose the ARM version for WaveForms, so we will use the ARM version of both the Runtime and Utilities for Adept.

Download Adept 2.


Open the Adept 2 File

Open up the file you downloaded for Adept 2 in Step 2.

Open the Adept 2 file.


Click Install

Click “Install” in the window when prompted.

Install.


Open the WaveForms File

Open the file you downloaded to install WaveForms.

Open the WaveForms file.


Click Install

Click “Install” in the window when prompted.

Install WaveForms.


Open WaveForms

Go to your applications and open WaveForms.

Open WaveForms.



Using WaveForms for the First Time

Windows

No Device Connected

When WaveForms initially opens, if you have no device plugged in it will give you a warning that no device was detected.

No device connected.


Run Demo Mode

That's okay, because WaveForms offers a demo mode where you can try out the features without having a compatible device.

Run demo mode.

Oscilloscope in Demo Mode

For example, here is a demonstration of the oscilloscope scoping a square amd sine wave.

Oscilloscope in demo mode.


Device Connected

When you plug in your Analog Discovery 2 it will appear on the device manager and you can then select it to connect to it.

Device connected.

Mac

Open Demo Mode

We can run demo mode to get a feel for the interface and capabilities of WaveForms without having a device attached.

Click on “Demo Mode” and then click “Select”.

Open demo mode.


Open Oscilloscope in Demo Mode

Open the oscilloscope tool and select “Play”. You can see a square and sine wave being demonstrated.

Open oscilloscope.


Plug in and Select Device

When you plug in your device it will appear in the Device Manager.

Plug in AD2.

Linux

No Device

If you don't have device plugged in, a window will pop up with a warning stating that no device was detected. You don't need to have a device to run the software, so go ahead and click “OK” to proceed.

No device.


Run Demo Mode

The device manager will now open. Click on “Demo Mode”, and then click “Select”.

Run demo mode.


Demo Mode Oscilloscope

As mentioned previously, if you don't have an Analog Discovery 2 yet, that's okay. You can still run WaveForms in demo mode and get a feel for the interface and capabilities. The below image is a demo of the oscilloscope displaying a sine and square wave.

Demo mode oscilloscope.


Plug in device

If you plug in your device, a window will pop up indicating that it was detected. Select “OK” to proceed.

Detected device.


Device Manager

If you open the device manager, or you have the device plugged in when WaveForms is open, the window displayed in the image below will appear. Select the Analog Discovery 2, for example, just as you did for demo mode.

Device manager.

Raspberry Pi 4 Model B

No Device

If you don't have a Test and Measurement device plugged in, a window will pop up with a warning stating that no device was detected. You don't need to have a device to run the software, so go ahead and click “OK” to proceed.

No device.


Run Demo Mode

The device manager will now open. Click on “Demo Mode”, and then click “Select”.

Run demo mode NEED SS.


Demo Mode Oscilloscope

You can run WaveForms in demo mode and get a feel for the interface and capabilities. The below image is a demo of the oscilloscope displaying a sine and square wave.

Demo mode oscilloscope.

Plug in Analog Discovery 2

The Raspberry Pi 4 has two blue USB 3.0 ports; it is recommended that one of these ports is used to plug in the Analog Discovery 2.

Blue USB 3.0 ports

Analog Discovery 2 connected to a blue USB 3.0 port

If you plug in the Analog Discovery 2, a window will pop up indicating that it was detected. Select “Yes” to proceed.

Detected device NEED SS.


Device Manager

If you open the device manager, or you have the Analog Discovery 2 plugged in when WaveForms is open, the window displayed in the image below will appear. Select the Analog Discovery 2 labeled as Discovery2 with a serial number.

Device manager.


Check out the Tools

Note the welcome menu on the left hand side. From this menu you can launch each of the tools.

Check out the Tools.


Start the WaveForm Generator

Open the WaveForm Generator, and click “run”.

Start the WaveForms Generator.


Start the Oscilloscope

Open the Oscilloscope, and click “run”.

Start the Oscilloscope.


Take a Measurement

Plug the yellow wire (Waveform Generator 1) into the orange wire (Oscilloscope Channel 1 positive.) Plug any black wire (ground) into the orange wire with the white stripe (Oscilloscope Channel 1 negative.)

Take a Measurement.


View your First Measurement

Open the Oscilloscope to see your first measurement! To learn more about the tools, please visit our support page.

View your First Measurement!

Additional Resources

For additional resources visit the WaveForms Resource Center. There you'll find the reference manuals, tutorials, downloads, and more.