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:16] – [Inventory] 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 16: Line 12:
  
   * Eclypse Z7   * 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
  
Line 22: Line 18:
     * //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 power supply for external power
   * A microUSB cable for a USB connection to the host computer   * A microUSB cable for a USB connection to the host computer
-  * And an ethernet connection to a router or switch (if using the Linux projects), for remote debugging+  * 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> <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. 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.
Line 40: Line 38:
 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. 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> </WRAP> <WRAP column half>
-FIXME add hw setup image+{{ :programmable-logic:eclypse-z7:demos:sw-demo-hw-setup.png?600 |}}
 </WRAP> </WRAP> </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. 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.
 ---- ----
  
Line 65: Line 64:
 ---- ----
 <WRAP group> <WRAP column half> <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. 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.+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> </WRAP> <WRAP column half>
-FIXME add results image+{{ :programmable-logic:eclypse-z7:demos:scope-results.png?600 |}}
 </WRAP> </WRAP> </WRAP> </WRAP>
 ---- ----
  
-FIXME add the remaining stuff here +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.
-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.+
  
---> Rebuilding the Hardware Platform # +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 Petalinux Project # +
-<-- +
- +
---> 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.