Viewing AI Engine Microcode - 2023.1 English

Vitis Unified IDE and Common Command-Line Reference Manual (UG1553)

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

After compiling AI Engine source code, you can view the generated microcode in the Vitis IDE. The microcode can be found in the <component>/build/<target>/Work/aie/<tile>/Release directory. Because checking the microcode is a frequently required action, and the generated files are deep in the build hierarchy, the tool makes it easy for you to quickly access the microcode.

Open the AI Engine microcode by right-clicking the component in the Component Explorer view and selecting the Microcode command. This displays a Microcode core selector, letting you choose the microcode scheduled to be executed on a specific AI Engine tile.

Figure 1. Select Core to View Microcode

The Microcode view has the following features:

  • Filter instruction lines by enabling/disabling Functions, Loop Nesting, User Defined or Other on the top filter bar
  • Cross-probe between the instruction and kernel source code by clicking the lines with blue dots next to the line numbers
  • Examine the number of cycles taken by specific lines of kernel code and see where optimizations can be made
  • Quickly navigate through the microcode using the global view displayed on the right
  • Right-click menu provides access to additional commands
Figure 2. Microcode View