Set a Trace event

2.11.3.1 Set a Trace event

To set a Trace event, set a trace start event and a trace end event that starts/stops collecting the trace data.

Use one of the following methods to set a trace start event and a trace end event.

(1)	For execution-related events

By setting execution-related events for a trace start event and a trace end event, it is possible to start and stop the collection of trace data at any place.

Perform this operation in the Editor panel/Disassemble panel in which the source text/disassembly text is displayed.

Follow the operation listed below from the context menu, in accordance with your desired event type, after moving the caret to the target line that has a valid address.

Event Type	Operation
Trace start	Select [Trace Settings] >> [Start Tracing]
Trace end	Select [Trace Settings] >> [Stop Tracing]

Caution

[Simulator]
Simulator will not display a trace end event as the results of a trace. For this reason, set a trace end event to one line below the range that you wish to display as the trace data.

A trace start event or a trace end event is set to the instruction at the start address corresponding to the line of the caret position.

Once a trace start event or a trace end event is set, the following event mark is displayed in the event area of the line that an event is set.

Table 2.12

Event Marks of Trace Start Event and Trace End Events

Event Type	Event Mark
Trace start
Trace end

Figure 2.120

Trace Start and Trace End Events Setting Example (Disassemble Panel)

(2)	For access-related events [E1][E20]

By setting access-related events for a trace start event and a trace end event, it is possible to start and stop the collection of trace data when a specified access is made to any variable or SFR.

Remark

The types of access that can be set by using methods described here are only a read/write (see “Table 2.5 Types of Accesses to Variables“).
To change the access type to a read or write, after setting trace start and end events, edit their [access type] item (see "2.15.4.2 Edit access-related events").

(a)	To set events for variables or SFR in the Editor panel/Disassemble panel

Perform this operation in the Editor panel/Disassemble panel in which the source text/disassembly text is displayed.

Follow the operation listed below from the context menu, in accordance with your desired event type, after selecting an arbitrary variable or SFR on the source text/disassembled text.

Note, however, that only global variables, static variables inside functions, and file-internal static variables can be used.

Event Type	Operation
Trace start	Select [Trace Settings] >> [Record Start R/W Value], and then press the [Enter] key.
Trace end	Select [Trace Settings] >> [Record End R/W Value], and then press the [Enter] key.

At this time, if you have specified a value in the text box in the context menu, collection of trace data is started or finished only when a read/write is performed with a specified value. On the other hand, if no value is specified, reading/writing the selected variable or SFR by any value will cause the break to occur.

Caution 1.

Variables within the current scope can be specified.

Caution 2.

Variables or SFR at lines that have no valid addresses cannot be used for trace start events and trace end events.

(b)	To set events for registered watch-expressions

Perform this operation in the Watch panel.

Follow the operation listed below from the context menu after selecting the registered watch-expression (multiple selections not allowed).

Note, however, that only global variables, static variables inside functions, file-internal static variables, and SFR can be used.

Event Type	Operation
Trace start	Select [Trace Output] >> [Record Start R/W Value], and then press the [Enter] key.
Trace end	Select [Trace Output] >> [Record End R/W Value], and then press the [Enter] key.

At this time, if you have specified a value in the text box in the context menu, collection of trace data is started or finished only when a read/write is performed with a specified watch-expression. On the other hand, if no value is specified, reading/writing the selected watch-expression by any value will cause the break to occur.

Caution

A watch-expression within the current scope can be specified.
To target a watch-expression outside the current scope, select a watch-expression with a specified scope.

When a trace start event and a trace end event are set, they are managed collectively on the Events panel as one instance of a Trace event (see "2.15 Manage Events"). When you click the "+" mark at a Trace event item, detailed information on the trace start event and the trace end event you have set is displayed.

Figure 2.121

Example of Trace Start and Trace End Events (Execution Type) in Events Panel

Remark 1.

If either one of a trace start event and a trace end event is set as Valid state, the check box of Unconditional Trace event in the Events panel is automatically cleared, therefore, trace data collection does not automatically start with the start of the program execution (the tracer will not run until the condition of the trace start event that has been set is met).

Remark 2.

A trace end event is not indispensable for a Trace event.

Remark 3.

Event marks differ depending on the event state (see "2.15.1 Change the state of set events (valid/invalid)").
When an event is set at the point which other event is already set, the event mark ( ) is displayed meaning more than one event is set at the point.

Remark 4.

[Simulator]
If either one of a trace start event and a trace end event is set to Valid state, the [Use trace function] property in the [Trace] category on the [Debug Tool Settings] tab of the Property panel is automatically set to [Yes] and the trace function will be enabled.