Post-Link Recompile of an AI Engine Application
Version: Vitis 2022.1
AI Engine application development can start early in the system development stage. Little by little, the AI Engine development team and the hardware development team converge to an interface between the Adaptable Engine and the AI Engine array. At some point, this interface is fixed and should not be changed. This tutorial shows you how to modify an AI Engine application after the platform has been frozen while avoiding a complete Vivado® tool run, which can take a long time if timing closure requires specific attention.
There are two ways to perform this operation:
Recompile the AI Engine application right after the link stage, using specific constraints to set the interface ports.
Create an intermediate platform which embeds these constraints.
In the first case, you have to extract the constraints from the files generated by the AI Engine compiler and use them as input constraints when you run it for the second time.
In the second case, running the AI Engine tools provides a fixed platform that acts as a constraint on the AI Engine array – Adaptable Engine interface specification. This tutorial explains the complete flow for these two cases.
This tutorial details all the steps to perform hardware emulation (
hw_emu), but it supports also the hardware implementation flow by changing the compilation target.
Before You Begin¶
This tutorial requires a number of tools and files to be installed:
Download and install the Vitis Embedded Base Platform VCK190.
Download and install the common image for embedded Vitis platforms for Versal® ACAP.
The AI Engine development documentation is also available here.
Before starting this tutorial, run the following steps:
Set up your platform by running the
xilinx-versal-common-v2022.1/environment-setup-cortexa72-cortexa53-xilinx-linuxscript as provided in the platform download. This script sets up the
CXXvariables. If the script is not present, you must run the
Set up your ROOTFS to point to
Set up your IMAGE to point to
Set up your
PLATFORM_REPO_PATHSenvironment variable based on where you downloaded the platform.
Accessing the Tutorial Reference Files¶
To access the reference files, type the following into a terminal:
git clone https://github.com/Xilinx/Vitis-Tutorials.
Navigate to the
Files contains all the source files necessary for this tutorial.
addon_setup.sh script is provided to initialize the platform name.
This tutorial shows you how to modify an AI Engine application after the platform has been frozen. It demonstrates a Vitis IDE flow and a Makefile flow.
Completing this tutorial should give you confidence to develop AI Engine designs based on a hardware/software platform, knowing that you can modify the AI Engine part and the processing system control application. The only limitation is that the hardware connection between the AI Engine array and the programmable logic (PL) must be kept fixed.
GitHub issues will be used for tracking requests and bugs. For questions go to forums.xilinx.com.
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
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.
XD039 | © Copyright 2021–2022 Xilinx, Inc.