Creating an Application Component - 2024.2 English - UG1702

Vitis Reference Guide (UG1702)
Document ID
UG1702
Release Date
2025-01-15
Version
2024.2 English

Embedded Application Component

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 the Applications section of the Vitis Embedded Software Development Flow Documentation (UG1400), or as described in Host Application Development in the Embedded Design Development Using Vitis (UG1701).

Data Center Application Component

Application components can also be created to run on x86 processors for use with accelerated systems running on Alveo Data Center accelerator cards as described in Introduction to Data Center Acceleration for Software Programmers in the Data Center Acceleration using Vitis (UG1700). 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 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 in the Data Center Acceleration using Vitis (UG1700). Within the Vitis development flow, you can choose a Data Center acceleration card such as an AMD Alveo™ card.

    There are a number of base platforms installed with the tools, and platforms that you can install and configure.

  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.
  4. Click Add files or Add folders to import source files or folder for the application.
    Note: User could check the option: Copy Sources to Component to copy source files to workspace.
  5. Edit these settings as needed for your source code.