Development Tools

Trace panel

This panel is used to display trace data recording the execution history of the program (see "2.11 Collect Execution History of Programs").

The trace data displays by mixing the disassembled text and source text by default, but it is also possible to display either one of these by selecting the Display mode.

After the execution of the program is stopped, the display position is automatically updated such that the latest trace data is displayed.

This panel appears only when connected to the debug tool.

Caution 1.

[E1][E20][EZ Emulator]
The trace function is supported only when the selected microcontroller incorporates the OCD trace function. For details on the OCD trace function, see "Table 2.11 Operation Specifications of OCD Trace Function".

Caution 2.

[Simulator]
4 bytes of the final address of the code flash area (when a code flash area is 0x0 - 0x1FFFF, 0x1FFFC - 1FFFFF corresponds to it) and the RAM area which can be fetched cannot be fetched (a message of "Stopped by accessing to no map area." will appear).

Remark 1.

When the separator line of each area in this panel is double-clicked, the width of the area changes to the shortest possible size that can display the contents of the area.

Remark 2.

This panel can be zoomed in and out by in the tool bar, or by moving the mouse wheel forward or backward while holding down the [Ctrl] key.

Figure A.15

Trace Panel

This section describes the following.

-	[How to open]

-	[Description of each area]

[Toolbar]

-	[[File] menu (Trace panel-dedicated items)]

-	[[Edit] menu (Trace panel-dedicated items)]

-	[Context menu]

[How to open]

-	From the [View] menu, select [Trace].

-	On the Editor panel/Disassemble panel, select [Trace Settings] >> [Show Trace Result] from the context menu.

[Description of each area]

(1)	[Number] area

The trace number corresponding to the trace frame is displayed.

(2)	[Time (h:min:s,ms,μs,ns)] area [IECUBE][Simulator]

This area displays the time required from the execution start of the program to the execution start of an instruction of each frame or generation of memory access cause.

The time is displayed in units of "hours, minutes, seconds, milliseconds, microseconds and nanoseconds".

If overflow occurs, this area is displayed in invalid color (gray).

Remark 1.

[IECUBE]
The precision of the time depends on the setting of the [Rate of frequency division of trace time tag] property on the [Trace] category on the [Debug Tool Settings] tab of the Property panel.

Remark 2.

[Simulator]
The question of whether to set the time display as an integrated value or differential value depends on the setting of the [Accumulate trace time] property on the [Trace] category on the [Debug Tool Settings] tab of the Property panel.

(3)	[Line/Address] area

The address of the assemble code or the line number of a source file is displayed.

The notation of a data value can be selected by the button on the toolbar or the context menu item.

The display formats are as follows:

Type of Display Line	Display Format
Instruction (disassemble results)	<Address>
Source text	<File name>#<Line number>
Other than above	-

Remark

Since the following execution histories are not displayed, the line numbers displayed are not consecutive numbers.

-	CPU register access

-	Operand access

-	Invalid fetch

(4)	[Source/Disassemble] area

The collected trace data is displayed as follows.

The items displayed in this area differ depending on the selection of the display mode (see "(a) Display mode").

Figure A.16

Display Contents of [Source/Disassemble] Area (Default)

Label

The label is displayed when a label is defined for the address.

Offset value

The offset value from the nearest label is displayed when a label is defined for the address.

Source text

The corresponding source text is displayed when the Mixed display mode or Source display mode is selected.
However, when a place where no debugging information is present is executed, "<No Debug Information>" is displayed.

[IECUBE][Simulator]

When the value of a variableNote 1 or an SFR that is accessed during execution of a source line can be analyzed, that value is displayed in the following format at the end of the source line.

-	<<<Variable name = Variable value>>>

-	<<<SFR name = SFR value>>>

Example: a=b; <<<a=5>>>

The results of the Point Trace are displayed as same as format above.

Instruction (disassemble results)

