Development Tools

Trace panel

This panel is used to display trace data recording the execution history of the program (see "2.14 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.

Software trace data can be acquired by using the Python console. See debugger.SoftwareTrace functions in "CS+ Python Console" for detail.

Caution 2.

[Full-spec emulator][E1][E20]
When trace data has been collected after selecting [all core] in the [Trace target setting] property in the [trace] category on the [Debug Tool Settings] tab of the Property panel, this panel displays the trace data regarding a core (PE) by switching selection between the target cores (see "2.9 Select a Core (PE)").

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.16

Trace Panel [Full-spec emulator][E1][E20]

Figure A.17

Trace Panel [Simulator]

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)	[Target] area [Simulator]

The name of the target core is displayed.

(3)	[Time (h:min:s,ms,μs,ns)] area

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".

Remark 1.

[Full-spec emulator][E1][E20]
The time is displayed as a differential time.
When the microcontroller is multi-core, the differential time from the time of the previous data that has the same PE number is displayed.

Remark 2.

[Simulator]
The question of whether to set the time display as an accumulated time or differential time depends on the setting of the [Accumulate trace time] property on the [Trace] category on the [Debug Tool Settings] tab of the Property panel.
When the microcontroller is multi-core and the differential time is displayed, the difference from the time of the previous data that has the same PE number is displayed.

(4)	[Time(Clock)] area

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 CPU clock cycles.

Remark 1.

[Full-spec emulator][E1][E20]
The time is displayed as a differential CPU clock cycles.

Remark 2.

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

(5)	[Line Number/Address] area

The line number of a source file or the address of the assemble code 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
Source text	<File name>#<Line number>
Instruction (disassemble results)	<Address>
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

(6)	[Pipeline] area [Simulator]

This area displays the pipeline execution status.

A 20-character string is displayed in this field, and each character represents the stage of the pipeline in one clock cycle. Residues of 20 from the number of clock cycles are used as indices in display of the string representing the corresponding stages of execution.

The meanings of the letters used to represent the stages are as follows.

Stage	Character
Fetch	F
Decode	D
Execute	E

Example 1.

F: 10th clock cycle, D: 11th clock cycle, E: 13th clock cycle
Display: FD_E_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _

Example 2.

F: 18th clock cycle, D: 19th clock cycle, E: 20th clock cycle
Display: E_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _FD

Remark

"_" indicates a space.

(7)	[Source/Disassemble] area

The collected trace data is displayed as follows:

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

Figure A.18

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.

In addition, when the value of a variableNote 1 or an I/O register 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>>>

-	<<<I/O register name = I/O register 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

[Simulator]

The reason why the program has broken down is displayed.

Note 1.

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 4 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, and break causes (default).
Disassemble display mode	Displays the instruction (disassemble results), labels, point trace results, and break causes.
Source display mode	Displays the source text (corresponding source line) 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.14.9 Save the contents of execution history" for details on the method for saving trace data.

(8)	[Factor] area [Full-spec emulator][E1][E20]

This area displays information on the memory access cause.

The display formats are as follows:

Factor	Display Format
PE/Thread	<Debug target information>
DMA	DMA
Bus Master	Bus Master ID<Number>Note
Other than above	(Nothing is displayed)

Note	See User's Manual: Hardware of each device for the number.

(9)	[Area] area [Full-spec emulator][E1][E20]

This area displays information on the target area of memory access.

The display formats are as follows:

Target Area	Display Format
Global RAM	Global RAM
Local RAM	Local RAM<Number>
Cluster RAM	Cluster RAM<Number>
Other than above	(Nothing is displayed)

(10)	[ID] area [Full-spec emulator][E1][E20]

This area displays the ID of memory access.

The display formats are as follows:

ID	Display Format
ID number	ID <Decimal number between 0 and 15>
Other than above	(Nothing is displayed)

(11)	[Address] area

The target address of memory access is displayed.

However, in the event of access to I/O register, the I/O register 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.

(12)	[Data] area

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

(13)	[Other] area

Other sets of information on the virtualization facility, software tracing, and so on are displayed in this area.

Sets of information are delimited by ‘,’.

Information is given in the format <item name> or <item name> = <value>.

Type	Display Format	Display Example
Host mode	Host	Guest,GPID=0,SPID=2 Host,SPID=0
Guest mode	Guest
Partition identifier for guest mode	GPID=<ID>
System protection ID	SPID=<ID>
dbcp	dbcp=<value>	dbcp=0x00100E4
dbpush	dbpush=(<Number>:<Value>)	Example of the display for __dbpush(4,6) dbpush=(4:0x00000000) dbpush=(5:0x00000007) dbpush=(6:0x0001000C)
dbtag	dbtag=<Value>	dbtag=0x3FF

[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.
		Starts the tracer operation. The content currently being displayed in this panel is cleared. This item is disabled while the tracer is running.
		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.
		Links with the Editor panel.
		Links with the Disassemble panel.
		Sets to the Mixed display mode as the display mode (default). This item is disabled while the tracer is running.
		Sets to the Disassemble display mode as the display mode. This item is disabled while the tracer is running.
		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		Starts the tracer operation (see "2.14.5.2 Restart collection of execution history"). The content currently being displayed in this panel is cleared. This item is disabled while the tracer is running.
Stop Trace		Stops the tracer operation (see "2.14.5.1 Stop collection of execution history temporarily"). 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		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		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		Opens the Editor panel and jumps to the source line corresponding to the line at the caret position in this panel.
Jump to Memory		Opens the Memory panel and jumps to the memory value corresponding to the line at the caret position in this panel.