Types of analysis information

1.1.2 Types of analysis information

The analysis tool acquires, analyzes, and displays the following two types of information.

(1)	Static analysis information

This is the function information/variable information that can be displayed when a build has completed without any compiler or assembler errors. This is the result of analyzing the load module and cross reference information generated by the build tool.

For this reason, in order to acquire static analysis information, you should configure your build tool to generate cross reference information when performing the build. The analysis tool does, however, provide the following property that forces the build tool to generate cross reference information:

-	Property panel >> [Settings] tab >> [General] category >> [Enable static analysis information] property

By setting this property to [Yes], it is possible to generate cross reference information regardless of the build tool's configuration. Note that if this property is set to [No] (default), the current setting in the build tool will take precedence.

(2)	Dynamic analysis information

This is the function information or variable information provided as a result of analyzing trace data, real-time RAM monitoring, or coverage data acquired by the debug tool.

For this reason, you should enable Trace function, RRM function/RAM monitor (pseudo RRM) function, or Coverage function [IECUBE][E20[RX]][Simulator] to acquire dynamic analysis information. The analysis tool does, however, provides the following property that automatically enables all of the above functions of the debug tool:

-	Property panel >> [Settings] tab >> [General] category >> [Enable dynamic analysis information] property

By setting this property to [Yes], it is possible to use the above debug tool's functions regardless of the debug tool's configuration. Note that if this property is set to [No] (default), the current setting in the debug tool will take precedence.

Cautions 1.

You must connect to the debug tool after the completion of the setting above.
It is necessary to re-connect to the debug tool if you change this setting during debugging.

Cautions 2.

Functions that the debug tool does not support cannot be enabled.
For some debug tools, the following functions are mutually exclusive. In that case, the priority is as follows:
Trace function > RRM function/RAM monitor (pseudo RRM) function > Coverage function

Cautions 3.

The dynamic analysis information cannot be acquired when the program analyzer tool or task analyzer tool provided by "RI series" is used.

The dynamic analysis information that each debug tool's function provides to the analysis tool is as follows:

(a)	Trace function

This function is used to collect an execution history of the program as a trace data.

The trace function provides the following Dynamic analysis information:

-	Execution time (including a proportion of total execution time and average execution time)

-	Execution count (including access type (read count, write count, and so on))

-	Variable values (including maximum values and minimum values)

-	Graph data (when the method for acquiring the graph data is Trace data analysis)

Cautions 1.

[RH850]

-	[Full-spec emulator][E1/E2/E20] The contents of the dynamic analysis information differ depending on the [Trace target setting] property in the [Trace] category on the [Debug Tool Settings] tab of the debug tool's Property panel.

-	When [Debug core only] is selected The debug tool collects trace data regarding PEn currently selected in the Debug Manager panel. Therefore, the analysis tool also displays the dynamic analysis information regarding PEn.

-	When [All core] is selected The debug tool collects trace data in all PEs. Therefore, after collecting trace data, the analysis tool displays the corresponding dynamic analysis information by switching to another PEn in the Debug Manager panel.

-	[Simulator] The debug tool collects trace data regarding PEn currently selected in the Debug Manager panel. Therefore, the analysis tool also displays the dynamic analysis information regarding PEn.

Cautions 2.

[Full-spec emulator][IECUBE][E1/E20/E2[RH850]][Simulator]
Perform the following setting on the debug tool's Property panel to acquire the execution time correctly:

-	[Debug Tool Settings] tab >> [Trace] category >> [Clear trace memory before running] property >> [Yes] (default)

Cautions 3.

[E20[RX]]
If [Start Trace]/[Stop Trace] from the context menu on the Trace panel is selected during execution of a program, then an invalid value will be displayed as the execution time.

Cautions 4.

[E1/E2/E2 Lite/E20[RX]][EZ Emulator[RX]]
The execution time of functions is not displayed when the device does not support the trace time tag feature. The time information displayed in graphs through Trace data analysis will not be correct.

Cautions 5.

[E20[RX]]
In the debug tool's Property panel, when the [Trace data type] property in the [Trace] category on the [Debug Tool Settings] tab is set to [Branch], the acquisition time of the dynamic analysis information by trace data will increase because complement of instructions between branch instructions is performed. If you focus only on variables, we recommend selecting [Data access] in this property.

Cautions 6.

[E1/E2/E2 Lite/E20/COM Port[RL78]][EZ Emulator[RL78]]
Since branch origin addresses can only be acquired from the trace data, only the [Execution Count] item in the Function List panel/Call Graph panel is supported.

(b)	RRM function/RAM monitor (pseudo RRM) function

This function permits you to read the contents of memory (variables/registers/addresses) in real-time while executing the program.

The RRM function/RAM monitor (pseudo RRM) function provides the following Dynamic analysis information:

-	Graph data (when the method for acquiring the graph data is Real-time sampling analysisNote)

Note

[E1/E2/E2 Lite/E20/COM Port[RL78]]
If the selected microcontroller incorporates a Smart Analog IC and the debug tool is in the Data collection mode, graph data is not acquired through real-time sampling analysis. Instead a sampling method specific to Smart Analog is used to acquire data and display graphs.

Caution

[RH850]

-	Variable values and addresses The address and value are determined based on the PC value in PEn currently selected in the Debug Manager panel.

-	Register values The value in PEn currently selected in the Debug Manager panel is acquired.

-	The area that can be read by this function The contents of memory can be read for access in all PEs. In the Local RAM self area, note that they can be read only for the access in PEn currently selected in the Debug Manager panel.

Remark

The target area from which you can read using the RRM function/RAM monitor (pseudo RRM) function varies depending on the microcontroller being selected in the project and the debug tool used.
For details on the relationship between the RRM function/RAM monitor (pseudo RRM) function and their target area, see "CS+ Debug Tool".

(c)	Coverage function [IECUBE][E20[RX]][Simulator]

This function is used to perform coverage measurements.

The coverage function provides the following Dynamic analysis information:

-	Code coverage rates

-	Data coverage rates

Cautions 1.

[E20[RX]]
The code coverage rates are measured only when the selected microcontroller supports the coverage function (a measurement of the data coverage is not supported).

Cautions 2.

[Simulator[RH850]]
The coverage is measured for access in all PEs. In the Local RAM self area, note that the measurement results will be displayed only for the access in PEn currently selected in the Debug Manager panel.