The corresponding instructions are displayed as the result of disassembling when the Mixed display mode or Disassemble display mode is selectedNote 2.

The mnemonics are shown highlighted.

Break cause

[IECUBE][Simulator]

The reason why the program has broken down is displayed.

Reset cause

[IECUBE]

The reason why CPU reset has occurred is displayed.

Note 1.

[IECUBE][Simulator]
When there is a memory access, a symbol will be interpreted as a variable and displayed only if a symbol is assigned to the accessed address. Note, however, that only variables of up to 2 bytes are supported. If multiplication or other code is processed by the standard libraries, the label of the SADDR area used by the standard library may be shown.

Note 2.

At a frame for which not all the trace data was fetched, "(LOST)" is displayed. In this case, the corresponding line is shown in error color (the error color depends on the configuration in the [General - Font and Color] category of the Option dialog box).

This area is provided with the following functions.

(a)	Display mode

It is possible to select the following three display modes by selection of a button on the toolbar or the context menu.

Display Mode	Displayed Content
Mixed display mode	Displays the instruction (disassemble results), labels, source text (corresponding source line), point trace results, reset causes [IECUBE], and break causes (default).
Disassemble display mode	Displays the instruction (disassemble results), labels, point trace results, reset causes [IECUBE], and break causes.
Source display mode	Displays the source text (corresponding source line) reset causes [IECUBE], and break causes. However, when a place where no debugging information is present is executed, "<No Debug Information>" is displayed.

(b)	Jumping to source line or disassemble

By selecting [Jump to Source] from the context menu, the Editor panel opens with moving the caret to the source line corresponding to the line at the current caret position (if the Editor panel is already open, the screen will jump to the panel).

In addition, similarly by selecting [Jump to Disassemble], the Disassemble panel (Disasemmble1) is opened with moving the caret to the address corresponding to the fetch address of the line at the current caret position (if the Disassemble panel is already open, the screen will jump to the panel (Disassemble1)).

(c)	Linking with other panels

By clicking the / button on the toolbar, or selecting [Window Connecting] >> [Connect Source Window]/[Connect Disassemble Window] from the context menu, it is possible to link and display the corresponding places on the Editor panel/Disassemble panel, with the address of the caret position on this panel used as the pointer (no movement of the focus is done).

(d)	Pop-up display

By hovering the mouse cursor over a line, all the area (item) data corresponding to that line is pop-up displayed in tandem shape.

(e)	Saving trace data

The Data Save dialog box can be opened by selecting the [File] menu >> [Save Trace Data As...], and the contents of this panel can be saved in a text file (*.txt) or CSV file (*.csv).

See "2.11.9 Save the contents of execution history" for details on the method for saving trace data.

(5)	[Address] area [IECUBE][Simulator]

The target address of memory access is displayed.

However, in the event of access to SFR, the SFR name is displayed instead of the address (when a plurality is accessed these are displayed in the following lines).

The radix of a data value can be selected by the button on the toolbar or the context menu item.

(6)	[Data] area [IECUBE][Simulator]

The accessed data value and the access type at that time are displayed.

However, CPU register access is not displayed.

The notation of a data value can be selected by the button on the toolbar or the context menu item.

The display format of the data value and the access type are as follows (character colors and background colors depend on the configuration in the [General - Font and Color] category of the Option dialog box):

Display Example (Default)			Memory Access Type
	Character color	Standard color	Read access
	Background color	Palegreen
	Character color	Standard color	Write access
	Background color	Orange
	Character color	Standard color	Read and write access
	Background color	Paleturquoise
	Character color	Standard color	Vector read access
	Background color	Palegreen

[Toolbar]

		Acquires the latest data from the debug tool, and updates the contents of this panel. This item is disabled while the tracer is running.
		Clears the trace memory and the display of this panel (initialized). This item is disabled while the tracer is running.
