Creating an Application Component - 2023.1 English

Vitis Unified IDE and Common Command-Line Reference Manual (UG1553)

Document ID
UG1553
Release Date
2023-07-17
Version
2023.1 English
An Application component can be created and compiled as a standalone component, or integrated with other components into a System project.
  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 Embedded Software Development Flow, or an extensible platform to support the Vitis development flow for application acceleration and heterogeneous system design as described in Introduction to Vitis Tools for Embedded System Designers. 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.

    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.
  5. Import source files
  6. Configure Compiler settings by clicking the on the Application Component Settings page.

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 CMakeLists.txt to specify needed include files or libraries.

  1. Right-click the Sources folder in the expanded view of the Application component in the Component Explorer.
  2. Select Import > Files or Import > Folders and import one or more files into the component as needed.
  3. In the Application Component Settings of the vitis-comp.json select the CMakeLists.txt to open the file. Scroll down the file contents until you come to the ### USER SETTINGS START ###. At this point you can add to the USER_COMPILE_DEFINITIONS, USER_COMPILE_OPTIONS, USER_INCLUDE_DIRECTORIES, and a number of other settings. Edit these settings as needed for the source code.
    Note: Insert your text between the quote marks for the various sections as shown below:
    set(USER_INCLUDE_DIRECTORIES
    "../aiegraph/aie"
    )