Defining the AI Engine Configuration File - 2024.1 English

AI Engine Tools and Flows User Guide (UG1076)

Document ID
Release Date
2024.1 English

The AI Engine component configuration file contains information used for the compilation and simulation of the component. To access the file, click Configuration File (aiecompiler.cfg) in the settings directory- of the AI Engine component. This will open the Configuration File Editor in the central editor window.

Figure 1. AI Engine Configuration File

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

Includes AI Engine options like input files, output file name, kernel frequency, and part name.
AI Engine
Compiler options applied to the graph.
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.
Collection of options for added functionality.
Compilation options specific to each kernel in the design.
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.
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.

There is a Search bar at the top of the Config File Editor which 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 that can be enabled to edit 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 as needed.

Tip: Remember after making changes to the config file, use the File > Save command, or Ctrl-S to save your changes. However, you can also enable the File > Auto Save command to have your work saved automatically.