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
learn:instrumentation:tutorials:openscope-mz:getting-started [2017/06/07 18:42] Sam Klearn:instrumentation:tutorials:openscope-mz:getting-started [2023/10/18 19:30] (current) Alyssa Holzer
Line 1: Line 1:
 ====== Getting Started with the OpenScope MZ ====== ====== Getting Started with the OpenScope MZ ======
-<WRAP info> 
-**April 2017** \\ \\ 
-WaveForms Live and the OpenScope MZ are currently in 'beta' release which means things are still a little rough around the edges.  We're working on a couple final features and improving the user experience and documentation.  During this time we encourage users to share feedback and ask our engineers questions in the [[https://forum.digilentinc.com/forum/30-waveforms-live-and-openscope-feedback/ | WaveForms Live and OpenScope forums]]. 
  
-  * [[/reference/instrumentation/openscope-mz/faq | Beta Program Known IssuesFAQ and Troublehsooting Guide]]+<WRAP center round important 80%> 
 +Despite our hopes and effort to create an innovative and low-cost T&M solutionwe’ve received consistent negative feedback on the OpenScope MZ and OpenLogger regarding overall reliability that has led us to determine that it is not up to our high standards for our test and measurement products.  
 + 
 +Unfortunately, we are unable to fix many of the issues, so we have made the difficult decision to pull both products, and related accessories from our shelves. This will allow us to ensure we can continue to deliver on the Digilent brand promise and focus our efforts on expanding our popular and core line of Test and Measurement Products. 
 + 
 +The materials on this page will remain here as legacy sources. Any Digilent provided support for this material will be extremely limited at best. Thank you for understanding.
 </WRAP> </WRAP>
  
