- Open or create a project in Carbide.c++.
- To add OST traces to the source code, start the TraceBuilder tool from
Carbide > TraceBuilder.
For more instructions, see the topic Adding
traces to the source code in TraceBuilder Help.
- Set your project's include paths and compile the application. For instructions,
see Setting project include paths and compiling in TraceBuilder Help.
Note: Compilation uses TraceCompiler that generates the needed headers.
After compilation, you should have two files:
- a SIS file of your tool that you can now install into the device.
- an XML format dictionary file that is needed for activating and decoding
traces in TraceViewer. It is generated into the following directory: [SDK
root]\epoc32\include\internal\symbiantraces\dictionary.
- In TraceViewer, also define the settings for connecting your PC to the
device. The options are USB or eXtended Trace Interface (XTI).
See
Setting TraceViewer preferences in TraceViewer Help.
Tip: If
you have TraceSwitch enabled in the device, the USB connection is supported
by default and you only need to plug in the device to start receiving traces.
- To activate and decode traces, start the TraceViewer tool from Carbide
> TraceViewer, and activate the dictionary file there.
For instructions,
see Trace activation in TraceViewer Help.
- In TraceAnalyser, create the rules for issues you want to monitor: timings
or parameters.
See example scenarios in TraceAnalyser overview and
step-by-step instructions in Creating
tracing rules.
- Transfer your application's SIS file to the device and run it.
If some
tracing rules fail during execution, they are listed on the TraceAnalyser's
Fail Log tab.
- To analyse the failed rule in more detail, double-click it to view it
in the TraceViewer application. TraceViewer will show the codeline that caused
the failure.