DESK-XZU-L/Development/Creating and building the Vivado project

History
Issue Date	Notes
2026/06/03	DESK-XZU-L-2.0.0 release

Vivado installation path, in this documentation, is the /opt directory. If you have chosen a different one, set it properly. The commands reported here below have been used on a native server running Ubuntu 20.04.

Creating and building the Vivado project

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_onda_eg.tcl	uSD and eMMC
recreate_prj_onda_ev.tcl	uSD and eMMC

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

• clone the repository:

git clone git@git.dave.eu:desk-xz-l/vivado.git -b desk-xzu-l-2.0.0
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-xzu-l-2.0.0
cd petalinux/vivado

• (only once as first tools setup) copy ONDA hardware definition into Vivado installation path:

cp -r boards/ <vivado directory installation>/Xilinx/2024.2/Vivado/2024.2/data/

• lunch Vivado Design Suite with the following commands and parameters

for XCZU5EG (XCZU5EG-1SFVC784I):

source <vivado directory installation>/Xilinx/2024.2/Vivado/2024.2/settings64.sh
vivado -mode tcl -source scripts/recreate_prj_onda_eg.tcl -notrace -tclargs "gen_bitstream"

for XCZU5EV (XCZU5EV-1SFVC784I):

source <vivado directory installation>/Xilinx/2024.2/Vivado/2024.2/settings64.sh
vivado -mode tcl -source scripts/recreate_prj_onda_ev.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/onda.xpr is ready for customization through the Vivado GUI
    

    Load xpr file from Vivado GUI
  • the bitstream files for XCZU5EG (XCZU5EG-1SFVC784I) are
    • vivado/onda_eg.runs/impl_1/onda_eg_wrapper.bit
    • vivado/onda_eg.runs/impl_1/onda_eg_wrapper.bin
  • the bitstream files for XCZU5EV (XCZU5EV-1SFVC784I) are
    • vivado/onda_ev.runs/impl_1/onda_ev_wrapper.bit
    • vivado/onda_ev.runs/impl_1/onda_ev_wrapper.bin
  • the hardware design file vivado/onda_eg.xsa or vivado/onda_ev.xsa is ready for the import into Petalinux