4.4. Integrate XVDPU and Multiscaler Kernels in the Platform

4.4.1. Prerequisites

  • Reference Design source files
  • Vitis Unified Software Platform 2021.1 (include AIE tool chain)

4.4.2. Build Flow Tutorial

Note

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

Clone the Reference Design Files:

Skip the following steps if the design has already been cloned and extracted to a working directory

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

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

The directory structure is described in the Introduction Section

Set up the Vitis toolchain:

  1. To set up the Vitis toolchain, run the following commands:

    source $XILINX_VITIS/settings.sh
    export XILINXD_LICENSE_FILE=<path to where the aiecompiler license file is installed>
    

Implement platform design with xvdpu and multiscaler accelerators:

  1. To create the platform design with accelerators integrated, run the following Makefile:

    cd $working_dir
    make overlay PFM=vck190_mipiRxSingle_hdmiTx OVERLAY=xvdpu
    

    The Makefile implements the following:

    • Builds the xvdpu kernel which has a PL and AIE portion. The RTL HDL files are converted to xvdpu.xo kernel format and the file libadf.a is provided as an input describing the AIE elf, cdo, and graph.
    • Builds the multiscaler kernel by synthesizing the HLS IP and converting it to .xo kernel format.
    • Integrates the above kernels into the vck190_mipiRxSingle_hdmiTx design using the Vitis linker. Generates binary_container_1.xclbin which contains meta data describing the kernels and platform. Generates a new XSA that includes the updated PDI.

    Note: If the Create the Vitis Platform tutorial is not run before this, then this Makefile also generates the Vitis platform

  2. The following is a list of important output products:

    • Vivado project with integrated kernels: $working_dir/overlays/xvdpu/kernels/_x/link/vivado/vpl/prj/prj.xpr
    • XSA required for building the Petalinux BSP: $working_dir/overlays/xvdpu/kernels/binary_container_1.xsa The XSA contains the updated PDI with the accelerators added into the platform design and the merged AIE binary.The XSA is required to build the final boot image BOOT.BIN in PetaLinux.
    • The xclbin that contains the platform and kernel meta data needed by XRT: $working_dir/overlays/xvdpu/kernels/binary_container_1.xclbin

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License.

You may obtain a copy of the License at [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.