[IECUBE][Simulator]		Starts the tracer operation. The content currently being displayed in this panel is cleared. This item is disabled while the tracer is running.
[IECUBE][Simulator]		Stops the tracer operation. The contents of trace data newly acquired are displayed. This item is disabled while the tracer is stopped.
		Opens the Trace Search dialog box.
Notation		The following buttons to change the notation of a data value are displayed. This item is disabled while the tracer is running.
		Displays values on this panel in hexadecimal number (default).
		Displays values on this panel in decimal number.
		Displays values on this panel in octal number.
		Displays values on this panel in binary number.
[IECUBE][Simulator]		Links with the Editor panel.
[IECUBE][Simulator]		Links with the Disassemble panel.
[IECUBE][Simulator]		Sets to the Mixed display mode as the display mode (default). This item is disabled while the tracer is running.
[IECUBE][Simulator]		Sets to the Disassemble display mode as the display mode. This item is disabled while the tracer is running.
[IECUBE][Simulator]		Sets to the Source display mode as the display mode. This item is disabled while the tracer is running.

[[File] menu (Trace panel-dedicated items)]

The following items are exclusive for the [File] menu in the Trace panel (other items are common to all the panels).

Note that all these items are disabled during execution of a program.

Save Trace Data

Overwrites the contents of this panel to the previously saved text file (*.txt)/CSV file (*.csv) (see "(e) Saving trace data").

Note that when the file has never been saved or the file is write disabled, the same operation is applied as the selection in [Save Trace Data As...].

This item is disabled while the tracer is running.

Save Trace Data As...

Opens the Data Save dialog box to newly save the contents of this panel to the specified text file (*.txt)/CSV file (*.csv) (see "(e) Saving trace data").

This item is disabled while the tracer is running.

[[Edit] menu (Trace panel-dedicated items)]

The following items are exclusive for [Edit] menu in the Trace panel (all other items are disabled).

Copy

Copies the contents of the selected line to the clipboard (multiple line selections impossible).

This item is disabled while the tracer is running.

Find...

Opens the Trace Search dialog box.

[Context menu]

Clear Trace		Clears the trace memory and the display of this panel (initialized). This item is disabled while the tracer is running.
Start Trace [IECUBE][Simulator]		Starts the tracer operation. The content currently being displayed in this panel is cleared. This item is disabled while the tracer is running.
Stop Trace [IECUBE][Simulator]		Stops the tracer operation. The contents of trace data newly acquired are displayed. This item is disabled while the tracer is stopped.
Find...		Opens the Trace Search dialog box. This item is disabled while the tracer is running.
Copy		Copies the contents of the selected line to the clipboard (multiple line selections impossible). This item is disabled while the tracer is running.
Mixed Display		Sets to the Mixed display mode as the display mode. This item is disabled while the tracer is running.
Disassemble View		Sets to the Disassemble display mode as the display mode. This item is disabled while the tracer is running.
Source View		Sets to the Source display mode as the display mode. This item is disabled while the tracer is running.
Notation		The following cascade menus are displayed to specify the notation. This item is disabled while the tracer is running.
	Hexadecimal number	Displays values on this panel in hexadecimal number (default).
	Decimal	Displays values on this panel in decimal number.
	Octal	Displays values on this panel in octal number.
	Binary	Displays values on this panel in binary number.
Window Connecting [IECUBE][Simulator]		The following cascade menus are displayed to link with other panels (see "(c) Linking with other panels").
	Connect Source Window	Links with the Editor panel.
	Connect Disassemble Window	Links with the Disassemble panel.
Jump to Disassemble [IECUBE][Simulator]		Opens the Disassemble panel (Disassemble1) and jumps to the fetch address corresponding to the line at the caret position in this panel.
Jump to Source [IECUBE][Simulator]		Opens the Editor panel and jumps to the source line corresponding to the line at the caret position in this panel.
Jump to Memory [IECUBE][Simulator]		Opens the Memory panel and jumps to the memory value corresponding to the line at the caret position in this panel.