## Launch Configuration Setup

To communicate between the Carbide.c++ debugger and the on-device debug agent, using either Application TRK or System TRK, you must define a debug launch configuration that matches the installed debug agent. The two configurations available include:

- Symbian OS Appication TRK— used to run or debug applications on a target device using the Application TRK on-device debug agent. Application TRK is an application that runs on released phones and allows you to debug your executables. The debugger will download a Symbian OS installation file to the phone and install it prior to launching.
- Symbian OS System TRK (not available in the Developer Edition) —used to run or debug applications or ROM code on a target device using the System TRK on-device debug agent. System TRK is an application that runs on reference boards and prototype phones and allows you to debug your executables. The debugger will download files to the phone prior to launching.

By default, you can click the Debug icon () in the toolbar to launch the New Launch Configuration Wizard. This creates a launch configuration for the project based on project information and any additional input required, like COM port selection. It is the recommended method for creating new launch configurations. Or, use the Debug window to create a customized launch configuration.

Figure 1. Debug launch configuration for on-device debugging (Application TRK shown)

#### Defining a Customized Launch Configuration

1. Choose the Run > Open Debug Dialog... menu item

The Debug window appears.

2. Select a Configuration type for on-device debugging and click New

Choose the Symbian OS Application TRK or System TRK configuration based on which debug agent is installed on the device, then click New. A new debug launch configuration appears in the Configuration list and the Main tab appears.

3. Enter the required information

For debug launch configurations using the TRK debug agent, the following pages require review and possible option settings:

- Main— defines the project to be launched on the target device
- Arguments — enter command line build system arguments
- Debugger— provides control over entry points, message handling, and instruction set default settings
- Connection— specifies the method used to transfer files to the target device
- File Transfer — the files transfered to the target device at the start of each launch
- Installation (Application TRK only)— specifies the .sis or .pkg file to install on the target device
- Executables — specifies the executables to be debugged
- ROM Log (System TRK only) — specifies the executables to be debugged

4. Click Debug

The Debug window closes and the Carbide.c++ debugger begins a debugging session using the new configuration. The next time you click the Debug icon, this debug launch configuration is used to start a debug session.

##### Related references

- Launch Configurations
- On-device Debugging
- Debug Window (On-device Debugging) Overview
- Creating a Launch Configuration