Page History

Table of content

Table of Contents

Create Vitis Project from Vivado

New 2019.2 reference designs provide scripts to generate platform project with local repository for the given reference design.

After implementation/bitstream generation run on Vivado TCL console: TE::sw_run_vitis

Scripts generate Platform with the given article name of the project. The overview window will not closed by default in this case, please close or minimise this vitis tab(Image Added).
Image Added

To create all manually see subsections below.

Create XSA with Vivado

This step must be done with Vivado. Synthesis (for xsa without bitstream) or implementation/bitstream step (for xsa with bitstream) must be done before.

File→ Export Hardware...
Image Added

Include local repositories

This step is need for local trenz SDK libraries. Add <reference design folder>/sw_lib to the repository_

Xilinx → Repositories
Image Added

Create Platform project for XSA

On Welcome Window press "Create Platform Project" or "File → New Platform Project"
Add name
Image Added
Select Create from XSA
Image Added
Select XSA File
Depending on usage: Change Operating system or Processor
Recommended: Select Generate Boot components, which generates fsbl for Zynq or ZynqMP devices and pmufw for ZynqMP as separate domain into the Platform project
Image Added

Create Domain

Following Domains will be generated with Platform Project generation (if selected):
- Stand-alone Domain for Stand-alone application (default selected on platform generation step)
- FSBL Domain: for Zynq and ZynqMP devices
- PMU Domain: for ZynqMP devices

Add new domain:

Open Platform Editor (Right click on the Platform project in the Assistant Window)
Image Added
Add Domain (go the the Platform Editor Window)
Image Added
Specify Name and Select OS, Processor and supported runtime:
Image Added
Note: for Linux additional files must be add (BIF, boot files(u-boot.elf for Zynq and ZynqMP, atf firmware (bl31.elf) for ZynqMP) and linux image (image.ub) from petalinux,)
Domain will be generated and can be selected for applications:
Image Added

Modify BSP Settings of the different Domains

Domain BSP modification are need to add for example Xilinx libs or modify BSP setup

On Platform Editor got the the Board Support Package of the Domain which should be modified and press "Modify BSP Settings..."
Image Added
Add need drivers or change default BSP setup
Image Added

Update Platform with modified XSA

Right click on the platform project and pes "Update hardware Specification"
Image Added
Note: if update works depends on the changes in the XSA file (your Vivado PS setup), it's saver to create a new vitis platform project with the new XSA!

Build Platform Project

Right click on the platform project in the Explore Window and press "Build Project" or "Clean Project" to generate/regenerate the platform project elf files
Image Added

Bare-metal Software Application

Applications which are provided with the reference designs, can be generated directly with vivado. After implementation/bitstream generation run on Vivado TCL console: TE::sw_run_vitis -all

Scripts generate Platform and application which are defined in <reference design base folder>\sw_lib\apps-list.csv. App generation needs some more time to finished(depends on PC performance). The overview window will not closed by default in this case, please close or minimise this vitis tab(Image Added).

Bare-metal application need a stand-alone domain, which must be generated at first (see CreateDomain). Stand-alone domain will be generated default with platform generation.

For manual bare metal project generation, see subsections below.

Create Application

Right click on the platform project in the Explore window or "File → New Application Project" on the top menue
Image Added
Set Name:
Image Added
Select Platform
Image Added
Select Domain (shows only generated domains) and language
Image Added
Select application
Image Added
Note: In case application needs some Xilinx libraries (shown as note, in case the app can't be selected for generation), add these libraries to the domain BSP before you try to generate the application.

Build Application

Important: Build Platform Project, in case it's not done before

Select the project in the Explore Window and change active configuration ( Debug or Release Build) and build design
Image Added
To build selected configuration again, use build symbol or right click on the application project in the Explore Window and press "Build Project" or "Clean Project" to generate/regenerate the application project elf files
Image Added
elf file will be generated in the corresponding release/debug folder
Image Added

Debug Software Example

working in process .... coming soon

Create Boot Files

working in process .... coming soon

Zynq

ZynqMP

Microblaze

Linux Software Application

Linux application need a linux domain, which must be generated at first (see CreateDomain). Reference Designs, which includes linux design, generate a linux domain after Vitis project generation with vivado. After implementation/bitstream generation run on Vivado TCL console: TE::sw_run_vitis

Scripts generate Platform and application which are defined in <reference design base folder>\sw_lib\apps-list.csv. The overview window will not closed by default in this case, please close or minimise this vitis tab(Image Added).

For manual linux project generation, see subsections below.

working in process .... coming soon