Creating a Run Configuration

The Vitis analyzer lets you create run configurations that specify how to run the application. You can create and save run configurations for software emulation, hardware emulation, and system hardware.

  1. From the Run menu, select the Edit Run Configurations command to open the Run Configurations dialog box as shown below.

  2. The Run Configurations dialog box lets you create new run configurations or edit and manage existing run configurations. Also, you can select a run configuration from the list of Configurations in the left pane, and the fields on the right pane under Edit Configurations are populated by the settings of the selected configuration. The configuration settings include:
    Name
    Specifies the name for the run configuration.
    Launch mode
    Specifies the run configuration as an emulation run, or hardware run.
    Executable
    This defines the host program used to run the application. Include the full path to the executable, or click button to locate the required file.
    Working directory
    This is the directory where the run outputs are collected and reports are generated. The specified directory must exist prior to the run, or Vitis analyzer will return an error.
    Arguments
    These are arguments to the host program specified by the Executable field. These arguments can include the xclbin file, as is common in Vitis examples, and any additional inputs required by the host program.
    Environment variables
    This specifies any environment variables required by the host program. It does not require the definition of XCL_EMULATION_MODE as described in Running an Application, as this environment variable is set through the Launch mode drop-down setting above.
    XRT configuration
    This displays the settings of the xrt.ini file that will be used when the run configuration is launched. Click button to modify the xrt.ini file on the disk. Refer to xrt.ini File for more information.
    Make this configuration active
    This check box specifies that the current run configuration should be the active run in the Vitis analyzer. The active run is displayed in the quick start menu command.
    Show this page before run
    This check box opens the Run Configuration dialog box with the specified run, which allows you to edit any of the current settings prior to the actual run.
  3. After editing the run configuration, select OK to accept your changes and close the dialog box.
  4. Select Apply to accept your changes and keep the dialog box open, or select Cancel to reject your changes and close the dialog box.
  5. If the Run Configuration dialog box has opened prior to launching a selected run, select Run to launch the run, or press Cancel to close the dialog box without launching the run.
  6. When a run is launched within the Vitis analyzer, a console window opens with a transcript of the run, and any reports are written to the specified working directory. Various reports are generated during the run as explained in Running an Application.