Main window


This window is automatically opened when CS+ is started up.

In this window, you can control the program execution and open panels for the debugging process.

Figure A.1

Main Window

 

This section describes the following.

[How to open]

-

From the Windows [Start] menu, select [All Programs] >> [Renesas Electronics CS+] >> [CS+ for CC].

Remark

In Windows 8.1, select [CS+ for CC (RL78,RX,RH850)] on the start screen.
In Windows 10, select Windows [Start] menu >> [All apps] >> [Renesas Electronics CS+] >> [CS+ for CC (RL78,RX,RH850)].

[Description of each area]

(1)

Menubar

Menu items related to the debugging are as follows:

Remark

The items that can be selected in each menu can be customized using the User Setting dialog box.

(a)

[View]

The [View] menu provides the following items and functions (default).

Watch

The following cascade menus are displayed to open the Watch panel.

These items are disabled when disconnected from the debug tool.

 

Watch1

Opens the Watch panel (Watch1).

Watch2

Opens the Watch panel (Watch2).

Watch3

Opens the Watch panel (Watch3).

Watch4

Opens the Watch panel (Watch4).

Local Variable

Opens the Local Variables panel.

Call Stack

Opens the Call Stack panel.

Memory

The following cascade menus are displayed to open the Memory panel.

These items are disabled when disconnected from the debug tool.

 

Memory1

Opens the Memory panel (Memory1).

Memory2

Opens the Memory panel (Memory2).

Memory3

Opens the Memory panel (Memory3).

Memory4

Opens the Memory panel (Memory4).

SFR

Opens the SFR panel.

This item is disabled when disconnected from the debug tool.

CPU Register

Opens the CPU Register panel.

This item is disabled when disconnected from the debug tool.

Trace

Opens the Trace panelNote.

This item is disabled when disconnected from the debug tool.

Disassemble

The following cascade menus are displayed to open the Disassemble panel.

These items are disabled when disconnected from the debug tool.

 

Disassemble1

Opens the Disassemble panel (Disassemble1).

Disassemble2

Opens the Disassemble panel (Disassemble2).

Disassemble3

Opens the Disassemble panel (Disassemble3).

Disassemble4

Opens the Disassemble panel (Disassemble4).

Event

Opens the Events panel.

This item is disabled when disconnected from the debug tool.

Virtual Board

[Simulator]

Opens the Virtual Board panel [Simulator].

This item is disabled when disconnected from the debug tool.

This item is also disabled even if a device for which the debug tool for the active project does not support peripheral simulation is currently connected to the debug tool.

Show Current PC Location

Displays the current PC position in the Editor panel.

This item is disabled when disconnected from the debug tool.

Back to Last Cursor Position

Goes back to the position before jumping (see "2.6.2.4 Move to the symbol defined location") to the defined location.

This item is disabled when disconnected from the debug tool.

Forward to Next Cursor Position

Forwards to the position before operating [Back to Last Cursor Position].

Tag Jump

Jumps to the corresponding line/column in the corresponding file if the information of a file name/line number/column number exists in the line at the caret position on the Editor panel/Output panel (see "CS+ Editor").

Note

[E1][E20][EZ Emulator]

This item is available only when the selected microcontroller incorporates the OCD trace function.

(b)

[Debug]

The [Debug] menu provides the following items and functions (default).

Download

Downloads the specified file(s) into the debug tool currently selected in the active project.

If CS+ is disconnected from the debug tool at this time, it is automatically connected to the debug tool before a download is executed.

This item is disabled during program execution/build (not including rapid build) execution.

Build & Download

Builds a project and executes a download to the debug tool currently selected in the active project after the build is complete. If CS+ is disconnected from the debug tool at this time, it is automatically connected to the debug tool before a download is executed.

This item is disabled during program execution/build (not including rapid build) execution.

When the build has failed, download will not be executed.

Rebuild & Download

Rebuilds a project and executes a download to the debug tool currently selected in the active project after the rebuild is complete. If CS+ is disconnected from the debug tool at this time, it is automatically connected to the debug tool before a download is executed.

This item is disabled during program execution/build (not including rapid build) execution.

When the rebuild has failed, download will not be executed.

Connect to Debug Tool

Connects to the debug tool currently selected in the active project.

This item is disabled while connected to the debug tool, during build (not including rapid build) execution or if the version of compiler being used is not supported by CS+.

Hot Plug-in

[E1][E20]

 

Connects to the debug tool currently selected in the active project via the hot plug-in function, in order to debug the target system currently running (see "2.4.3 Connect to the debug tool using hot plug-in [E1][E20]").

This item is disabled while connected to the debug tool.

