Difference between revisions of "Embedded Studio Debug Options"

From SEGGER Wiki
Jump to: navigation, search
(Created page with "The Debug Options configure how the project should be debugged, which debug interface (J-Link, GDB Server, Simulator) should be used, and how the target should be configured o...")
 
(Debugger)
Line 28: Line 28:
 
|-
 
|-
 
| Startup Completion Point
 
| Startup Completion Point
||
+
|| ''string''
  +
|| Specifies the point in the program where startup is complete. Software breakpoints and debugIO will be enabled after this point has been reached.
||
 
 
|-
 
|-
 
| Start From Entry Point Symbol
 
| Start From Entry Point Symbol
||
+
|| Yes, No
  +
|| If yes the debugger will start execution from the entry point symbol.If no the debugger will start execution from the core specific location.
||
 
 
|-
 
|-
 
| Leave Target Running
 
| Leave Target Running
||
+
|| Yes, No
  +
|| Debugger will leave the target running on debug stop.
||
 
 
|-
 
|-
 
| Register Definition File
 
| Register Definition File
  +
|| ''filepath''
||
 
  +
|| The name of the file containing register definitions.
||
 
 
|-
 
|-
 
| Debug Terminal Log File
 
| Debug Terminal Log File
||
+
|| ''string''
  +
|| A file to write the output from the debug terminal to.
||
 
 
|-
 
|-
 
| Threads Script File
 
| Threads Script File
  +
|| ''filepath''
||
 
  +
|| The threads script used by the debugger.
||
 
 
|-
 
|-
 
| Thread Maximum
 
| Thread Maximum
||
+
|| ''number''
  +
|| The maximum number of threads to display.
||
 
 
|-
 
|-
 
| Working Directory
 
| Working Directory
  +
|| ''directorypath''
||
 
  +
|| The working directory for a debug session. This property will have macro expansion applied to it.
||
 
 
|-
 
|-
 
| Command Arguments
 
| Command Arguments
||
+
|| ''string''
  +
|| The command arguments passed to the executable. This property will have macro expansion applied to it.
||
 
 
|-
 
|-
 
| Access Variables Within Memory Map Only
 
| Access Variables Within Memory Map Only
||
+
|| Yes, No
  +
|| If enabled the debugger will only display variables located in the memory map.
||
 
 
|-
 
|-
 
| Entry Point Symbol
 
| Entry Point Symbol
||
+
|| ''string''
  +
|| Debugger will start execution at symbol if defined.
||
 
 
|-
 
|-
 
| Ignore .debug_aranges Section
 
| Ignore .debug_aranges Section
||
+
|| Yes, No
  +
|| The debugger will not use the .debug_aranges section.
||
 
 
|-
 
|-
 
| Ignore .debug_frame Section
 
| Ignore .debug_frame Section
||
+
|| Yes, No
  +
|| The debugger will not use the .debug_frame section.
||
 
 
|-
 
|-
 
| Memory Upload Page Size
 
| Memory Upload Page Size
||
+
|| ''number''
  +
|| The aligned page size the debugger uses when uploading address ranges.
||
 
 
|-
 
|-
 
| Reserved Member Name
 
| Reserved Member Name
||
+
|| ''string''
  +
|| The struct reserved member name. Struct members that contain the (case insensitive) string will not be displayed.
||
 
 
|-
 
|-
 
| RTT Control Block Address
 
| RTT Control Block Address
||
+
|| ''string''
  +
|| The symbol or 0x prefixed address of the RTT control block.
||
 
 
|-
 
|-
 
| RTT Enable
 
| RTT Enable
||
+
|| Yes, No
  +
|| If enabled the debugger will service RTT input/output in the debug terminal.
||
 
 
|-
 
|-
 
| Starting Stack Pointer Value
 
| Starting Stack Pointer Value
||
+
|| ''number''
  +
|| The symbol or 0x prefixed value to set the stack pointer on start debugging.
||
 
 
|-
 
|-
 
| Type Interpretation File
 
| Type Interpretation File
||
+
|| ''string''
  +
|| Specifies the type interpretation file to use.
||
 
 
|-
 
|-
 
| Debug Symbols File[0-3]
 
| Debug Symbols File[0-3]
||
+
|| ''string''
  +
|| The name of the debug symbols file. This property will have macro expansion applied to it. If it is not defined then the main load file is used.
||
 
 
|}
 
|}
   

Revision as of 13:15, 14 August 2019

The Debug Options configure how the project should be debugged, which debug interface (J-Link, GDB Server, Simulator) should be used, and how the target should be configured on certain operations.

