Vitis

Table of content

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().

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...

Include local repositories

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

Xilinx → Repositories

Create Platform project for XSA

On Welcome Window press "Create Platform Project" or "File → New Platform Project"
Add name
Select Create from XSA
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

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)
Add Domain (go the the Platform Editor Window)
Specify Name and Select OS, Processor and supported runtime:

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:

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..."
Add need drivers or change default BSP setup

Update Platform with modified XSA

Right click on the platform project and pes "Update hardware Specification"

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

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().

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
Set Name:
Select Platform
Select Domain (shows only generated domains) and language
Select application

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
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
elf file will be generated in the corresponding release/debug folder

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().

For manual linux project generation, see subsections below.

working in process .... coming soon