Kernel Location - 2025.2 English - UG1483

Vitis Model Composer User Guide (UG1483)

Document ID
UG1483
Release Date
2025-11-20
Version
2025.2 English

When building large graphs with multiple subgraphs, it is sometimes useful to control the exact mapping of kernels to AI Engines. This can be either relative to other kernels or in an absolute sense. Specifying location constraints provides a powerful mechanism to create a robust, scalable, and predictable mapping of your graph onto the AI Engine array. It also reduces the choices for the mapper to try, which can considerably speed up the mapper.

You can specify the Kernel Location constraint from the Model Composer Constraints editor window as shown.

  • By default, the option Specify Kernel Location is deselected. Select this to specify the constraint.
    Figure 1. Specify Kernel Location

You can choose to either:

  • Constrain a kernel to be placed on a specified AI Engine tile.
    Figure 2. Constrain Kernel

    Important: You can use MATLAB variables to specify the kernel locations.

    Or

  • Constrain two kernels to be placed relatively on the same AI Engine. This forces them to be sequenced in topological order and be able to share memory buffers without synchronization. As shown, you can select the kernel you want to place relatively on the AI Engine from the drop down.
    Figure 3. Constrain Two Kernels

  • Vitis Model Composer also supports specifying two kernels, for example, k1 and k2. Do not map these to the same AI Engine.
    Figure 4. Specify Two Kernels