====== Analog Discovery Pro (ADP3450/ADP3250) Getting Started Guide ======
~~TechArticle~~
{{ reference:test-and-measurement:analog-discovery-pro-3x50:getting-started-success.png?600 |}}

===== Overview =====
This guide will get you started with your new Analog Discovery Pro, from getting it out of the box to taking your first measurement in the default Standard mode. 
----
===== Inventory =====
  * Your new Analog Discovery Pro, along with the included power supply and USB cable.
    * BNC oscilloscope probes and BNC to minigrabber clip cables
  * A computer, with the WaveForms application (version 3.15.22 or later) installed.
    * Installation instructions can be found in Step 2 of this guide.
    * Installers for each supported operating system (Windows, Mac, and Linux) can be found here: [[https://cloud.digilent.com/myproducts/waveform?pc=1&tab=2|WaveForms installers]].

----
===== Guide =====
==== 1. Unboxing ====
-->Unboxing#
<WRAP group>
<WRAP half column>
The Analog Discovery Pro arrives in a large box.
</WRAP>

<WRAP half column>
{{ reference:test-and-measurement:analog-discovery-pro-3x50:closedboxadp3450.jpg?600 |What could be inside?}}
</WRAP>
</WRAP>

----

<WRAP group>
<WRAP half column>
A thin layer of foam and a small walk-around sheet are located on top of the Analog Discovery Pro which is contained in an anti-static bag.
</WRAP>

<WRAP half column>
{{ reference:test-and-measurement:analog-discovery-pro-3x50:openboxapd3450.jpg?600 |I think I see it!}}
</WRAP>
</WRAP>

----

<WRAP group>
<WRAP half column>
Underneath the Analog Discovery Pro, which is nestled in its own tray, are two compartments: the required Power Supply Brick and the MTE, USB, and IEC cables.
</WRAP>

<WRAP half column>
{{ reference:test-and-measurement:analog-discovery-pro-3x50:unboxedadp3450.jpg?600 |Wait there's more?}}
</WRAP>
</WRAP>

<--

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

Digilent's WaveForms application provides a user interface to the Analog Discovery Pro (ADP3450/ADP3250). Please download the appropriate WaveForms installer for the operating system (Windows, Linux, Mac). If WaveForms is already installed, please make sure that it is up to date (version 3.15.22 or later).

Check the [[#Inventory|Inventory]] section, above, for the download link.

Click on the appropriate option below for OS-specific installation instructions.
----

--> 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 Analog Discovery Pro 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, Analog Discovery Pro (ADP3450/ADP3250), 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 |}}
</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 ===
Click **Finish** to close the installer.
</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.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-studio:getting-started-guide:mac-open-package-3.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 Analog Discovery Pro 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. 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 to the Test and Measurement section of the [[https://forum.digilent.com|Digilent Forum]].

</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>
<--*/

----
==== 3. Update the Firmware (Optional) ====

--> In Standard Mode #
<WRAP group>
<WRAP group><WRAP column half>
Plug the Analog Discovery Pro’s power supply into an outlet, then plug the power supply into the Analog Discovery Pro.

Plug the Analog Discovery Pro into the computer via the USB cable.

Flip the Analog Discovery Pro power switch to the on position, on the left side of the unit. The green “power good” indicator LED on the front of the device (far left side) will turn on.
</WRAP><WRAP column half>
/*{{ :reference:test-and-measurement:analog-discovery-pro-3450:DisconnectedADP3450.jpg?600 |Disconnected cables}}*/
{{ reference:test-and-measurement:analog-discovery-pro-3x50:connectedadp3450.jpg?600 |Connected cables and switched on}}
/*{{ :reference:test-and-measurement:analog-discovery-pro-3450:TurnedOnADP3450.jpg?600 |Green light is on}}*/
</WRAP> </WRAP>

{{page>test-and-measurement:analog-discovery-pro-3x50:firmware-update#guide&noheader}}
</WRAP>
<--

----
==== 4. Take a Measurement ====

{{ reference:test-and-measurement:analog-discovery-pro-3x50:getting-started-guide:measurement-splash.png?nolink&800 |}}

This section walks through using the Analog Discovery Pro (ADP3450/ADP3250) 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 #

<WRAP group><WRAP column half>
=== 1. ===
If you haven't yet, plug the Analog Discovery Pro’s power supply into an outlet, then plug the power supply into the Analog Discovery Pro.
=== 2. ===
Plug the Analog Discovery Pro into the computer via the USB cable.
=== 3. ===
Flip the Analog Discovery Pro power switch to the on position, on the left side of the unit. The green “power good” indicator LED on the front of the device (far left side) will turn on.
</WRAP><WRAP column half>
/*{{ :reference:test-and-measurement:analog-discovery-pro-3450:DisconnectedADP3450.jpg?600 |Disconnected cables}}*/
{{ reference:test-and-measurement:analog-discovery-pro-3x50:connectedadp3450.jpg?600 |Connected cables and switched on}}
/*{{ :reference:test-and-measurement:analog-discovery-pro-3450:TurnedOnADP3450.jpg?600 |Green light is on}}*/
</WRAP> </WRAP>
----
<WRAP group><WRAP column half>
=== 4. ===
Take a BNC oscilloscope probe and connect it to the Analog Discovery Pro’s Oscilloscope Channel 1. Connect a BNC to minigrabber clip cable to Wavegen Out Channel 1. Connect the tips together. Set the scope probe's attenuation to 1x.
</WRAP><WRAP column half>
{{ reference/test-and-measurement/guides/wavegen_and_scope.jpg?600 |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
=== 5. ===
Launch the WaveForms application. Upon launch, WaveForms will automatically detect and connect to the Analog Discovery Pro in the Device Manager. If the Analog Discovery Pro is not connected to the host computer when WaveForms launches, plug in the device and turn it on, at which point it will appear in the Device Manager’s device list.

If your device doesn't show up, you can click the **Refresh Stopped** button to have WaveForms begin automatically refreshing the list of devices.

If an **Update Device** button is visible after selecting the device, __[[test-and-measurement:analog-discovery-pro-3x50:getting-started-guide#update_the_firmware_optional|update the firmware]]__ prior to doing anything else.
After updating the firmware, select the Device and then click **Select** to continue.

</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-pro-3x50:device-manager-select-device.png?600 |}}
</WRAP></WRAP>

----
<WRAP group><WRAP column half>
== 6. ==
In WaveForms, open the //Wavegen// instrument by clicking on the **Wavegen** button in the instrument panel on the left side of the screen.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:guides:waveforms-waveform-generator-open-wavegen.png?600 |}}
</WRAP></WRAP>

----

<WRAP group><WRAP column half>
== 7. ==
Leave all settings as defaults, and then go back to WaveForms' //Welcome// tab and click on the **Scope** button to open the //Scope// instrument. You will hear a small click from the Analog Discovery Pro when the oscilloscope is enabled.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:guides:waveforms-oscilloscope-open-scope.png?600 |}}
</WRAP></WRAP>
----
<WRAP group><WRAP column half>
== 8. ==

Click the green play arrow in the top right of WaveForms to run all Instruments and begin capturing data.
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-pro-3x50:getting-started-run-all.png?600 |}}
</WRAP></WRAP>

<WRAP group><WRAP column half>
== 9. ==
You have now taken your first measurement!
</WRAP><WRAP column half>
{{ reference:test-and-measurement:analog-discovery-pro-3x50:getting-started-success.png |}}
</WRAP></WRAP>

<--
----
===== Other Resources =====
If you want to check out using the device in Linux mode, see [[linux-mode]].

For more information on streaming data through ethernet while using Standard mode, see [[ethernet-streaming]].

To find reference materials and guides on how to use the Analog Discovery Pro and WaveForms, please visit the [[start|Analog Discovery Pro (ADP3450/ADP3250) 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 the [[https://forum.digilent.com|Digilent Forum]].

----