====== Using the Zmod AWG with the Zmod Library and Eclypse Z7 ======

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

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

This demo uses the Zmod AWG 1411, the initial release of the Zmod DAC IP cores (ZmodDAC1411_Controller and AXI_Zmod_DAC1411), and the ZmodDAC1411 software library to create a simple ramp waveform. Captured data is written to a file and standard out. Both baremetal and PetaLinux-based projects are provided.

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

  * Eclypse Z7
  * A Zmod AWG installed in the Eclypse's Zmod B port

  * 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 measure the signal generated by the Zmod AWG's CH1 SMA connector - perhaps an oscilloscope.

----
===== 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 AWG into Zmod Port B 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.

Some load should be connected to the Zmod AWG's CH1 SMA connector. In the image to the right, the output is left floating but is connected to an oscilloscope via an SMA cable for measurement. The demo, without user modification, repeatedly creates a ramp signal, ascending from -1 V to 5 V over the course of 12 µs.
</WRAP> <WRAP column half>
{{:programmable-logic:eclypse-z7:demos:sw-demo-hw-setup.png?600|}}
</WRAP> </WRAP>


----

--> 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, the ramp will be performed and the message "ZmodDAC1411 Demo" will be printed to a connected serial terminal. Results captured by an [[test-and-measurement:analog-discovery-pro-3x50:start|Analog Discovery Pro (ADP3450)]] oscilloscope can be seen in the screenshot to the right.

The signal repeatedly ramps from -1 V to 5 V over the course of 12 μs. The full 100 MS/s sample rate is used, with a 600 sample buffer, and an output frequency divider factor of 2 - each sample is sent to the Zmod AWG from the Eclypse twice in a row.
</WRAP> <WRAP column half>
{{:programmable-logic:eclypse-z7:demos:awg-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 AWG can be found on their resource centers, linked below:
  * [[../start|Eclypse Z7 Resource Center]]
  * [[zmod:awg:start|Zmod AWG Resource Center]]

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