Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
test-and-measurement:analog-discovery-pro-5250:getting-started-guide [2021/08/29 18:22] – [3. Update the Firmware (Optional)] Keith M Kolmostest-and-measurement:analog-discovery-pro-5250:getting-started-guide [2022/10/04 11:38] (current) – external edit 127.0.0.1
Line 1: Line 1:
-====== Analog Discovery Pro (ADP5250) Getting Started Guide (UNDER CONSTRUCTION) ======+====== Analog Discovery Pro (ADP5250) Getting Started Guide ======
  
 ~~TechArticle~~ ~~TechArticle~~
Line 6: Line 6:
  
 ===== Overview ===== ===== Overview =====
-This guide will get you started with your new Analog Discovery Pro 5250, from getting it out of the box to taking your first measurement in the default Standard mode. +This guide will get you started with your new Analog Discovery Pro (ADP5250), from getting it out of the box to taking your first measurement. 
 ---- ----
 ===== Inventory ===== ===== Inventory =====
-  * Your new Analog Discovery Pro 5250 +  * Your new Analog Discovery Pro (ADP5250)
   * 40 pin (34 signal) connector for Mixed Signal Oscilloscope Connections   * 40 pin (34 signal) connector for Mixed Signal Oscilloscope Connections
   * 14 pin (8 channel) Digital Inputs and Outputs (PN 163-667)   * 14 pin (8 channel) Digital Inputs and Outputs (PN 163-667)
   * 6 pin connector for Power Supply Connections (PN 163-668)   * 6 pin connector for Power Supply Connections (PN 163-668)
-  * USb A to B connector+  * USB A to B cable
   * North American Power Supply Cable    * North American Power Supply Cable 
   * International Power Adapter (PN 300-008)   * International Power Adapter (PN 300-008)
   * International Power Adapter (PN 300-009)   * International Power Adapter (PN 300-009)
