Startup tab

The Startup tab specifies the first commands for the GDB client to execute at startup. Commands are executed in the order of appearance on the tab, after which debugging of the code becomes available to the user.


Startup tab

The following table describes all settings that can appear on the Startup tab. Some settings described below are particular to the selected debugging interface and are hidden from the tab for other interfaces.

Table 1. Debug Configurations - Startup settings
Setting Description
Initialization Commands

(apply to GDB Hardware Debugging only)

 Specify the initialization commands to be executed before the debug session is started. Configure the following related options:
  • Reset and Delay (seconds): Select this option to reset the target after programming and to delay the debug session. Specify the number of seconds for the delay.
  • Halt: Select this option to halt the target at startup.
Load Image and Symbols Specify the file that contains the code for debugging:
  • Load image: Select this option to point the binary file for debugging. This file will be downloaded to the target:
    • Use project binary: Select this option to debug the project's executable.
    • Use file: Select this option to point a different ELF file for debugging. Click Workspace or File System to browse to the file.
  • Image offset (hex): Specify offset of the file section where the code starts. Leave this field empty if the code will be loaded from the project's executable.
Specify the source of the debugging information (“symbols”) to be passed to the debugger. The debugging information will be kept on the host rather than downloaded to the target.

Typically, the debugging information (DWARF) is embedded in the ELF file generated from the project.

  • Load symbols: Enable this option to point the file with symbols:
    • Use project binary: Select this option to use symbols from the project's executable.
    • Use file: Select this option to use symbols from a different ELF file. Click Workspace or File System to browse to the file.
  • Symbols offset (hex): Specify offset of the .text section in the file where the table of symbols starts. Leave this field empty if symbols will be fetched from the project's executable.
Runtime Options Specify the runtime settings for the debugger. Options:
  • Set program counter at (hex): Select this option to set the program counter.
  • Set breakpoint at: Set the first breakpoint at the specified function.
  • Resume: Select this option to continue execution after the breakpoint.
Run Commands Commands to be executed by the GDB client after all above options are done. After that, the user can interact with the debugger.