Everything

[Variable Value Changing] tab


The [Variable Value Changing] tab is used to display the detailed information on graphs displayed in the [Variable Value Changing Chart] tab of the Analysis Chart panel categorized by the following and the configuration can be changed.

 

(1)[General]

(2)[Trigger]

(3)[Smart Analog] [E1/E2/E2 Lite/E20/COM Port[RL78]]

(4)[Channel 1 - 32]

[Description of each category]

(1)

[General]

The general information on graphs is displayed and its configuration can be changed.

Analysis method

Select the method for acquiring the graph data (see “(2)Specify the method for acquiring the graph data“).

Default

Real-time sampling

Modifying

Select from the drop-down list.

Note that changes cannot be made during execution of a program.

Available values

Real-time sampling

Displays graphs based on the data acquired via the RRM function/RAM monitor (pseudo RRM) function of the debug tool.

Note, however, that if the debug tool is set in the Data collection modeNote 1, then the data will be collected using a sampling method for Smart Analog.

Analysis of trace data

Displays graphs based on the trace data acquired via the Trace function of the debug tool.

This does not appear when any one of the following:

-

The debug tool does not support the trace function.

-

The debug tool does not support the trace time tag feature.

-

The debug tool is set in the Data collection modeNote 1.

Load from file

Displays graphs by loading the analysis chart data file (*.mtac) that has been saved.

Analysis chart data file

Specify the analysis chart data file (*.mtac) to restore graphs.

The following placeholders are supported:

%ProjectName% : Replaces itself with the project name.

%MicomToolPath% : Replaces itself with the absolute path of the CS+ install folder.

The reference point of the relative path is the project folder.

This property appears only when the [Analysis method] property is set to [Load from file].

Default

Blank

Modifying

Specify with the Open File dialog box.

The Open File dialog box is opened by clicking the [...] button that appears at right edge in the column when this property is selected (no files can be specified on the Property panel).

Available values

One file (*.mtac)

Start/stop real-time sampling

Select whether the start/stop of the real-time sampling synchronizes to the start/stop of a program execution.

This property appears only when the [Analysis method] property is set to [Real-time sampling].

Default

Sync

Modifying

Select from the drop-down list.

Available values

Sync

Synchronizes to the start/stop of a program execution.

Manual

Does not synchronize to the start/stop of a program execution. It can be controlled via the [Sampling] button on the [Variable Value Changing Chart] tab.

Auto adjustment

Select whether to calculate the optimum values from the obtained graph data and specify them in the [Time per grid[Time/Div]] property and [Value per grid[Val/Div] 1 - 32]/[Offset 1 - 32] properties for the X and Y axes of the graph (see "(c)Setting the display range").

[E1/E2/E2 Lite/E20/COM Port[RL78]]

This property does not appear when the debug tool is set in the Data collection modeNote 1.

Default

Only during program stop

Note that [None] is fixed to this property if the [Analysis method] property is set to [Load from file] or the [Use trigger function] property is set to [Yes].

Modifying

Select from the drop-down list.

Available values

Always

Always adjusts the graph display automatically.

Only during program stop

Automatically adjusts the graph display only when program execution stops.

None

Does not adjust the graph display automatically.

Number of transition location for auto adjustment

Specify the number of value transition points to be displayed in the rendering area when the graph display is automatically adjusted.

This property does not appear when the [Auto adjustment] property is set to [None].

Default

20

Modifying

Directly enter from the keyboard.

Available values

The value in decimal number within the following range.

-

1 to 1000

Time per grid[Time/Div]

Specify the time for each of the 10 units (grid segments) that the grid area is divided into.

This property is enabled only when the [Auto adjustment] property is set to [None].

Default

1ms

Note that the value loaded from the file is set to this property if [Load from file] is specified with the [Analysis method] property.

Modifying

Directly enter from the keyboard.

Available values

Any one of the following (1ns to 10s: in decimal number)Note 2.

-

1 to 10s

-

