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:cmod-a7:demos:oob [2021/05/14 23:04] – ↷ Page moved from reference:programmable-logic:cmod-a7:demos:oob to programmable-logic:cmod-a7:demos:oob Arthur Brownprogrammable-logic:cmod-a7:demos:oob [2022/10/04 11:38] (current) – external edit 127.0.0.1
Line 21: Line 21:
   * Cmod A7 with MicroUSB programming cable   * Cmod A7 with MicroUSB programming cable
   * Vivado and Vitis installations compatible with the latest release of this demo (2020.1)   * Vivado and Vitis installations compatible with the latest release of this demo (2020.1)
-    * //See [[reference:programmable-logic:guides:installation|Installing Vivado, Vitis, and Digilent Board Files]] for installation instructions.//+    * //See [[programmable-logic:guides:installing-vivado-and-vitis|Installing Vivado, Vitis, and Digilent Board Files]] for installation instructions.//
   * Serial Terminal application to receive messages printed by the demo   * Serial Terminal application to receive messages printed by the demo
-    * //See [[learn/programmable-logic/tutorials/tera-term]] for more information.//+    * //See [[programmable-logic:guides:serial-terminals:start]] for more information.//
  
 ---- ----
Line 40: Line 40:
 | Cmod A7-35T  | v2016.4-1            | [[https://github.com/Digilent/Cmod-A7-35T-OOB/releases/tag/v2016.4-1|Release ZIP Downloads]]  | [[learn/programmable-logic/tutorials/github-demos/start|Using Digilent Github Demo Projects (Legacy)]]  | | Cmod A7-35T  | v2016.4-1            | [[https://github.com/Digilent/Cmod-A7-35T-OOB/releases/tag/v2016.4-1|Release ZIP Downloads]]  | [[learn/programmable-logic/tutorials/github-demos/start|Using Digilent Github Demo Projects (Legacy)]]  |
  
-**Note for Advanced Users:** //All demos for the Cmod A7 are provided through the [[https://github.com/Digilent/Cmod-A7|Cmod-A7]] repository on Github. Further documentation on the structure of this repository can be found on this wiki's [[reference:programmable-logic:documents:git]] page.//+**Note for Advanced Users:** //All demos for the Cmod A7 are provided through the [[https://github.com/Digilent/Cmod-A7|Cmod-A7]] 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: Instructions on the use of the latest release can be found in this dropdown:
Line 47: Line 47:
 <WRAP group> <WRAP group>
  
-{{page>reference:programmable-logic:guides:using-github-releases#baremetal_release_before_programming&noheader}}+{{page>programmable-logic:guides:using-github-releases#baremetal_release_no_build&noheader}} 
 + 
 +--> Apply Fix for Vitis 2020.1 Bug # 
 +<WRAP round important> 
 +Due to a bug in the 2020.1 version of Xilinx's Vitis IDE, two more steps are needed for the project to import correctly. If you are using another version of Vitis, ignore this section. 
 +</WRAP> 
 +<WRAP group><WRAP column half> 
 +After importing the project, open the **.sprj** file. In the System Project Settings, select a platform by clicking on the **''...''** icon, as shown in the image. Select the platform presented and click Ok.  
 +</WRAP><WRAP column half> 
 +{{:reference:programmable-logic:guides:workaround1.png?600|}} 
 +</WRAP></WRAP> 
 +---- 
 +<WRAP group><WRAP column half> 
 +Right click on the **.prj** file and select **Properties**. In the opened window, go into **C/C++ Build** and select **Settings**, as shown in the image. After opening the Settings tab, select **Linker Script** and change the existing path to ''../src/lscript.ld''. 
 +</WRAP><WRAP column half> 
 +{{:reference:programmable-logic:guides:workaround2.png?600|}} 
 +</WRAP></WRAP> 
 +---- 
 +Also found in the C/C++ Build Settings, select **Directories** under **MicroBlaze gcc compiler** and edit the listed path to change it to ''../src''. 
 + 
 +Click Yes when prompted to rebuild the index. 
 + 
 +Click Apply and Close. 
 +The project is now imported correctly. 
 +---- 
 +<-- 
 + 
 +--> Build a Vitis Application # 
 +<WRAP group> 
 +{{page>programmable-logic:guides:vitis-build-software&noheader}} 
 +</WRAP> 
 +<--
  
 --> Set up the Cmod A7 # --> Set up the Cmod A7 #
Line 55: Line 86:
 <-- <--
  
-{{page>reference:programmable-logic:guides:using-github-releases#baremetal_release_programming&noheader}}+{{page>programmable-logic:guides:using-github-releases#baremetal_release_programming&noheader}}
  
 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. 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.
Line 61: Line 92:
 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. 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.
 ---- ----
-{{page>reference:programmable-logic:guides:using-github-releases#baremetal_update_specification&noheader}}+{{page>programmable-logic:guides:using-github-releases#baremetal_update_specification&noheader}}
  
  
Line 88: Line 119:
 All materials related to the use of the Cmod A7 can be found on its [[..:start|Resource Center]]. All materials related to the use of the Cmod A7 can be found on its [[..:start|Resource Center]].
  
-For a walkthrough of the process of creating a simple baremetal software project in Vivado and Vitis, see [[reference: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.+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.
  
 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.