Main window


This is the first window that opens when you launch CS+.

When debugging a program, use this window to control program execution and opening of each panel.

Figure A.1

Main Window

 

This section describes the following.

[How to open]

-

Select Windows [Start] >> [Programs] >> [Renesas Electronics CS+] >> [CS+ for CC (RL78,RX,RH850)].

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)

Menu bar

The debug-related menu items are described below.

Remark

The items drawn from each menu can be customized using the User Settings dialog box.

(a)

[View]

Each item on [View] menu and their functionality are as follows (default).

Watch

Shows the following cascaded menu to open the Watch panel.

However, this item is disabled when CS+ is 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.

However, this item is disabled when CS+ is disconnected from the debug tool.

Call Stack

Opens the Call Stack panel.

However, this item is disabled when CS+ is disconnected from the debug tool.

Memory

Shows the following cascaded menu to open the Memory panel.

However, this item is disabled when CS+ is 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).

IOR

Opens the IOR panel.

However, this item is disabled when CS+ is disconnected from the debug tool.

CPU Register

Opens the CPU Register panel.

However, this item is disabled when CS+ is disconnected from the debug tool.

Trace

Opens the Trace panel.

However, this item is disabled when CS+ is disconnected from the debug tool.

Disassemble

Shows the following cascaded menu to open the Disassemble panel.

However, this item is disabled when CS+ is 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.

However, this item is disabled when CS+ is disconnected from the debug tool.

Debug Console

Opens the Debug Console panel.

However, this item is disabled when CS+ is disconnected from the debug tool.

Show Current PC Location

Displays the current PC position (PC register value) on the Editor panel.

However, this item is disabled when CS+ is disconnected from the debug tool.

Back to Last Cursor Position

Moves the caret back to where it was before it jumped to a defined place (see "2.6.2.4 Moving to a symbol definition part").

Forward to Next Cursor Position

Moves the caret back to where it was before [Back to Last Cursor Position] was executed.

Tag Jump

If, on Editor panel or Output panel, there is file name or line/column information on the line at which the caret exists, this menu causes a jump to the relevant line/column in the relevant file.

(b)

[Debug]

Each item of the [Debug] menu and their functionality are as follows (default).

Download

Downloads a specified file to 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 rebuild 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(JTAG)]

[E20(JTAG)]

Hot-plugs in to the debug tool currently selected in the active project in order to debug the target system currently under execution (see Section "2.4.3 Connect the debug tool to CS+ using hot plug-in [E1(JTAG)] [E20(JTAG)]").

However, if already connected with the debug tool, this item is disabled.

Upload...

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

However, this item is disabled during program execution, when build (not including rapid build) is under execution, or when disconnected from the debug tool.

Disconnect from Debug Tool

Terminates communication with the currently connected debug tool.

However, this item is disabled when build (not including rapid build) is under execution or when already disconnected from the debug tool.

Using Debug Tool

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

Note that the debug tools displayed in this menu differ depending on the microcontroller selected in the project.

 

RX E1(Serial)

Uses E1 in Serial communication mode as the debug tool.

RX E1(JTAG)

Uses E1 in JTAG communication mode as the debug tool.

RX E20(Serial)

Uses E20 in Serial communication mode as the debug tool.

RX E20(JTAG)

Uses E20 in JTAG communication mode as the debug tool.

RX EZ Emulator

Uses EZ Emulator as the debug tool.

RX Simulator

Uses Simulator as the debug tool.

Stop

Forcibly halts the currently executed program.

However, this item is disabled when the program is already halted or disconnected from the debug tool.

Go

Runs the program from the current PC position and when the condition for a set break event holds true, stops the program under execution.

However, this item is disabled during program execution, when build (not including rapid build) is under execution, or when disconnected from the debug tool.

Ignore break and go

Runs the program from the current PC position and continues running it ignoring the break and action events set.

However, this item is disabled during program execution, when build (not including rapid build) is under execution, or when disconnected from the debug tool.

Step In

Runs the program from the current PC position by executing one stepNote at a time, updating the content of each panel.

For a function call, the program stops at the beginning of a called function.

However, this item is disabled during program execution, when build (not including rapid build) is under execution, or when disconnected from the debug tool.

Step Over

Runs the program from the current PC position by executing one stepNote at a time, updating the content of each panel.