1 to 10000ms

-

1 to 10000000μs

-

1 to 10000000000ns

Chart type

Select the chart type (i.e. the format of lines between transition points).

Default

Depends on the specification of the [Analysis method] property.

-

When [Real-time sampling] is specified
Line chart

-

When [Analysis of trace data] is specified
Step line chart (fixed)

Modifying

Depends on the specification of the [Analysis method] property.

-

When [Real-time sampling] is specified
Select from the drop-down list.

-

When [Analysis of trace data] is specified
Changes not allowed

Available values

Line chart

Displays the graph in a normal line chart.

Step line chart

Displays the graph in a step-plot line chart.

Specify foreground color and background color

Select whether to select the foreground color and background color of the graph.

Default

No

Modifying

Select from the drop-down list.

Available values

Yes

Selects the foreground color and background color of the graph.

No

Does not select the foreground color and background color of the graph (i.e. uses the setting of background color for the [Default] item in the Option dialog box).

Background color

Specify the background colorNote 3 of the graph.

This property appears only when the [Specify foreground color and background color] property is set to [Yes].

Default

The setting of background color for the [Default] item in the Option dialog box.

Modifying

Specify with the color selection combo box or directly enter from the keyboard.

Available values

When directly enter from the keyboard

The value in decimal number/hexadecimal number (prefix "0x" is needed) or the color name (see "About the specification of the color").

Background color(Lost section)

Specify the background colorNote 3 of the graph in a lost section (see "(a)Graph").

This property appears only when the [Specify foreground color and background color] property is set to [Yes].

Default

The setting of background color for the [Lost] item in the Option dialog box.

Modifying

Specify with the color selection combo box or directly enter from the keyboard.

Available values

When directly enter from the keyboard:

The value in decimal number/hexadecimal number (prefix "0x" is needed) or the color name (see "About the specification of the color").

Foreground color

Specify the foreground colorNote 3 of the graph.

This property appears only when the [Specify foreground color and background color] property is set to [Yes].

Default

The setting of font color for the [Default] item in the Option dialog box.

Modifying

Specify with the color selection combo box or directly enter from the keyboard.

Available values

When directly enter from the keyboard:

The value in decimal number/hexadecimal number (prefix "0x" is needed) or the color name (see "About the specification of the color").

Cursor-A -B color

Specify the color of the Cursor-A and Cursor-B.

Default

Cursor-A: PaleGreen

Cursor-B: PaleTurquoise

Modifying

Specify with the color selection combo box or directly enter from the keyboard.

Available values

When directly enter from the keyboard:

The value in decimal number/hexadecimal number (prefix "0x" is needed) or the color name (see "About the specification of the color").

Zoom-1 - 4 color

Specify the color of the Zoom-1 to the Zoom-4.

Default

Zoom-1: 64, 255,10,79

Zoom-2: 64, 91, 228, 22

Zoom-3: 64, 5, 109, 239

Zoom-4: 64, 255, 84, 28

Modifying

Specify with the color selection combo box or directly enter from the keyboard.

Available values

When directly enter from the keyboard:

The value in decimal number/hexadecimal number (prefix "0x" is needed) or the color name (see "About the specification of the color").

Notes 1.

[E1/E2/E2 Lite/E20/COM Port[RL78]]
This feature is supported only when the selected microcontroller incorporates Smart Analog IC.

Notes 2.

If the unit (case insensitive) is omitted, when [Real-time sampling] is selected in the [Analysis method] property, it will be handled as "ms". In other cases, it will be handled as "ns".
When this property is changed, if the value of the [Trigger position] property is greater than "the value of this property x 10", then "the value of this property x 10" is automatically specified to the [Trigger position] property.

Notes 3.

The color specified in this property will also be reflected to the foreground color/background color of the Variable Value Changing Chart (zoomed in) panel.

(2)

[Trigger]

The information on the trigger function is displayed and its configuration can be changed (see "(3)Use the trigger function").

Use trigger function

