Eclipse

From SEGGER - Support Wiki
Jump to: navigation, search

Eclipse is a universal customizable IDE, which is also the base for many common commercial IDEs. In order to work with Eclipse and debug with J-Link, you also need to install a toolchain which includes compiler, assembler, linker + GDB (GNU Debugger) for debugging (e.g. GNU Tools for ARM). Moreover, in order to allow hardware debugging on embedded systems via GDB + GDB Server, there is also an Eclipse plugin needed, which enables hardware debugging via GDB (e.g. the CDT plugin). After setting up Eclipse + Plugin, Eclipse will use GDB as debugger where GDB communicates via the GDB protocol with J-Link GDB Server, allowing to debug the target hardware which is connected to a J-Link.

The tutorials in this article are based on Eclipse Neon.3 setup with the GNU ARM Eclipse environment by following the official install instructions. The GNU ARM Eclipse project is a collection of plug-ins for Eclipse CDT and ARM toolchains including extensions for easy embedded development in Eclipse. It is recommended to use this plug-in when working with a standard Eclipse installation.


Note: J-Link GDB Server is part of the J-Link Software and Documentation Pack and can be used free of charge.


Getting started

Creating a J-Link Debug Configuration

  • Open Run -> Debug Configurations...
  • Double click GDB SEGGER J-Link Debugging
  • Eclipse CreateJLinkDebugConf.png
  • Eclipse will create a New Debug Configuration and set setting to defaults based on the workspace and project
  • Eclipse JLinkDebugConfDefault.png


Configuring the target interface type

  • Open Run -> Debug Configurations...
  • On the left side, select the used Debug configuration in the group GDB SEGGER J-Link Debugging
  • Switch to the tab Debugger
  • The target interface can be selected in the area marked below
  • Eclipse JLinkDebugConf Debugger TargetInterface.png


Configuring the target interface speed

  1. Initial interface speed before/during connect
    • Open Run -> Debug Configurations...
    • On the left side, select the used Debug configuration in the group GDB SEGGER J-Link Debugging
    • Switch to the tab Debugger
    • The interface speed before connect can be specified in the field Initial speed marked below
    • Eclipse JLinkDebugConf Debugger TargetInterfaceSpeed Initial.png
  2. Interface speed after connect to target before/during reset & halt
    • Open Run -> Debug Configurations...
    • On the left side, select the used Debug configuration in the group GDB SEGGER J-Link Debugging
    • Switch to the tab Startup
    • The interface speed after connect to target before/during reset & halt can be specified in the field Low speed marked below
    • Eclipse JLinkDebugConf Startup TargetInterfaceSpeed ResetHalt.png
  3. Interface speed after initialization
    • Open Run -> Debug Configurations...
    • On the left side, select the used Debug configuration in the group GDB SEGGER J-Link Debugging
    • Switch to the tab Startup
    • The initial speed can be specified in the area JTAG/SWD Speed marked below
    • Eclipse JLinkDebugConf Startup TargetInterfaceSpeed.png


Specifying the target device

  • Open Run -> Debug Configurations...
  • On the left side, select the used Debug configuration in the group GDB SEGGER J-Link Debugging
  • Switch to the tab Debugger
  • The target device can be specified in the field Device name: marked below
  • Eclipse JLinkDebugConf Debugger TargetDevice.png


Specifying J-Link GDB Server commandline options

For a list of available commandline options, please refer to UM08001. Commandline options for GDB Server can used for various J-Link features, e.g.

  • specifying a J-Link Settings file
  • specifying a J-Link script file
  • specifying a J-Link Command String

Commandline options can be specified by editing the field Other options:

  • Open Run -> Debug Configurations...
  • On the left side, select the used Debug configuration in the group GDB SEGGER J-Link Debugging
  • Switch to the tab Debugger
  • Commandline options can be specified by editing the field Other options marked below
  • Eclipse JLinkDebugConf Debugger GDBServerCLO.png


J-Link Settings File

Please refer to Specifying J-Link GDB Server commandline options


Using J-Link Command Strings

Please refer to Specifying J-Link GDB Server commandline options
Please note that J-Link Command Strings can also be executed from J-Link script files.


Using J-Link script files

Please refer to Specifying J-Link GDB Server commandline options