Main page

The options shown in the Main page differ based upon the type of launch configuration. Generally, the options fall into these choices:

Emulation Main page

The Symbian OS Emulation launch configuration uses the Main page to define the process to be launched by the emulator.

The behavior that occurs when launching a debug session varies based upon the SDK. Normally, starting a debug session launches the emulator (epoc.exe) and you must then navigate to your application and open it. However, starting a debug session for an .exe file will, in most cases, launch the .exe directly. This starts the emulator and then opens your application automatically. Note that some SDKs do not support this behavior. In those cases you must still open your application in the emulator manually.

Figure 1. Main page (Emulation shown)

Table 1. Emulator Main page —items
Item Explanation
Project

The project to associate with this debug launch configuration. Click Browse to select a different project.

Process to launch The path to the emulator or executable to launch. For Symbian OS 9.1 the emulator path is required. For Symbian OS 9.2 and later the path to the executable should be used. Click Browse to select a different emulator.

Run-mode Main page

The Symbian OS Application TRK launch configuration uses the Main page to defines the project and the process to launch on the target device.

Figure 2 - Main page (Application TRK shown)

Table 2. Run-mode Main page —items
Item Explanation
Project

The project to associate with this launch configuration. Click Browse to select a different project.

Remote process to launch

The absolute path of the remote executable to launch on the target device. The binary to debug may be stored on one of several memory locations, the most common are:

  • RAM (default) — programs running in RAM are launched from c:\sys\bin\
  • ROM — programs running in ROM are launched from z:\sys\bin\
  • Memory cards — programs running on a memory card are launched from e:\sys\bin\

In the event a program is not launching, verify that the path is correct for the memory location where the binary resides.

Use connection Choose the remote connection type to associate with this launch configuration. Click New to add a new connection, or Edit to modify the current one.

Stop-mode Main page

The Symbian OS System TRK, Sophia, and Trace32 launch configurations uses the Main page to defines the project and the executable to launch on the target device.

Figure 3. Main page

Table 3. Stop-mode Main page — items
Item Explanation
Project The project to associate with this debug launch configuration. Click Browse to select a different project.
Executable This is the name of the executable that is linked to the project. Click Browse to select a different executable.
Use connection Choose the remote connection type to associate with this launch configuration. Click New to add a new connection, or Edit to modify the current one.

Other references