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 described below.

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

Debug Manager		Opens the Debug Manager panel This item is disabled when the selected microcontroller version does not support multi-core or when disconnected from the debug tool.
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).
IOR		Opens the IOR 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 panel. 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.
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.7.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.

(b)

[Debug]

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

Debug Solutions		A cascade menu is displayed to open a window of solutions related to debugging functions.
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+.
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. Note that the debug tools displayed in this menu differ depending on the microcontroller selected in the project.
	RH850 IE850A	Uses IE850A as the debug tool.
	RH850 Full-spec emulator	Uses Full-spec emulator as the debug tool.
	RH850 E2	Uses E2 as the debug tool.
	RH850 E1(LPD)	Uses E1 in LPD communication mode as the debug tool.
	RH850 E20(LPD)	Uses E20 in LPD communication mode as the debug tool.
	RH850 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 jarl 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 jarl instruction has been executed). In the case of an instruction other than jarl, 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.10.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 jarl 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 jarl instruction has been executed). In the case of an instruction other than jarl, 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.10.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.11 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)	Selection of debug target core

This area is used to select a core (PE) to be debugged (see "2.9 Select a Core (PE)").

Note that nothing is displayed here when the selected microcontroller version does not support multi-core or when disconnected from the debug tool.

Caution

When the drop-down list used for switching between cores on the status bar is being displayed while the size of this window is maximized, part of the list is hidden behind the task bar and thus cannot be selected.
Set the task bar to "Hide automatically" or set the location of the task bar as [Right], [Left], or [Upper].

(d)	Current context

This area displays the current context of the core (PE) being debugged.

However, the state is not displayed if the microcontroller does not have information on the context or the debug tool is not connected.

Current context	Item Displayed
Undefined since the program is being executed	Run
Host mode	Host
Guest mode (GPIDx: x is any number from 0 to 7.)	Guest(GPIDx)

(e)	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

(f)	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
Full-spec emulator E1/E20	Halt	In HALT mode
	Stop	In STOP mode
	Reset	In reset state
	Pow Off	Power not supplied to the target
	Initial Stop	In initial stop state
	Deep Stop	In Deep Stop mode
	Cyclic Run	In Cyclic Run mode
	Cyclic Stop	In Cyclic Stop mode
	Cyclic Disable	This is the state of the core other than the main core when the main core is in the Cyclic Run or Cyclic Stop mode.
	Standby	A clock signal is not being supplied to the GTM.
	Disable	The selected multi-channel sequencer (MCS) is not activated.
Simulator	Halt	In HALT mode
	Stop	In STOP mode
	Reset	In reset state

(g)	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: "Current PC: 0x current PC value (source name#line countNote)".

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

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.

(h)	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

(i)	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.15.1 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

(j)	Debug tool state

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

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

Function	Use		Not Use
Function	Being Executed	Stopped	Not Use
Trace
Timer
Coverage

Remark

[Simulator]
When the program is halted, clicking the appropriate icon enables the state to be switched between "Use" and "Not use". 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.