Select whether to display the graphs by using the trigger function.

Default

No

Modifying

Depends on the specification of the [Analysis method] property.

-

When [Real-time sampling] is specified
Select from the drop-down list.

-

When [Analysis of trace data] or [Load from file] is specified
Changes not allowed

Note that changes cannot be made during execution of a program.

Available values

Yes

Uses the trigger function.

No

Does not use the trigger function.

Trigger mode

Select the trigger mode (the timing at which graphs are updated).

This property appears only when the [Use trigger function] property is set to [Yes].

Default

Auto

Modifying

Select from the drop-down list.

Note that changes cannot be made during execution of a program.

Available values

Auto

Re-renders the graph cyclically. Also clears and re-renders the graph upon receipt of a trigger signal.

Single

Only renders the graph upon the first trigger signal from the start of sampling.

Normal

Only re-renders the graph upon receipt of a trigger signal.

Trigger source

Select the variable (channel) that is the source of a trigger signal.

This property appears only when the [Use trigger function] property is set to [Yes].

Default

ch1

Modifying

Select from the drop-down list.

Note that changes cannot be made during execution of a program.

Available values

Any one of the channels (ch1 to ch32)

Trigger level

Select the trigger level (i.e. the threshold value for determining as a trigger signal).

This property appears only when the [Use trigger function] property is set to [Yes].

Default

0

Modifying

Select from the drop-down list.

Note that changes cannot be made during execution of a program.

Available values

The value in decimal number/hexadecimal number within the following range.

The minimum value of the trigger variable (Trigger source)“ to “The maximum value of the trigger variable (Trigger source)“

Values in floating point notation can also be specified.

Direction of trigger edge

Select the direction of the trigger edge.

This property appears only when the [Use trigger function] property is set to [Yes].

Default

Rising

Modifying

Select from the drop-down list.

Note that changes cannot be made during execution of a program.

Available values

Rising

Generates a trigger signal when the value of Trigger source changes from less than Trigger level to greater than or equal to Trigger level.

Falling

Generates a trigger signal when the value of Trigger source changes from greater than Trigger level to less than or equal to Trigger level.

Both

Generates a trigger signal when both “Rising“ and “Falling“.

Trigger position

Specify the trigger position (i.e. the horizontal position that indicates the location at which a trigger signal has been generated).

This property appears only when the [Use trigger function] property is set to [Yes].

Default

0s

Modifying

Directly enter from the keyboard.

Note that changes cannot be made during execution of a program.

Available values

The value in decimal number within the following rangeNote.

-

0 to "(the value of the [Time per grid[Time/Div]] property) x 10"

Trigger mark color

Specify the color of the trigger marks that indicate trigger level and the trigger position.

This property appears only when the [Use trigger function] property is set to [Yes].

Default

Color Orange

Modifying

Specify with the color selection combo box or directly enter from the keyboard.

Note that changes cannot be made during execution of a program.

Available values

When directly enter from the keyboard:

The value in decimal number/hexadecimal number (prefix "0x" is needed) or the color name (see "About the specification of the color").

Note

If the unit (s, ms, us/μs, ns: case insensitive) is omitted, it will be handled as "ms".
If the specified value is greater than "the value of [Time per grid[Time/Div]] x 10", then "the value of [Time per grid[Time/Div]] x 10" is automatically specified to this property.

(3)

[Smart Analog] [E1/E2/E2 Lite/E20/COM Port[RL78]]

The information on the Smart Analog function is displayed and its configuration can be changed.

Caution

This category appears only when the selected microcontroller incorporates Smart Analog IC and the debug tool is set to the Data collection mode.

Sampling interval[ms]

Specify the sampling interval in ms unit to collect the data by using Smart Analog function.

