Build Flow Tutorial - 2020.2 English - XD336

Versal Base TRD Documentation (XD336)

Document ID
XD336
Release Date
2025-12-01
Version
2020.2 English

Note

The below steps use platform vck190_mipiRxSingle_hdmiTx as an example. The same steps can be used for other platforms as well. The file/directory names will be replaced with the targeted platform name - vck190_<plarform_name>

  1. Clone the VCK190 Base TRD repository using the following command

    git clone --branch 2022.1 --recursive https://github.com/Xilinx/vck190-base-trd.git
    

The directory structure is described in the Introduction Section

Generate PetaLinux Image

Petalinux build flow has dependecy on artifacts from Vitis platform and overlay. Build steps shown below before generating a bootable petalinux image.

  • Section 4.2: Create the Vitis Platform

    Ensure all steps under this section are executed Build Flow Tutorial

  • Section 4.3: Integrate Kernels in the Platform

    Ensure all steps under this section are executed Build Flow Tutorial

The xsa and xclbin binaries produced from the previous step are consumed by petalinux during the image creation step.

  1. Source the PetaLinux tool settings.sh script.

  2. Create a bootable SD card image:

    make sdcard PFM=vck190_mipiRxSingle_hdmiTx OVERLAY=filter2d
    

The resulting build artifacts will be available in the images/linux/ folder. The following is a list of important output files:

  • binary_container_1.xclbin: This is the kernel meta data file used by XRT

  • BOOT.BIN: This is the boot image which includes:

    • Platform Loader and Manager (PLM)

    • PS Management (PSM) firmware

    • Platform Device Image (PDI)

    • ARM trusted firmware

    • u-boot

    • Device tree blob

    • Merged AI Engine application and configuration data object (CDO) file

  • boot.scr: A u-boot boot script

  • Image: Linux kernel image

  • ramdisk.cpio.gz.u-boot: Initial filesystem in ramdisk

  • rootfs.tar.gz: Compressed root file system tar ball

  • petalinux-sdimage.wic.xz: Compressed SD card image file in wic format

The SD card image is now ready to be used to boot the device into Linux, see Section Run the Prebuilt Image for details.