-  * A computer, with the WaveForms application (version 3.16.32 or later) installed +  * A Windows computer and the WaveForms application installer (version 3.16.32 or later) 
-    * Installation instructions can be found in Step 2 of this guide. +    * The installer for Windows can be found here: [[https://mautic.digilentinc.com/waveforms-download|WaveForms installers]]. 
-    * Installers for each supported operating system (Windows, Mac, and Linux) can be found here: [[https://mautic.digilentinc.com/waveforms-download|WaveForms installers]].+  * You will also need some BNC Oscilloscope probes and minigrabber cables for the Scope inputs and AWG output
  
 ---- ----
Line 25: Line 25:
 ==== 1. Unboxing ==== ==== 1. Unboxing ====
 -->Unboxing# -->Unboxing#
-<WRAP group> +<WRAP group> <WRAP half column>
-<WRAP half column>+
 The Analog Discovery Pro arrives in a large box.   The Analog Discovery Pro arrives in a large box.  
- +</WRAP> <WRAP half column> 
-**ANDREW NOTE - My BOX was covered in FED EX STICKERS.  You will need to retake picture** +{{:test-and-measurement:analog-discovery-pro-5250:unboxing-box-angle.jpg?600|}} 
- +</WRAP> </WRAP>
-</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> 
-<WRAP group> +The Analog Discovery Pro can be seen in the foam. 
-<WRAP half column> +</WRAP> <WRAP half column> 
-A thin layer of foam and a small walk-around sheet are located on top of the Analog Discovery Pro. +{{:test-and-measurement:analog-discovery-pro-5250:unboxing-box-inside.jpg?600|}} 
- +</WRAP> </WRAP>
-**ANDREW NOTE - My BOX was covered in FED EX STICKERS.  You will need to retake picture** +
-</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 is another box containing the accessories.
 +</WRAP> <WRAP half column>
 +{{:test-and-measurement:analog-discovery-pro-5250:unboxing-accessories-box.jpg?600|}}
 +</WRAP> </WRAP>
 +----
 +<WRAP group> <WRAP half column>
 +Several inserts with some getting started instructions are also included. Here you can see everything!
 +</WRAP> <WRAP half column>
 +{{:test-and-measurement:analog-discovery-pro-5250:unboxing-all-displayed.jpg?600|}}
 +</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> 
- 
-**KEITH NOTE INSERT NEW PHOTO HERE INSTEAD** 
-{{ reference:test-and-measurement:analog-discovery-pro-3x50:unboxedadp3450.jpg?600 |Wait there's more?}} 
-</WRAP> 
-</WRAP> 
  
 <-- <--
Line 71: Line 55:
 ==== 2. Download and Install WaveForms ==== ==== 2. Download and Install WaveForms ====
  
-Digilent's WaveForms application provides a user interface to the Analog Discovery Pro (ADP5250). 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.16.32 or later).+Digilent's WaveForms application provides a user interface to the Analog Discovery Pro (ADP5250). Please download the WaveForms Windows installer. If WaveForms is already installed, please make sure that it is up to date (version 3.16.32 or later).
  
 Check the [[#Inventory|Inventory]] section, above, for the download link. Check the [[#Inventory|Inventory]] section, above, for the download link.
  
-Click on the appropriate option below for OS-specific installation instructions. 
 ---- ----
  
- +--> Installing WaveForms : Windows#
-  +
---> Installing WaveForms : Windows #+
  
 +<WRAP group>
 +<WRAP column half>
 +=== Open the Executable File ===
 +Open the executable file that you downloaded.
 +</WRAP>
 +<WRAP column half>
 +{{ :learn:instrumentation:tutorials:downloadwf.png?nolink&500 |}}
 +</WRAP>
 +</WRAP>
 +---------------
 <WRAP group> <WRAP group>
 <WRAP column half> <WRAP column half>
 === Welcome === === 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**.+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>
 <WRAP column half> <WRAP column half>
Line 91: Line 82:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
 +------------
 <WRAP group> <WRAP group>
 <WRAP column half> <WRAP column half>
Line 101: Line 92:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
 +-----------------
 <WRAP group> <WRAP group>
 <WRAP column half> <WRAP column half>
 === Choose Components === === 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. +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, Analog Discovery Pro (ADP3450/ADP3250), Digital Discovery, and Electronics Explorer Board.+  * 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 Runtime contains a library and device support files needed to run custom applications.
   * The WaveForms Application is the Digilent virtual instrumentation interface.   * The WaveForms Application is the Digilent virtual instrumentation interface.
-  * The Waveforms SDK is the software development kit for creating custom applications. +  * The WaveForms SDK is the software development kit for creating custom applications. 
 +  * If you have an ADP5250, make sure to check the box for its driver installation, to ensure that your PC will be able to communicate with the device.
 **Note:** //Even with all components selected, the WaveForms install does not take much hard drive space (<200MB). Digilent recommends that all components are installed.// **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>
 <WRAP column half> <WRAP column half>
-{{ reference:test-and-measurement:analog-discovery-studio:gsg-install-components.png |}}+{{:software:waveforms:waveforms-3:newinstall.jpg?600|}}
 </WRAP> </WRAP>
 </WRAP> </WRAP>
 +------------
 <WRAP group> <WRAP group>
 <WRAP column half> <WRAP column half>
Line 127: Line 118:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
 +-------------
 <WRAP group> <WRAP group>
 <WRAP column half> <WRAP column half>
 === Choose Install Location === === Choose Install Location ===
-Click **Install**.+  * You'll need to choose an installation destination or just leave it at the default. 
 +  * Click "Install".
 </WRAP> </WRAP>
 <WRAP column half> <WRAP column half>
Line 137: Line 129:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
 +----------------
 <WRAP group> <WRAP group>
 <WRAP column half> <WRAP column half>
 === Installing / Installation Complete === === Installing / Installation Complete ===
-Wait for the Installation to complete, then click **Next**.+  * WaveForms will be installed as indicated by the progress bar. 
 +  * Click "Next".
 </WRAP> </WRAP>
 <WRAP column half> <WRAP column half>
Line 147: Line 140:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
 +------------
 <WRAP group> <WRAP group>
 <WRAP column half> <WRAP column half>
 === Complete === === Complete ===
-Click **Finish** to close the installer.+  * Check or uncheck the boxes to open WaveForms and the readme. 
 +  * Click "Finish".
 </WRAP> </WRAP>
 <WRAP column half> <WRAP column half>
Line 157: Line 151:
 </WRAP> </WRAP>
 </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 Scopes and Instruments section of the [[https://forum.digilentinc.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) ==== +
- +
- +
-**ANDREW NOTE: In the beta software the UPDATE FIRMWARE button does not appear.** +
- +
---> 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}}*/ +
- +
-{{ :test-and-measurement:analog-discovery-pro-5250:5250back.jpg?400 |}} +
-/*{{ :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 ====+==== 3. Take a Measurement ====
  
 {{ reference:test-and-measurement:analog-discovery-pro-3x50:getting-started-guide:measurement-splash.png?nolink&800 |}} {{ 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 (ADP 5250) 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. +This section walks through using the Analog Discovery Pro (ADP5250) 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 # --> Take a Measurement #
Line 262: Line 169:
 Plug the Analog Discovery Pro into the computer via the USB cable. Plug the Analog Discovery Pro into the computer via the USB cable.
 === 3. === === 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.+Press the power button on the top left of the front of the unit and wait for the Analog Discovery Pro to turn on.
 </WRAP><WRAP column half> </WRAP><WRAP column half>
 +{{ :test-and-measurement:analog-discovery-pro-5250:5250back.jpg?600 |}}
 /*{{ :reference:test-and-measurement:analog-discovery-pro-3450:DisconnectedADP3450.jpg?600 |Disconnected cables}}*/ /*{{ :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-3x50:connectedadp3450.jpg?600 |Connected cables and switched on}} */
 /*{{ :reference:test-and-measurement:analog-discovery-pro-3450:TurnedOnADP3450.jpg?600 |Green light is on}}*/ /*{{ :reference:test-and-measurement:analog-discovery-pro-3450:TurnedOnADP3450.jpg?600 |Green light is on}}*/
 </WRAP> </WRAP> </WRAP> </WRAP>
Line 271: Line 179:
 <WRAP group><WRAP column half> <WRAP group><WRAP column half>
 === 4. === === 4. ===
-Take a BNC oscilloscope probe and connect it to the BNC connector labelled AWG (Arbitrary Waveform Generatorn) Analog Discovery Set the scope probe's attenuation to 1x.+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 AWG Channel 1. Connect the tips together. Set the scope probe's attenuation to 1x.
 </WRAP><WRAP column half> </WRAP><WRAP column half>
-{{ reference/instrumentation/guides/wavegen_and_scope.jpg?600 |}}+{{ /test-and-measurement/guides/img_7470.jpg?600 |}} 
 </WRAP></WRAP> </WRAP></WRAP>
 ---- ----
Line 281: Line 190:
  
 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 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> </WRAP><WRAP column half>
-{{ reference:test-and-measurement:analog-discovery-pro-3x50:device-manager-select-device.png?600 |}}+{{:test-and-measurement:analog-discovery-pro-5250:getting-started-devicemanager.png?600|}}
 </WRAP></WRAP> </WRAP></WRAP>
  
Line 294: Line 200:
 In WaveForms, open the //Wavegen// instrument by clicking on the **Wavegen** button in the instrument panel on the left side of the screen. 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> </WRAP><WRAP column half>
-{{ reference:test-and-measurement:guides:waveforms-waveform-generator-open-wavegen.png?600 |}}+{{:test-and-measurement:analog-discovery-pro-5250:getting-started-wavegen.png?600|}}
 </WRAP></WRAP> </WRAP></WRAP>
  
Line 303: Line 209:
 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. 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> </WRAP><WRAP column half>
-{{ reference:test-and-measurement:guides:waveforms-oscilloscope-open-scope.png?600 |}}+{{:test-and-measurement:analog-discovery-pro-5250:getting-started-scope.png?600|}}
 </WRAP></WRAP> </WRAP></WRAP>
 ---- ----
 <WRAP group><WRAP column half> <WRAP group><WRAP column half>
 == 8. == == 8. ==
- 
 Click the green play arrow in the top right of WaveForms to run all Instruments and begin capturing data. 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! You have now taken your first measurement!
 </WRAP><WRAP column half> </WRAP><WRAP column half>
-{{ reference:test-and-measurement:analog-discovery-pro-3x50:getting-started-success.png |}}+{{:test-and-measurement:analog-discovery-pro-5250:getting-started-measurement.png?600|}}
 </WRAP></WRAP> </WRAP></WRAP>
  
Line 324: Line 224:
 ---- ----
 ===== Other Resources ===== ===== 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]].+To find reference materials and guides on how to use the Analog Discovery Pro and WaveForms, please visit the [[start|Analog Discovery Pro (ADP5250) Resource Center]].
  
 For technical support, please visit the Test and Measurement section of the [[https://forum.digilentinc.com|Digilent Forum]]. For technical support, please visit the Test and Measurement section of the [[https://forum.digilentinc.com|Digilent Forum]].