For a function call by a jump to subroutine instruction, all of the source lines or instructions in that function are executed successively in one step until a place is reached at which control returns from the function (step execution will continue until the same nest is formed as when a jump to subroutine instruction has been executed).

For other than a jump to subroutine instruction, the same operation as [Step In] is selected is performed.

However, this item is disabled during program execution, when build (not including rapid build) is under execution, or when disconnected from the debug tool.

Return Out

Runs the program until control returns from the currently executed function (until control returns to the calling function)Note.

However, this item is disabled during program execution, when build (not including rapid build) is under execution, or when disconnected from the debug tool.

CPU Reset

Resets the CPU (program is not executed).

However, this item is disabled when build (not including rapid build) is under execution or when disconnected from the debug tool.

Restart

Resets the CPU once and then starts running the program from the reset address.

However, this item is disabled when build (not including rapid build) is under execution or when disconnected from the debug tool.

Note

Step execution can be performed either at the source level or at the instruction level.
For details, see Section "2.9.3 Execute programs in steps".

(2)

Debug toolbar

The debug toolbar comprises buttons each representing a command for controlling program execution.

Each button and their functionality are as follows (default).

Remark 1.

The buttons in each toolbar can be customized using the User Settings dialog box. Also, this same dialog box can be used to create a new toolbar.

Remark 2.

Right-clicking on the toolbar displays a context menu, which allows selection of a group to be displayed in or hidden from the toolbar.

 

Builds a project and, after building, downloads the file to the active project's debug tool.

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

However, if a build fails, no download is executed.

This is the same as selecting [Build and download to the debug tool] from the [Debug] menu.

 

Downloads a specified file to the active project's debug tool.

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

However, this item is disabled during program execution/build (not including rapid build) execution.

This is the same as selecting [Download] from the [Debug] menu.

 

Resets the CPU (program is not executed).

However, this item is disabled when build (not including rapid build) is under execution or when disconnected from the debug tool.

This is the same as selecting [CPU Reset] from the [Debug] menu.

 

Forcibly halts the currently executed program.

However, this item is disabled when the program is already halted or disconnected from the debug tool.

This is the same as selecting [Stop] from the [Debug] menu.

 

Runs the program from the current PC position and when the condition for a set break event holds true, stops the program under execution.

However, this item is disabled during program execution, when build (not including rapid build) is under execution, or when disconnected from the debug tool.

This is the same as selecting [Go] from the [Debug] menu.

 

Runs the program from the current PC position and continues running it ignoring the break and action events set.

However, this item is disabled during program execution, when build (not including rapid build) is under execution, or when disconnected from the debug tool.

This is the same as selecting [Ignore break and go] from the [Debug] menu.

 

Resets the CPU once and then starts running the program from the reset address.

However, this item is disabled when build (not including rapid build) is under execution or when disconnected from the debug tool.

This is the same as selecting [Restart] from the [Debug] menu.

 

Runs the program from the current PC position by executing one stepNote at a time, updating the content of each panel (Step In execution).

For a function call, the program stops at the beginning of the called function.

However, this item is disabled during program execution, when build (not including rapid build) is under execution, or when disconnected from the debug tool.

This is the same as selecting [Step In] from the [Debug] menu.

 

Runs the program from the current PC position by executing one stepNote at a time, updating the content of each panel (step-over execution).

For a function call by a jump to subroutine instruction, all of the source lines or instructions in that function are executed successively in one step until a place is reached at which control returns from the function (step execution will continue until the same nest is formed as when a jump to subroutine instruction has been executed).

For other than a jump to subroutine instruction, the same operation as the button is clicked is performed.

However, this item is disabled during program execution, when build (not including rapid build) is under execution, or when disconnected from the debug tool.

This is the same as selecting [Step Over] from the [Debug] menu.

 

Runs the program until control returns from the currently executed function (until control returns to the calling function)Note (Return Out execution).

However, this item is disabled during program execution, For other than a jump to subroutine instruction, the same operation as the when build (not including rapid build) is under execution, or when disconnected from the debug tool.

This is the same as selecting [Return Out] from the [Debug] menu.

 

Terminates communication with the currently connected debug tool.

However, this item is disabled when build (not including rapid build) is under execution or when already disconnected from the debug tool.

