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
programmable-logic:eclypse-z7:demos:zmod-scope [2021/11/04 00:02] – [Download and Usage Instructions] Arthur Brownprogrammable-logic:eclypse-z7:demos:zmod-scope [2022/10/04 11:38] (current) – external edit 127.0.0.1
Line 1: Line 1:
-====== Using the Eclypse Z7 and Zmod Scope with the Zmod Library ======+====== Using the Zmod Scope 1410-105 with the Zmod Library and Eclypse Z7 ======
  
-<WRAP round todo> +{{ :programmable-logic:eclypse-z7:demos:sw-demo-hw-setup.png?600 |}}
-== Under Construction == +
-</WRAP> +
- +
-FIXME add image+
  
 ---- ----
Line 15: Line 11:
 ===== Inventory ===== ===== Inventory =====
  
-  * Eclypse Z7 with a MicroUSB Programming Cable and external Power Supply +  * Eclypse Z7 
-  * a Zmod Scope installed in the Eclypse's Zmod A port+  * A Zmod Scope installed in the Eclypse's Zmod A port
     * **Important!** Only the Zmod Scope 1410-105 is supported     * **Important!** Only the Zmod Scope 1410-105 is supported
 +
   * Vivado and Xilinx SDK installations compatible with the latest release of this demo (2019.1)   * Vivado and Xilinx SDK installations compatible with the latest release of this demo (2019.1)
     * //See [[vivado/getting_started/start]] for installation instructions.//     * //See [[vivado/getting_started/start]] for installation instructions.//
   * PetaLinux Installation compatible with the latest release of this demo (2019.1)   * PetaLinux Installation compatible with the latest release of this demo (2019.1)
-    * //See Xilinx's [[https://www.xilinx.com/support/documentation/sw_manuals/xilinx2019_1/ug1144-petalinux-tools-reference-guide.pdf|PetaLinux Tools Documentation (2019.1) (UG1144)]] for installation instructions.//+    * //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     * Only required if you want to rebuild the PetaLinux image
   * Serial Terminal application to receive messages printed by the demo   * Serial Terminal application to receive messages printed by the demo
     * //See [[programmable-logic:guides:serial-terminals:start]] for more information.//     * //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 ===== ===== 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.+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 # --> Setting up the Linux Projects #
 <WRAP GROUP> <WRAP GROUP>
-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. A power supply, USB connection to the host computer, and an ethernet connection to a router or switch will be required to power the board, provide a UART serial connection, and connect the board to a network shared with the Eclypse, respectively. Some stimulus should be provided to the Zmod Scope's SMA connectors (FIXME, are ). 
----- 
 {{section>/programmable-logic/eclypse-z7/environment-setup#import_library_and_demo_projects&noheader}} {{section>/programmable-logic/eclypse-z7/environment-setup#import_library_and_demo_projects&noheader}}
 ---- ----
 {{section>/programmable-logic/eclypse-z7/environment-setup#linux_environment_project_setup}} {{section>/programmable-logic/eclypse-z7/environment-setup#linux_environment_project_setup}}
 ---- ----
-When the project is run,  
 </WRAP> </WRAP>
 <-- <--
  
 --> Setting up the Baremetal Projects # --> Setting up the Baremetal Projects #
-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. A power supply and a USB connection to the host computer will be required. 
 <WRAP GROUP> <WRAP GROUP>
 {{section>/programmable-logic/eclypse-z7/environment-setup#import_library_and_demo_projects}} {{section>/programmable-logic/eclypse-z7/environment-setup#import_library_and_demo_projects}}
Line 51: Line 63:
 <-- <--
 ---- ----
 +<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.
  
-FIXME add the remaining stuff here +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. 
-Once you've tried running the projects as is, the remaining steps, found below, will show you how to obtain and rebuild the projects they depend on, so that you can make changes to the hardware or OS.+</WRAP> <WRAP column half> 
 +{{ :programmable-logic:eclypse-z7:demos:scope-results.png?600 |}} 
 +</WRAP> </WRAP> 
 +----
  
---> Rebuilding the Hardware Platform # +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.
-<--+
  
---> Rebuilding the Petalinux Project # +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]].
-<-- +
- +
---> Rebuilding the Software Projects # +
-<--+
 ===== Additional Resources ===== ===== Additional Resources =====
  
 All materials related to the use of the Eclypse Z7 and Zmod Scope can be found on their resource centers, linked below: 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]]   * [[../start|Eclypse Z7 Resource Center]]
-  * [[/zmod/zmodadc/start|Zmod Scope 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. For technical support, please visit the [[https://forum.digilentinc.com/forum/4-fpga/|FPGA]] section of the Digilent Forum.