Step 2: Create Vitis Platform - 2024.2 English - XD098

Vitis Tutorials: Getting Started (XD098)
Document ID
XD098
Release Date
2025-02-19
Version
2024.2 English

  1. Download Versal common image from AMD website download page, place it under your WorkSpace directory, and extract the common image.

    tar xvf ../xilinx-versal-common-v2024.2.tar.gz .

  2. Create Vitis platform

    • Install SDK tool by typing sh xilinx-versal-common-v2024.2/sdk.sh -d xilinx-versal-common-v2024.2/ -y in console. Option -d is to specify the directory where to install. Option -y means confirmation. So it gets installed in xilinx-versal-common-v2024.2/ folder.

    Note: The SDK installation is not required for platform creation; it is needed for application compilation. You can install it later as needed.

    • Run Vitis by typing vitis -w . in the console. -w is to specify the workspace. . means the current workspace.

    • In the Vitis IDE, select File > New Component > Platform to create a platform component.

    • Enter the Component name. For this example, type vck190_custom, click Next.

      Note: If you target VEK280, please update component name to vek280_custom.

    • In the XSA selecting page, click Browse button, select the XSA file generated by the Vivado. In this case, it is Your Vivado Project Directory>/vck190_custom.xsa or vek280_custom.xsa. Expand the Advanced Options and set the items as following:

    Created Vitis Platform

    • SDT Source Repo: This is used to replace the built-in SDT tool. For this tutorial, leave it empty.

    • Board DTSI: Specify the board machine name, which is used to retrieve the board-level DTSI file. For this tutorial, leave it empty. To check the board machine name, refer to UG1144 Machine Name Checking

    • User DTSI: Allows you to specify a custom DTSI file. Click Browse and select the the system-suer.dtsi file located in the corresponding board folder.

    • DT ZOCL: Enables Zocl node generation for the XRT driver. Ensure this option is enabled, then click Next.

    • Set the Operating System to Linux and the Processor to psv_cortexa72. Enable the Generate Device Tree Blob (DTB) option, then click Next.

    • Review the summary and click Finish.

    Created Vitis Platform

    • Click the linux On psv_cortexa72 domain.

    • Update the Display Name to xrt by clicking the entry bar and inputting the name. It is indicated that this is a Linux domain has XRT installed and can run acceleration applications.

    • Set Bif file: Click the button as shown in the following diagram and generate BIF file. The BIF file is generated in the resource directory.

      vitis_platform_config

    • Pre-Built Image Directory: Browse to extracted common image path directory: xilinx-versal-common-v2024.2/ and click OK. Bootgen looks for boot components referred by BIF in this directory to generate BOOT.BIN.

    • DTB file: It will be generated automatically and populated in this area.

    • FAT32 Partition Directory: if you have additional file to be stored in FAT32 partition diretory you can browse to the file. If not please omit this.

    • QEMU Data: This Directory is used to add additional file for emulation. User can set it according to your requirement.

    • In the flow navigator, click the drop-down button to select the component. In this case, select vck190_custom component and click the Build button to build the platform.

    Note: If there are additional QEMU settings, update qemu_args.txt accordingly.

    After this step2, the platform creation process is completed. Next, run an application to validate this platform.