Creating an Application Component - 2023.2 English

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)

Document ID
UG1393
Release Date
2023-12-13
Version
2023.2 English

An Application component can be created for the development of embedded software applications targeted towards embedded processors such as AMD Versal™ adaptive SoC, and AMD Zynq™ MPSoC, as described in Vitis Embedded Software Development Flow Documentation (UG1400), or as described in Introduction to Vitis Tools for Embedded System Designers. Application components can also be created to run on x86 processors for use with accelerated systems running on Alveo Data Center acceleration cards as described in Introduction to Data Center Acceleration for Software Programmers. The following steps describe creating an Application component.

  1. With the AMD Vitis™ IDE opened, from the main menu select File > New Component > Application.

    Tip: You can also select the Create Application Component command from the Welcome page.

    This opens the Name and Location page of the Create Host Component wizard.

  2. Specify the Component Name and Component Location and select Next. This opens the Platform page.
  3. Select a Platform from the list and click Next.

    The choice of a platform in the Application component is an important one. First, you can choose between a fixed platform to support the Vitis Embedded Software Development Flow Documentation (UG1400), or an extensible platform to support the Vitis development flow for application acceleration and heterogeneous system design as described in Introduction to Data Center Acceleration for Software Programmers. Within the Vitis development flow, you can also choose between an embedded processor based design, or a Data Center acceleration card such as an AMD Alveo™ card, or a bare-metal system as described in Creating a Bare-metal System.

    There are a number of base platforms installed with the tools, and platforms that you can install and configure as described in Managing Platform Repositories.

  4. Depending on the Platform selected, the Summary page is displayed for Data Center platforms, and for Embedded Platforms the Domain page is opened to let you select the processor domain for the Application component and then the Summary page is displayed. Select the domain as needed, review the summary page, and click Finish to create the Application component.

After the Application component is created the vitis-comp.json file is opened in the central editor window. You will need to import source files and edit the UserConfig.make to specify needed include files or libraries.

  1. Right-click the Sources folder in the expanded view of the Application component in the Vitis Component Explorer.
  2. Select Import > Files or Import > Folders and import one or more files into the component as needed.
  3. In the Compiler Settings of the vitis-comp.json select the UserConfig.make to open in an editor. Scroll down to Directories, and select Add Item under Include Paths.

    Edit these settings as needed for your source code.