Opening the Run Summary with Vitis Analyzer - 2022.2 English

Vitis Tutorials: Getting Started

Document ID
XD098
Release Date
2022-11-07
Version
2022.2 English

Use the following command to open the summary in Vitis Analyzer:

vitis_analyzer ./vadd.xclbin.link_summary

This opens the Vitis Analyzer tool and loads the various reports and displays the run summary. You can navigate to the various reports using the left pane of the Vitis Analyzer or by clicking on the links provided in the summary report.

  • Open the System Diagram.

    • The System Diagram is a graphical view of the contents of the Xilinx device. It shows the various hardware kernels, how they are connected to platform resources such a global memory banks.

    • Notice the Estimated Resources information displayed next to the vadd kernel.

    • Click on the “Settings” icon located in the top right corner of the diagram and check the “Show Interface Ports” box. Notice that the diagram now displays the mapping of kernel arguments to kernel ports and shows bandwidth information for each port.

    • Click on each of the tabs (Compute Units, Kernels, Memories, Clocks) located at the bottom of the diagram and look at the information displayed in each of them.

  • Open the System Guidance report

    • The Guidance report flags issues and potential issues in your application and kernel, and provides actionable feedback on how to improve it.

    • This simple example is not fully optimized and Guidance reports several warnings. Inspect each of these warnings to learn more about optimization opportunities and design best practices.

    • What can you learn about the width of the kernel ports?

The link_summary also includes the compile_summary. Take a look at the various elements of the compile_summary report by selecting them in the Vitis Analyzer tool.

Now open the xrt.run_summary by using the File > Open Summary command from the Vitis Analyzer main menu.

  • Open the Profile Summary report

    • The Profile Summary provides annotated details regarding the overall application performance. All data generated during the execution of the application is grouped into categories.

    • Use the left pane of the report to navigate through the various categories and explore all the metrics reported in the Profile Summary.

  • Open the Timeline Trace

    • The Timeline Trace collects displays host and kernel events on a common timeline to help visualize the overall health and performance of your system. The graphical representation is very useful to see issues regarding kernel synchronization and efficient concurrent execution.

    • Zoom in and scroll to the far right of the timeline trace to visualize the point where the host program transfers the buffers and executes of the kernel.

    • Hover over the various activity events to get more details about each of them.

    • Can you relate the timeline activity to the sequence of API calls in the host.cpp file?

img

When you are done exploring the various reports in Vitis Analyzer, you can close the tool.