Debugging a Linux Application from the Vitis IDE - 2025.1 English - UG1209

Debugging Linux applications requires the Linux agent to be set up properly. Refer to Preparing the Linux Agent for Remote Connection for detailed steps.

1. Debug the Linux application:

   1. Select hello_linux, and click the Open Settings button beside it to open the launch.json file.

   2. Select Application Debug.

   3. Review the configurations:

      1. Target Setup Mode: Application Debug

      2. Target Connection: Linux Agent

      3. Work Directory: ‘/tmp/’

   4. Click Debug.

   The debug configuration has identical options to the run configuration. The difference between debugging and running is that debugging stops at the main() function.

2. Try the debugging features:

   Hello World is a simple application. It does not contain much to debug, but you can try the following to explore the Vitis debugger:

   • Review the tabs on the upper right corner: Variables, Breakpoints, Expressions, and the rest.

   • Review the call stack on the left.

   • The next line to execute has a green background.

   • Step over by clicking the icon on the toolbar or pressing F6 on the keyboard. The printed string will be shown on the Console panel.

   

3. Disconnect the connection:

   • Click the Terminate button on the toolbar or press Ctrl+F2.

   • Click the Disconnect button on the toolbar.