Vitis Hardware Function Settings - 2023.1 English

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)

Document ID
UG1393
Release Date
2023-07-17
Version
2023.1 English

To edit the settings for the hardware functions, expand the build target for the kernels project in the Assistant view, select the hardware function, and click the Settings button (). This displays the Hardware Function Settings dialog box as shown in the following figure.

Tip: Notice in the figure below that the dct kernel (or hardware function) is selected for the Emulation-HW build target of the hardware kernels project (dct_project_kernels).
Figure 1. Hardware Function Settings

This dialog box lets you set options related to the hardware function, and the v++ compilation process for the selected build target. Specific options include:

Stall Profiling
Enables the --profile.stall option for the kernel as explained in --profile Options.
Max memory ports
For OpenCL kernels, when enabled, generates a separate physical memory interface (m_axi) for every global memory buffer declared in the kernel function signature. If not enabled, a single physical memory interface is created for the memory mapped kernel ports.
Port data width
For OpenCL kernels, specify the width of the data port.
Extra source files
Define any additional source files required by this hardware function, such as input data files.
V++ configuration settings
Specify Vitis compiler options to be added to the compiler configuration file. Select the Edit command () to edit the options to add to the config file. Specified options will be added to the compile.cfg file that is linked in the V++ Compiler Command Line displayed at the bottom of the dialog box.
V++ compiler options
Specify Vitis compiler options to be added to the V++ Compiler Command Line displayed at the bottom of the dialog box.
Supported targets
Specify which of the three build targets you are defining in the Hardware Function Settings dialog box. You can select one or all build targets.
Kernel Arguments
Displays the names and attributes of the arguments of the hardware kernel.
V++ Compiler Command Line
Displays the current v++ command line with any compilation options you have specified.
Tip: The settings specified by the Hardware Function Settings dialog box are written to a configuration file used by the Vitis compiler with the --config option as described in Vitis Compiler Configuration File. The configuration file is a link; when you place your mouse over the link, it displays the contents of the configuration file.