Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
programmable-logic:eclypse-z7:demos:oob [2022/09/12 12:18] – changed forum.digilentinc.com to forum.digilent.com jeff.greenberg_ni.comprogrammable-logic:eclypse-z7:demos:oob [2022/10/04 11:38] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +====== Eclypse Z7 Out of Box Demo ======
 +
 +----
 +===== Description =====
 +
 +The Out-of-Box demo is programmed into the Eclypse's flash memory at the time of manufacturing. As the demo does not make use of any Zmods, it may not be the most useful, however, it is presented here in case you want to review its sources or reprogram the flash.
 +
 +----
 +===== Inventory =====
 +
 +  * Eclypse Z7
 +  * Vivado and Xilinx SDK installations compatible with the latest release of this demo (2019.1)
 +    * //See [[vivado/getting_started/start]] for installation instructions.//
 +  * 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
 +
 +----
 +===== 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.
 +
 +<WRAP group> <WRAP column half>
 +The Out-of-Box demo doesn't use any Zmods, but it is perfectly safe to have them plugged in while running it. It should be noted that Zmods are not hot-swappable.
 +
 +Get the power supply and USB cable plugged into the board. It can be powered on whenever.
 +</WRAP> <WRAP column half>
 +{{:programmable-logic:eclypse-z7:demos:oob-results.png?600|}}
 +</WRAP> </WRAP>
 +
 +----
 +
 +Download the demo project with the below command:
 +
 +<code>git clone --recursive https://github.com/Digilent/Eclypse-Z7.git -b OOB/master</code>
 + 
 +The ''sw'' subdirectory of the folder created when you run this command ("Eclypse-Z7"), will be used as the Xilinx SDK workspace in later steps.
 +
 +If you want to download the Vivado and PetaLinux projects at the same time, instead clone the ''Eclypse-Z7'' repository (still using the ''oob/master'' branch). Instructions on working with these projects, as well as on how to check them out from source, can be found in the [[../git]] documentation.
 +
 +----
 +
 +<WRAP group> <WRAP column half>
 +Launch Xilinx SDK and select the software folder as the workspace.
 +</WRAP> <WRAP column half>
 +{{ :programmable-logic:eclypse-z7:demos:setws.png?600 |}}
 +</WRAP> </WRAP>
 +
 +----
 +
 +<WRAP group> <WRAP column half>
 +The projects in the repository now need to be added to the workspace.
 +
 +Click the "Import Project" button.
 +</WRAP> <WRAP column half>
 +{{:programmable-logic:eclypse-z7:demos:sdk-import.png?400|}}
 +</WRAP> </WRAP>
 +
 +----
 +
 +<WRAP group> <WRAP column half>
 +Choose the directory previously chosen as the workspace as the root directory, make sure all of the project boxes (that aren't grayed out) are checked and click **Finish**.
 +</WRAP> <WRAP column half>
 +{{ :programmable-logic:eclypse-z7:demos:import-project.png?400 |}}
 +</WRAP> </WRAP>
 +
 +----
 +
 +<WRAP group> <WRAP column half>
 +Next, make sure the projects have been built and select "Xilinx Tools -> Create Boot Image" from the menu at the top of the window. In the dialog that pops up, pick memorable locations to put the boot image format (BIF) file and the binary boot image ("boot.bin"). "Add" the FSBL ELF file (found in the FSBL's Debug folder), the bitstream (found in the hardware platform), and the application ELF file (found in the application's Debug folder) to the image in that order. Click "Create Image" to continue.
 +</WRAP> <WRAP column half>
 +{{ :programmable-logic:eclypse-z7:demos:create-boot-image.png?600 |}}
 +</WRAP> </WRAP>
 +
 +----
 +
 +<WRAP group> <WRAP column half>
 +Next, make sure that the Eclypse is plugged in and the programming mode select jumper is set to JTAG. Select "Xilinx Tools -> Program Flash", select the BOOT.bin file you just created for the Image File field, and enter the FSBL ELF file into the "FSBL File" field. Everything else can remain as default. Click "Program" to continue. The process of programming the flash may take several minutes.
 +</WRAP> <WRAP column half>
 +{{ :programmable-logic:eclypse-z7:demos:program-flash-memory.png?400 |}}
 +</WRAP> </WRAP>
 +
 +----
 +
 +Finally, switch the programming mode select jumper to QSPI and power cycle the board to boot the demo.
 +
 +----
 +
 +<WRAP group> <WRAP column half>
 +When the project is run, the LEDs will begin cycling, and, whenever one of the buttons is pressed, the message "Button # pressed!" is printed to a connected serial console.
 +</WRAP> <WRAP column half>
 +{{ :programmable-logic:eclypse-z7:demos:oob-tera-term.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.
 +
 +----
 +===== Additional Resources =====
 +
 +All materials related to the use of the Eclypse Z7 can be found on its [[../start|Resource Center]].
 +
 +For technical support, please visit the [[https://forum.digilentinc.com/forum/4-fpga/|FPGA]] section of the Digilent Forum.