Upload...

Opens the Data Save dialog box to save the memory contents.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

Disconnect from Debug Tool

Disconnects from the currently connected debug tool.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

Using Debug Tool

The following cascade menus are displayed to select the debug tool to use.

This item is disabled while connected to the debug tool.

 

RL78 IECUBE

Uses IECUBE as the debug tool.

RL78 E2

Uses E2 as the debug tool.

RL78 E2 Lite

Uses E2 Lite as the debug tool.

RL78 E1(Serial)

Uses E1 with serial communication method as the debug tool.

RL78 E20(Serial)

Uses E20 with serial communication method as the debug tool.

RL78 EZ Emulator

Uses EZ Emulator with an evaluation kit and so on.

RL78 Simulator

Uses Simulator as the debug tool.

Stop

Forcibly stops the program currently being executed.

This item is disabled when the program is already halted or disconnected from the debug tool.

Go

Executes the program from the current PC position.

Execution of the program will be stopped when the condition of a set break event is met.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

Ignore break and go

Executes the program from the current PC position.

Execution of the program continues, ignoring set break events and action events.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

Step In

Executes the program step by stepNote from the current PC position (Step in execution).

However, in the case of a function call, the program is stopped at the beginning of the function having been called.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

Step Over

Executes the program step by stepNote from the current PC position (Step over execution).

In the case of a function call by the CALL instruction, all the source lines/instructions in the function are treated as one step and executed until the position where execution returns from the function (step-by-step execution will continue until the same nest is formed as when the CALL instruction has been executed).

In the case of an instruction other than CALL, operation is the same as when [Step In] is selected.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

Return Out

Executes the program until execution returns from the current function (or returns to the calling function)Note(Return out execution).

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

CPU Reset

Resets the CPU (does not execute a program)

This item is disabled during build (not including rapid build) execution or when disconnected from the debug tool.

Restart

Resets the CPU and then executes the program from the reset address.

This item is disabled during build (not including rapid build) execution or when disconnected from the debug tool.

Rewind debug tool state

Rewinds the debug tool to the last state that was automatically saved.

Note that the data to be rewound is limited to memory and register values that can be read or written.

To use this debugging function, it has to be set so in the Option dialog box.

Save debug tool state

The following menus are relevant to saving and restoring of the state of the debug tool.

Note that the data to be saved is limited to memory and register values that can be read or written.

 

Restore debug tool state n

Restores the state of the debug tool from the n-th data file.

Save debug tool state n

Saves the current state of the debug tool in a file as the n-th data.

Note

Step execution can be carried out either in units of source lines or in units of instructions.
For details, see "2.7.3 Execute programs in steps".

(2)

Debug toolbar

The debug toolbar includes the buttons that control the execution of programs.

The debug toolbar provides the following buttons and functions (default).

Remark 1.

The buttons on the toolbar can be customized using the User Setting dialog box. Furthermore, a new toolbar can be created using the same dialog box.

Remark 2.

A Group of toolbar displayed can be selected with the context menu that is displayed by right-clicking on the toolbar.

 

Executes the build of a project and downloads the file into the debug tool currently selected in the active project. If CS+ is disconnected from the debug tool at this time, it is automatically connected to the debug tool before a download is executed.

This item is disabled during program execution/build (not including rapid build) execution.

When the build has failed, download will not be executed.

The function of this item is the same as that of [Build & Download] in the [Debug] menu.

 

Downloads the specified file(s) into the debug tool currently selected in the active project.

If CS+ is disconnected from the debug tool at this time, it is automatically connected to the debug tool before a download is executed.

This item is disabled during program execution/build (not including rapid build) execution.

The function of this item is the same as that of [Download] in the [Debug] menu.

 

Resets the CPU (does not execute a program)

This item is disabled during build (not including rapid build) execution or when disconnected from the debug tool.

The function of this item is the same as that of [CPU Reset] in the [Debug] menu.

 

Forcibly stops the program currently being executed.

This item is disabled when the program is already halted or disconnected from the debug tool.

The function of this item is the same as that of [Stop] in the [Debug] menu.

 

Executes the program from the current PC position.

Execution of the program will be stopped when the condition of a set break event is met.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

The function of this item is the same as that of [Go] in the [Debug] menu.

 

Executes the program from the current PC position.

Execution of the program continues, ignoring set break events and action events.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

The function of this item is the same as that of [Ignore break and go] in the [Debug] menu.

 

Resets the CPU and then executes the program from the reset address.

This item is disabled during build (not including rapid build) execution or when disconnected from the debug tool.

The function of this item is the same as that of [Restart] in the [Debug] menu.

 

