Application Runtime Options - 2023.2 English

Vitis Tutorials: Hardware Acceleration (XD099)

Document ID
XD099
Release Date
2023-11-13
Version
2023.2 English
  • FILTER_TYPE: selects between 6 different filter types: choices are 0-6(Identity, Blur, Motion Blur, Edges, Sharpen, Gaussian, Emboss)

  • PARALLEL_ENQ_REQS: application command-line argument for parallel enqueued requests

  • NUM_IMAGES: number of images to process

  • IMAGE_WIDTH: image width to use

  • IMAGE_HEIGHT: image height to use

  • INPUT_TYPE: selects between host versions

  • INPUT_IMAGE: path and name of image file

  • PROFILE_ALL_IMAGES: while comparing CPU vs. FPGA, use all images or not

  • NUM_IMAGES_SW_EMU: sets no. of images to use for sw_emu

  • NUM_IMAGES_HW_EMU: sets no. of images to use for hw_emu

To build the host application with randomized data please follow these steps:

  1. Edit the Makefile options:

cd  $CONV_TUTORIAL_DIR/
vim make_options.mk
  1. Make sure INPUT_TYPE option is set to random. This will build the host_randomized.cpp application:

############## Host Application Options
INPUT_TYPE :=random

TIP: To build the host.cpp you must include the following two variables that point to OpenCV 2.4 install path in make_options.mk file:

############## OpenCV Installation Paths
OPENCV_INCLUDE :=/**OpenCV2.4 User Install Path**/include
OPENCV_LIB :=/**OpenCV2.4 User Install Path**/lib
  1. Source the install specific scripts for setting up the Vitis application acceleration development flow and the Xilinx RunTime Library:

source /**User XRT Install Path**/setup.sh
source /**User Vitis Install Path**/settings64.sh
  1. After setting the appropriate paths, build the host application using the makefile command as follows:

make host

It will build host.exe inside a build folder. By building the host application separate from the kernel code, you can make sure the host code compiles correctly and all library paths have been set.