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...")
(No difference)

Revision as of 11:23, 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
Start From Entry Point Symbol
Leave Target Running
Register Definition File
Debug Terminal Log File
Threads Script File
Thread Maximum
Working Directory
Command Arguments
Access Variables Within Memory Map Only
Entry Point Symbol
Ignore .debug_aranges Section
Ignore .debug_frame Section
Memory Upload Page Size
Reserved Member Name
RTT Control Block Address
RTT Enable
Starting Stack Pointer Value
Type Interpretation File
Debug Symbols File[0-3]

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.