Variable List panel


This panel is used to display the acquired variable information.

The following types of variable are displayed in this panel.

-

Global variable

-

Static variable inside a file

-

Static variable inside a function

-

Class variable (only when C++ source files are subject to analysis)

 

Note, however, that the variable information in the files not to be analyzed is not displayed in this panel (see "1.1.1 What is analyzed").

See "2.1 Overview" for details on how to display the variable information.

Cautions 1.

[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 2.

[CC-RX]

When C++ source files are subject to analysis, also see "3.6 When CC-RX (C++ Source Files) Is Used".

Cautions 3.

[CC-RX]

Unused variables deleted via compiler optimization are not displayed.

Remarks 1.

You can set filters for displaying variable information on this panel (see "2.6.5 Filter the analysis information").

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

Remarks 3.

[RH850]

See "(a) Trace function" for details on the relationship between the Dynamic analysis information in this panel and PEn currently being selected in the Debug Manager panel.

Figure A.8

Variable List Panel

 

The following items are explained here.

[How to open]

-

On the toolbar in the Main window, click the button.

-

From the [View] menu, select [Program Analyzer] >> [Variable List].

[Description of each area]

(1)

Header area

(a)

Column name

The name of the item of the acquired variable information is displayed.

Marks (icons) that are displayed at the name of the item indicate as follows:

Mark (Icon)

Meaning

/

Indicates whether there is a sort order setting (see "2.6.4 Sort the analysis information").

/

Indicates whether there is a filter display setting (see "2.6.5 Filter the analysis information").

/

Indicates whether display is locked (see "2.6.3 Lock the specific column to display").

 

Indicates that a message relating to information about this item has been output to the Output panel. Hover the mouse over it to display a pop-up with the last message to be output.

Remark

Columns to display can be customized via mouse operations in this area.
- Set the columns to display
- Change the order of the columns to display
- Lock the specific column to display


(b)

Button

 

Opens the Column Chooser dialog box in order to sort and show/hide the items (columns) displayed in the panel, and return customized settings to the defaults (see "2.6 Customize Display Method").

(2)

Information area

This area displays the acquired variable information.

The analysis tool acquires two types of function information: Static analysis information and Dynamic analysis information. The timing when each type of information can be displays differs (see "1.1.2 Types of analysis information").

When the active project is changed while displaying the variable information, the variable information of the target project is displayed. Note, however, that if the cross reference information has not been generated in the project or the analysis tool is not supported by the project, nothing is displayed on this panel.

The value of the information that has been changed because of the execution of a program is shown highlighted (the color depends on the configuration in the [General - Font and Color] category of the Option dialog box). To reset the highlighting, click the button on the toolbar.

The items and details acquired as variable information are as follows:

Item

Type

Contents

Variable Name

Static analysis

Displays the name of the global variable, the static variable inside a file, the static variable inside a function or the class variable (static member variable of a class type) that is defined/referenced in the C/C++ source file.

Up to 1024 characters can be displayed.

The meanings of icons displayed are as follows:

-

: Variable

-

: Member variable [CC-RX]

[CC-RX]

If an anonymous union is used, then this will display "<unnamed_N>" as the variable name (N: A number from 1 automatically provided in appearance order).

Class Name

[CC-RX]

Static analysis

Displays the name of the class to which the variable belongs.

If it is a template class, then the number of template arguments are also displayed in the format of "class name<T: the number of template arguments>".

Note, however, that if the variable is not a member variable, or if analysis was not completed, then this will be blank.

Namespace

[CC-RX]

Static analysis

Displays the name of the namespace to which the variable belongs.

If the namespace is nested, then it is displayed in the format of "namespace name::namespace name". If it is an anonymous namespace, then "<unnamed>"is displayed.

Note, however, that if analysis was not completed, then this will be blank.

File Name

Static analysis

Displays the file name (without path) of the C/C++ source file where the variable is definedNote 1.

Note, however, that if it is not defined in a C/C++ source file in project, or if analysis was not completed, then this will display "(No Definition)".

If it is defined in a header file, then the name of the header file is displayed.

Function NameNote 1

Static analysis

Displays the name of the function where the variable is defined.

Note, however, this will be blank for other than a static variable inside a function.

[CC-RX]

In addition to the above, the argument types of the function are also displayed in parentheses "( )". If the function is a const member function/volatile member function, then "const"/"volatile" is displayed immediately after the function name.

File PathNote 1

Static analysis

Displays the absolute path of the C/C++ source file where the variable is defined.

Note, however, that if it is not defined in a C/C++ source file in project, or if analysis was not completed, then this will be blank.

If it is defined in a header file, then the absolute path of the header file is displayed.

PM Information [RH850]

 

Static analysis

Displays the following information about PE from which the variable can be accessed.

-

From PEn: PMn

-

From common PE: Common

-

Unknown: -

Note that this item appears only when the selected microcontroller version supports multi-core.

ImportNote 1

Static analysis

Displays the following information about the source of the variable information.

-

If it was acquired from inside an active project
"Original" is displayed.

-

If it was acquired from an import file
The names of all import files are displayed.

-

If it was acquired from inside an active project and an import file
"Original" and the names of all import files are displayed.

See "2.12 Import or Export Information File" for details on the import function.

Access Specifier

[CC-RX]

Static analysis

Displays the access specifier being declared to the member variable.

Note, however, that this will display "-" if analysis is not complete.

The following access specifiers can be displayed.

public, private, protected

Attribute

Static analysis

Displays the variable's symbol attributes/symbol-modifier attributes.

If there are multiple attributes, then they are displayed separated by commas (",").

Note, however, that this will display "-" if analysis is not complete.

The following attributes can be displayed.

-

[CC-RH]

static, ior, const, volatile

-

[CC-RX]

static, const, volatile, restrict

-

[CC-RL]

static, const, volatile, near, far, saddr

Type

Static analysis

Displays the type of the variableNote 2.

If including an alternative name by using "#define statement" or "typedef statement", then not the alternative name but the type is displayed.

Note, however, that this will display "-" if analysis is not complete.

There is no limit to display the number of pointers (up to 4 dimensions for an array can be displayed).

Members

Static analysis

Displays the members of the structure/union.

If there are multiple members, then they are displayed separated by commas (",").

Note, however, that this will display "-" if other than structures/unions or analysis is not complete.

Address

Static analysis

Displays the variable's allocated address in hexadecimal number notation.

The number of digits to display is equivalent to the maximum address value of the selected microcontroller.

Note, however, that this will display "-" if analysis is not complete.

Size[Bytes]

Static analysis

Displays the variable's size in decimal number notation.

Note, however, that this will display "-" for bit variables or the like that cannot be displayed in bytes, or if analysis is not complete.

[CC-RX(V1.xx.xx)]

Variables that are defined only and not referenced will be eliminated by compiler optimization. For this reason, this will display "0" for such variables.

Reference Count

Static analysis

Displays the number of times the variable is referenced in the program, in decimal number notation.

The location where the variable is defined is also counted. The totals for structures, unions, and arrays are displayed at the variable level (references to individual members and array elements are not shown).

In the definition of variables, a line with an assignment statement (e.g. "int variable = 10") is counted.

"variable++;" is interpreted as "variable = variable + 1". Therefore, this variable is counted twice.

Code in C/C++ source files that is referenced but is eliminated by the preprocessor during compilation (e.g. via "#if" or "#ifdef" statements) is not included in the number of references (it is also not output by the search results from [Find All References] in the context menu).

Note, however, that this will display "-" if analysis is not complete.

Read Count

[Full-spec emulator]
[IECUBE]
[E1/E2/E20[RH850]]
[E1/E2 Lite/E20[RX]]
[Simulator]



Dynamic analysis

Displays the number of times the variable was read, in decimal number notationNote 3, 4.

For structures and unions, reads are counted at the structure/union variable level (the number of reads at the individual member and element levels are not shown).

Note, however, that this will display "-" if the debug tool's Trace function is disabled, or if analysis is not complete.

Write Count

[Full-spec emulator]
[IECUBE]
[E1/E2/E20[RH850]]
[E1/E2 Lite/E20[RX]]
[Simulator]



Dynamic analysis

Displays the number of times the variable was written, in decimal number notationNote 3, 4.

For structures and unions, writes are counted at the structure/union variable level (the number of writes at the individual member and element levels are not shown).

Note, however, that this will display "-" if the debug tool's Trace function is disabled, or if analysis is not complete.

Read/Write CountNote 1

[Full-spec emulator]
[IECUBE]
[E1/E2/E20[RH850]]
[E1/E2 Lite/E20[RX]]
[Simulator]



Dynamic analysis

Displays the number of times the variable was read/written, in decimal number notationNote 3, 4.

For structures and unions, reads/writes are counted at the structure/union variable level (the number of reads/writes at the individual member and element levels are not shown).

It may not be possible to analyze reads/writes of variables in segments where variables have been assigned to registers via compiler optimization. For this reason, reads/writes in such sections will not be counted.

Note, however, that this will display "-" if the debug tool's Trace function is disabled, or if analysis is not complete.

Minimum Value

[Full-spec emulator]
[IECUBE]
[E1/E2/E20[RH850]]
[E1/E2 Lite/E20[RX]]
[Simulator]



Dynamic analysis

Displays the minimum measurement time from the results of program execution, in decimal number notationNote 3.

Only a variable less than or equal to 4 bytes can be displayed.

Note, however, that this will display "-" if for bit type variables/boolean type variables/Bool type variables/structures/unions/arrays/pointer, if the debug tool's Trace function is disabled, or if analysis is not complete.

Maximum Value

[Full-spec emulator]
[IECUBE]
[E1/E2/E20[RH850]]
[E1/E2 Lite/E20[RX]]
[Simulator]



Dynamic analysis

Displays the maximum measurement time from the results of program execution, in decimal number notationNote 3.

Only a variable less than or equal to 4 bytes can be displayed.

Note, however, that this will display "-" if for bit type variables/boolean type variables/Bool type variables/structures/unions/arrays/pointer, if the debug tool's Trace function is disabled, or if analysis is not complete.

Data Coverage[%]

[IECUBE[RL78]]
[Simulator]

Dynamic analysis

Displays the data coverage rates of the variable ("number of bytes accessed in the address range" / "variable size" x 100) (see "3.2 Coverage Results").

The level of shading of the cell's background color indicates the data coverage.

Note, however, that this will display "-" if the debug tool's Coverage function [IECUBE][E20[RX]][Simulator] is disabled, or if analysis is not complete.

Notes 1.

This item does not appear by default.
See "2.6.1 Set the columns to display" for details on how to display this item.

Notes 2.

If including an alternative name by using "#define" or "typedef", then not the alternative name but the original type is displayed.

Notes 3.

Set the [Accumulate result of analysis] property in the [General] category on the [Settings] tab of the Property panel to [Yes] to display the cumulative value for each program execution.

Notes 4.

The calculation is based on the acquired trace data. So for example, if one write to a 4-byte area was output in the trace data as the upper 2 bytes and the lower 2 bytes, then two times will be displayed.

 

In the bottom of the [Variable Name] item, the following information for each file is shown as [*Total*].

Note that "(No Definition)" displayed in the [File Name] item is treated as one file.

Figure A.9

[*Total*] Display (Variable List Panel)

Item

Contents

File Name

The target file name

File PassNote

File pass of the target file

Size[Bytes]

Total of the variable's size in the target file

Reference Count

Total number of times variables are referenced in the target file

Read Count

Total number of times variables were read in the target file

Write Count

Total number of times variables were written in the target file

Read/Write Count

Total number of times variables were read/written in the target file

Data Coverage[%]

The data coverage rates of variables in the target file

Note

This item does not appear by default.
See "2.6.1 Set the columns to display" for details on how to display this item.

Cautions 1.

Items of the Dynamic analysis information do not appear while disconnecting from the debug tool (default).

Cautions 2.

The [Read Count]/[Write Count]/[Read/Write Count]/[Data Coverage[%]] item for a bit type variable/boolean type variable/_Bool type variable/bit field structure is measured by counting the number of accesses to the address that the variable is being allocated.
Consequently, if bit type variables/boolean type variables/_Bool type variables/bit field structures are allocated to the same address, these items above will display the same value.

Remarks 1.

If static variables inside a function with the same name are declared in a function, they are handled as follows:

-

[Members]/[Address]/[Size[Bytes]]/[Read Count]/[Write Count]/[Read/Write Count]/[Minimum Value]/[Maximum Value]/[Data Coverage[%]]
The information of the variable that is first declared in a function is displayed.

-

Items other than listed above
The information of the variable that is first declared in a function is displayed.

Remarks 2.

If you define a static variable in a header file, and include it from more than one source file, information for the header file and all source files is displayed on one line.

Remarks 3.

The display of each type of information can be customized as follows:
- Sort the analysis information
- Filter the analysis information

Remarks 4.

The current row mark ( ) on the left edge of this area indicates that the column in question is the current row.
The following operations can be performed on the current row:
- Jump to Defined Location
- Register Watch-Expressions
- Display List of Referencing Location
- Graph transitions in values




[Toolbar]

The toolbar provides the following items and functions.

 

Acquires the latest data from the debug tool, and updates the contents of this panel.

 

Displays the latest information automatically by acquiring the information each time program execution stops.

Note that this item is disabled when the [Refresh at program stop] property in the [General] category on the [Settings] tab of the Property panel is set to other than [Specify Individually] (this button is locked in accordance with the setting on the Property panel).

 

Resets highlighting of values that have been changed by executing a program.

Note that this item is disabled during execution of a program.

 

Displays only the information for variables in a file(s)/category(s) currently selected in the Project Tree panel (see "(a) Linking with the Project Tree panel").

 

Displays only the information for variables starting with the word at the caret position in the Editor panel (see "(b) Linking with the Editor panel").

 

[RH850]

Displays only the information for variables in the common region and PEn currently selected in the Debug Manager panel (see "(c) Linking with the Debug Manager panel [RH850]").

Note that this item is disabled when the selected microcontroller version does not support multi-core. or while disconnecting from the debug tool.

[[File] menu (Variable List panel-dedicated items)]

The [File] menu for this panel provides the following items and functions.

Save Variable List Data

Overwrites the contents of this panel to the previously saved file (see "2.14 Save Analysis Information").

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 Variable List Data As...].

