Variable View and Memory Inspector - 2024.2 English - UG1702

Vitis Reference Guide (UG1702)

Document ID
UG1702
Release Date
2025-01-15
Version
2024.2 English

The Variables view displays the values of kernel variables. Clicking on a variable shows its type, value, and the address of the variable. For array/structure variables, clicking on the arrow of the variable expands array/structure content of the array.

Figure 1. Variables View

Click on the variable in the VARIABLES view or hover your mouse over the variables in the code view on the right-side as shown above to get the address and add that address in the memory inspector as shown below. As you step-in, step-over the code, the values in the variable and memory view changes.

Tip: You can export the contents of the Memory window by selecting the Copy to Clipboard command from the right-click menu to copy and paste the contents into a text editor and save to a file.

From the Debug view, you can open the Memory Inspector by selecting View > Memory Inspector from the main menu, or by clicking the Memory Inspector icon on the right hand side of the display, as shown in the image below.

Figure 2. Memory Inspector

The Memory Inspector view is displayed as shown above. In the Threads view, select the desired AI Engine core to examine the core's memory. Enter an address, offset and length from which you would like to retrieve the memory range. Click the Go command to view the memory contents.

For AI Engine-ML, the options in the Memory menu enable you to choose the memory to be inspected.

Figure 3. Memory Menu on AI Engine-ML
Display Memory Bank
Enables you to access to the four neighbor memory modules.
Display Global Buffer
Enables you to access to all the shared buffers declared in the design.

In the previous image, the content of the shared buffer bufi10 is displayed.

Select the Settings command at the top of the Memory Inspector to define attributes of the memory, such as Byte Size, Bytes Per Group, or Endian. You can edit the contents of the displayed memory by selecting an address, clicking in it and entering a new value. If a data needs to be updated from the address range, it will highlight a blue under liner. Click on the highlighted address and update with the required value and select Apply Changes.