====== Analog Discovery 3 Getting Started Guide ======

~~TechArticle~~

{{:test-and-measurement:analog-discovery-3:analog-discovery-3-unbox-3.png?800}}

===== Overview =====
This guide will get you started with your new Analog Discovery 3, from getting it out of the box to taking your first measurement.

----
===== Inventory =====
  * Your new Analog Discovery 3
  * A computer, with the WaveForms application (version 3.20.1 or later) installed.
    * Installation instructions can be found in Step 2 of this guide.

Register your AD3 and access the WaveForms installer for your operating system here: [[https://digilent.com/discovermore|Discover More]].

----
===== Guide =====
==== 1. Unboxing ====
<WRAP group><WRAP column half>
The Analog Discovery 3 and its accessories come in a reusable project box.
</WRAP><WRAP column half>
{{:test-and-measurement:analog-discovery-3:analog-discovery-3-unbox-1.png?400|}}
</WRAP></WRAP>
--------------

<WRAP group><WRAP column half>
Take out your Analog Discovery 3.
  * Take note of the 2x15-pin connector, USB Type-C® connector, and barrel jack connector for external power.
</WRAP><WRAP column half>
{{:test-and-measurement:analog-discovery-3:analog-discovery-3-unbox-2.png?400|}}
</WRAP></WRAP>
--------------

<WRAP group><WRAP column half>
Remove the accessories from the box.
  * Included with the Analog Discovery 3 are five 6-pin male headers, one USB Type-C® cable, one 2x15-pin flywire assembly, flywire labels, and info cards.
</WRAP><WRAP column half>
{{:test-and-measurement:analog-discovery-3:analog-discovery-3-unbox-3.png?400|}}
</WRAP></WRAP>
--------------


==== 2. Download and Install WaveForms ====

Digilent's WaveForms application provides a user interface to the Analog Discovery 3. Please download the appropriate WaveForms installer for the operating system (Windows, Linux, Mac). You can find WaveForms downloads on the My Products section of this website. Register your AD3 and access your installer here: [[https://digilent.com/discovermore|Discover More]].

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>
=== Open the Executable File ===
Open the executable file that you downloaded.
</WRAP>
<WRAP column half>
{{test-and-measurement/analog-discovery-3/download.png?nolink&600 |}}
</WRAP>
</WRAP>
---------------
<WRAP group>
<WRAP column half>
=== 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**.
</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 Analog Discovery 3 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 3, 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>
{{ test-and-measurement/analog-discovery-3/windows-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 ===
  * You'll need to choose an installation destination or just leave it at the default.
  * 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 ===
  * WaveForms will be installed as indicated by the progress bar.
  * 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 ===
  * Check or uncheck the boxes to open WaveForms and the readme.
  * Click "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>
Expand your downloads and open the **.dmg** file that you have downloaded.
</WRAP>
<WRAP column half>

{{ :learn:instrumentation:tutorials:analog-discovery-2-getting-started-mac:mac-step1.jpg?nolink |Open the DMG File.}}
</WRAP>
</WRAP>
----
<WRAP group><WRAP column half>
From the desktop, open the **WaveForms** drive.
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:analog-discovery-2-getting-started-mac:mac-step2.jpg?nolink |Open the New Drive.}}
</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#
<WRAP group>
<WRAP column half>
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.\\
</WRAP><WRAP column half>
{{ :learn:instrumentation:tutorials:analog-discovery-2-getting-started-mac:mac-step4.jpg?nolink |Open the FTDI Diver Install.}}
</WRAP></WRAP>
----

<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 the **Waveforms **. 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 Analog Discovery 3 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>

<--

----
==== 3. Take a Measurement ====

This section walks through using the Analog Discovery 3 for the first time. An analog output pin is connected to an analog input pin, and a waveform is generated and captured via this simple loopback circuit.

--> Take a Measurement - Steps #
<WRAP group>
<WRAP group><WRAP column half>
=== Plug in your Analog Discovery 3 ===
Plug the USB C cable into your computer and Analog Discovery 3.

=== Set up a Loopback Circuit ===
Plug the yellow wire ("W1", Waveform Generator 1) into the orange wire ("1+", Oscilloscope Channel 1 Positive) Plug any black wire (down arrow symbol, Ground) into the orange wire with the white stripe ("1-", Oscilloscope Channel 1 Negative).
</WRAP><WRAP column half>
{{ test-and-measurement/analog-discovery-3/first-measurement-hardware-setup.png?800 }}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== Launch WaveForms ===
Launch WaveForms. Upon launch, WaveForms will automatically detect and connect to the Analog Discovery 3.
If the Analog Discovery 3 is not connected to the host computer when WaveForms launches, the Device Manager will be launched. Make sure that the device is plugged in and turned on, at which point it will appear in the Device Manager's device list (1). Click on the device in the list to select it, then click the Select button (2) to close the Device Manager.

**Note:** //“DEMO” devices are also listed, which allow the user to use WaveForms and create projects without a physical device.//

**Note:** //The Device Manager can be opened by clicking on the device identifier button at the bottom of the window (3), or by selecting “Device Manager” from the “Settings” menu at the top of the screen.//
</WRAP><WRAP column half>
{{ test-and-measurement/analog-discovery-3/first-measurement-device-manager.png |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
== Open the "Wavegen" Instrument ===
Click on its button in the instrument panel on the left side of the screen.
</WRAP><WRAP column half>
{{ test-and-measurement/analog-discovery-3/first-measurement-open-wavegen.png |}}
</WRAP></WRAP>
------
<WRAP group><WRAP column half>
Leave all settings as defaults, and click the green arrow at the top of the window to play the wave.
</WRAP><WRAP column half>
{{ test-and-measurement/analog-discovery-3/first-measurement-start-wavegen.png |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
== Open "Scope" Instrument ===
Using the "+" button on the "Welcome" tab, open the "Scope" instrument.
</WRAP><WRAP column half>
{{ test-and-measurement/analog-discovery-3/first-measurement-open-scope.png |}}
</WRAP></WRAP>
--------
<WRAP group><WRAP column half>
Leave all settings as defaults and click the green play arrow to begin capturing data.
</WRAP><WRAP column half>
{{ test-and-measurement/analog-discovery-3/first-measurement-start-scope.png |}}
</WRAP></WRAP>
-----------
<WRAP group><WRAP column half>
Check it out, you've now got acquired data plotted on the chart!
</WRAP><WRAP column half>
{{ test-and-measurement/analog-discovery-3/first-measurement.png |}}
</WRAP></WRAP>
</WRAP>

<--

----
===== Next Steps =====

To find reference materials and guides on how to use the Analog Discovery 3 and WaveForms, please visit the [[start|Analog Discovery 3 Resource Center]].

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 analog-discovery-3 }}
{{include_n>1}}