====== Using the Zmod Scope 1410-105 with the Zmod Library and Eclypse Z7 ======

{{ :programmable-logic:eclypse-z7:demos:sw-demo-hw-setup.png?600 |}}

----
===== Description =====

This demo uses the Zmod Scope 1410, the initial release of the Zmod ADC IP cores (ZmodADC1410Controller and AXI_Zmod_ADC1410), and the Zmod ADC1410 software library to perform 10 μs captures of an incoming signal. Captured data is written to a file and standard out. Both baremetal and PetaLinux-based projects are provided.

----
===== Inventory =====

  * Eclypse Z7
  * A Zmod Scope installed in the Eclypse's Zmod A port
    * **Important!** Only the Zmod Scope 1410-105 is supported

  * Vivado and Xilinx SDK installations compatible with the latest release of this demo (2019.1)
    * //See [[vivado/getting_started/start]] for installation instructions.//
  * PetaLinux Installation compatible with the latest release of this demo (2019.1)
    * //See Xilinx's [[https://docs.xilinx.com/v/u/2019.1-English/ug1144-petalinux-tools-reference-guide|PetaLinux Tools Documentation (2019.1) (UG1144)]] for installation instructions.//
    * Only required if you want to rebuild the PetaLinux image
  * Serial Terminal application to receive messages printed by the demo
    * //See [[programmable-logic:guides:serial-terminals:start]] for more information.//
  * Git is required to download the sources

  * A power supply for external power
  * A microUSB cable for a USB connection to the host computer
  * A an ethernet connection to a router or switch (if using the Linux projects), for remote debugging
  * And some way to provide stimulus to the Zmod Scope's CH1 SMA connector - a signal to capture.

----
===== Download and Usage Instructions =====
The projects will be downloaded by cloning the [[https://github.com/Digilent/Eclypse-Z7|Eclypse Z7]] repo on Github. Use of git to obtain the sources is recommended. It is still possible to download ZIPs of the projects from Github but dependencies will need to be downloaded and placed in the correct locations manually. A Windows host can be used for either set of projects but will be unable to rebuild the PetaLinux project.
----
<WRAP group> <WRAP column half>
Since Zmods are not hot-swappable, you should ensure that you plug the Zmod Scope into Zmod Port A on the Eclypse prior to powering the board on.

Get the power supply, USB cable, and ethernet cable plugged into the board. Additional setup will be performed in the "Setting up..." dropdowns, below, so don't turn the board on just yet.
</WRAP> <WRAP column half>
{{ :programmable-logic:eclypse-z7:demos:sw-demo-hw-setup.png?600 |}}
</WRAP> </WRAP>
----
Some stimulus should be provided to the Zmod Scope's CH1 SMA connector. The demo, without user modification, performs a capture immediately, providing a 1024-sample, 10 us long, buffer of data to the host.

The results shown later in this document were produced by connecting CH1 to the first waveform generator channel of an [[test-and-measurement:analog-discovery-pro-3x50:start|Analog Discovery Pro (ADP3450)]] via a BNC cable and a BNC-to-SMA adapter.
----

--> Setting up the Linux Projects #
<WRAP GROUP>
{{section>/programmable-logic/eclypse-z7/environment-setup#import_library_and_demo_projects&noheader}}
----
{{section>/programmable-logic/eclypse-z7/environment-setup#linux_environment_project_setup}}
----
</WRAP>
<--

--> Setting up the Baremetal Projects #
<WRAP GROUP>
{{section>/programmable-logic/eclypse-z7/environment-setup#import_library_and_demo_projects}}
----
{{section>/programmable-logic/eclypse-z7/environment-setup#baremetal_project_setup&noheader}}
</WRAP>
<--
----
<WRAP group> <WRAP column half>
When the project is run, data will be printed to a connected serial terminal, as seen in the screenshot to the right. The data is printed in both volts and 14-bit raw twos-complement form, along with the time since the start of the buffer, tab-separated.

When using the Linux project, the same data is written to a CSV file, which can be found in the ''/home/eclypse'' directory of the Eclypse's filesystem.
</WRAP> <WRAP column half>
{{ :programmable-logic:eclypse-z7:demos:scope-results.png?600 |}}
</WRAP> </WRAP>
----

Once you've run the projects, check out the [[/programmable-logic/eclypse-z7/git]] documentation for more information on how the repository you cloned is structured and how to obtain and build the software project's dependencies.

For more information on the structure of the software projects and libraries, and how to modify the projects, or create new ones, check out the [[zmod/zmodbaselibraryuserguide]].
===== Additional Resources =====

All materials related to the use of the Eclypse Z7 and Zmod Scope can be found on their resource centers, linked below:
  * [[../start|Eclypse Z7 Resource Center]]
  * [[zmod:scope:start|Zmod Scope Resource Center]]

For technical support, please visit the [[https://forum.digilentinc.com/forum/4-fpga/|FPGA]] section of the Digilent Forum.