## Run-mode Overview

The Debug or launch configuration window provides C/C++ debugger options for on-device debugging. On-device debugging uses a program called Terminal Resident Kernel (TRK) to communicate between Carbide and the device. On-device debugging is supported by creating one of the following debug launch configurations:

- Symbian OS Application TRK—supports application debugging only
- Symbian OS System TRK—supports both application and limited ROM debugging (not available in the Developer Edition)

The settings included in the TRK launch configurations are a combination of Carbide, CDT, and Eclipse options. Once a suitable Symbian OS debug launch configuration is defined the tabs in the window include:

- The Main tab defines the project to be launched. Enter the name of the project containing the class to launch in the project field, and the executable name in the Executable field and the remote process to launch on the device.
- The Arguments tab (standard Eclipse page) defines any arguments to be passed to the process to launch.
- The Debugger tab provides common debugger options for the project.
- The Connection tab specifies the method used to transfer files to the target device. This is where you specify the COM port if the connection is via Bluetooth or USB.
- The File Transfer tab displays a list of files to transfer to the target device at the start of each launch. This is used primarily by System TRK to transfer files to a phone for debugging.
- The Installation tab (shown in Application TRK only) defines where programs are installed on the target device. This is where you specify the SIS file to be uploaded for Application TRK.
- The Executables tab allows you to specify which executables within your project to debug.
- The ROM Log tab (shown in System TRK only) specifies where the ROM log file is stored and the Epoc32 directory.
- The Source tab (standard CDT page) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here.
- The Common tab (standard CDT page) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file and specify which perspectives become active when the launch configuration is launched.

Figure 1 - Debug/Run window for on-device debugging (Application TRK version)

##### Other references

- Debug Window
- Creating a Launch Configuration
- Emulator overview
- Stop-mode overview