TraceAnalyser basic walk-through

Before you start

Setting up TraceAnalyser requires the following tracing tools:

The following steps are needed for using this tool:

  1. Open or create a project in Carbide.c++.
  2. 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.

  3. 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:

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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.