- Important information
- New features
- Known problems
- Program corrections
- User guide corrections
- Miscellaneous
- Release history
Important information
- EZ-CUBE2 On-Chip Debug Emulator
The EZ-CUBE2 On-Chip Debug Emulator is a new hardware product that has not yet been fully tested.
- Option byte setting
The so called Option byte area of the RL78 flash memory holds the device configuration for watchdog, voltage detection, on-chip oscillator, OCD interface, etc. During power-up and reset of an application, this area is automatically referenced by the device so you need to make sure that it is correctly configured. Refer to the IAR Embedded Workbench C-SPY Debugging Guide and to the hardware user’s manual for your device. You also find code examples for configuring the Option byte area in sub-folder rl78\examples\RL78 targetboard samples.
- Breakpoints for core S1
Software breakpoints for the OCD drivers, which normally are used for standard code breakpoints, are not available for S1 cores like for example RL78/G10. Instead, hardware events are used for standard code breakpoints. These are of type Break after execution and at such a break, execution always slips a number of cycles from the chosen address. The same thing happens when you use debugging commands like Step Over, Run to cursor, etc. Due to this, Terminal I/O is not supported and the application will not stop at the exit label. To be able to use all, normally 2, available events as breakpoints, you also need to disable the stack check.
- Hardware multiplier/divider
Some RL78 microcontrollers have a hardware multiplier/divider unit which is not supported by the C-SPY simulator. This unit can be disabled on the Project Options>General Options>Library Configuration page.
- Emulator firmware
The latest emulator firmware and other software updates from Renesas can be found here.
- Please refer to the IAR Embedded Workbench C-SPY Debugging Guide for detailed information about this product part.
New features
Flash programmer security ID support
C-SPY now supports security ID handling for flash programmers as required by microcontrollers like RL78/F24, that has extended security features.
Known problems
-
[EWRL78-435] There is no context menu implemented in the Trace window for the emulators.
-
[EWRL78-416, EW23868] On rare occasions, you can get an error message for the OCD drivers that says:
Fatal Error: Emulator message: No response from the CPU. Failed to set SOC RSU info.
A reason might be that the RL78 so called Option byte area is not setup correctly in your application. See section Important information above. Alternate workaround: Exit the IDE and delete the settings subfolder, the .dep file and the .ewd file in your project folder. Alternatively, use the Renesas programmer to erase the device. -
[EWRL78-695] The column labels in the Data Sample window do not refresh when you switch variables in the Data Sample Setup window.
-
[EWRL78-678] Some C-SPY error messages contain mixed Japanese and English sentences.
Program corrections
- None
User guide corrections
RL78 COM Port driver
The C-SPY driver COM Port enables hardware debugging via a USB-to-serial adapter. It has the same feature set as the TK driver except that it also supports trace. See section C-SPY drivers overview in the C-SPY® Debugging Guide for details.
Miscellaneous
- Since the E2 On-Board (E2 OB) and E2-lite emulators are using the same C-SPY driver, the text string for the C-SPY driver selection has been updated in the project Options dialog box.
Release history
4.21.2 2021-08-12
New features
RL78 COM Port support
A new C-SPY driver called COM Port has been added. With this, you can debug a program simply by using a USB-to-serial adapter.
4.21.1 2021-04-29
Program corrections
-
[EWRL78-814]
Loading an UBROF image in an ELF version of the debugger fails if the UBROF file makes use of any __far data.
-
[EWRL78-799]
The Renesas E2 Self Check Program utility does not work with the E2 emulator probe due to a number of missing files.
4.20.2 2020-02-20
Program corrections
-
[EWRL78-786]
When using the power debugging features in C-SPY, the IDE can become unresponsive during single-stepping.
4.20.1 2019-12-04
Program corrections
-
[EWRL78-756]
Interrupts in the simulator will jump to a wrong address if the interrupt occurs when the current PC is on an address above 0x0FFFF.
-
[EWRL78-743]
If the Queues window that comes with the FreeRtos plugin is opened, the debug session will in some cases crash.
New features
EZ-CUBE2 On-Chip Debug Emulator support
The EZ-CUBE2 On-Chip Debug Emulator, primarily targeted for the Chinese market, is now supported.
E2 emulator power debugging in C-SPY
The E2 emulator allows you to measure the dynamically
changing current drawn by the user system. This is
visualized as a graph in the C-SPY Timeline window
as well as a list of time-current value pairs in the Power
Log window. It is also possible to stop
execution when the current goes above or below a certain
user-defined threshold value.
4.10.1 2018-12-18
Program corrections
-
[EWRL78-674]
With Japanese as the selected IDE language, some strings in the Hardware Setup dialog box have garbled characters and the menu items Event Log, Event Summary, and Timeline are missing from the Emulator menu.
3.10.1 2017-09-15
Program corrections
-
[EWRL78-533] If you toggle a 2-byte variable between two distinct values in C source code and display them in the Data Sample window, some of the samples show incorrect values.
-
[EWRL78-520] Specifying the serial number for an E1/E20 emulator (in the Project>Options dialog box) sometime causes the emulator not to be found.
2.21.5 2017-04-03
Program corrections
-
[EWRL78-513] C-SPY is using a 2Kbytes flash block size for the OCD drivers which is causing problems if a bootloader is located close to the application code. The flash block size needs to be 1Kbytes as specified by Renesas.
New features
-
A new option Monitor clock has been added in the C-SPY emulator driver Hardware setup dialog box.
2.21.1 2016-05-31
Program corrections
-
[EW25913] The execution time measurement feature for IECUBE shows wrong cycle values when measuring for more than 30 seconds.
-
[EW25950] C-SPY C source level Step In and Step Over do not work for switch statements with more than 99 cases.
-
C-SPY now supports the Renesas E2 emulator Lite and EZ-Cube (available in China only) on-chip debugging emulators.
2.20.1 2015-12-17
Program corrections
-
[EW25840] The C-SPY system macro __setLogBreak() does not work for emulators.
2.10.4 2015-11-05
Program corrections
-
[EW25668] A warning message is displayed when single step is not allowed during flashing and C-SPY stops execution with a "failed to run" message.
-
[EW25667] 64-bit double variables are not displayed correctly in the Watch windows and during mouse-over.
2.10.1 2015-06-15
Program corrections
-
[EW25151] If the IECUBE feature Fail safe break is activated and such a break occurrs, the debug session is unexpectedly closed.
-
[EW25107] The RL78 E1 driver sometimes gives incorrect download verification errors as the emulator monitor area, located in the highest part of the memory, is erroneusly included in the verification.
New features
-
In the C-SPY Watch window family, you can now choose Save
All to File from the context menu to save the
contents of the current window to a text file.
1.40.6 2014-11-12
Program corrections
-
[EW25065] The emulator now displays a message when wrong clock configuration is used.
1.40.3 2014-09-17
Program corrections
-
[EW24790] Instead of closing the debug session with an error message for the case when single-stepping is not allowed during flashing, a warning message is displayed.
1.40.2 2014-06-10
New features
-
Japanese translation.
1.40.1 2014-04-10
Program corrections
-
[EW24263] Due to a bug in the algorithm for filling in missing frames between the branches in the trace buffer, the IDE hangs for a certain code example when using Trace.
-
[EW24319] For certain trace settings, the time stamps in the Trace window are incorrect for the IECUBE emulator.
-
[EW24237] The Data Flash Memory window is not possible to open.
-
[EW24594] Variables displayed in the Sampled Graphs window are not updated unless they are present in the Live Watch window at the same time.
New features
-
Code coverage save/restore session for the IECUBE emulator
The possibility to save/restore a code coverage session data to/from a *.dat file is now supported also for the IECUBE emulator. In addition, there is a new C-SPY driver option for the IECUBE emulator, --code_coverage_session_file, that can be used with cspybat to save a session.
-
New windows for C-SPY macros
Two new C-SPY windows have been added to easier manage C-SPY macros. The Macro Registration window controls
which macro files are loaded and the Debugger Macros window shows a list of all macros available in the debugger.
These windows replaces the Macro configuration dialog box.
1.30.4 2013-10-10
Program corrections
-
[EW23929] Setting up a debug session for hot-plugin capable devices often fails.
-
[EW24022] Using the E1 emulator single-stepping over a for-loop or stepping into a function, the error "Break reason: Unknown (hwbrfact: 0x00000000)" is sometimes generated.
1.30.3 2013-06-14
Program corrections
-
[EW23940] Manually changed values for word sized SFR's in the C-SPY Register window leads to wrong values written back to the hardware system.
-
[EW23952] It is not possible to define a value for a data access event as the fields for Value and Mask are disabled.
-
[EW23928] In the E1 emulator Hardware Setup dialog box, entries will be added in the Power supply drop-down list each time the Default button is clicked.
-
[EW23862] The program counter (PC) can in rare circumstances get a value bigger than 20 bits. In these cases the disassembler hangs.
1.30.2 2012-03-15
Program corrections
-
[EW23213] When you are watching global variables in the Live Watch window using the E1 emulator, only the variables located in the Live Memory area are updated correctly.
-
[EW23556] The simulator Interupt Setup dialog box description in the C-SPY Debugging Guide is not up to date when it comes to column naming.
-
[EW23728] Function entries and exits are not always shown correctly in the Timeline Window.
New features
-
Attach to running target for E1 and E20
C-SPY now allows you to connect an E1 or E20 emulator to
a running system to inspect it without interrupting
program execution.
-
Sampled Graphs in C-SPY
It is now possible to specify variables for which you
want to collect data samples. You can view the sampled
data either in table format in the Data Sample window or
as graphs in the Sampled Graphs window.
-
Custom SFR window
It is now possible to define custom SFR's (special
function registers) in C-SPY with selectable access size
and type.
-
Macro Quicklaunch window
The new Macro Quicklaunch window makes it possible to
evaluate expressions and to launch C-SPY macros. The
return value from the evaluated macro or expression is
shown in a separate column and the user can re-trigger
the evaluation at any given point.
1.30.1 2013-03-01
-
Pre-release.
1.20.3 2012-08-09
Program corrections
-
[EW23386] The simulator no longer calculates wrong number of cycles when executing bit branch and skip instructions.
1.20.1 2012-04-13
Program corrections
-
[EW23010] A manually generated reset for IECUBE while an application was active no longer causes an error message.
-
[EW22675] Anonymous struct and union variables with multiple fields are now shown correctly in the C-SPY watch windows.
-
[EW22775] Parsing large ORTI description files could cause the ORTI plugin to fail with a "memory exhausted" message. This has been corrected.
-
[EW23081] It is no longer possible to choose Debug>Memory>Save while your application is running.
New features
-
OCD trace support
The IAR C-SPY Debugger driver for the E1 emulator now supports OCD trace.
1.10.5 2011-10-26
Program corrections
-
[EW22722] C-SPY could hang/crasch during OCD debugging when stepping over a function call.
-
[EW22693] An error in the disassembler could cause C-SPY to hang when no debug information was present in the object file.
New features
-
New C-SPY macro __setCodeHWBreak()
The new macro __setCodeHWBreak() sets a code HW breakpoint. See section "User guide corrections" for details.
-
Some RL78 device series support a feature to identify the
currently used device. This information is now output in
the Debug Log window.
1.10.4 2011-08-11
Program corrections
-
[EW22543] When installing on a computer with a non-English Windows operating system, a warning message concerning emulator drivers appeared in some cases.
1.10.3 2011-08-04
Program corrections
-
[EW22559] The C-SPY macro __driverType now works for all emulator drivers.
-
[EW22560] When two 8-bit I/O registers are defined at the same address inside a 16-bit I/O register,
the wrong address was generated for one of the 8-bit registers.
-
[EW22526] Based addressing and based index addressing was not correctly simulated when a base + offset overflow occurred.
1.10.2 2011-06-23
Program corrections
-
[EW22384] Cspybat now works for all emulator drivers.
-
[EW22397] Interrupt simulation did not work properly.
1.10.1 2011-03-01
-
Initial release.
New features
RL78 COM Port support
A new C-SPY driver called COM Port has been added. With this, you can debug a program simply by using a USB-to-serial adapter.
4.21.1 2021-04-29
Program corrections
-
[EWRL78-814] Loading an UBROF image in an ELF version of the debugger fails if the UBROF file makes use of any __far data.
-
[EWRL78-799] The Renesas E2 Self Check Program utility does not work with the E2 emulator probe due to a number of missing files.
4.20.2 2020-02-20
Program corrections
-
[EWRL78-786] When using the power debugging features in C-SPY, the IDE can become unresponsive during single-stepping.
4.20.1 2019-12-04
Program corrections
-
[EWRL78-756] Interrupts in the simulator will jump to a wrong address if the interrupt occurs when the current PC is on an address above 0x0FFFF.
-
[EWRL78-743] If the Queues window that comes with the FreeRtos plugin is opened, the debug session will in some cases crash.
New features
EZ-CUBE2 On-Chip Debug Emulator support
The EZ-CUBE2 On-Chip Debug Emulator, primarily targeted for the Chinese market, is now supported.E2 emulator power debugging in C-SPY
The E2 emulator allows you to measure the dynamically changing current drawn by the user system. This is visualized as a graph in the C-SPY Timeline window as well as a list of time-current value pairs in the Power Log window. It is also possible to stop execution when the current goes above or below a certain user-defined threshold value.
4.10.1 2018-12-18
Program corrections
-
[EWRL78-674] With Japanese as the selected IDE language, some strings in the Hardware Setup dialog box have garbled characters and the menu items Event Log, Event Summary, and Timeline are missing from the Emulator menu.
3.10.1 2017-09-15
Program corrections
-
[EWRL78-533] If you toggle a 2-byte variable between two distinct values in C source code and display them in the Data Sample window, some of the samples show incorrect values.
-
[EWRL78-520] Specifying the serial number for an E1/E20 emulator (in the Project>Options dialog box) sometime causes the emulator not to be found.
2.21.5 2017-04-03
Program corrections
-
[EWRL78-513] C-SPY is using a 2Kbytes flash block size for the OCD drivers which is causing problems if a bootloader is located close to the application code. The flash block size needs to be 1Kbytes as specified by Renesas.
New features
-
A new option Monitor clock has been added in the C-SPY emulator driver Hardware setup dialog box.
2.21.1 2016-05-31
Program corrections
-
[EW25913] The execution time measurement feature for IECUBE shows wrong cycle values when measuring for more than 30 seconds.
-
[EW25950] C-SPY C source level Step In and Step Over do not work for switch statements with more than 99 cases.
-
C-SPY now supports the Renesas E2 emulator Lite and EZ-Cube (available in China only) on-chip debugging emulators.
2.20.1 2015-12-17
Program corrections
-
[EW25840] The C-SPY system macro __setLogBreak() does not work for emulators.
2.10.4 2015-11-05
Program corrections
-
[EW25668] A warning message is displayed when single step is not allowed during flashing and C-SPY stops execution with a "failed to run" message.
-
[EW25667] 64-bit double variables are not displayed correctly in the Watch windows and during mouse-over.
2.10.1 2015-06-15
Program corrections
-
[EW25151] If the IECUBE feature Fail safe break is activated and such a break occurrs, the debug session is unexpectedly closed.
-
[EW25107] The RL78 E1 driver sometimes gives incorrect download verification errors as the emulator monitor area, located in the highest part of the memory, is erroneusly included in the verification.
New features
-
In the C-SPY Watch window family, you can now choose Save All to File from the context menu to save the contents of the current window to a text file.
1.40.6 2014-11-12
Program corrections
-
[EW25065] The emulator now displays a message when wrong clock configuration is used.
1.40.3 2014-09-17
Program corrections
-
[EW24790] Instead of closing the debug session with an error message for the case when single-stepping is not allowed during flashing, a warning message is displayed.
1.40.2 2014-06-10
New features
-
Japanese translation.
1.40.1 2014-04-10
Program corrections
-
[EW24263] Due to a bug in the algorithm for filling in missing frames between the branches in the trace buffer, the IDE hangs for a certain code example when using Trace.
-
[EW24319] For certain trace settings, the time stamps in the Trace window are incorrect for the IECUBE emulator.
-
[EW24237] The Data Flash Memory window is not possible to open.
-
[EW24594] Variables displayed in the Sampled Graphs window are not updated unless they are present in the Live Watch window at the same time.
New features
-
Code coverage save/restore session for the IECUBE emulator
The possibility to save/restore a code coverage session data to/from a *.dat file is now supported also for the IECUBE emulator. In addition, there is a new C-SPY driver option for the IECUBE emulator, --code_coverage_session_file, that can be used with cspybat to save a session. -
New windows for C-SPY macros
Two new C-SPY windows have been added to easier manage C-SPY macros. The Macro Registration window controls which macro files are loaded and the Debugger Macros window shows a list of all macros available in the debugger. These windows replaces the Macro configuration dialog box.
1.30.4 2013-10-10
Program corrections
-
[EW23929] Setting up a debug session for hot-plugin capable devices often fails.
-
[EW24022] Using the E1 emulator single-stepping over a for-loop or stepping into a function, the error "Break reason: Unknown (hwbrfact: 0x00000000)" is sometimes generated.
1.30.3 2013-06-14
Program corrections
-
[EW23940] Manually changed values for word sized SFR's in the C-SPY Register window leads to wrong values written back to the hardware system.
-
[EW23952] It is not possible to define a value for a data access event as the fields for Value and Mask are disabled.
-
[EW23928] In the E1 emulator Hardware Setup dialog box, entries will be added in the Power supply drop-down list each time the Default button is clicked.
-
[EW23862] The program counter (PC) can in rare circumstances get a value bigger than 20 bits. In these cases the disassembler hangs.
1.30.2 2012-03-15
Program corrections
-
[EW23213] When you are watching global variables in the Live Watch window using the E1 emulator, only the variables located in the Live Memory area are updated correctly.
-
[EW23556] The simulator Interupt Setup dialog box description in the C-SPY Debugging Guide is not up to date when it comes to column naming.
-
[EW23728] Function entries and exits are not always shown correctly in the Timeline Window.
New features
-
Attach to running target for E1 and E20
C-SPY now allows you to connect an E1 or E20 emulator to a running system to inspect it without interrupting program execution. -
Sampled Graphs in C-SPY
It is now possible to specify variables for which you want to collect data samples. You can view the sampled data either in table format in the Data Sample window or as graphs in the Sampled Graphs window. -
Custom SFR window
It is now possible to define custom SFR's (special function registers) in C-SPY with selectable access size and type. -
Macro Quicklaunch window
The new Macro Quicklaunch window makes it possible to evaluate expressions and to launch C-SPY macros. The return value from the evaluated macro or expression is shown in a separate column and the user can re-trigger the evaluation at any given point.
1.30.1 2013-03-01
-
Pre-release.
1.20.3 2012-08-09
Program corrections
-
[EW23386] The simulator no longer calculates wrong number of cycles when executing bit branch and skip instructions.
1.20.1 2012-04-13
Program corrections
-
[EW23010] A manually generated reset for IECUBE while an application was active no longer causes an error message.
-
[EW22675] Anonymous struct and union variables with multiple fields are now shown correctly in the C-SPY watch windows.
-
[EW22775] Parsing large ORTI description files could cause the ORTI plugin to fail with a "memory exhausted" message. This has been corrected.
-
[EW23081] It is no longer possible to choose Debug>Memory>Save while your application is running.
New features
-
OCD trace support
The IAR C-SPY Debugger driver for the E1 emulator now supports OCD trace.
1.10.5 2011-10-26
Program corrections
-
[EW22722] C-SPY could hang/crasch during OCD debugging when stepping over a function call.
-
[EW22693] An error in the disassembler could cause C-SPY to hang when no debug information was present in the object file.
New features
-
New C-SPY macro __setCodeHWBreak()
The new macro __setCodeHWBreak() sets a code HW breakpoint. See section "User guide corrections" for details.
-
Some RL78 device series support a feature to identify the currently used device. This information is now output in the Debug Log window.
1.10.4 2011-08-11
Program corrections
-
[EW22543] When installing on a computer with a non-English Windows operating system, a warning message concerning emulator drivers appeared in some cases.
1.10.3 2011-08-04
Program corrections
-
[EW22559] The C-SPY macro __driverType now works for all emulator drivers.
-
[EW22560] When two 8-bit I/O registers are defined at the same address inside a 16-bit I/O register, the wrong address was generated for one of the 8-bit registers.
-
[EW22526] Based addressing and based index addressing was not correctly simulated when a base + offset overflow occurred.
1.10.2 2011-06-23
Program corrections
-
[EW22384] Cspybat now works for all emulator drivers.
-
[EW22397] Interrupt simulation did not work properly.
1.10.1 2011-03-01
-
Initial release.