The Vitis Unified IDE provides a VFS Application launch configuration that you can use to debug a Vitis Functional Simulation (VFS) script with GDB from inside the IDE.
See the following prerequisites.
- Open the VFS application folder as a workspace in the Vitis Unified IDE. The IDE opens the workspace in User Managed view.
- If using Python, make sure the Python interpreter required by your VFS script is installed and on PATH. Supported Python versions for VFS are 3.9, 3.10, 3.11, 3.12, and 3.13.
- In the Flow Navigator, hover over the run row to reveal the Settings icon, and click it to open Run settings.
- Click New Launch Configuration.
- In the configuration-type dialog, select VFS Application.
- Choose one of the following modes:
- Launch. The IDE starts the VFS script and attaches GDB. Fill in the Launch form fields.
-
Attach. The IDE
attaches GDB to a VFS process that is already running. Fill in the
Attach form fields. In the Process ID field, enter the process ID
returned by
os.getpid()(Python) orvfs.getpid()(MATLAB). For details, see Debugging with VFS in the Embedded Design Development Using Vitis (UG1701) .
- Submit the form to create the launch configuration. The new configuration is in launch.json.
Run the Debug Session using the steps below.
- Add breakpoints in the AIE or HLS kernel source code.
- From the Flow Navigator, click Run or Debug.
- You can step over, step into, step out, view variables, view threads, and inspect output the same way as in any Vitis Unified IDE debug session.