Packaging a platform component - 2023.2 English

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

Document ID
Release Date
2023.2 English

There are a number of ways to create a Platform component in the new Vitis Unified IDE. The following steps describe a recommended approach. For a description of the views and pages mentioned in the steps below refer to Working with the Vitis Unified IDE.

  1. With the Vitis IDE open, from File menu options, click New Component > Platform.
    Tip: You can also select the Create Platform Component command from the Welcome page, or from the right-click menu in the Explorer view.
  2. This opens the Name and Location page of the Create Platform Component wizard as shown.

  3. Enter a Component name and Component location and select Next.
  4. This opens the Select XSA page of the Create Platform Component wizard as shown below.

    Figure 1. Create Platform Component - XSA

  5. You can specify the XSA file for your platform component from one of the base platforms available with the Vitis tools located at $XILINX_VITIS/base_platforms, or you can select Browse to locate an XSA from your $PLATFORM_REPO_PATHS or an existing system design. Select Next to proceed to Select Operating System and Processor.
    Note: If the XSA you selected is a fixed hardware platform, then this Vitis platform is created for embedded design only. If you selected an extensible hardware platform, then this Vitis platform can be used for embedded design, in addition to acceleration applications.
  6. After selecting the XSA, the tool reads the XSA and identifies the available processors and operating system domains From the Select Operating System and Processor page of the Create Platform Component wizard, you can select which OS and processor your platform uses.

    Figure 2. Create Platform Component - OS and Processor

  7. Specify the Operating system, and the Processor for the platform, and click Next to proceed to the Summary page.
  8. The Summary page reflects the choices you have made on the prior pages. Review the summary and select Finish to create the Platform component, or select Back to return to earlier pages and change your selections.

When the Platform component is created the vitis-comp.json file for the component is opened in the central editor window as shown for the Linux platform below.

Figure 3. Platform Component - vitis-comp.json

Depending on the OS you selected for your platform, and possibly the processor you chose as well, the contents of the platform vitis-comp.json can vary.

  • For Linux Operating System: As shown above, you need to specify the Bif file, Boot Component Directory, SD Card Directory and as well as the Qemu data. The Qemu Args file are auto-populated by tool.
  • For standalone (baremetal) OS: No special operation is required.
  • For FreeRTOS: No special operation is required.

After setting, you can build the Platform component by selecting it in the Flow Navigator and selecting the Build command. After compilation is finished the tool will populate the platform and its related software and hardware components in the Output folder of the Platform component in the Component Explorer.