Development Tools

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]

-	[Description of each area]

[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 function simulations 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
E1/E20 EZ Emulator	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.