Differences

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

Link to this comparison view

programmable-logic:eclypse-z7:start [2022/02/02 11:53] – [Additional Resources] Arthur Brownprogrammable-logic:eclypse-z7:start [2022/10/04 04:38] (current) – external edit 127.0.0.1
Line 58: Line 58:
 }} }}
  
-{{page>reference-manual}} \\ \\+{{page>reference-manual}} 
 + 
 +This page is the resource center for the Eclypse Z7, where you will find all of Digilent’s support materials and documentation for the Eclypse, including fully open and customizable hardware designs, baremetal software examples, and Linux images. 
 + 
 +{{section>reference-manual#image_gallery}} 
 + 
 +\\ \\ 
 + 
 +===== Getting Started ===== 
 + 
 +  * [[programmable-logic/eclypse-z7/getting-started-guide]]
  
 ===== Documentation ===== ===== Documentation =====
  
-  * [[getting-started-guide|Eclypse Z7 Getting Started Guide]] +  * [[programmable-logic/eclypse-z7/reference-manual]] 
-  * [[reference-manual]] +  * [[programmable-logic/eclypse-z7/git]] 
-  * [[git|Eclypse Z7 Git Repository Documentation]] +  * [[https://docs.xilinx.com/v/u/en-US/ds180_7Series_Overview|Xilinx 7 Series FPGAs Data Sheet: Overview]] 
-  * [[https://www.xilinx.com/support/documentation/data_sheets/ds180_7Series_Overview.pdf|Xilinx 7 Series FPGAs Data Sheet: Overview]]+  * [[https://docs.xilinx.com/v/u/en-US/ug585-Zynq-7000-TRM|Xilinx Zynq-7000 Technical Reference Manual (UG585)]]
   * [[https://github.com/Digilent/digilent-xdc|Master XDC Files for Digilent Boards]]   * [[https://github.com/Digilent/digilent-xdc|Master XDC Files for Digilent Boards]]
   * [[https://github.com/Digilent/vivado-boards|Board Files for Digilent Boards]]   * [[https://github.com/Digilent/vivado-boards|Board Files for Digilent Boards]]
Line 75: Line 85:
  
 ---- ----
- 
 ===== Peripherals ===== ===== Peripherals =====
  
-  * The Eclypse Z7 is compatible with [[zmod:start|Digilent Zmods]], as well as other modules that conform to Opal Kelly's [[https://syzygyfpga.io|SYZYGY Standard Specification]]. A list of Digilent Zmods can be found through their start page, linked above. Digilent provides IP cores, hierarchical blocks, software libraries, and example projects to support the use of each Digilent Zmod. Guides and documentation on the use of these systems can be found below.+  * The Eclypse Z7 is compatible with [[zmod:start|Digilent Zmods]], as well as other modules that conform to Opal Kelly's [[https://syzygyfpga.io|SYZYGY Standard Specification]]. A list of Digilent Zmods can be found through their start page, linked above.
  
   * The Eclypse Z7 is compatible with modules that conform to Digilent's Pmod™ Specification, including Digilent's line of [[pmod:start|Pmods]].   * The Eclypse Z7 is compatible with modules that conform to Digilent's Pmod™ Specification, including Digilent's line of [[pmod:start|Pmods]].
  
 ---- ----
- 
 ===== Development Environments ===== ===== Development Environments =====
 **Important:** //The Eclypse Z7's tutorials, projects, and system images target Vivado 2019.1, Xilinx SDK 2019.1, and Petalinux 2019.1, and are not officially supported in other versions of Vivado.// **Important:** //The Eclypse Z7's tutorials, projects, and system images target Vivado 2019.1, Xilinx SDK 2019.1, and Petalinux 2019.1, and are not officially supported in other versions of Vivado.//
Line 91: Line 99:
  
 == Petalinux == == Petalinux ==
-  * Petalinux is a tool created by Xilinx, used for the creation and modification of Linux images for Xilinx chips, including the Zynq-7000. \\ Xilinx's [[https://www.xilinx.com/support/documentation/sw_manuals/xilinx2019_1/ug1144-petalinux-tools-reference-guide.pdf|Petalinux Tools Reference Guide (UG1144)]] covers installation and usage of Petalinux. Chapter 2 discusses the installation process. \\ **Note:** //For Windows users, Digilent recommends the use of either a dual-boot Linux setup or virtual machine that fits the requirements specified in UG1144, linked above.//+  * Petalinux is a tool created by Xilinx, used for the creation and modification of Linux images for Xilinx chips, including the Zynq-7000. \\ Xilinx's [[https://docs.xilinx.com/v/u/2019.1-English/ug1144-petalinux-tools-reference-guide|Petalinux Tools Reference Guide (UG1144)]] covers installation and usage of Petalinux. Chapter 2 discusses the installation process. \\ **Note:** //For Windows users, Digilent recommends the use of either a dual-boot Linux setup or virtual machine that fits the requirements specified in UG1144, linked above.//
  
 ---- ----
 ===== Example Projects ===== ===== Example Projects =====
  
-There are three categories of example project available for the Eclypse Z7, //Petalinux Software Projects//, //Baremetal Software Projects//, and //Standalone Hardware Projects//.+  * [[/programmable-logic/eclypse-z7/demos/zmod-scope]] is a software demo (Baremetal and PetaLinux) that captures data from the <nowiki>ADC</nowiki> and writes it out to a file (in PetaLinux) and standard out. This demo uses the Zmod Library and the initial release of the Zmod IPs. Zmod Scope variants other than the 1410-105 are not supported.
  
-  * //Petalinux Software Projects// target an Eclypse running a Linux <nowiki>OS</nowiki> from an SD card, and at minimum require Xilinx SDK and a prebuilt Linux image to be built and run on the board. Changes to the hardware design require the use of Vivado and Petalinux to build the hardware and reconfigure the <nowiki>OS</nowiki> for the modifications. +  * [[/programmable-logic/eclypse-z7/demos/zmod-awg]] is a software demo (Baremetal and PetaLinux) that outputs a ramp waveform through one of the channels of the Zmod AWG. This demo uses the Zmod Library and the initial release of the Zmod IPs.
-  * //Baremetal Software Projects// use the Zynq Processing System (PS) and Programmable Logic (PL), and at minimum require Xilinx SDK and a prebuilt hardware handoff file (HDF) to be built and run on the board. Changes to the hardware design require the use of Vivado to modify and build the new new hardware, and to export a new HDF. +
-  * //Standalone Hardware Projects// use only the Zynq Programmable Logic (PL), and require Vivado to be built and run on the board.+
  
-The table below lists each demo available for the Eclypse Z7:+  * [[/programmable-logic/eclypse-z7/demos/low-level-low-pass-filter]] is a hardware-only demo that captures data from a Zmod Scope, passes it through a FIR filter in the Zynq PL, and outputs it through a Zmod AWG. The latest release of the Zmod IPs is used, and all variants of the Zmod Scope are supported.
  
-^ Demo Name ^ Type of Project ^ Description ^ Setup Instructions ^ +  * The [[/programmable-logic/eclypse-z7/demos/oob]] is programmed into flash memory during manufacturing of the Eclypse. Baremetal software is used to cycle the RGB LEDs and report button states over UART.
-| Zmod <nowiki>ADC</nowiki> Demo | Baremetal and Petalinux Software | Captures data from the <nowiki>ADC</nowiki> and writes it out to a file and standard out. | Found in Section 3 of the [[zmod:zmodbaselibraryuserguide]] | +
-| Zmod <nowiki>DAC</nowiki> Demo | Baremetal and Petalinux Software | Outputs a ramp waveform through one of the <nowiki>DAC</nowiki> channels. | Found in Section 3 of the [[zmod:zmodbaselibraryuserguide]] | +
-| Out-of-Box Demo | Baremetal Software | Programmed into Flash during manufacturing. Can be used to ensure that the board is functional. | Found in the [[https://github.com/Digilent/Eclypse-Z7-HW/tree/oob/master|OOB Demo's Github README]] | +
-| Low Level Zmod <nowiki>ADC</nowiki> + <nowiki>DAC</nowiki> Demo | Standalone Hardware | Captures data from the <nowiki>ADC</nowiki>, and outputs the result of passing that signal through a FIR filter through the <nowiki>DAC</nowiki>. | [[programmable-logic:eclypse-z7:low_level_zmod_adc_dac]] |+
  
 ---- ----
-===== Tutorials, Guides, and Documentation for the Eclypse Platform =====+===== Support for Zmods ===== 
 +As of the time of writing, two different versions of the Zmod IPs used to provide a hardware interface from the Zynq PL to the Zmods exist. These two versions have different pros and cons. In short, at the time of writing, the latest release supports all of the variants of the Zmod Scope but does not yet support Petalinux or Baremetal software projects, while the initial release fully supports software, but does not support variants of the Zmod Scope other than the 1410-105.
  
-=== Software ===+=== Latest Release === 
 +The Zmod AWG 1411 Controller and Zmod Scope 1410 Controller make up the second release of the low-level controller IP. No compatible software libraries are available at the time of writing.
  
-  * [[zmod:zmodbaselibraryuserguide]] +For a hardware-only project demonstrating their use, see the [[/programmable-logic/eclypse-z7/demos/low-level-low-pass-filter]].
-    * The documentation of the Zmod Base Library includes the steps necessary to to run one of several Digilent-provided software examples on the Eclypse Platform.+
  
-=== Hardware ===+  * [[https://github.com/Digilent/vivado-library/blob/zmod/v2/2019.1-2/ip/Zmods/ZmodScopeController/docs/ZmodScopeController.pdf|Zmod Scope Controller IP Core User Guide]] 
 +  * [[https://github.com/Digilent/vivado-library/blob/zmod/v2/2019.1-2/ip/Zmods/ZmodAWGController/docs/ZmodAWG1411_Controller.pdf|Zmod AWG 1411 Controller IP Core User Guide]]
  
 +----
 +=== Initial Release ===
 +== Zmod AWG == 
 +The initial release of demos for the Eclypse and Zmod AWG used the Zmod Library to control the Zmod AWG through the Zmod DAC 1411 AXI Adapter and Zmod DAC 1411 Low Level Controller IPs.
 +
 +[[/programmable-logic/eclypse-z7/demos/zmod-awg]] is a software demo (Baremetal and PetaLinux) that outputs a ramp waveform through one of the channels of the Zmod AWG. This demo uses the Zmod Library and the initial release of the Zmod IPs.
 +
 +  * [[/zmod/zmodbaselibraryuserguide]].
 +  * [[zmod:awg:zmoddac1411libraryuserguide]]
 +  * [[https://github.com/Digilent/vivado-library/blob/zmod/v1/2019.1-2/ip/Zmods/AXI_Zmod_DAC1411/doc/ZmodDAC1411AxiAdapter.pdf|Zmod DAC 1411 AXI Adapter User Guide]]
 +  * [[https://github.com/Digilent/vivado-library/blob/zmod/v1/2019.1-2/ip/Zmods/ZmodDAC1411_Controller/docs/ZmodDAC1411LLC.pdf|Zmod DAC 1411 Low Level Controller User Guide]]
 +
 +----
 +== Zmod Scope ==
 +The initial release of demos for the Eclypse and Zmod Scope used the Zmod Library to control the Zmod Scope through the Zmod ADC1410 AXI Adapter and Zmod ADC 1410 Low Level Controller IPs. These IPs are **only** compatible with the Zmod Scope 1410-105 (formerly the Zmod ADC 1410).
 +
 +[[/programmable-logic/eclypse-z7/demos/zmod-scope]] is a software demo (Baremetal and PetaLinux) that performs an immediate capture of 10 μs of data from channel one of the Zmod Scope and writes it to standard out and (in Linux) a file. This demo uses the Zmod Library and the initial release of the Zmod IPs.
 +
 +  * [[/zmod/zmodbaselibraryuserguide]].
 +  * [[zmod:scope:zmodadc1410libraryuserguide]]
 +  * [[https://github.com/Digilent/vivado-library/blob/zmod/v1/2019.1-2/ip/Zmods/AXI_Zmod_ADC1410/docs/ZmodADC1410AxiAdapter.pdf|Zmod ADC 1410 AXI Adapter User Guide]]
 +  * [[https://github.com/Digilent/vivado-library/blob/zmod/v1/2019.1-2/ip/Zmods/ZmodADC1410Controller/docs/ZmodADC1410LLC.pdf|Zmod ADC 1410 Low Level Controller User Guide]]
 +
 +----
 +===== Additional Tutorials and Guides for the Eclypse Platform =====
 +
 +  * [[zmod:zmodbaselibraryuserguide]]
 +    * The documentation of the Zmod Base Library includes the steps necessary to run one of several Digilent-provided software examples on the Eclypse Platform.
 +    * **Note:** //The Zmod Library is only compatible with the initial release of the Zmod IPs, as described above.//
   * [[:vivado:getting-started-with-ipi:start]]   * [[:vivado:getting-started-with-ipi:start]]
     * This tutorial covers the creation of a basic baremetal application that blinks an <nowiki>LED</nowiki>. Vivado IPI is used to design the system and Xilinx SDK is used to develop the application.     * This tutorial covers the creation of a basic baremetal application that blinks an <nowiki>LED</nowiki>. Vivado IPI is used to design the system and Xilinx SDK is used to develop the application.
   * [[learn:programmable-logic:tutorials:vivado-hierarchical-blocks:start]]   * [[learn:programmable-logic:tutorials:vivado-hierarchical-blocks:start]]
     * This tutorial covers the addition of a hierarchical block supporting a specific peripheral, whether Pmod or Zmod, to an existing IPI design, adding required library source files to a baremetal Xilinx SDK application project, and running an example on the board.     * This tutorial covers the addition of a hierarchical block supporting a specific peripheral, whether Pmod or Zmod, to an existing IPI design, adding required library source files to a baremetal Xilinx SDK application project, and running an example on the board.
-  * [[customizing-zmods-os|]]+  * [[/programmable-logic/eclypse-z7/customizing-zmods-os]]
     * This tutorial covers the steps necessary to configure and build the Eclypse Z7 Petalinux project to support a new Zmod configuration.     * This tutorial covers the steps necessary to configure and build the Eclypse Z7 Petalinux project to support a new Zmod configuration.
- 
----- 
-=== Additional Guides === 
-  * [[:vivado:getting_started:start]] 
-    * This tutorial covers the creation of a basic design that blinks an <nowiki>LED</nowiki>, written in an RTL language. The processor is not used. 
-  * [[learn:programmable-logic:tutorials:pmod-ips:start]] 
-    * This tutorial covers the basics of Pmod IPs, Creating a simple Vivado IPI design and Xilinx SDK application to run an example on the board. Pmod IPs are not supported by default in Petalinux. 
  
 ---- ----
Line 138: Line 164:
   * [[https://github.com/Digilent/Eclypse-Z7-OOB|Eclypse Z7 Out-of-Box Demo (GitHub)]]   * [[https://github.com/Digilent/Eclypse-Z7-OOB|Eclypse Z7 Out-of-Box Demo (GitHub)]]
   * {{reference:programmable-logic:eclypse-z7:eclypsez7_pcbas_a5.pdf|Mechanical Diagrams for the Eclypse Z7}}   * {{reference:programmable-logic:eclypse-z7:eclypsez7_pcbas_a5.pdf|Mechanical Diagrams for the Eclypse Z7}}
 +  * [[https://files.digilent.com/resources/whitepapers/Digilent-Designing_A_Filter_On_MATLAB.pdf|Whitepaper - Designing and Verifying a Digital Filter Using MATLAB With Eclypse Z7 as FPGA-in-the-Loop]]
 +
   * [[https://vaxelinc.com/downloads/|VAXEL Resources]]   * [[https://vaxelinc.com/downloads/|VAXEL Resources]]
 +    * VAXEL-EZ boosts the productivity of algorithm verification processes on Digilent FPGA boards. The package includes a set of utility software that runs on Windows to facilitate tasks ranging from automation of FPGA synthesis to execution of tests. With VAXEL-EZ, no FPGA expertise is needed to take full advantage of the Digilent FPGA boards.
  
 ---- ----
 {{tag>resource-center}} {{tag>resource-center}}