Creating a Linux Application Project - 2023.1 English

Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400)

Document ID
UG1400
Release Date
2023-07-26
Version
2023.1 English

You can create a C or C++ Linux application project by using the New Application Project wizard.

To create a project:

  1. Click File > New > Application Project. The New Application Project wizard appears.

    This will show you the page that guide you to create the application project.

  2. Click Next to open the platform view.
  3. Choose a platform for your project.
    • You can either use a pre-supplied platform (from AMD or another vendor), or a previously created custom platform.
    • You can create one automatically from an exported Vivado hardware project (XSA).

    Click Next to proceed.

  4. Select the Platform that has a Linux domain and click Next.
    Note: If the Linux domain is not present in the platform, add it as shown in the following steps:
    1. After selecting the platform, click Next.
    2. On the system project page, select Show all the processors in the hardware specification option, and then select the Linux processor which is displayed in the list and click Next.
  5. Provide the name of the application project of your choice and select Next.

    This displays the list of domains present in the platform. Optional: You can choose the sysroot, the root file system, and the kernel image path.

    • sysroot provides the header and library files for cross compilation. Usually it's a folder extracted from sdk.sh, which is generated by PetaLinux. Since the content in sysroot contains Linux style symbol link, extracting sdk.sh on Windows does not work. For using Vitis on Windows, sysroot can be a mapped folder from a Linux server.
    • RootFS and Kernel Image are used for packaging the sd_card.img


  6. Click Next to proceed to the Templates page.

    The software platform provides useful sample applications listed in the Templates page that you can use to create your project. The Description box displays a brief description of the selected sample application. When you use a sample application for your project, the Vitis software platform creates the required source and header files and linker script.

  7. Select the desired template. To create a blank project, select Empty Application.

    You can then add C files to the project after the project is created.

  8. Click Finish to create your application project and board support package (if it does not exist).