## Launch Configuration Setup

To communicate between the Carbide.c++ debugger and the on-device debug agent, using either Symbian OS Device (Install SIS) or Symbian OS Device, you must define a debug launch configuration that matches the installed debug agent. The two configurations available include:

- Symbian OS Device (Install SIS) — used to run or debug applications on a target device using CODA (Carbide On-device Debug Agent). 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 Device — used to run or debug applications or ROM code on a target device using CODA. 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 (Device (Install SIS) 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 Device or Symbian OS Device (Install SIS) 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 CODA, 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 (Install SIS only)— specifies the .sis or .pkg file to install on the target device
- Executables — specifies the executables to be debugged
- ROM Log (Device 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