Vitis Compiler Configuration File - Vitis Compiler Configuration File - 2026.1 English - UG1702

Configuration files are the recommended way of working with either the Vitis Unified IDE, or the common command-line supported by v++. A configuration file provides an organized way of passing options to the tools by grouping similar commands together, creating reusable configuration files to perform specific tasks like connectivity or profiling, and minimizing and simplifying the v++ command line. The following are some of the features that the config file controls.

• AI Engine commands to configure component creation using v++ -c --mode aie
• HLS commands to configure interface definition, configure synthesis and simulation, and control packaging when using v++ -c --mode hls
  Tip: Specify HLS commands in a configuration file. The exceptions are --platform and --freqhz, which are permitted on the command line or in a config file.
• Connectivity directives for system linking specifying the number of kernels to instantiate, or assigning AI Engine streaming ports to PL kernel ports when using v++ --link
• Package directives to configure the creation of boot files, the genration of the .xclbin file from a .xsa, and the creation of an SD card when using v++ --package
• Directives for the Vivado Design Suite to manage hardware synthesis and implementation.
• You can add comments to the configuration file by starting the line with a "#":

  # This is a comment line

The Vitis Unified IDE use configuration files to drive component build and simulation processes. The tool can create configuration file at the time of component creation. You can also import the configuration file from an existing component, or add it to the component separately. For the command-line flow, specify the configuration file through the v++ --config option as discussed in the v++ General Options. An example of the --config option is:

v++ --link --config ../src/system.cfg

Config file commands can be non-composing, which means they are only permitted one time, such as --platform. In this case the commands are read from the config file in the order of encounter. Config file commands can also be composing, which means that multiple values can be specified to apply to specific ports or CUs in the design. In this case the commands are cumulative, with any later conflicting commands either ignored or resulting in an error.

The tool reads the commands in the order of encounter. If the same switch is repeated with conflicting information, the first switch read is used or an error is returned. The order of precedence for switches is as follows, where item one takes highest precedence:

1. Command line switches.
2. Config files as specified on the command line from left-to-right.
3. Within a single config file, precedence is as encountered from top-to-bottom.

In general, you can specify any v++ command option in a configuration file. However, the configuration file supports defining sections containing groups of related commands under command headers to help manage build options and strategies. The following table lists the defined section headers.