Defining the AI Engine Configuration File - Defining the AI Engine Configuration File - 2026.1 English

Defining the AI Engine Configuration File - Defining the AI Engine Configuration File - 2026.1 English - UG1702

Vitis Reference Guide (UG1702)

Document ID

UG1702

Release Date

2026-06-23

Version

2026.1 English

The AI Engine component configuration file contains information compilation and simulation information. To access the file, click Configuration File (aiecompiler.cfg) in the settings directory of the AI Engine component.

Figure 1. AI Engine Configuration File

For the AI Engine component, the configuration file includes the following sections.

Generic: Includes AI Engine options such as input files, output file name, kernel frequency, and part name.
AI Engine: Compiler options applied to the graph.
CDO: Options for graph configuration and initialization in configuration data object (CDO) format.
Compiler Debugging: Log-levels and compilation options to help analyze and debug the compilation process.
Design Rule Check: Options to enable, disable or waive Design Rule Check for the specified ID.
File Specific: Source files and include files required for building and running the component.
Miscellaneous: Collection of options for added functionality.
Module-Specific: Compilation options specific to each kernel in the design.
Tracing: Options to configure event trace when running the design in hardware. Some event tracing options require specific resources in the design and can affect the performance of the design.
XLOpt: Option to set the level of kernel optimizations. Each of these levels enables specific combinations of optimizations.

Tip: Each of the config file options has a brief description in the Vitis IDE for ease-of-use, and are also v++ --mode aie command-line options. Refer to v++ Mode AI Engine for more detailed information on the options.

The Search bar at the top of the Config File Editor lets you quickly search through the options using a keyword or phrase.

The Config File Editor offers both a form-based view of the configuration file options, and a text-based editor for editing the configuration file directly. You can switch between the two by using the Configuration File buttons () at the top of the editor window.

Selecting the text-based editor view from time to time is a good way to review the current contents of the config file. You can also quickly edit or add configuration commands.

Tip: After making changes to the config file, use the File > Save command, or Ctrl-S to save your changes. You can also enable the File > Auto Save command to save your work automatically.