Creating tracing rules
Before you start
Before you
can create tracing rules, check that you have:
- compiled your code,
- and loaded the generated dictionary file to TraceViewer.
See
TraceAnalyser basic walk-through for the complete steps.
To create
tracing rules, do the following:
- Start TraceAnalyser from the Carbide > TraceAnalyser menu item.
- Click Create new rule.
The Edit Rule dialog is displayed.
- From the Rule Type list box, select which kind of rule you are
creating:
- Timing rule for detecting if an operation can be executed within
a specified time limit.
- Trace parameter rule for detecting if parameters are beyond a desireable
value range.
- In the Rule Name field, type in a name for the rule.
For example:
Camera Test.
- (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.
- Configure the rule-specific settings.
For instructions, see either To define timing rules or To define
parameter rules below.
- Connect your PC to the device by using the connection settings defined
in TraceViewer (USB or XTI).
- In TraceViewer, activate the traces you want to receive.
- 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:

After the rules have been executed, you can do either of the following:
To define timing rules:
- 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.
- Select the traces you want to use and click OK.
- Repeat the above steps for Trace B.
- In the Time Limit fields, enter the range the values in milliseconds
for Trace A and Trace B.
- For Time Limit A, the value means that Trace B must arrive after
this.
- For Time Limit B, the value means that Trace B must arrive before
this.
The following figure shows an example of how a tracing rule could
look like:

- To finish, click OK.
To define parameter rules:
- 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.
- Select the traces you want to use and click OK.
- From the Trace parameter should be list box, select the behavior
what you want the parameter and values to be:
- Greater than/Equal to
- Less than/Equal to
- Between
- Equal to
The following figure shows an example of how a tracing rule could
look like:

- To finish, click OK.
Related tasks