Difference between revisions of "DESK-XZ7-L/Development/Creating and building the Vivado project"

From DAVE Developer's Wiki
Jump to: navigation, search
Line 9: Line 9:
 
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000"|DESK-XZ7-L-1.0.0-rc1 release
 
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000"|DESK-XZ7-L-1.0.0-rc1 release
 
|-
 
|-
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000"|2024/01/12
+
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000"|2024/01/25
 
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000"|DESK-XZ7-L-1.0.1 release
 
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000"|DESK-XZ7-L-1.0.1 release
 
|-
 
|-
Line 20: Line 20:
 
The Vivado repository allows to:
 
The Vivado repository allows to:
 
* track hardware/fpga related sources/configuration
 
* track hardware/fpga related sources/configuration
* reproduce hardware design output (FPGA bitstream, XSA) using TCL scripts. Development kit TCL scripts supported are as follow:
+
* reproduce hardware design output (FPGA bitstream, XSA) using TCL scripts
 +
 
 +
Development kit TCL scripts supported are the following one:
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 40: Line 42:
 
|}
 
|}
  
Take ''Bora'' platform for example, to reproduce the build, user just need to:
+
As an example, to reproduce the build for the ''Bora'' platform, here below are the steps:
 
* clone the repository:
 
* clone the repository:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
Line 47: Line 49:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
or you can clone Vivado repository when you clone Petalinux repository
+
or clone the Vivado repository when you clone Petalinux repository
  
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
Line 54: Line 56:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
* (only once as first tools setup) copy ''Bora'' hardware definition into Vivado installation.:
+
* (only once as first tools setup) copy ''Bora'' hardware definition into Vivado installation path:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
cp -r boards/ /opt/Xilinx/2021.2/Vivado/2021.2/data/
 
cp -r boards/ /opt/Xilinx/2021.2/Vivado/2021.2/data/
 
</syntaxhighlight>
 
</syntaxhighlight>
* lunch Vivado Design Suite with the following command:
+
* lunch Vivado Design Suite with the following commands and parameters:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
source /opt/Xilinx/2021.2/Vivado/2021.2/settings64.sh
 
source /opt/Xilinx/2021.2/Vivado/2021.2/settings64.sh
 
vivado -mode tcl -source scripts/recreate_prj_bora_BASE.tcl -notrace -tclargs "gen_bitstream"
 
vivado -mode tcl -source scripts/recreate_prj_bora_BASE.tcl -notrace -tclargs "gen_bitstream"
 
</syntaxhighlight>
 
</syntaxhighlight>
* at the end of bitstream build process, the script automatically exports hardware
+
* at the end of the bitstream build process, the script automatically exports the Xilinx Support Archive ('''XSA''') hardware design
** The Vivado project ready for customization through Vivado GUI is available into <code>vivado/bora.xpr</code>
+
** the Vivado project <code>vivado/bora.xpr</code> is ready for customization through the Vivado GUI
** The bitstream file is now present in
+
** the bitstream files are
 
*** <code>vivado/bora.runs/impl_1/bora_wrapper.bit</code>
 
*** <code>vivado/bora.runs/impl_1/bora_wrapper.bit</code>
 
*** <code>vivado/bora.runs/impl_1/bora_wrapper.bin</code>
 
*** <code>vivado/bora.runs/impl_1/bora_wrapper.bin</code>
** The hardware export, ready for import into Petalinux, is available in <code>vivado/bora.xsa</code>
+
** the hardware design file <code>vivado/bora.xsa</code> is ready for the import into Petalinux
 +
 
 
<section end=Body/>
 
<section end=Body/>
  
----
+
[[Category:BORA]] [[Category:BORA Xpress]][[Category:BORA Lite]]
 
 
[[Category:BORA]]
 

Revision as of 09:44, 25 January 2024

History
Issue Date Notes
2022/11/15 DESK-XZ7-L-1.0.0-rc1 release
2024/01/25 DESK-XZ7-L-1.0.1 release



Creating and building the Vivado project[edit | edit source]

The Vivado repository allows to:

  • track hardware/fpga related sources/configuration
  • reproduce hardware design output (FPGA bitstream, XSA) using TCL scripts

Development kit TCL scripts supported are the following one:

Script Boot
recreate_prj_bora.tcl uSD and QSPI-NOR
recreate_prj_borax_BASE.tcl uSD and QSPI-NOR
recreate_prj_boralite_BASE.tcl uSD and QSPI-NOR
recreate_prj_boralite_NAND.tcl uSD and NAND

As an example, to reproduce the build for the Bora platform, here below are the steps:

  • clone the repository:
git clone git@git.dave.eu:desk-xz-l/vivado.git -b desk-xz7-l-1.0.1
cd vivado

or clone the Vivado repository when you clone Petalinux repository

git clone --recursive git@git.dave.eu:desk-xz-l/petalinux.git -b desk-xz7-l-1.0.1
cd petalinux/vivado
  • (only once as first tools setup) copy Bora hardware definition into Vivado installation path:
cp -r boards/ /opt/Xilinx/2021.2/Vivado/2021.2/data/
  • lunch Vivado Design Suite with the following commands and parameters:
source /opt/Xilinx/2021.2/Vivado/2021.2/settings64.sh
vivado -mode tcl -source scripts/recreate_prj_bora_BASE.tcl -notrace -tclargs "gen_bitstream"
  • at the end of the bitstream build process, the script automatically exports the Xilinx Support Archive (XSA) hardware design
    • the Vivado project vivado/bora.xpr is ready for customization through the Vivado GUI
    • the bitstream files are
      • vivado/bora.runs/impl_1/bora_wrapper.bit
      • vivado/bora.runs/impl_1/bora_wrapper.bin
    • the hardware design file vivado/bora.xsa is ready for the import into Petalinux