-This document will walk you through the OpenScope MZ setup process including: +This document will walk you through the OpenScope MZ setup process Please post any questions or comments in the [[https://forum.digilent.com/forum/30-waveforms-live-and-openscope-mz/ | WaveForms Live and OpenScope MZ forums]]
-  * [[#setup_the_digilent_agent_required | Setup the the Digilent Agent]] (Required) +
-  * [[#add_the_openscope_mz_to_waveforms_live_required Add the OpenScope MZ to WaveForms Live]] (Required) +
-  * [[#update_the_openscope_mz_firmware_and_calibrate_the_device_recommended | Update the OpenScope MZ Firmware and Calibrate the device ]](Recommended) +
-  * [[#take_a_measurement_recommended | Take A Measurement]] (Recommended)+
  
-===== Setup the Digilent Agent (Required) ===== +-->Setup the Digilent Agent and Connect to the OpenScope MZ(Required)
----- + 
-The [[/reference/software/digilent-agent/start | Digilent Agent]] is a service that runs in the system tray on Windows, Mac, or Linux and enables WaveForms Live to communicate with Digilent hardware. The Digilent Agent makes it easy to update the OpenScope MZ's firmware, configure Wifi and calibrate the instruments.+{{ youtube>yuce5HZEu_4?large }} 
 + 
 +The [[software:digilent-agent:start| Digilent Agent]] is a service that runs in the system tray on Windows, Mac, or Linux and enables WaveForms Live to communicate with Digilent hardware. The Digilent Agent makes it easy to update the OpenScope MZ's firmware, configure Wifi and calibrate the instruments.
  
   - **Download and install the Digilent Agent**.    - **Download and install the Digilent Agent**. 
-    * [[https://reference.digilentinc.com/software/?software=digilent-agent&platform=win32 | Windows]] +    * [[https://s3-us-west-2.amazonaws.com/digilent/Software/Digilent+Agent/1.2.3/digilent.agent_v1.2.3.exe | Windows]] 
-    * [[https://reference.digilentinc.com/software/?software=digilent-agent&platform=osx-32 Mac ]] +    * [[https://s3-us-west-2.amazonaws.com/digilent/Software/Digilent+Agent/1.0.1/digilent-agent-1.0.1-9.dmg mac ]] 
-    * [[https://reference.digilentinc.com/software/?software=digilent-agent&platform=linux-amd64-deb | Linux (64-bit .deb)]]+    * [[https://s3-us-west-2.amazonaws.com/digilent/Software/Digilent+Agent/1.0.1/digilent-agent_1.0.1-1_amd64.deb | Linux (64-bit .deb)]]
  
-===== Add the OpenScope MZ to WaveForms Live (Required) ===== +/* 
----- +    * [[https://mautic.digilentinc.com/digilent-agent-download | Latest Installers for All Operating Systems]] 
-WaveForms Live provides a browser based instrumentation environment for managing devices and acquiring data.  WaveForms Live uses the Digilent Agent to communicate with local devices via USB.+ 
 +    * [[https://resources.digilentinc.com/digilent-agent-v1-2-3-exe/ | Windows]] 
 +    * [[https://resources.digilentinc.com/digilent-agent-1-0-1-9-dmg/ | Mac ]] 
 +    * [[https://resources.digilentinc.com/digilent-agent_1-0-1-1_amd64-deb/ | Linux (64-bit .deb)]] 
 + 
 +*/ 
 + 
 +WaveForms Live provides a browser-based instrumentation environment for managing devices and acquiring data.  WaveForms Live uses the Digilent Agent to communicate with local devices via USB.
  
   - Connect the OpenScope MZ to the computer via USB.   - Connect the OpenScope MZ to the computer via USB.
-    * The blue light on the OpenScope will flash or remain solid when the device is ready, however it may take the several seconds for the computer to recognize the device the first time it is connected.+    * It may take the several seconds for the computer to recognize the device the first time it is connected.  Subsequent connections will be established faster.
   - Right click the Digilent Agent in the system tray and click **Launch WaveForms Live**.   - Right click the Digilent Agent in the system tray and click **Launch WaveForms Live**.
     * This will launch waveformslive.com if you have internet access or a locally hosted version of WaveForms Live if not.     * This will launch waveformslive.com if you have internet access or a locally hosted version of WaveForms Live if not.
   - Add the Digilent Agent and OpenScope MZ to WaveForms Live. \\ \\   - Add the Digilent Agent and OpenScope MZ to WaveForms Live. \\ \\
-    * Click **Add A Device**. \\ \\ {{ :reference:instrumentation:openscope-mz:openscope-mz-getting-started-1.png?nolink |}} \\ +    * Click **Add A Device**. \\ \\ {{ reference:test-and-measurement:openscope-mz:openscope-mz-getting-started-1.png?nolink |}} \\ 
-    * Choose **Agent**. \\ \\ {{ :reference:instrumentation:openscope-mz:openscope-mz-getting-started-2.png?nolink |}} \\  +    * Choose **Agent**. \\ \\ {{ reference:test-and-measurement:openscope-mz:openscope-mz-getting-started-2.png?nolink |}} \\  
-    * Enter the **hostname or IP address** of the device where the Agent is running and click **Add Device**. \\ Typically the default value "http://localhost:42135" is correct for an agent running on the local machine.  \\ \\ {{ :reference:instrumentation:openscope-mz:openscope-mz-getting-started-3.png?nolink |}} \\ \\ +    * Enter the **hostname or IP address** of the device where the Agent is running and click **Add Device**. \\ Typically the default value "http://localhost:42135" is correct for an agent running on the local machine.  \\ \\ {{ reference:test-and-measurement:openscope-mz:openscope-mz-getting-started-3.png?nolink |}} \\ \\ 
-    * Select the COM port associated with the OpenScope MZ from the drop down. \\ \\ {{ :reference:instrumentation:openscope-mz:openscope-mz-getting-started-4.png?nolink |}} \\ +    * Select the COM port associated with the OpenScope MZ from the drop down. \\ \\ {{ reference:test-and-measurement:openscope-mz:openscope-mz-getting-started-4.png?nolink |}} \\  
 + 
 +<-- 
 + 
 +-->Update the OpenScope MZ Firmware (Required)# 
 + 
 +{{ youtube>YiMInbbDKZ0?large }} 
 + 
 + \\ \\ 
 + 
 +  * Click **Update Firmware** and follow the instructions to update the firmware on the OpenScope MZ. \\ \\ {{ reference:test-and-measurement:openscope-mz:openscope-mz-getting-started-5.png?nolink |}} \\  
 +  * Review the **Current Firmware Version** on the device and the **Latest Firmware Version** available. 
 +  * Select the desired **Available Firmware Version** 
 +  * Click **Update**. 
 +  * The firmware update should take about 10 seconds and Waveforms Live reports the firmware update progress. 
 +  * Click **Done**.  The firmware is now updated. 
 + 
 +<-- 
 + 
 + 
 +-->Calibrate the OpenScope MZ (Required)# 
 + 
 +{{ youtube>Bxf24fgrgKM?large }}  
 + 
 +\\ \\ 
 + 
 +  - Under the **Calibration** section click **Calibrate**. \\ \\ {{ reference:test-and-measurement:openscope-mz:waveforms-live-openscope-calibration-6.png |}} \\ \\  
 +  - Device specific instructions are provided.  
 +    - Connect the solid red wire to the solid orange wire. 
 +    - Connect the solid white wire to the solid blue wire. 
 +    - Click **Next** to begin calibration.  \\ \\ {{ reference:test-and-measurement:openscope-mz:waveforms-live-openscope-calibration-7.png |}} \\ \\  
 +  - The calibration process takes about 30 seconds.  \\ \\ {{ reference:test-and-measurement:openscope-mz:waveforms-live-openscope-calibration-8.png |}} \\ \\  
 +  - The calibration information is displayed.  Select the desired **storage location** (flash is recommended) and click **Save**.  Then click **Done**.  \\ \\ {{ reference:test-and-measurement:openscope-mz:waveforms-live-openscope-calibration-9.png |}} \\ \\  
 +  - The new calibration data has been applied to the instrument and will be applied at boot. 
 + 
 +<-- 
 + 
 + 
 +-->Take A Measurement (Recommended)#
  
 +  - Click the new **device card** to navigate to the instrument panel for the OpenScope MZ.  \\ \\ {{ :learn:instrumentation:tutorials:openscope-mz:openscope-mz-getting-started-8.png?nolink | }} \\ 
 +  - Connect the solid orange wire (Osc Ch 1) to solid yellow wire (AWG Ch 1). \\ \\ 
 +  - Click the power button to turn on the WaveGen.  This will generate a 1 KHz sine wave which can be read on oscilloscope channel 1.   \\ \\ {{ :learn:instrumentation:tutorials:openscope-mz:openscope-mz-getting-started-9.png?nolink | }}\\ 
 +  - Click Single to acquire a single buffer of data.  \\ \\ {{ reference:test-and-measurement:openscope-mz:openscope-mz-getting-started-10.png?nolink |}} \\ 
 +  - The data is displayed on the chart.   \\ \\ {{ reference:test-and-measurement:openscope-mz:openscope-mz-getting-started-11.png?nolink |}} \\ 
  
-===== Update the OpenScope MZ Firmware and Calibrate the device (Recommended) ===== +<--
----- +
-    * Click **Update Firmware** and follow the instructions to update the firmware on the OpenScope MZ. \\ \\ {{ :reference:instrumentation:openscope-mz:openscope-mz-getting-started-5.png?nolink |}} \\  +
-    * Click **Calibrate** and follow the instructions to calibrate the OpenScope MZ.   +
-    * For full step-by-step instructions see [[/reference/instrumentation/openscope-mz/calibration]] \\ \\ {{ :reference:instrumentation:openscope-mz:openscope-mz-getting-started-7.png?nolink |}} \\  +
-    * For more information on device configuration see the [[/reference/software/waveforms-live/reference-manual | WaveForms Live reference manual]]. \\ \\ +
-    * Click **Done**. \\ \\+
  
-===== Take A Measurement (Recommended) ===== 
----- 
-  - Click the new **device card** to navigate to the instrument panel for the OpenScope MZ.  \\ \\ {{ :reference:instrumentation:openscope-mz:openscope-mz-getting-started-8.png?nolink |}} \\  
-  - Connect the solid orange wire (Osc Ch 1) to solid yellow wire (AWG Ch 1). 
-  - Click the power button to turn on the WaveGen.   \\ \\ {{ :reference:instrumentation:openscope-mz:openscope-mz-getting-started-9.png?nolink |}} \\  
-  - Click Single to acquire a single buffer of data.  \\ \\ {{ :reference:instrumentation:openscope-mz:openscope-mz-getting-started-10.png?nolink |}} \\  
-  - The data is displayed on the chart.   \\ \\ {{ :reference:instrumentation:openscope-mz:openscope-mz-getting-started-11.png?nolink |}} \\  
  
 ==== Related Links ==== ==== Related Links ====
  
-  * [[/reference/software/waveforms-live/wifi-setup]] +  * [[software:waveforms-live:wifi-setup]] 
-  * [[/reference/instrumentation/openscope-mz/calibration]] +  * [[/learn/instrumentation/tutorials/openscope-mz/calibration]] 
-  * [[/reference/software/waveforms-live/start]] +  * [[software:waveforms-live:start]] 
-  * [[/reference/software/waveforms-live/reference-manual]] +  * [[software:waveforms-live:reference-manual]] 
-  * [[/reference/instrumentation/openscope-mz/reference-manual]] +  * [[test-and-measurement:openscope-mz:reference-manual]] 
-  * [[/reference/software/waveforms-live/add-device]] +  * [[software:waveforms-live:add-device]] 
-  * [[/reference/software/digilent-instrumentation-protocol/start]]+  * [[software:digilent-instrumentation-protocol:start]]
  
 {{tag>learn instrumentation tutorial openscope-mz getting-started}} {{tag>learn instrumentation tutorial openscope-mz getting-started}}
 +{{include_n>1}}