diff -r 15296fd0af4a -r 14dc2103a631 trace/traceanalyser/com.nokia.s60tools.traceanalyser.help/html/tasks/creating_rules.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/trace/traceanalyser/com.nokia.s60tools.traceanalyser.help/html/tasks/creating_rules.htm Wed Jun 23 13:57:56 2010 +0300 @@ -0,0 +1,85 @@ + + + + + +Creating tracing rules + +

Creating tracing rules

Before you start

Before you +can create tracing rules, check that you have:

See +TraceAnalyser basic walk-through for the complete steps.

To create +tracing rules, do the following:

    +
  1. Start TraceAnalyser from the Carbide > TraceAnalyser menu item. +
    2. +
  2. Click Create new rule.

    The Edit Rule dialog is displayed. +

    3. +
  3. From the Rule Type list box, select which kind of rule you are +creating:
    4. +
  4. In the Rule Name field, type in a name for the rule.

    For example: +Camera Test.

    5. +
  5. (Optional) In the Description field, type in a free-form description +of what the rule is about.

    For example, for a timing rule: Test that +the Camera application is able to capture a picture within 1000ms time limit. +

    6. +
  6. Configure the rule-specific settings.

    For instructions, see either To define timing rules or To define +parameter rules below.

    7. +
  7. Connect your PC to the device by using the connection settings defined +in TraceViewer (USB or XTI).
    8. +
  8. In TraceViewer, activate the traces you want to receive.
    9. +
  9. Run your application on the device.

    During execution, TraceAnalyser +lists both passed and failed events to the main view, along with other information +such as the pass rate. See the following example:

    10. +

After the rules have been executed, you can do either of the following: +

To define timing rules:

    +
  1. To select which trace should be monitored as the first part of this rule +(Trace A), click Select Trace.

    The Select Trace for Rule dialog +is opened, showing the trace dictionaries that you loaded in TraceViewer earlier. +

    2. +
  2. Select the traces you want to use and click OK.
    3. +
  3. Repeat the above steps for Trace B.
    4. +
  4. In the Time Limit fields, enter the range the values in milliseconds +for Trace A and Trace B.

    The following figure shows an example of how a tracing rule could +look like:

    Sample of the Edit Rule dialog with the sample values filled in.

    5. +
  5. To finish, click OK.
    6. +

To define parameter rules:

    +
  1. To select which trace should be monitored as the first part of this rule, +click Select Trace.

    The Select Trace for Rule dialog is opened, +showing the trace dictionaries that you loaded in TraceViewer earlier.

    2. +
  2. Select the traces you want to use and click OK.
    3. +
  3. From the Trace parameter should be list box, select the behavior +what you want the parameter and values to be:

    The following figure shows an example of how a tracing rule could +look like:

    Sample of the UI showing values for parameter rule type

    4. +
  4. To finish, click OK.
    5. +
Related tasks
+