Save Variable List Data As...

Opens the Save As dialog box to newly save the contents of this panel to the specified text file (see "2.14 Save Analysis Information").

Print...

Opens the Windows dialog box to print the contents currently being displayed in this panel.

[[Edit] menu (Variable List panel-dedicated items)]

The [Edit] menu for this panel provides the following items and functions.

Copy

Copies the contents of the selected column (multiple selections possible) to the clipboard as character strings separated by tabs.

Note that the contents of the clipboard cannot be pasted to this panel.

Select All

Selects all the columns being displayed in this panel.

[Context menu]

The context menu displayed by right-clicking on this panel provides the following items and functions.

Find All References

Displays a list of the locations referencing the variable(s) of the selected row(s), in the Output panel's [Find References] tab (see "2.11 Display List of Referencing Location").

Register to Analysis Chart

Registers the variable(s) of the selected row(s) to the Analysis Chart panel (see "2.13.1 Graph transitions in values").

Note that this item is disabled while disconnecting from the debug tool.

Access Break

The following cascade menus are displayed to set a break eventNote with access condition (see "2.9.2 Set a break event to a variable").

Note that this item is disabled while disconnecting from the debug tool.

 

Set Variable Read Break to

Sets a break event with read access condition to the variable of the current row.

Set Variable Write Break to

Sets a break event with write access condition to the variable of the current row.

Set Variable R/W Break to

Sets a break event with read/write access condition to the variable of the current row.

Register to Watch1

Registers the variable(s) of the selected row(s) to the Watch panel (Watch1) as watch-expression(s) (see "2.10 Register Watch-Expressions").

Note that this item is disabled while disconnecting from the debug tool.

Jump to Source

Opens the Editor panel and displays the source file in which the variable of the current row is defined (see "2.7 Jump to Defined Location").

Jump to Memory

Opens the Memory panel (Memory1) and displays the memory list from the start address of the variable of the current row (see "2.7 Jump to Defined Location").

Note that this item is disabled while disconnecting from the debug tool.

Copy

Copies the contents of the selected row(s) to the clipboard as character strings separated by tabs.

Note that the contents of the clipboard cannot be pasted to this panel.

Note

[RX]

For combination break events, this item is valid only when the combination condition is "OR".