Vitis Unified Software Platform Documentation Embedded Software Development UG1400 (v2019.2) March 18, 2020 Revision History Revision History The following table shows the revision history for this document. Section Revision Summary 03/18/2020 Version 2019.2 Using HSM Mode Added PPK inputs to Stage 0 elements BSP, DTS, and Application Generation in Vivado Removed section 02/28/2020 Version 2019.2 FreeRTOS Analysis using STM Updated flow. TCF Profiling Updated flow. System Performance Modeling Using a User-Defined Flow Updated flow. 12/18/2019 Version 2019.2 Creating a Platform Project Corrected flow. Migrating an SDK Project to the Vitis Software Platform Added new use case. Packaging Drivers for Vitis Added new section. 11/11/2019 Version 2019.2 Vitis 2019.2 Software Platform Release Notes Updated content. Installation Requirements Updated content and removed licensing information. Vitis Software Platform Installation Updated content. 10/30/2019 Version 2019.2 Initial release. N/A UG1400 (v2019.2) March 18, 2020Send Feedback www.xilinx.com Vitis Embedded Software Development 2 Table of Contents Revision History...............................................................................................................2 Section I: Getting Started........................................................................................ 10 Chapter 1: Vitis 2019.2 Software Platform Release Notes.................11 What's in the Vitis Software Platform................................................................................11 Supported Platforms........................................................................................................... 12 Changed Behavior................................................................................................................12 Known Issues........................................................................................................................13 Chapter 2: Installation Requirements......................................................... 14 Install Required CentOS/RHEL Packages.......................................................................... 14 Chapter 3: Vitis Software Platform Installation..................................... 16 Install the Vitis Software Platform..................................................................................... 16 Installing Xilinx Runtime......................................................................................................17 Installing Embedded Platforms..........................................................................................18 Setting Up the Environment to Run the Vitis Software Platform................................... 19 Chapter 4: Vitis Unified Software Platform Overview.........................20 Key Concepts........................................................................................................................ 20 Document Scope and Audience......................................................................................... 21 Chapter 5: Migrating to the Vitis Software Platform from Xilinx SDK................................................................................................................. 22 Workspace Structure in the Vitis Software Platform and SDK........................................22 Workflows in the Vitis Software Platform and SDK..........................................................24 Chapter 6: Quick Start...........................................................................................26 Create a Platform................................................................................................................. 26 Create a Hello World Application....................................................................................... 28 Section II: Using the Vitis IDE............................................................................... 30 UG1400 (v2019.2) March 18, 2020Send Feedback www.xilinx.com Vitis Embedded Software Development 3 Chapter 7: Develop.................................................................................................. 31 Target Platform.................................................................................................................... 31 Applications.......................................................................................................................... 36 Using Custom Libraries in Application Projects............................................................... 56 Chapter 8: Run, Debug, and Optimize..........................................................57 Run Application Project....................................................................................................... 57 Debug Application Project.................................................................................................. 67 Cross-Triggering...................................................................................................................86 Profile/Analyze..................................................................................................................... 93 Optimize.............................................................................................................................. 102 Packaging the System/Utilities.........................................................................................126 Chapter 9: Vitis Utilities......................................................................................129 Xilinx Software Command-Line Tool................................................................................129 Program FPGA.................................................................................................................... 129 Dump/Restore Data File....................................................................................................131 Launch Shell........................................................................................................................131 Import..................................................................................................................................131 Export.................................................................................................................................. 132 Generating Device Tree..................................................................................................... 133 Chapter 10: Embedded Software Development Use Cases in the Vitis Software Platform......................................................................... 135 Creating a Platform Project.............................................................................................. 135 Customizing a Pre-Built Platform.....................................................................................137 Adding Domains to a Platform Project............................................................................138 Creating Applications from Domains in a Platform.......................................................139 Managing Multiple Applications in a System Project.................................................... 142 Creating and Building Applications for XSA Exported from the Vivado Design Suite................................................................................................................................ 144 Switching FSBL Targeting Processor................................................................................146 Creating Multiple Domains for a Single Hardware........................................................ 147 Changing a Referenced Domain...................................................................................... 149 Changing and Updating the Hardware Specification....................................................150 Debugging the Application on Hardware....................................................................... 151 Running and Debugging Applications under a System Project Together ................. 152 UG1400 (v2019.2) March 18, 2020Send Feedback www.xilinx.com Vitis Embedded Software Development 4 Creating a Bootable Image ..............................................................................................152 Flash Programming........................................................................................................... 154 Generating Device Tree..................................................................................................... 155 Debugging an Application using the User-Modified/Custom FSBL.............................155 Modifying the Domain Sources (Driver and Library Code)...........................................156 Migrating an SDK Project to the Vitis Software Platform..............................................160 Section III: Bootgen Tool........................................................................................ 162 Chapter 11: Introduction................................................................................... 163 Installing Bootgen..............................................................................................................164 Boot Time Security............................................................................................................. 164 Chapter 12: Boot Image Layout..................................................................... 166 Zynq-7000 SoC Boot and Configuration.......................................................................... 166 Zynq UltraScale+ MPSoC Boot and Configuration........................................................