Software Debugger (XSDB) - 2024.2 English

Software Debugger Reference Guide (UG1725)

Document ID
UG1725
Release Date
2024-11-13
Version
2024.2 English

The AMD Vitis™ IDE is a graphical development environment that is helpful when developing for a new processor architecture. It simplifies common functions through logical wizards, so even beginners can use it. However, it is necessary for these tools to be scriptable, meaning they can be modified or extended, providing flexibility. This is especially helpful for developing regression tests that are run daily or when using a specific set of commands frequently. It is particularly useful when developing regression tests that are be run nightly or when running a set of commands that are frequently used.

Software debugger (XSDB) is an interactive and scriptable command-line interface to the Vitis IDE. As with other AMD tools, the scripting language for XSDB is based on the tools command language (Tcl). You can run XSDB commands interactively or script the commands for automation.

XSDB supports debugging and programming, such as:

  • Downloading and running applications on hardware targets
  • Reading and writing registers
  • Setting break points and watch expressions

This reference guide is intended to provide the information you need to develop scripts for software development and debug targeting AMD processors.

In this guide, abbreviations are used for various products produced by AMD. For example:

  • Use of ps7 in the source code implies that these files are targeting the AMD Zynq™ 7000 SoC family of products, and specifically the dual-core Cortex® Arm® A9 processors in the SoC.
  • Use of psu in the source code implies that this code is targeting an AMD Zynq™ UltraScale+™ MPSoC device, which contains a Cortex quad-core Arm A53, dual-core Arm R5, Arm Mali 400 GPU, and a MicroBlaze™ processor based platform management unit (PMU).
  • Hardware definition files (XSA) are used to transfer the information about the hardware system that includes a processor to the embedded software development tools such as Vitis IDE and XSDB. It includes information about which peripherals are instantiated, clocks, memory interfaces, and memory maps.