GD32 Embedded Builder

From SEGGER Knowledge Base
Jump to navigation Jump to search

GD32 Embedded Builder is a J-Link compatible 3rd party IDE that supports most J-Link features.
Usually it is not necessary to separately install the J-Link software and documentation package.
Anyhow, we recommend installing the latest version of the J-Link software and make sure that DLL is used.

Creating a new project

In this example we will use GD32 Embedded Builder's Code Generation feature, which automatically creates projects and code for a list of GD32 devices.

  1. Click File -> New -> Project.
  2. Select GD32 Project and click Next >.
    GD32 Embedded Builder New GD32 Project .png

  3. Enter a project name and click Next >.
  4. Select the desired MCU and click Finish.
    GD32 Embedded Builder New Project Select Device.png

  5. Configure the peripherals, clock and other options to your liking.
  6. Click Project -> Generate Code.
    GD32 Embedded Builder New Project Generate Code.png

  7. Follow the steps described in Using J-Link with an exisiting project

Using J-Link with an exisiting project

  1. Build the project.
    • Press Ctlr+B or click the hammer symbol to do so.
  2. Configure a debug configuration for J-Link usage
    1. Open the debug configurations via Run -> Debug Confiugrations
      GD32 Embedded Builder Open Debug Configurations.png

    2. Right click GDB General Debugging and click New Configuration
      GD32 Embedded Builder New Debug Configuration.png

    3. In the "Main" tab make sure the compiled application was detected.
      GD32 Embedded Builder Debug Configuration Main Tab.png

    4. In the "Debugger" tab:
      1. Select Debugger: J-Link
      2. Make sure the target device was selected correctly. If unsure, a complete list of supported device names can be found at segger.com
      3. Make sure the J-Link GDB Server command line tool path is correct.
        • We recommend installing the current version of the J-Link software and documentation package and using the path to that installation of the J-Link GDB Server command line tool.
      4. Press Apply and Close'.
        GD32 Embedded Builder Debug Configuration Debugger Tab.png


From now on you can click the bug-symbol or press F11 to start a debugging sessions.
GD32 Embedded Builder DebuggingSession.png