====== Digital Discovery - Getting Started Guide ======

~~TechArticle~~

{{ reference:test-and-measurement:digital-discovery:digital-discovery-0.png?nolink&400 |}}

----
==== Unboxing ====

{{ :learn:instrumentation:tutorials:digital-discovery-getting-started-mac:unboxingvideo.mp4?nolink&800 |}}

----
==== Download and Install WaveForms ====

{{ reference:test-and-measurement:digital-discovery:digital-discovery-8.png?nolink&800 |}}

Digilent's WaveForms application provides a user interface to the Digital Discovery. Please download the appropriate WaveForms installer for the operating system (Windows, Linux, Mac) via the [[software:waveforms:waveforms-3:start|WaveForms Resource Center]]. Then click on the appropriate option below for OS-specific installation instructions.

If WaveForms is already installed, please make sure that it is up to date.

----
--> Installing WaveForms : Windows #

<WRAP group>
<WRAP column half>
=== Welcome ===
First 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**.
</WRAP>
<WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:gsg-install-summary.png?nolink |}}
</WRAP>
</WRAP>

<WRAP group>
<WRAP column half>
=== License Agreement ===
Read the license agreement on this screen, then, if in agreement to it, click **I Agree** to continue.
</WRAP>
<WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:gsg-install-license.png?nolink |}}
</WRAP>
</WRAP>

<WRAP group>
<WRAP column half>
=== 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 Digital Discovery 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.//
</WRAP>
<WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:gsg-install-components.png?nolink |}}
</WRAP>
</WRAP>

<WRAP group>
<WRAP column half>
=== Shortcut Options ===
Click **Next**.
</WRAP>
<WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:gsg-install-shortcuts.png?nolink |}}
</WRAP>
</WRAP>

<WRAP group>
<WRAP column half>
=== Choose Install Location ===
Click **Install**.
</WRAP>
<WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:gsg-install-location.png?nolink |}}
</WRAP>
</WRAP>

<WRAP group>
<WRAP column half>
=== Installing / Installation Complete ===
Wait for the Installation to complete, then click **Next**.
</WRAP>
<WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:gsg-install-complete.png?nolink |}}
</WRAP>
</WRAP>

<WRAP group>
<WRAP column half>
=== Complete ===
**Finish**.
</WRAP>
<WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:gsg-install-finish.png?nolink |}}
</WRAP>
</WRAP>

<--

--> Installing WaveForms : Mac #

<WRAP group><WRAP column half>
From the downloads folder, open the downloaded **.dmg** file.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-open-package-1.png?nolink |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
From the desktop, open the **WaveForms** drive.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-open-package-2.png?nolink |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
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
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-open-package-3.png?nolink |}}
</WRAP></WRAP>
----

--> Install Drivers : Only for OS-X 10.13 or earlier #

For OS-X 10.14 Mojave or later, if the Digilent FTDI Driver is installed, the device may not be detected. 

**Skip this section if the OS version is newer than OS-X 10.13.**

----
<WRAP group><WRAP column half>
=== Launch Installer ===
Double click **DigilentFtdiDriver.pkg** to open the FTDI Driver Installer.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-install-driver-1.png?nolink |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
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**.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-open-waveforms-security.png?nolink |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== Introduction ===
Click **Continue**.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-install-driver-2.png?nolink |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== Read Me ===
Click **Continue**.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-install-driver-3.png?nolink |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== License ===
Read the license, then if in agreement, click **Continue**, then click **Agree** in the popup.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-install-driver-4.png?nolink |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== Destination Select ===
Pick the users to install the drivers for, then click **Continue**.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-install-driver-5.png?nolink |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== Installation Type ===
Click **Install**.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-install-driver-6.png?nolink |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== Summary ===
Once the installation has completed, click **Close**.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-install-driver-7.png?nolink |}}
</WRAP></WRAP>

<--

----
<WRAP group><WRAP column half>
The OS may block the launch of WaveForms when it is opened for the first time. If this is the case, go into the System Preferences' Security and Privacy page and click **Open Anyway**.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-open-waveforms-security.png?nolink |}}
</WRAP></WRAP>

<--

--> Installing WaveForms : Linux #
<WRAP group>
First, download the package for the [[software:adept:start|Adept Runtime]]. This program is required for WaveForms to connect to the Digital Discovery 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. \\

<WRAP group><WRAP column half>
=== Download Adept Runtime ===

  * Download the correct version of Adept. The link for Adept downloads is located [[/digilent_adept_2|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.
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:analog-discovery-2-getting-started-linux:lin-step1.jpg?nolink |Download Adept.}}
</WRAP></WRAP>
------------
--> Install Files using built-in Package Manager #
<WRAP group><WRAP column half>
=== Open the Adept File ===
Open the file you downloaded for Adept in the previous step.\\
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:analog-discovery-2-getting-started-linux:lin-step2.jpg?nolink |Open the Adept File.}}
</WRAP></WRAP>
----------
<WRAP group><WRAP column half>
=== Click Install ===
Click "Install" on the window that pops up.\\

</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:analog-discovery-2-getting-started-linux:lin-step3.jpg?nolink |Click Install.}}
</WRAP></WRAP>
\\
-------------
<WRAP group><WRAP column half>
=== Open the WaveForms File ===
Open the file you downloaded to install WaveForms.
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:analog-discovery-2-getting-started-linux:lin-step4.jpg?nolink |Open the WaveForms File.}}
</WRAP></WRAP>
--------------
<WRAP group><WRAP column half>
 === 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
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:analog-discovery-2-getting-started-linux:lin-step5.jpg?nolink |Click Install.}}
</WRAP></WRAP>
--------------
<--
--> 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:

<code>
sudo dpkg -i <path to Adept Runtime .deb file>
sudo dpkg -i <path to WaveForms .deb file>
sudo apt-get install -f
</code>
<--

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:

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

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 the Test and Measurement section of the [[https://forum.digilent.com|Digilent Forum]].

</WRAP>

<--
/*-->Installing WaveForms : 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 [[software:waveforms:waveforms-3:start|from the website]]. We will be using Raspberry Pi 4 Model B 1 GB version in this tutorial. The 2 GB and the 4 GB versions of the Raspberry Pi 4 Model B also work with this tutorial.
----
<WRAP group><WRAP column half>
=== 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.
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:ad2-waveforms2015-installation-rpi:ARM_debian_option.png?600 |Select installation file.}}
</WRAP></WRAP>
---------
<WRAP group><WRAP column half>
=== Download Adept 2 ===
Download the correct version of [[/software/adept/start|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. 
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:ad2-waveforms2015-installation-rpi:Adept2_RPi_RuntimeUtilitiesDownload.png?600 |Download Adept 2.}}
</WRAP></WRAP>
------------
<WRAP group><WRAP column half>
=== Open the Adept 2 File ===
Open up the file you downloaded for Adept 2 in Step 2. 
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:ad2-waveforms2015-installation-rpi:DoubleClick_AdeptRuntimeDownload.png?600 |Open the Adept 2 file.}}
</WRAP></WRAP>
-------------
<WRAP group><WRAP column half>
=== Click Install ===
Click "Install" in the window when prompted. 
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:ad2-waveforms2015-installation-rpi:InstallAdeptRuntime.png?600 |Install.}}
</WRAP></WRAP>
-----------
<WRAP group><WRAP column half>
=== Open the WaveForms File ===
Open the file you downloaded to install WaveForms.  
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:ad2-waveforms2015-installation-rpi:DoubleClick_WaveFormsDownload.png?600 |Open the WaveForms file.}}
</WRAP></WRAP>
-----------
<WRAP group><WRAP column half>
=== Click Install ===
Click "Install" in the window when prompted. 
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:ad2-waveforms2015-installation-rpi:Install_WaveForms.png?600 |Install WaveForms.}}
</WRAP></WRAP>
-----------
<WRAP group><WRAP column half>
=== Open WaveForms ===
Go to your applications and open WaveForms.
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:ad2-waveforms2015-installation-rpi:DoubleClick_WaveForms_Launch.png?600 |Open WaveForms.}}
</WRAP></WRAP>

<--*/

/*--> Installing WaveForms : Raspberry Pi #
<WRAP group>
{{section>reference:test-and-measurement:guides:getting-started-with-raspberry-pi#installing_waveforms_on_raspberry_pi&noheader}}
</WRAP>
<--*/
----

==== Take a Measurement ====

{{ :learn:instrumentation:tutorials:digital-discovery-getting-started-windows:17.png?nolink&800 |}}

This section walks through using the Digital Discovery for the first time. Four digital output pins are connected to four digital input pins, and a pattern of type Binary Counter is generated and captured via this simple loopback circuit.

--> Take a Measurement #

<WRAP group><WRAP column half>
=== 1. Plug in your Digital Discovery === 
Plug in the Digital Discovery to the computer via the USB cable.
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:digital-discovery-getting-started-mac:31595015463_038669b0e5_b.jpg?nolink&400 |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== 2. Select Your Device === 
Select the Digital Discovery in the Device Manager. The Device Manager can be accessed anytime from the main toolbar. Open the settings menu and select Device Manager. 
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:digital-discovery-getting-started-windows:9.png?nolink&600 |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== 3. Start the Pattern Generator ===
  * Open the Pattern Generator by clicking Patterns. 
  * Click on the green plus sign and select BUS. 
  * Select DIO 28-31, and click the green plus sign. 
  * Click Add.
  * In the type column, use the drop-down to select Binary Counter. 
  * Click Run. Your screen should look like the image above. 
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:digital-discovery-getting-started-windows:17.png?nolink&600 |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== 4. Start the Logic Analyzer===
  * Go to the main window and click Logic to open the Logic Analyzer.
  * Set the Base to 1ms/div, this will allow us a better window to see the data. 
  * Click the green plus sign and select Bus.
  * In the window that appears select DIO 24-27.
  * Click Add and the window will close.
  * Click Run.
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:digital-discovery-getting-started-windows:19.png?nolink&600 }}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== 5. Take a Measurement ===
Connect DIO 24-27 to DIO 28-31.
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:digital-discovery-getting-started-mac:32406042075_6bfbe74574_b_1_.jpg?nolink&600 }}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== 6. View your First Measurement ===
Congratulations! In the logic analyzer window you should see a binary counter. The individual signals are displayed as well as the decoded decimal value. 

You've now decoded your first Digital Bus. Keep playing around with the tools and visit [[https://forum.digilent.com|forum.digilent.com ]] for questions or technical issues. 
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:digital-discovery-getting-started-windows:21.png?nolink&600 }}
</WRAP></WRAP>

<--

----
==== Next Steps ====
For additional resources visit the [[test-and-measurement:digital-discovery:start|Digital Discovery Wiki Page]]. There you'll find the reference manuals, tutorials, downloads, a Fritzing image and more.

For detailed steps about how to install and use WaveForms on Raspberry Pi, follow this guide: [[test-and-measurement:guides:getting-started-with-raspberry-pi]].

For technical support, please visit the Test and Measurement section of  [[https://forum.digilent.com|Digilent Forum]].
----
{{tag>learn instrumentation tutorial digital-discovery}}