Debugger

The Debugger options control how to debug the project. These options apply to all debug interfaces.

Options Values Description
Target Connection J-Link, GDB Server, Simulator Select the debug interface to use to connect to the target device.
Target Device string, select from the list of known devices The name of the device to connect to.
Run To Control Always, Only With No Breakpoint Set, Never, On Entry Specifies when the initial breakpoint should be set.
Run To string Specifies where to set the initial breakpoint.
Startup Completion Point string Specifies the point in the program where startup is complete. Software breakpoints and debugIO will be enabled after this point has been reached.
Start From Entry Point Symbol Yes, No If yes the debugger will start execution from the entry point symbol.If no the debugger will start execution from the core specific location.
Leave Target Running Yes, No Debugger will leave the target running on debug stop.
Register Definition File filepath The name of the file containing register definitions.
Debug Terminal Log File string A file to write the output from the debug terminal to.
Threads Script File filepath The threads script used by the debugger.
Thread Maximum number The maximum number of threads to display.
Working Directory directorypath The working directory for a debug session. This property will have macro expansion applied to it.
Command Arguments string The command arguments passed to the executable. This property will have macro expansion applied to it.
Access Variables Within Memory Map Only Yes, No If enabled the debugger will only display variables located in the memory map.
Entry Point Symbol string Debugger will start execution at symbol if defined.
Ignore .debug_aranges Section Yes, No The debugger will not use the .debug_aranges section.
Ignore .debug_frame Section Yes, No The debugger will not use the .debug_frame section.
Memory Upload Page Size number The aligned page size the debugger uses when uploading address ranges.
Reserved Member Name string The struct reserved member name. Struct members that contain the (case insensitive) string will not be displayed.
RTT Control Block Address string The symbol or 0x prefixed address of the RTT control block.
RTT Enable Yes, No If enabled the debugger will service RTT input/output in the debug terminal.
Starting Stack Pointer Value number The symbol or 0x prefixed value to set the stack pointer on start debugging.
Type Interpretation File string Specifies the type interpretation file to use.
Debug Symbols File[0-3] string The name of the debug symbols file. This property will have macro expansion applied to it. If it is not defined then the main load file is used.

J-Link

The J-Link Options configure how to connect to a J-Link and how J-Link connects to the target. These options apply only when "J-Link" is selected as "Target Connection".

Options Values Description
Host Connection string, USB, USB s/n, IP s/n, IP nnn.nnn.nnn.nnn, selection from available J-Links Defines how to connect Embedded Studion to the J-Link.
Target Interface Type
Speed
Supply Power
Show Log Messages In Output Window
Log File
Script File
Exclude Flash Cache Range
Additional J-Link Options

GDB Server

The GDB Server Options configure how to connect to a GDB Server and how to handle it. these options apply only when "GDB Server" is selected as "Target Connection".

Options Values Description
Host string, Default: localhost The hostname or IP of the GDB Server to connect to.
Type J-Link, OpenOCD, ST-Link, Custom The type of GDB Server being connected to.
GDB Server Command Line string The command line to start GDB Server.
Auto Start GDB Server Yes, No Specifies whether GDB Server is started by Embedded Studio on connect or assumed to be already running.
Port number The portnumber of the GDB Server to connect to.
Reset and Stop Command string, automatically set for known GDB Servers. The remote GDB Server command to use to reset and stop the target.
Ignore Checksum Errors Yes, No, automatically set for known GDB Servers. Specifies whether an incorrect GBD communication checksum causes an error. Workaround for ST-Link GDB Server.
Allow Memory Access During Execution Yes, No, automatically set for known GDB Servers. Specifies whether memory can be accessed while target is running. If No, target will be stopped for each memory access.
Log File filepath Specifies a file to output the log of GDB Server communication to.
Target XML File filepath If set, use this file instead of the target.xml returned by GDB Server.
Connect Timeout number The length of time in secconds to attempt to connect to server before failing.


Simulator

The Simulation Options configure how the target device core should be simulated. These options apply only when "Simulator" is selected as "Target Connection".

Options Values Description
Memory Simulation file
Memory Simulation Parameter
Memory Simulation Parameter Macros
Stop On Memory Error
Trace Buffer Size

Loader

The Loader Options configure which application file and additional files to program to the target device on debug.

Target Control

Additional Options for checks when debugging on a target.

Target Script

The Target Scrip Options configure script functions to be executed on certain debug operations.

Target Trace

The Target Trace Options configure which trace interface to use and how to initialize trace on the target device.