Performing a Debug Session - Performing a Debug Session - 2026.1 English

Performing a Debug Session - Performing a Debug Session - 2026.1 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID

UG1144

Release Date

2026-06-23

Version

2026.1 English

Creating a Linux Application and Debugging in the Vitis Software Platform

Launch the Vitis software platform.
Create a Linux application by following these steps:
1. Select File –> Go to New Application Project.
2. Create a platform from the provided .xsa file.
3. Choose a name for your application and select the target processor.
4. Specify domain details, setting the Operating System to Linux.
5. Select an application template (for example, Hello World).
Choose the application you wish to debug.
Select Run –> Debug Configuration.
Click Launch on Hardware (Single Application Debug) to create a new configuration.
In the Debug Configuration window, follow these steps:
1. In the Main Tab, do the following:
  - From the Debug Type drop-down list, select Linux Application Debug.
  - From the Connection drop-down list, choose Linux agent.
2. In the Application Tab, provide the necessary information:
  1. In the Remote File Path field, specify the path in Linux where you want to download the application.
3. If your application expects any command-line arguments, specify them in the Arguments tab.
4. If your application relies on specific environment variables, define them in the Environment tab.
5. Set up the target connection by entering the Linux hostname or IP address in the Hostname field.
  
  Note: By default, the tcf-agent runs on port 1534 on the Linux machine. If you use a different port, update the Port field with the correct port number.
Click the Debug button. This opens a separate console for processing standard I/O operations.
Set breakpoints by double-clicking on the desired lines of code.
To continue execution, click Resume.
For stepping through the code, follow these options:

Step Over

Click this to execute the current line and move to the next line in the same function.

Step-In

Click this to enter into a called function.

Step-Rerun

Click this to re-execute the current line.
To continue running the application after stepping through the code, click Resume again.

Ensure that you follow these steps carefully to successfully create a Linux application and debug it using the Vitis software platform.