Before the debug tool starts acquiring data in the Data collection mode, the value of the symbol (r_dbg_graph.c#static_e1_waveout_rate) is replaced with the value specified for this property.

Default

10

Modifying

Directly enter from the keyboard.

Note that changes cannot be made during execution of a program.

Available values

0 to 1000 in decimal number

Data collection channel

Select channels to collect the data.

Before the debug tool starts acquiring data in the Data collection mode, the value of the symbol (r_dbg_graph.c#static_e1_waveout_flag) is replaced with the value specified for this property.

Default

All check boxes are not selected

Modifying

Select check boxes from the drop-down list.

Note that changes cannot be made during execution of a program.

Available values

ch1 to ch8 (multiple selections possible)

(4)

[Channel 1 - 32]

The information on the graphing target that is registered in each channel is displayed and its configuration can be changed (see "(1)Register graphing targets").

For how to integrate the settings for channels into a pattern and switch the pattern from among multiple patterns, refer to Remarks 2. of this section.

Caution

If [Load from file] has been specified with the [Analysis method] property, then the values loaded from the file are reflected to the properties in this category and these values cannot be changed.

Variable/Address 1 - 32

Specify the name of a variable or an address expression that is registered as a graphing target (see “(1)Register graphing targets“).

Note that the values of all properties in this category will be changed to the default value if the value of this property is changed.

[E1/E2/E2 Lite/E20/COM Port[RL78]]

When the debug tool is in the Data collection mode, character strings specified in this property are only displayed as a label for the Variable name check box (they are not handled as a graphing target).

Default

Blank

Modifying

Directly enter from the keyboard.

Note that changes cannot be made during execution of a program.

Available values

Up to 2046 charactersNote 1

Type/Size 1 - 32

Select the type and size of the variable/address to register.

[E1/E2/E2 Lite/E20/COM Port[RL78]]

This property does not appear when the debug tool is in the Data collection mode.

Default

Auto

Modifying

Select from the drop-down list.

Note that changes cannot be made during execution of a program.

Available values

Any one of the following:

-

AutoNote 2

-

signed 1byte(8bits)

-

signed 2bytes(16bits)

-

signed 4bytes(32bits)

-

unsigned 1byte(8bits)

-

unsigned 2bytes(16bits)

-

unsigned 4bytes(32bits)

Value per grid[Val/Div] 1 - 32

Select the value for each of the 10 units (grid segments) that the grid area is divided into.

This property is enabled only when the [Auto adjustment] property is set to [None].

Default

(“The maximum value of the variable" - “The minimum value of the variable") / 10

Note that the value loaded from the file is set to this property if [Load from file] is specified with the [Analysis method] property.

[E1/E2/E2 Lite/E20/COM Port[RL78]]

When the debug tool is in the Data collection mode: 409.5

Modifying

Select from the drop-down list.

Note that changes cannot be made during execution of a program.

Available values

The value in decimal number/hexadecimal number within the following range:

The minimum positive value of the variable“ to
(“The maximum value of the variable“ - “The minimum value of the variable“)

Values in floating point notation can also be specified.

Offset 1 - 32

Specify the offset of the graph.

The graph of the variable value to which this offset value is added is rendered.

This property is enabled only when the [Auto adjustment] property is set to [None].

Default

0

[E1/E2/E2 Lite/E20/COM Port[RL78]]

When the debug tool is in the Data collection mode: -2048

Modifying

Directly enter from the keyboard.

Available values

The value in decimal number within the following range:

The minimum value of the float type (Approx. -3.4028235e+38)“ to
The maximum value of the float type (Approx. 3.4028235e+38)“

Values with decimals can also be specified.

Color 1 - 32

Specify the rendering color of the graph.

Default

Depends on the number (1 - 32)Note 3

Modifying

Specify with the color selection combo box or directly enter from the keyboard.

Available values

When directly enter from the keyboard:

The value in decimal number/hexadecimal number (prefix "0x" is needed) or the color name (see "About the specification of the color").

Notes 1.

The input format is as follows (same as the input format of the Watch panel).
Note the following, however, when registering items.

-

If the variable name of a structure, union, or array is registered, it cannot be graphed. For structures, unions, and arrays, the member name or element must be specified.

-

Immediate addresses are registered with a size of 1 byte.

Input Format

Value to be Acquired

Variable name of C language

Value of C language variable

Variable-expression[Variable-expression]

Element of array

Variable-expression.Member name

Member of structures/unions

Variable-expression->Member name

Member of structures/unions that pointer designates

*Variable-expression

Value of pointer variable

CPU register name

Value of the CPU register

I/O register name [RH850][RX]

I/O register value

SFR register name [RL78]

SFR register value

Label, EQU symbol and immediate address

Values of label, EQU symbol and immediate address

Bit symbol

Bit symbol value

Notes 2.

A judgment is automatically made in order of address expression, register name, IOR/SFR name, variable name by the debug tool. If a address expression is determined, it will be handled as "signed 1byte(8bits)".

Notes 3.

The relationship between channel numbers and colors is as follows:

Number

Color

αRGB value in 32 bits

Number

Color

αRGB value in 32 bits

1

Red

0xC0FF0A4F

17

Light red

0xC0FF6666

2

Green

0xC05BE416

18

Light yellow

0xC0FFCC66

3

Blue

0xC0056DFF

19

Light green

0xC066CC66

4

Orange

0xC0FF541C

20

Light navy blue

0xC06666FF

5

Lightblue

0xC04FC1FF

21

Light violet

0xC0CC66FF

6

Purple

0xC0A932FF

22

Pure orange

0xC0FF9900

7

Yellow

0xC0FFD91C

23

Pure green

0xC000AA00

8

Redviolet

0xC0FF30A5

24

Pure blue

0xC00000FF

9

Yellowgreen

0xC0BEE02F

25

Pure magenta

0xC0CC00FF

10

Blueviolet

0xC05510FF

26

Deep red

0xC0FF0000

11

Pink

0xC0FF97E4

27

Deep green

0xC0006600

12

Brown

0xC0913A37

28

Deep blue

0xC02222CC

13

Ocher

0xC0C68E15

29

Deep purple

0xC09900CC

14

Darkgreen

0xC0317F0C

30

Dark red

0xC0990000

15

Darkbrown

0xC060493E

31

Very dark green

0xC0004400

16

Grey

0xC072808E

32

Dark purple

0xC0663399

Remarks 1.

About the specification of the color

You can specify one of the following.

Note, however, that if you specify the alpha value indicating transparency, then it is assumed that "255(0xff)" (opaque) was specified.

-

32-bit value (assigning each 8-bit segment, from high to low, to the αRGB values)
Example: 0xC0FF0A4F

-

24-bit value (assigning each 8-bit segment, from high to low, to the RGB values)
Example: 0xFF0A4F

-

Four eight-bit values, delimited by commas (assigning values from left to right to αRGB)
Example: 192, 255, 10, 79

-

Three eight-bit values, delimited by commas (assigning values from left to right to RGB)
Example: 255, 10, 79

-

Using general English color words (case insensitive)
Example: Blue

Remarks 2.

How to integrate the settings for channels into a pattern and switch the pattern from among multiple patterns

You can integrate, save, and restore the settings for all channels. You can also select a pattern from among multiple patterns.

1. Make the settings for each channel. Shift the focus to the Analysis Chart panel,

select [Save Analysis Chart Data As...] from the [File] menu, and save the settings in the [Analysis Chart Data (*.mtac)] file format. In this case, the file name will include a pattern name such as analysis_graph_xx_pattern.mtac. Not including graph data in the file will reduce its size.

2. Set another pattern for a different channel and save the file with another name.

Repeat this step as many times as the number of patterns.

Creating files enables the management of deleting and copying patterns from the Explorer.

3. To use a saved pattern, select [Load from file] for the [Analysis method] property

on the [Variable Value Changing] tabbed page of the Property panel and specify the *.mtac file containing the pattern for the [Analysis chart data file] property. Restore the [Analysis method] property to its original setting.