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:oob [2021/11/16 02:50] – Arthur Brownprogrammable-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 ====== ====== Eclypse Z7 Out of Box Demo ======
- 
-<WRAP round todo> 
-== Under Construction == 
-</WRAP> 
- 
-FIXME add image 
  
 ---- ----
Line 20: Line 14:
   * 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
Line 33: Line 28:
 Get the power supply and USB cable plugged into the board. It can be powered on whenever. Get the power supply and USB cable plugged into the board. It can be powered on whenever.
 </WRAP> <WRAP column half> </WRAP> <WRAP column half>
-FIXME add hw setup image, the eclypse with both zmods plugged in, along with a USB cable and power supply+{{:programmable-logic:eclypse-z7:demos:oob-results.png?600|}}
 </WRAP> </WRAP> </WRAP> </WRAP>
  
---> Download the Demo #+----
  
 Download the demo project with the below command: Download the demo project with the below command:
  
-<code>git clone --recursive https://github.com/Digilent/Eclypse-Z7-SW.git -b oob/master</code>+<code>git clone --recursive https://github.com/Digilent/Eclypse-Z7.git -b OOB/master</code>
    
-The directory created when you run this command ("Eclypse-Z7-SW"), will be used as the Xilinx SDK workspace in later steps.+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#vivado_hw_repositories]] documentation.+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.
  
 ---- ----
  
-FIXME Import Projects+<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>
  
 ---- ----
  
-FIXME Build Projects+<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>
  
 ---- ----
  
-FIXME Run the App+<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>
  
 ---- ----
  
-FIXME Create Flash Image+<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>
  
 ---- ----
  
-FIXME Program Flash+<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> <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. 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> </WRAP> <WRAP column half>
-FIXME add results image+{{ :programmable-logic:eclypse-z7:demos:oob-tera-term.png?600 |}}
 </WRAP> </WRAP> </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. 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.