Requirements

The following hardware is mandatory:

• A PC

• A target Symbian device

  The device must provide a way to launch executables and must be capable of being connected to the PC via a supported communication link as described below. It must also support the software requirements described in the following section. Debugging has been validated on the Brutus and Cogent boards.

• A communication link

  Theoretically any kind of communication link can be used provided that it is accessed on the Symbian target device via the communication server, and on the host computer as a standard serial port. Serial cable connections have been validated for debugging on the Brutus and Cogent boards, and on the Psion Series 5mx Pro. Infrared connections have been tested on the Brutus board and 5mx Pro.

On the host computer:

• A Symbian-aware version of GDB

  A Symbian-aware version of GDB is installed automatically with the SDK. Note that the version of GDB supplied with the SDK has only been tested under NT 4.0. See How to check that GDB is Symbian-aware for more information.

  An optional debuggee-specific GDB initialisation file gdb.ini.

  The GDB initialisation file configures the host-side communications port, and identifies the program to be debugged. GDB must be launched from the directory containing the debuggee's initialisation file, which is typically located with the debuggee's build script bld.inf.

On the target-side:

• The Base sub-component of the Symbian platform

• The communication server and the appropriate communication module for the type of communication link to be used. e.g. ECUART.CSY if a serial cable is used

• The GDB stub engine gdbseng.dll, user interface gdbstub.exe, and plug in DLL gdbseal.dll. Note that these may already be in device ROM, otherwise they can be installed from a Symbian installation file supplied with the SDK.

• An optional GDB stub configuration file

  The GDB stub is configured by default to communicate on device port 0, at a rate of 115200 baud, using a serial cable connection. The configuration file is require for debugging using another port, connection rate, or over an IR connection. If present, the file must be located at C:\gdbstub\gdbstub.ini.

• The various files composing the program to debug (debuggee)