Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
programmable-logic:eclypse-z7:demos:zmod-scope [2021/10/29 20:47] – created Arthur Brownprogrammable-logic:eclypse-z7:demos:zmod-scope [2022/10/04 11:38] (current) – external edit 127.0.0.1
Line 1: Line 1:
-====== Eclypse Z7 Zmod Scope 1410 Demo ======+====== 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+
  
 ---- ----
 ===== Description ===== ===== Description =====
  
-<color #ed1c24>Broadly describe what the demo does here. If the demo was originally documented elsewhere, this section can be pulled directly from the introduction to the Github README, or from an existing wiki page.</color> +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.
- +
-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 us captures of an incoming signal. Both baremetal and PetaLinux-based projects are provided.+
  
 ---- ----
 ===== 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 (only the Zmod Scope 1410-10 is supported)+  * 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)   * 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 =====
-FIXME most of this needs rewritten, potentially copy paste from https://digilent.com/reference/zmod/zmodbaselibraryuserguide and https://digilent.com/reference/programmable-logic/eclypse-z7/git+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.
  
-First and foremost, releases - consisting of a set of files for download - are only compatible with a specific version of the Xilinx tools, as specified in the name of the release (referred to as a //release tag//). In addition, releases are only compatible with the specified variant of the board. For example, a release tagged "20/DMA/2020.1" for the Zybo Z7 is only to be used with the -20 variant of the board and Xilinx tools (Vivado and Vitis) version 2020.1.+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 latest release version for this demo is highlighted in green.+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. 
 +----
  
-/* **Note:** //Releases for FPGA demos from before 2020.1 used a different git structure and used a different release tag naming scheme.// */ +--> Setting up the Linux Projects # 
- +<WRAP GROUP> 
-<color #ed1c24>In a specific demo's page, table rows should only be created for releases that have a README that explains the use of that release. The Board Variant column should be excluded if there are no variants of the board. Release links can be found by navigating to the Releases page of a Github repo and selecting a single release. The latest release for each variant is highlighted in green, as seen in the table below.</color> +{{section>/programmable-logic/eclypse-z7/environment-setup#import_library_and_demo_projects&noheader}}
- +
-^ Release Tag  ^ Release Downloads  ^ Setup Instructions  | +
-| @#C0EEBD: (tag)  | [[https://github.com/Digilent/(Board)/releases/tag/(tag)|Release ZIP Downloads]] | See //Using the Latest Release//, below  | +
- +
- +
-**Note for Advanced Users:** //All demos for the (Board) are provided through the [[https://github.com/Digilent/Board|(Board)]] repository on Github. Further documentation on the structure of this repository can be found on this wiki's [[programmable-logic:documents:git]] page.//+
 ---- ----
-Instructions on the use of the latest release can be found in this dropdown: +{{section>/programmable-logic/eclypse-z7/environment-setup#linux_environment_project_setup}}
- +
---> Using the Latest Release # +
-<WRAP group> +
-{{page>programmable-logic:guides:using-github-releases#baremetal_release_before_programming_xsct_scripts&noheader}} +
- +
---> Set up the (Board) # +
- +
-<color #ed1c24>Provide any additional demo-specific setup that needs to occur prior to programming here. This may include connecting a serial console, connecting additional hardware, etc.</color> +
 ---- ----
 +</WRAP>
 <-- <--
  
-{{page>programmable-logic:guides:using-github-releases#baremetal_release_programming&noheader}} +--> Setting up the Baremetal Projects # 
- +<WRAP GROUP> 
-At this point, the demo is now running on your board. Refer to the [[#description|Description]] section of this document for more information on what it does. <color #ed1c24>alternatively, if more information is required, add an additional outliner dropdown here. Warnings about potential damage to the board should be placed here regardless.</color>+{{section>/programmable-logic/eclypse-z7/environment-setup#import_library_and_demo_projects}}
 ---- ----
-Additional steps beyond here present how you can use the other archive provided in the release, containing the hardware project, to rebuild the Vivado project, and use a newly exported XSA file to update the platform in Vitis. +{{section>/programmable-logic/eclypse-z7/environment-setup#baremetal_project_setup&noheader}}
----- +
-{{page>programmable-logic:guides:using-github-releases#baremetal_update_specification&noheader}} +
- +
 </WRAP> </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>
 ---- ----
-===== Additional Resources ===== 
  
-All materials related to the use of the <color #ed1c24>name the primary product here</color> can be found on its [[FIXME link|Resource Center]].+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.
  
-All materials related to the use of the <color #ed1c24>list other products here</color> can be found on their resource centers, linked below: +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]]. 
-  * [[start|(product) Resource Center]] +===== Additional Resources =====
-  * [[start|(product) Resource Center]]+
  
-For a walkthrough of the process of creating a simple baremetal software project in Vivado and Vitis, see [[programmable-logic:guides:getting-started-with-ipi]]. Information on important parts of the GUIs, and indirect discussion of the steps required to modify, rebuild, and run this demo in hardware can also be found here.+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. For technical support, please visit the [[https://forum.digilentinc.com/forum/4-fpga/|FPGA]] section of the Digilent Forum.
  
----- 
-<color #ed1c24>Some board resource centers use tags to automatically pull their demos into lists. In these cases, the tag syntax in the code block below should be used. Do NOT remove the code block until the page has been finalized, or else it will be pulled automatically into various resource centers.</color> 
-<code>{{tag>project zybo-z7}}</code>