Launch XSDB, and Offload Trace Information - 2025.1 English - XD100

Vitis Tutorials: AI Engine Development (XD100)

Document ID
XD100
Release Date
2025-08-25
Version
2025.1 English

After loading the HSDP enabled Linux image on Versal Evaluation board:

1. Power on the Versal Evaluation board and SmartLynq+ module.

2. Observe the Linux boot messages in the minicom application (SmartLynq+ module can be used as a serial terminal to remotely view the UART output from the  Versal board using the pre-installed minicom application).

3. Launch XSDB from your local directory, where the AI Engine design Work/ directory is located.

``` xsdb
	%xsdb connect -url TCP:${COMPUTER NAME/IP}:3121
	%xsdb ta
	%xsdb ta 1
	%xsdb source $::env(XILINX_VITIS)/scripts/vitis/util/aie_trace.tcl
	%xsdb  `aietrace start -graphs mygraph -work-dir Work/ -link-summary tutorial.xsa.link_summary -graph-based-aie-tile-metrics "all:all:all_stalls"`
```
Note: You should be able to use all the options specified in XSDB Flow. However, the options -baseaddress and -depth are not applicable for HSDP offload. XSDB issues an error if you try to use these options.

6. Run the application on the hardware. Make sure xrt.ini file does not contain any AI Engine trace configurations which conflicts with the configuration given by XSDB.
7. Stop AI Engine trace using the command `aietrace stop`. You should see the file hsdp_event_trace0.txt corresponding to the AI Engine trace and a JSON file that contains event configuration.
8. Now, the dumped trace should be processed using the hw_analyze command to generate the .wdb file which can be used in Vitis IDE.
`hwanalyze --pkg-dir=<WORK_DIR> --trace=hsdp_event_trace_aie.txt --trace_config=<PATH_TO_JSON> -wdb`
9. Launch the Vitis IDE and open the .wdb file to analyze the event trace.

You can calculate the execution time of one iteration as follows. Place the marker at the start and end of the iteration and (1) - (2) gives 262.4 ns which is ~= 329 cycles. This matches with the Function time in the profile data from both the AI Engine simulation

image