Debugging a remote target

Debugging a CBS project is done via the Launch Bar. Make sure the launch bar is installed and enabled.

A new remote target must be added to the launch bar.

  1. Select launch mode Debug.

  2. Unfold the launch target selector by pressing the "v" symbol.

  3. Select New Launch Target…​

Create new launch target

Remote TCP target

Select target type GDB Remote TCP and click Next >.

Select GDB Remote TCP

Enter the connection details, and click Finish.

TCP connection details

When the remote target is selected in the launch bar, the launch configuration Debugger tab has an extra sub tab Connection. The Connection tab inherited the values from launch target. The fields are disabled for editing. Changing host name or port number must be done in the launch target. Note that the launch target can be used for multiple launch configurations.

Launch configuration debug tab TCP

Build and launch the project.

Remote Serial target

Create a new launch target of type GDB Remote Serial.

Select GDB Remote Serial

Enter the connection details, and click Finish.

Serial connection details

As with a TCP remote target, in the launch configuration the the fields for the connection parameters are not editable.

Launch configuration debug tab Serial


Copyright (c) 2000, 2025 Contributors to the Eclipse Foundation