Getting Started

This section details the hardware and software requirements of the Core Dump Subsystem.

CDS can capture application and system failure information only if it is configured to capture such information. You can configure CDS either using the tools provided by Symbian (TechView UI and a command-line tool) or your own UI. To configure CDS using the tools provided by Symbian, the following requirements must be met:

RequirementDescription

H4 Hardware Reference Platform (HRP)

An H4 HRP is used as the development boards for Symbian OS Version version 9.5 and later. The purpose of this hardware is to provide customisation and development kit customers with a target platform, and to verify the functionality of Symbian platform and applications that run on it.

Symbian platform

The HRP must have Symbian OS version v9.5 or later running on it. This is because the run-mode debug subsystem used by CDS is available from this version onwards.

MMC (Multi-Media Card)

An MMC is used to copy the ROM image from the PC and load it on to the hardware board.

PC

A PC installed with Symbian OS v9.5 SDK or later installed on it to create the ROM image.

If the requirements listed in the preceding table are met, you must create a ROM image containing the configuration UI, the command-line tool, and the plug-ins.

To create the ROM image for a H4 board, run the following command on your PC:

> buildrom h4hrp techview dexcformatter.iby symbianelfformatter.iby filewriter.iby coredumpserver.iby coredumpui.iby coredumpscriptconfig.ibycrashapp.iby crashdriver.iby btrace.iby

This builds a ROM image named h4hrp_001.techview.IMG for the H4 board. The image contains CDS with the configuration UI, Symbian ELF and D_EXC formatters, and file writer plug-ins.

You can load the ROM image on an H4 board. After the ROM image is loaded, configure CDS with the UI or the command-line tool. It is then ready to use. For more information on how to configure CDS, refer to Configuration.

Notes:

  • The hardware and software requirements, BUILDROM commands, and steps to load the ROM image listed earlier, are valid only if you are using the TechView-based UI to configure CDS.

  • The IBY files are provided with CDS as part of the TVK (Tools Vendor Kit) Debug package.