## Launch Configuration Setup

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

- Symbian OS Appication CODA— used to run or debug applications on a target device using the Application CODA on-device debug agent. Application CODA 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 CODA (not available in the Developer Edition) —used to run or debug applications or ROM code on a target device using the System CODA on-device debug agent. System CODA 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 TCF CODA shown)

#### Defining a Customized Launch Configuration

1. Choose the Run > Debug As menu item

The Debug window appears.

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

Choose the Symbian OS Application TCF CODA or System CODA 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 CODA 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 CODA only)— specifies the .sis or .pkg file to install on the target device
- Executables — specifies the executables to be debugged
- ROM Log (System CODA 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