Launch Configurations - 2023.2 English

Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400)
Document ID
UG1400
Release Date
2023-12-13
Version
2023.2 English
To debug, run, and profile an application, you must create a launch configuration that captures the settings for executing the application. To do this, go to the Flow Navigator and select the application component, right-click on the Open Settings next to Run or Debug.

Note: The Open Settings command is a hidden icon. Hover the cursor over Flow Navigator next to either Run or Debug to view it.

The launch.json file is opened to let you edit the launch configurations. The Launch Configuration editor has a toolbar menu at the top, as shown in the following figure. The specific contents of the launch configuration vary depending on the component or the project selected.

Launch Configurations

The commands in the Launch Configuration toolbar include:

  • Settings Form / Source Editor: You can toggle between the GUI view and Text Editor view of the launch.json file with these commands.
  • Undo/Redo: To undo or redo the last actions.
  • Add Configuration: You can add a configuration by clicking the + button. The default launch configurations for System projects are Emulation SW, Emulation HW, and Hardware.
  • Run / Debug: To launch run or debug using the currently selected launch configuration.


Hover your cursor over the configuration name and the Duplicate and Delete commands appear. Select Delete to remove the launch configuration, or Duplicate to copy the launch configuration.

In each configuration, you can update the settings to configure the tool prior to running or debugging the component or project. After setting up the launch configuration, you can select Run or Debug commands in the Launch Configuration editor, or by selecting Run or Debug from the Flow Navigator and specifying a launch configuration if more than one is available.