Set a Performance Measurement event

2.14.1.1 Set a Performance Measurement event

To set a Performance Measurement event, set a performance measurement start event and a performance measurement end event that starts/stops a performance measurement.

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

(1)	For execution-related events

The performance of a desired section can be measured by setting execution-related events as performance start and end events.

Perform this operation in the Editor panel/Disassemble panel in which the source text/disassembled 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
Performance measurement start	Select [Performance Measurement Settings] >> [Start Performance Measurement] >> [Set Performance Measurement nNote]
Performance measurement end	Select [Performance Measurement Settings] >> [Stop Performance Measurement] >> [Set Performance Measurement nNote]

Note	Select the channel number (n: 1 to 4) in which a Performance Measurement event is set for each core.

Caution

The performance for a performance measurement end event will not included in the measurement results. For this reason, set a performance measurement end event to one line below the range for which you wish to measure the performance.

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

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

Table 2.16

Event Marks of Performance Measurement Start Event/Performance Measurement End Event

Event Type	Event Mark
Performance Measurement start
Performance Measurement end

Figure 2.132

Performance Measurement Start and Performance Measurement End Events Setting Example (Disassemble Panel)

(2)	For access-related events

By setting access-related events for a performance measurement start event and a performance measurement end event, it is possible to start and stop performance measurement when a specified access is made to any variable or IOR.

(a)	For access to a variable or I/O register on the Editor panel/Disassemble panel

Perform this operation in the Editor panel/Disassemble panel in which the source text/disassembled 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.

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

Event Type	Access Type	Operation
Performance measurement start	Read	Select [Performance Measurement Settings] >> [Set Performance Measurement Start Read Value] >> [Set Performance Measurement n], and then press the [Enter] key.
	Write	Select [Performance Measurement Settings] >> [Set Performance Measurement Start Write Value] >> [Set Performance Measurement n], and then press the [Enter] key.
	Read/Write	Select [Performance Measurement Settings] >> [Set Performance Measurement Start R/W Value] >> [Set Performance Measurement n], and then press the [Enter] key.
Performance measurement end	Read	Select [Performance Measurement Settings] >> [Set Performance Measurement End Read Value] >> [Set Performance Measurement n], and then press the [Enter] key.
	Write	Select [Performance Measurement Settings] >> [Set Performance Measurement End Write Value] >> [Set Performance Measurement n], and then press the [Enter] key.
	Read/Write	Select [Performance Measurement Settings] >> [Set Performance Measurement End R/W Value] >> [Set Performance Measurement n], and then press the [Enter] key.

At this time, if you have specified a value in the text box in the context menu, performance measurement is started or finished only when a read/write is performed with a specified value. If no value is specified, performance measurement is started or finished when a read/write is performed to the selected variable or IOR, regardless of the value.

Caution 1.

Variables within the current scope can be specified.

Caution 2.

Variables or IOR at lines that have no valid addresses cannot be used for performance measurement start events and performance measurement end events.

(b)	For access to a registered watch-expression

Perform this operation in the Watch panel.

Select the watch-expression as the subject to access and perform the following operation from the context menu.

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

Event Type	Access Type	Operation
Performance measurement start	Read	Select [Performance Measurement Settings] >> [Set Performance Measurement Start Read Value] >> [Set Performance Measurement n], and then press the [Enter] key.
	Write	Select [Performance Measurement Settings] >> [Set Performance Measurement Start Write Value] >> [Set Performance Measurement n], and then press the [Enter] key.
	Read/Write	Select [Performance Measurement Settings] >> [Set Performance Measurement Start R/W Value] >> [Set Performance Measurement n], and then press the [Enter] key.
Performance measurement end	Read	Select [Performance Measurement Settings] >> [Set Performance Measurement End Read Value] >> [Set Performance Measurement n], and then press the [Enter] key.
	Write	Select [Performance Measurement Settings] >> [Set Performance Measurement End Write Value] >> [Set Performance Measurement n], and then press the [Enter] key.
	Read/Write	Select [Performance Measurement Settings] >> [Set Performance Measurement End R/W Value] >> [Set Performance Measurement n], and then press the [Enter] key.

At this time, if you have specified a value in the text box in the context menu, performance measurement is started or finished only when a read/write is performed with a specified watch-expression. If no value is specified, performance measurement is started or finished when a read/write is performed to the selected variable or IOR, regardless of the value.

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 performance measurement start event and a performance measurement end event are set, they are managed collectively on the Events panel as one instance of a Performance Measurement event (see "2.17 Manage Events"). When you click the "+" mark at a Performance Measurement event item, detailed information on the performance measurement start event and the performance measurement end event you have set is displayed.

Figure 2.133

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

Remark

Event marks differ depending on the event state (see "2.17.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.

Caution

Performance measurement can be performed with even only one setting: a performance measurement start event or a performance measurement end event. When only a performance measurement start event is set, performance measurement is terminated when program execution stops. When only a performance measurement end event is set, performance measurement is started when program execution starts.