This is the same as selecting [Disconnect from Debug Tool] from the [Debug] menu.

Note

Step execution can be performed either at the source level or at the instruction level.
For details, see Section "2.9.3 Execute programs in steps".

(3)

Panel display area

This area displays various panels available.

For details about displayed contents, see the section in which the relevant panel is described.

(4)

Status bar

The status bar displays the information shown below.

Figure A.2

Status Bar

(a)

Status message

Displays the following messages.

-

Simple description of a selected menu item

-

Message to notify that a value input in the panel/dialog is invalid

-

Message to notify that the character string specified in the Find and Replace dialog box could not be found

-

Message to identify the cause of program break (see Section "2.10 Stop Programs (Break)")

(b)

Focus panel status information

Displays status information on the currently focused panel (e.g., information about caret position or overwrite/insertion mode).

However, this status is hidden for panels that do not have status information.

(c)

Execution status

Shows the current execution status of a program using the following icons and character strings.

However, this status is hidden when CS+ is disconnected from the debug tool.

Program status

Displayed Content

Under execution

RUN

Now halted

BREAK

Step execution in progress

STEP

(d)

CPU status [E1(JTAG)][E20(JTAG)]

Displays the current CPU status of the debug tool.

If the CPU is in several different status at the same time, each status is shown separated by "&".

However, this status is hidden when CS+ is disconnected from the debug tool.

Debug Tool

Displayed Content

CPU Status

E1(JTAG)
E20(JTAG)

Reset

Reset state

Pow Off

Target not supplied with power

Sleep

Now in sleep mode

Standby

Now in standby mode

Remark

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

(e)

Current PC position

Displays a hexadecimal value representing the current PC position.

Clicking this area moves the caret to the current PC position on the Editor panel.

Note that the content displayed during program execution changes according to settings in the [Register] category on the Property panel's [Debug Tool Settings] tab, as follows:

Program state

State of [PC display during the execution] property

Displayed content

While halted

--

Current PC position

During execution

Yes

Current PC position at update intervals set in [Display update interval for PC[ms]] property Note 1

No

Running

 

Placing the cursor over this area will pop up the following information.

-

Current PC: 0x current PC value (source name # number of lines Note 2)

 

However, this status is hidden when CS+ is disconnected from the debug tool.

Note 1.

[RX100 Series]
PC values are hidden because these microcontrollers do not support display of the PC value in the status bar during program execution.

Note 2.

If this information cannot be obtained, it is substituted for by "Symbol name + Offset value".

(f)

Connection status with the debug tool

Shows the current status of connection with the debug tool using the following icons and character strings.

Connection Status

Displayed content

Currently connected

Debug tool name

Currently disconnected

DISCONNECT

(g)

Run-Break timer result

Displays the results of measurements by the Run-Break timer (see Section "2.14.2 Measuring execution time from start to stop"). The display unit is determined by the measurement results.

However, this status is hidden when CS+ is disconnected from the debug tool.

Status

Displayed content

No measurements mode

Not measured

Measurement in progress

Measuring

When overflowed

OVERFLOW

Remark

When the EZ Emulator is in use, the status shown in the status bar is always Not measured because the EZ Emulator does not support the Run-Break timer function.

(h)

Debug tool status

Displays the current status of each function of the debug tool using the following icons.

However, this status is hidden when CS+ is disconnected from the debug tool.

Function

In operation

Not in operation (Enable)

Disable

Trace

 

 

 

Timer

 

 

-

Coverage [Simulator][[E20 [RX71M and RX64M Groups]]

 

 

 

Caution 1.

[E1] [E20] [EZ Emulator]
The trace function does not go to a "Disable" state even when you click the subject icon.

Caution 2.

[E20(JTAG)]
When you click the icon of the trace function, the contents set in the [Usage of trace function] property in the [Trace] category on the Property panels [Debug Tool Settings] tab is toggled between Trace and Real-time RAM monitor.

Caution 3.

[Simulator]
When the program is halted, you can click the subject icons of the trace and coverage functions to change their "Enable" or "Disable" state.
Also, the set contents of the following properties on Property panels [Debug Tool Settings] tab toggle between Yes and No.
- [Use trace function] property in the [Trace] category
- [Use coverage function] property in the [Coverage] [Simulator] category