diff -r 15296fd0af4a -r 14dc2103a631 trace/traceanalyser/com.nokia.s60tools.traceanalyser.help/html/cheatsheet/getStarted_ta_cs.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/trace/traceanalyser/com.nokia.s60tools.traceanalyser.help/html/cheatsheet/getStarted_ta_cs.xml Wed Jun 23 13:57:56 2010 +0300 @@ -0,0 +1,140 @@ + + + + + + + + +This tutorial shows you the steps for creating tracing rules in the TraceAnalyser tool. +

+Prerequisites +

+* TraceViewer and TraceBuilder applications are present in your Carbide.c++ environment. +

+* (Optional) TraceSwitch SIS is installed on your device. +

+You can obtain TraceSwitch from the S60 RnD SDK, under the RnD Tools folder. TraceSwitch, together with the ToolsStarter SIS, support the USB connection method by default. You only need to plug in the device to start receiving traces. +
+
+ + +Open or create a new project in Carbide.c++. + + + + +Adding Open System Traces (OST) means adding "tags" to your application's source code, to those places that you want to monitor. +
+
+The easiest way to do this is by using the TraceBuilder application: Carbide > TraceBuilder. +
+
+For example, to monitor timings in a camera application, you could add the first trace to capture the key press for taking a picture, and another where the taken picture is shown to the user. +
+
+The corresponding rule to be created in TraceAnalyser might then state that these actions must occur within 5 seconds. +
+
+ + + To use Open System Trace (OST) traces, you must include the "OpenSystemTrace.h" header file from the development environment. +

+
+
+ + + After compiling your project, you should have two files: +

+1: A SIS file of your application that you can install into the device by using USB. +

+2: An XML format dictionary file that is needed for activating and decoding traces in TraceViewer. +

+The file is generated into the following directory: +

+[SDK root]\epoc32\include\internal\symbiantraces\dictionary. + +
+
+ + + To start receiving traces on the TraceViewer application, define connection settings between the device and your PC. +

+Start the TraceViewer tool from Carbide > TraceViewer. +

+On the toolbar, click the small arrow and from the drop-down list, select Connection Settings. +

+
+
+ + + Trace activation is a way of generating specific trace data that is relevant for your components. This reduces the amount of traces listed on the TraceViewer user interface. +

+Start the TraceViewer tool from Carbide > TraceViewer. +

+Load the dictionary file (.xml) that contains the necessary component and group information. +

+Activate the components and groups you want to use. +

+For more information, see TraceViewer Help. +
+
+ + + Start TraceAnalyser from Carbide > TraceAnalyser. +

+Create either Timing or Parameter rule type for the events you want to monitor. +

+An example of the rule could be a statement like this: "Taking a picture should not take longer than 5 seconds." +
+
+ + + In TraceViewer, start receiving traces. +

+Run the SIS file of your application on the device. +
+
+ + + All executed trace rules (both passed and failed ones) are listed on the TraceAnalyser main view. +

+If some of them fail during execution (for example, an operation execution takes longer than defined in the rule), the TraceAnalyser icon will quickly flash to indicate that a rule violation has occurred. +

+To view the failed cases, select the Fail Log tab. +

+To view the traces that caused the failure, double-click a rule on the view. TraceViewer opens and scrolls to the traces. +

+Double-click the trace to jump to the codeline that caused the failure. +
+
+ + + + To view the traces that caused the failure, double-click a rule on the TraceAnalyser Fail Log. +

+TraceViewer opens and scrolls to the trace. +

+In TraceViewer, double-click the trace to jump to the codeline that caused the failure. +

+Once you have identified the problem in the source code, try to fix it and run the rule again. +
+
+ +