Executes the program step by stepNote from the current PC position (Step in execution).

However, in the case of a function call, the program is stopped at the beginning of the function having been called.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

The function of this item is the same as that of [Step In] in the [Debug] menu.

 

Executes the program step by stepNote from the current PC position (Step over execution).

In the case of a function call by the CALL instruction, all the source lines/instructions in the function are treated as one step and executed until the position where execution returns from the function (step-by-step execution will continue until the same nest is formed as when the CALL instruction has been executed).

In the case of an instruction other than CALL, operation is the same as when the button is clicked.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

The function of this item is the same as that of [Step Over] in the [Debug] menu.

 

Executes the program until execution returns from the current function (or returns to the calling function)Note (Return out execution).

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

The function of this item is the same as that of [Return Out] in the [Debug] menu.

 

Disconnects from the currently connected debug tool.

This item is disabled during program execution/build (not including rapid build) execution or when disconnected from the debug tool.

The function of this item is the same as that of [Disconnect from Debug Tool] in the [Debug] menu.

Note

Step execution can be carried out either in units of source lines or in units of instructions.
For details, see "2.7.3 Execute programs in steps".

(3)

Panel display area

This area displays the various panels.

For details on the display content, see the sections describing the individual panels.

(4)

Statusbar

Statusbar displays the following items of information.

Figure A.2

Statusbar

(a)

Status message

This area displays the following messages and other information.

-

A brief explanation of the selected menu item

-

A message reporting that an invalid value has been input in the panel/dialog

-

A message reporting that the specified character string has not been found as a result of a search using the Find and Replace dialog box

-

A statement of the cause of the break when a break has occurred (see "2.8 Stop Programs (Break)")

(b)

Focus panel status information

This area displays status information on the panel currently having the focus.

Note that nothing is displayed here for a panel that has no status information.

(c)

Running state

This area displays the state of the program with the following icons and character strings.

Note that nothing is displayed here when the debug tool is not connected.

State of Program

Displayed Content

Under execution

RUN

Now halted

BREAK

Step execution in progress

STEP

(d)

CPU status

This area displays the current CPU status of the debug tool. When there is the possibility that the CPU is in two or more statuses, the corresponding display contents are displayed separated by "&".

Note that nothing is displayed here when the debug tool is not connected.

Debug Tool

Displayed Content

CPU Status

IECUBE

Halt

In HALT mode

Stop

In STOP mode

Wait

In wait state

Reset

In reset state

Pow Off

Power not supplied to the target

E1/E20
EZ Emulator

Reset

In reset state

Pow Off

Power not supplied to the target

Simulator

Halt

In HALT mode

Stop

In STOP mode

Reset

In reset state

Remark

Nothing is displayed here when the CPU is in status other than those listed above.

(e)

Current PC position

This area displays the current PC position with a hexadecimal value. When this area is clicked, the caret moves to the current PC position on the Editor panel.

In addition, when the mouse pointer is placed over this area, a pop-up window appears to display the following information. Note, however, that nothing is displayed here when the debug tool is not connected.

-

Current PC: 0x current PC value (source name#line countNote)

Note

"symbol name+offset value" is displayed when acquisition of information is impossible.

Remark

"Running" is displayed in this area during execution of a program.

(f)

Connection state

This area displays the current state of connection with the debug tool using the following icons and character strings.

Connection State

Displayed Content

Connected

Debug tool name

Disconnected

DISCONNECTED

(g)

Run-Break Timer measurement result

This area displays the result of measurement by the Run-Break Timer event (the unit of value used differs depending on the measurement amount). See "2.12.2 Measure execution time until stop of the execution".

Note that nothing is displayed here when the debug tool is not connected.

Condition

Displayed Content

Un-measuring

Not measured

Under measurement

Measuring

When a timer measurement overflow has occurred

OVERFLOW

(h)

Debug tool state [IECUBE][Simulator]

This area displays the current state of debug tool's functions using the following icons and character strings.

When a function is stopped, clicking the appropriate icon enables the state to be switched between "Use" and "Not use"Note.

Note that nothing is displayed here when the debug tool is not connected.

Function

Being Executed

Stopped (Use)

Not Use

Trace

 

 

 

Timer

 

 

 

Coverage

 

 

 

Note

[IECUBE]

Switching is impossible because the trace function, the timer function and the coverage function are always used (the icon for "Not use" is not displayed).
[Simulator]

The result of switching will be reflected in the setting of the [Use trace function]/[Use timer function]/[Use coverage function] property in the [Trace]/[Timer]/[Coverage] category on the [Debug Tool Settings] tab of the Property panel.