R0E00008AKCE00 Renesas Electronics America, R0E00008AKCE00 Datasheet

Page 1

... E8a Emulator User's Manual R0E00008AKCE00E Renesas Microcomputer Development Environment System All information contained in these materials, including products and product specifications, represents information on the product at the time of publication and is subject to change by Renesas Electronics Corporation without notice. Please review the latest information published by Renesas Electronics Corporation through various means, including the Renesas Electronics Corporation website (http://www ...

Page 2

All information included in this document is current as of the date this document is issued. Such information, however, is subject to change without any prior notice. Before purchasing or using any Renesas Electronics products listed herein, please confirm ...

Page 3

... Renesas Electronics Corporation 1753, Shimonumabe, Nakahara-ku, Kawasaki, Kanagawa, 211-8668, Japan Renesas Solutions Corp. Nippon Bldg., 2-6-2, Ote-machi, Chiyoda-ku, Tokyo 100-0004, Japan Renesas Electronics Europe Limited Dukes Meadow, Millboard Road, Bourne End, Buckinghamshire, SL8 5FH, U.K. Renesas E8a Emulator R0E00008AKCE00 ...

Page 4

...

Page 5

This manual describes the followings - E8a Emulator functions - Preparation before use - Debugger functions - Tutorial - Appendix: (Components of the E8a Emulator, Notes on High-performance Embedded Workshop, and Diagnostic Test Procedure) This manual does not intend to ...

Page 6

Document Conventions This manual uses the following typographic conventions: Table 1 Typographic Conventions Convention [Menu->Menu Option] FILENAME.C “enter this string” Key + Key (The “how to” symbol) Bold text with ‘->’ is used to indicate menu options (for example, [File->Save ...

Page 7

Before using this product, be sure to read the user’s manual (this user's manual) carefully. Keep this user’s manual, and refer to this when you have questions about this product. Emulator: The emulator in this document refers to the following ...

Page 8

Usage restrictions: This emulator has been developed as a means of supporting system development by users. Therefore, do not use device used for equipment-embedded applications. Also, do not use it for developing the systems or equipment used ...

Page 9

Before using this product, be sure to read the user’s manual (this user's manual) carefully. Keep this user’s manual, and refer to this when you have questions about this product. Precautions for Safety READ FIRST ...

Page 10

DEFINITION OF SIGNAL WORDS Be sure to read and understand the warnings below before using this emulator. Note that these are the main warnings, not the complete list. This is the safety alert symbol used to alert you ...

Page 11

Do not repair or remodel the emulator product by yourself for electric shock prevention and quality assurance. 2. Always switch OFF the host computer and user system before connecting or disconnecting any CABLES or PARTS. Failure ...

Page 12

...

Page 13

Section 1 Overview................................................................................................1 1.1 Warnings ................................................................................................................................ 4 1.2 Environmental Conditions ..................................................................................................... 5 1.3 Components ........................................................................................................................... 6 Section 2 E8a Emulator Functions.........................................................................7 2.1 Overview................................................................................................................................... 7 2.2 Trace Functions ........................................................................................................................ 9 2.3 Break Functions ...................................................................................................................... 10 2.4 Memory Access Functions...................................................................................................... 11 2.5 ...

Page 14

Using the Event Points......................................................................................................... 83 5.4.1 PC Breakpoints ....................................................................................................... 83 5.4.2 Break Conditions .................................................................................................... 83 5.4.3 Opening the [Event] Window ................................................................................. 83 5.4.4 Setting PC Breakpoints ........................................................................................... 83 5.4.5 Add ......................................................................................................................... 84 5.4.6 Edit.......................................................................................................................... 84 5.4.7 Enable ..................................................................................................................... 84 ...

Page 15

Downloading the Tutorial Program......................................................................... 103 6.6.2 Displaying the Source Program............................................................................... 104 6.7 Setting a PC Breakpoint........................................................................................................ 105 6.8 Setting Registers ................................................................................................................... 106 6.9 Executing the Program.......................................................................................................... 108 6.10 Reviewing Breakpoints....................................................................................................... 111 6.11 Viewing Memory................................................................................................................ 112 6.12 Watching Variables............................................................................................................. 113 ...

Page 16

...

Page 17

E8a Emulator User's Manual The High-performance Embedded Workshop is a Graphical User Interface intended to ease the development and debugging of applications written in C/C++ programming language and assembly language for Renesas microcomputers. Its aim is to provide a powerful ...

Page 18

E8a Emulator User's Manual The emulator has three activation modes: (1) Erase Flash and Connect This mode is used to erase data of the MCU flash memory and activate the debugger. A program for the emulator is also written to ...

Page 19

E8a Emulator User's Manual (8) Compact debugging environment A laptop computer can be used as a host computer, creating a debugging environment in any place. REJ10J1655-0400 Rev.4.00 Apr 30, 2010 1. Overview Page 3 of 158 ...

Page 20

E8a Emulator User's Manual 1.1 Warnings READ the following warnings before using the emulator product. Incorrect operation will damage the user system and the emulator product. The USER PROGRAM will be LOST. (1) Check all components against the component list ...

Page 21

E8a Emulator User's Manual 1.2 Environmental Conditions Observe the conditions listed in tables 1.1 and 1.2 when using the emulator. Failure will cause illegal operation in the user system, the emulator product, and the user program. Table ...

Page 22

E8a Emulator User's Manual 1.3 Components Check that all of the components are present when unpacking the product. For details on the E8a emulator components, refer to the component list provided at the rear side of the component box. If ...

Page 23

E8a Emulator User's Manual Section 2 E8a Emulator Functions This section describes the emulator functions. They differ according to the device supported by the emulator. 2.1 Overview Table 2.1 gives a functional overview of the emulator. Table 2.1 Emulator Functions ...

Page 24

E8a Emulator User's Manual Table 2.1 Emulator Functions (cont) No. Item 5 Memory access function 6 General/control register access function 7 Internal I/O register access function 8 Source-level debugging function 9 Command line function 10 Start/Stop function 11 Help function ...

Page 25

E8a Emulator User's Manual 2.2 Trace Functions The branch source addresses, mnemonics, operands, and source lines are displayed. Since this function uses the trace buffer built into the device, a realtime trace can be acquired. Note: The MCUs which have ...

Page 26

E8a Emulator User's Manual 2.3 Break Functions The E8a emulator has the following four break functions. (1) Hardware break function H8 R8C series Uses a break controller incorporated in the device. The access address, instruction fetch address, data, or bus ...

Page 27

E8a Emulator User's Manual 2.4 Memory Access Functions The emulator has the following memory access functions. (1) Memory read/write function [Memory] window: The memory contents are displayed in the window. Only the amount specified when the [Memory] window is opened ...

Page 28

E8a Emulator User's Manual (6) Other memory operation functions Other functions are as follows: • Memory fill • Memory copy • Memory save • Memory verify • Memory search • Internal I/O display • Displaying label and variable names and ...

Page 29

E8a Emulator User's Manual 2.7 Online Help An online help explains the usage of each function or the command syntax that can be entered from the command line window. Select [Emulator Help] from the [Help] menu to view the emulator ...

Page 30

E8a Emulator User's Manual REJ10J1655-0400 Rev.4.00 Apr 30, 2010 2. E8a Emulator Functions Page 14 of 158 ...

Page 31

E8a Emulator User's Manual Section 3 Preparation before Use 3.1 Emulator Preparation Unpack the emulator and prepare it for use as follows: READ the reference sections shaded in Figure 3.1 before using the emulator product. Incorrect operation will damage the ...

Page 32

E8a Emulator User's Manual 3.2 Emulator Hardware Configuration As shown in Figure 3.2, the emulator consists of an emulator, a USB cable, and a user system interface cable. The emulator is connected to the host computer via USB 1.1, and ...

Page 33

E8a Emulator User's Manual The names of each section of the emulator are explained next. Emulator Upper-side Panel: (a) ACT LED: (b) VCC LED: REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Figure 3.3 Emulator Upper-side Panel An LED to show the operating ...

Page 34

E8a Emulator User's Manual Emulator Host-Computer-Side Panel: Figure 3.4 Emulator Host-Computer-Side Panel (a) Host-side connector: (b) Portable strap hole: REJ10J1655-0400 Rev.4.00 Apr 30, 2010 A USB cable connector to connect the emulator to the host computer. Be sure to connect ...

Page 35

E8a Emulator User's Manual Emulator User-System-Side Panel: Figure 3.5 Emulator User-System-Side Panel (a) User-system-side connector: REJ10J1655-0400 Rev.4.00 Apr 30, 2010 A user system interface cable is connected. 3. Preparation before Use Page 19 of 158 ...

Page 36

E8a Emulator User's Manual Emulator Bottom Panel: (a) Seal for product management: The serial number and a description of the emulator are REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Figure 3.6 Emulator Bottom Panel written on the seal. The actual written content ...

Page 37

E8a Emulator User's Manual Emulator Left-Side Panel: (a) Self-check connector: (b) Cover for self-check connector: REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Figure 3.7 Emulator Left-Side Panel A connector for the user system interface cable when the E8aSCP (self-check program) is run. ...

Page 38

... E8a Emulator User's Manual 3.3 Emulator Software Configuration The following item is included with the emulator debugger when it is purchased: • E8a Emulator Software: R0E00008AKCE00SR (CD) 3.3.1 CD Install the software as instructed by the displayed messages by inserting the included CD into the CD-ROM drive. The folders contain the files and programs listed below. ...

Page 39

E8a Emulator User's Manual 3.4 Installing Emulator’s Debugger When the CD is inserted in the host computer’s CD drive, execute HewInstMan.exe from the root directory of the CD. REJ10J1655-0400 Rev.4.00 Apr 30, 2010 3. Preparation before Use Page 23 of ...

Page 40

E8a Emulator User's Manual 3.5 Connecting the Emulator to the Host Computer This section describes how to connect the emulator to the host computer. For the position of each connector of the emulator, refer to section 3.2, Emulator Hardware Configuration. ...

Page 41

E8a Emulator User's Manual The emulator is connected to the host computer via the USB 1.1, and also to the USB port conforming to USB 2.0. Figure 3.8 shows the system configuration. Figure 3.8 System Configuration when Connecting the Emulator ...

Page 42

E8a Emulator User's Manual 3.6 Connecting the Emulator to the User System Use the procedure below to connect the emulator to the user system with the user system interface cable disconnect them when moving the emulator or the ...

Page 43

E8a Emulator User's Manual (2) The pin assignments of the connector are shown in the section of ‘Pin Assignments of the E8/E8a Connector’ in the additional documents for the E8a emulator user’s manual. User system interface cable Figure 3.9 Connecting ...

Page 44

E8a Emulator User's Manual 3.7 Connecting System Ground Separate the frame ground from the signal ground at the user system. Failure will result in a FIRE HAZARD and will damage the user system and the emulator product ...

Page 45

E8a Emulator User's Manual 3.8 System Check When the software is executed, use the procedure below to check that the emulator is connected correctly. Here, use the workspace for a tutorial provided on the product. Refer to section 4, Preparations ...

Page 46

E8a Emulator User's Manual When the [Open workspace] dialog box is opened, specify the following directory: <OS installation directory> \WorkSpace\Tutorial\E8\xxxx\Tutorial After the directory has been specified, select the following file and click the [Open] button. Figure 3.12 [Open Workspace] Dialog ...

Page 47

E8a Emulator User's Manual H8/Super Low Power Drive where the OS has been installed: \WorkSpace\Tutorial\E8a\H8\TutorialSLP 6. The [Emulator Setting] dialog box is displayed. Figure 3.13 [Emulator Setting] Dialog Box Select the device name in use from the [MCU Group] drop-down ...

Page 48

E8a Emulator User's Manual Note: The emulator occupies the user’s flash memory area according to the target MCUs. For details, refer to the additional document, Notes on Connecting the xxxxx. ⎯ Keep Flash and Connect This mode is used to ...

Page 49

E8a Emulator User's Manual Before carrying out the power supply, check the power specification of the user system and there is no short circuit in the user system. Incorrect operation will damage the user system and the emulator product. The ...

Page 50

E8a Emulator User's Manual 8. When the version of the E8a firmware downloaded into the emulator is old, the message box shown in Figure 3.15 will be displayed. Figure 3.15 Dialog Box for confirming the E8a firmware download Note: When ...

Page 51

E8a Emulator User's Manual When no power is supplied from the emulator, click the [OK] button without selecting the [Power Target from Emulator. (MAX 300mA)] check box. When power is supplied from the emulator, select the [Power Target from Emulator. ...

Page 52

E8a Emulator User's Manual 11. When "Connected" is displayed in the [Output] window of the High-performance Embedded Workshop, the emulator initiation is completed Figure 3.18 High-performance Embedded Workshop Window Note: When the user program has already been downloaded to the ...

Page 53

E8a Emulator User's Manual Notes the user system interface cable is disconnected from the connector on the user system, the following dialog box will appear. Figure 3.19 [Connector disconnected] Dialog Box 2. If the emulator is not properly ...

Page 54

E8a Emulator User's Manual Figure 3.21 [Error sending Flash memory write program] Dialog Box (c) The following dialog box is displayed when an incorrect ID code has been input. For the H8/Tiny, H8/Super Low Power, R8C/10, 11, 12 and 13, ...

Page 55

E8a Emulator User's Manual incorrect driver has been selected, the following dialog box will appear. Figure 3.24 [Unable to restore the previous driver settings] Dialog Box REJ10J1655-0400 Rev.4.00 Apr 30, 2010 3. Preparation before Use Page 39 ...

Page 56

E8a Emulator User's Manual 3.9 Uninstalling the Emulator’s Debugger Follow this procedure to remove the installed emulator’s debugger from the user’s host computer. As the installed product is known by the High-performance Embedded Workshop, uninstall the product on the High-performance ...

Page 57

E8a Emulator User's Manual Click the [+] mark at the left of [Debugger Components] in the [Registered components] list box to list the installed components. Then, highlight the product name to be uninstalled. Figure 3.27 Highlighting the Product to be ...

Page 58

E8a Emulator User's Manual Figure 3.29 [Uninstall HEW Tool] Dialog Box Click the [Start] button to list the installed components. Figure 3.30 Highlighting the Product to be Uninstalled REJ10J1655-0400 Rev.4.00 Apr 30, 2010 3. Preparation before Use Page 42 of ...

Page 59

E8a Emulator User's Manual Highlight the product name to be uninstalled and click the [Uninstall] button. This is the end of uninstallation. A shared file may be detected while the program is being removed. If another product may be using ...

Page 60

E8a Emulator User's Manual REJ10J1655-0400 Rev.4.00 Apr 30, 2010 3. Preparation before Use Page 44 of 158 ...

Page 61

E8a Emulator User's Manual Section 4 Preparations for Debugging 4.1 Method for Activating High-performance Embedded Workshop To activate the High-performance Embedded Workshop, follow the procedure listed below. 1. Connect the emulator to the host computer and the user system, then ...

Page 62

E8a Emulator User's Manual 4.1.1 Creating the New Workspace (Toolchain Not Used the [Welcome!] dialog box that is displayed when the High-performance Embedded Workshop is activated, select [Create a new project workspace] radio button and click the [OK] ...

Page 63

E8a Emulator User's Manual Figure 4.3 [New Project Workspace] Dialog Box [Workspace Name] edit box: Enter the new workspace name. Here, enter ‘test’. [Project Name] edit box: [CPU family] drop-down list box: Select the target CPU family. [Tool chain] drop-down ...

Page 64

E8a Emulator User's Manual 3. The following dialog box is displayed. Figure 4.4 [Setting the Target System for Debugging] Dialog Box Select the target system for debugging and click the [Next] button. [Target system for debugging] M32C E8a SYSTEM: M16C ...

Page 65

E8a Emulator User's Manual Figure 4.5 [Setting the Debugger Options] Dialog Box This is the end of the emulator setting. Click the [Finish] button to exit the Project Generator. The High-performance Embedded Workshop is activated. 5. After the High-performance Embedded ...

Page 66

E8a Emulator User's Manual 4.1.2 Creating the New Workspace (Toolchain Used the [Welcome!] dialog box that is displayed when the High-performance Embedded Workshop is activated, select [Create a new project workspace] radio button and click the [OK] button. ...

Page 67

E8a Emulator User's Manual [Workspace Name] edit box: [Project Name] edit box: [CPU family] drop-down list box: Select the target CPU family. [Tool chain] drop-down list box: [Project type] list box: REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Enter the new workspace ...

Page 68

E8a Emulator User's Manual 3. Make the required setting for the toolchain. Figure 4.8 [New Project-1/6-Select Target CPU. Toolchain version] Dialog Box Select your toolchain version, CPU series and click the [Next] button. REJ10J1655-0400 Rev.4.00 Apr 30, 2010 4. Preparations ...

Page 69

E8a Emulator User's Manual 4. Make the required settings for the RTOS. Figure 4.9 [New Project-2/6-Select RTOS] Dialog Box Select the RTOS you use, type of startup file and click the [Next] button. Note: In the H8/Tiny, H8/Super Low Power ...

Page 70

E8a Emulator User's Manual 5. Make the required settings for the heap area etc. Figure 4.10 [New Project-3/6-Setting the Contents of Files to be Generated] Dialog Box Set the heap size etc. and click the [Next] button. Note: In the ...

Page 71

E8a Emulator User's Manual 6. Make the required setting for the stack area. Figure 4.11 [New Project-4/6-Setting the Stack Area] Dialog Box Set the stack size and click the [Next] button. REJ10J1655-0400 Rev.4.00 Apr 30, 2010 4. Preparations for Debugging ...

Page 72

E8a Emulator User's Manual 7. When the tool chain settings have been completed, the following dialog box is displayed. Figure 4.12 [New Project-5/6-Setting the Target System for Debugging] Dialog Box Select the target system for debugging and click the [Next] ...

Page 73

E8a Emulator User's Manual 8. Set a configuration file name. The configuration file saves the settings of the High- performance Embedded Workshop except for the emulator. Figure 4.13 [New Project-6/7-Setting the Debugger Options] Dialog Box REJ10J1655-0400 Rev.4.00 Apr 30, 2010 ...

Page 74

E8a Emulator User's Manual 9. Finally, confirm the file name you create. Figure 4.14 [New Project-7/7-Changing the File Names to be Created] Dialog Box The files which will be generated by the High-performance Embedded Workshop are displayed If you want ...

Page 75

E8a Emulator User's Manual 10. After the High-performance Embedded Workshop has been activated, connect the emulator. However not needed to connect the emulator immediately after the High-performance Embedded Workshop has been activated. To connect the emulator, use one ...

Page 76

E8a Emulator User's Manual (b) Connecting the emulator without the setting at emulator activation The emulator can be easily connected by switching the session file that the setting for the emulator use has been registered. In the list box that ...

Page 77

E8a Emulator User's Manual 4.1.3 Selecting an Existing Workspace 1. In the [Welcome!] dialog box that is displayed when the High-performance Embedded Workshop is activated, select [Browse to another project workspace] radio button and click the [OK] button. REJ10J1655-0400 Rev.4.00 ...

Page 78

E8a Emulator User's Manual 2. The [Open Workspace] dialog box is displayed. Select a directory in which you have created a workspace. After that, select the workspace file (.hws) and press the [Open] button. Figure 4.17 [Open Workspace] Dialog Box ...

Page 79

E8a Emulator User's Manual 4.2 Setting at E8a Emulator Activation 4.2.1 Setting at Emulator Activation When the emulator is activated, the command chain can be automatically executed also possible to register multiple load modules to be downloaded. The ...

Page 80

E8a Emulator User's Manual Figure 4.19 [Debug Settings] Dialog Box ([Options] Page) The command chain that is automatically executed at the specified timing is registered. The following three timings can be specified: • At connecting the emulator • Immediately before ...

Page 81

E8a Emulator User's Manual 4.2.2 Downloading a Program A download module is added under [Download modules] in the [Workspace] window. Open the load module of [Download modules] in the [Workspace] window by clicking the right- hand mouse button and select ...

Page 82

E8a Emulator User's Manual 4.2.3 Setting the [Program Flash] Mode The following describes the procedures when the emulator is used as the programming tool. The load module to be downloaded to the new workspace is registered and programmed. (a) Select ...

Page 83

E8a Emulator User's Manual (b) Select the target MCU and click the [Next] button. Figure 4.22 [Setting the Target System for Debugging] Dialog Box REJ10J1655-0400 Rev.4.00 Apr 30, 2010 4. Preparations for Debugging Page 67 of 158 ...

Page 84

E8a Emulator User's Manual (c) Set a configuration file name and click the [Finish] button. Figure 4.23 [Setting he Debugger Options] Dialog Box REJ10J1655-0400 Rev.4.00 Apr 30, 2010 4. Preparations for Debugging Page 68 of 158 ...

Page 85

E8a Emulator User's Manual (d) The [Emulator Setting] dialog box is displayed. Figure 4.24 [Emulator Setting] Dialog Box Select the [Program Flash] mode. When the [Power Target from Emulator. (MAX 300mA)] check box is selected, power will be supplied to ...

Page 86

E8a Emulator User's Manual (e) When [Power Target from Emulator. (MAX 300mA)] is not checked, the dialog box shown in Figure 4.25 will be displayed. Figure 4.25 Dialog Box of Power-on request message When [Power Target from Emulator. (MAX 300mA)] ...

Page 87

E8a Emulator User's Manual (g) Select [Debug Settings…] from the [Debug] menu. Figure 4.27 High-performance Embedded Workshop Window REJ10J1655-0400 Rev.4.00 Apr 30, 2010 4. Preparations for Debugging Page 71 of 158 ...

Page 88

E8a Emulator User's Manual (h) Select the target MCU and then the download module with the [Add…] button. Figure 4.28 [Debug Settings] Dialog Box ([Target] Page) (i) The download file is displayed on [Projects]. Figure 4.29 [Workspace] Window ([Projects]) REJ10J1655-0400 ...

Page 89

E8a Emulator User's Manual (j) Select and download the file with the right-hand mouse button. Figure 4.30 Download Menu of the [Workspace] Window ([Projects]) (k) The dialog box for sum checking is displayed and writing is completed. Figure 4.31 Message ...

Page 90

E8a Emulator User's Manual (l) When the following dialog box is displayed, close and restart or exit the workspace. Figure 4.32 Message for Restarting or Exiting the [Program Flash] Mode REJ10J1655-0400 Rev.4.00 Apr 30, 2010 4. Preparations for Debugging Page ...

Page 91

E8a Emulator User's Manual This section describes the debugging operations and their related windows and dialog boxes. For details on the common functions of the High-performance Embedded Workshop products, refer to the High-performance Embedded Workshop User’s Manual. 5.1 Setting the ...

Page 92

E8a Emulator User's Manual 5.1.2 [General] Page Sets the emulator operation conditions. Figure 5.1 [Configuration] Dialog Box ([General] Page) Items that can be displayed in the sheet are listed below. [ Device] combo box [Emulation mode] combo box [User interface ...

Page 93

E8a Emulator User's Manual [Flash memory synchronization] combo box Note: This dialog box differs depending on products. For details, refer to the online help. REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Selects whether or not the contents of the flash memory are ...

Page 94

E8a Emulator User's Manual 5.2 Downloading a Program This section describes how to download a program and view it as source code or assembly- language mnemonics. Note: After a break has been detected, the High-performance Embedded Workshop displays the location ...

Page 95

E8a Emulator User's Manual 5.2.2 Viewing the Source Code Select a source file name in the [Workspace] window and click [Open] in the popup menu to make the High-performance Embedded Workshop display the source file in the editor ...

Page 96

E8a Emulator User's Manual In this window, the following items are shown on the left as line information. The first column (Line Number column) Line number The second column (Source address column): Address information The third column (Event column): Event ...

Page 97

E8a Emulator User's Manual To switch off a column in all source files 1. Click the right-hand mouse button on the [Source] window or select the [Edit] menu. 2. Click the [Define Column Format…] menu item. 3. The [Global Editor ...

Page 98

E8a Emulator User's Manual 5.3 Stopping Your Program This section describes how you can halt execution of your application's code. This section describes how to stop the program by setting an address match breakpoints at specific locations in your code. ...

Page 99

E8a Emulator User's Manual 5.4 Using the Event Points The emulator has the event point function that performs breaking by specifying higher-level conditions along with the PC breakpoints standard for the High-performance Embedded Workshop. 5.4.1 PC Breakpoints When the instruction ...

Page 100

E8a Emulator User's Manual This window displays and sets the breakpoints. Items that can be displayed in the sheet are listed below. [Type] Breakpoint [State] Whether the breakpoint is enabled or disabled [Condition] An address that the breakpoint is set ...

Page 101

E8a Emulator User's Manual 5.4. Source Only enabled when one breakpoint is selected. Opens the [Source] window at the address of the breakpoint. 5.4.12 [Set Break] Dialog Box This dialog box specifies break conditions. A breakpoint address to ...

Page 102

E8a Emulator User's Manual Notes on Setting the [Set Break] Dialog Box 1. When an odd address is set for the H8/Tiny and H8/Super Low Power series, the address is rounded down to an even address Breakpoint is ...

Page 103

E8a Emulator User's Manual Notes on Setting the Break Condition: 1. When [Go to cursor], [Step In], [Step Over], or [Step Out] is selected, the settings of Break Condition 1 are disabled. 2. Setting of Break Condition 1 is disabled ...

Page 104

E8a Emulator User's Manual 5.4.16 Disable Disables the selected break channel(s). When a break channel is disabled, a break will not occur even if specified conditions have been satisfied. 5.4.17 Delete Initializes the condition of the selected break channel. To ...

Page 105

E8a Emulator User's Manual 5.4.25 Deleting Break Conditions Select a break condition and choose [Delete] from the popup menu to remove the selected break condition. To retain the break condition but not have it cause an event when its conditions ...

Page 106

E8a Emulator User's Manual The [Address] group box sets address bus conditions. Option [Don’t care] check box [Address] radio button [Only program fetched address after] radio button [Address] edit box [Mask] edit box The contents of an option that can ...

Page 107

E8a Emulator User's Manual 5.5 Viewing the Trace Information For the description on the trace function, refer to section 2.2, Trace Functions. 5.5.1 Opening the [Trace] Window To open the [Trace] window, choose [View -> Code -> Trace] or click ...

Page 108

E8a Emulator User's Manual 5.5.3 Clearing the Trace Information When [Clear] is selected from the popup menu, the trace buffer that stores the trace information becomes empty. If several [Trace] windows are open, all [Trace] windows will be cleared as ...

Page 109

E8a Emulator User's Manual 5.6 Using the Start/Stop Function The emulator executes the specified routine of the user program immediately before starting and immediately after halting program execution. This function is used to control the user system in synchronization with ...

Page 110

E8a Emulator User's Manual If no specified routine is executed immediately before starting user program execution, do not select the [The specified routine is executed immediately before execution of the user’s program.] check box. When the [The specified routine is ...

Page 111

E8a Emulator User's Manual 5.6.3 Restrictions on the Start/Stop Function The start/stop function has the following restrictions. • Do not change the SFR used by the firmware. • When the watchdog timer is used, refresh the watchdog timer in the ...

Page 112

E8a Emulator User's Manual REJ10J1655-0400 Rev.4.00 Apr 30, 2010 5. Debugging Page 96 of 158 ...

Page 113

E8a Emulator User's Manual 6.1 Introduction This section describes the main functions of the emulator by using a tutorial program. The tutorial program is based on the C program that sorts ten random data items in ascending or descending order. ...

Page 114

E8a Emulator User's Manual 6.2 Running the High-performance Embedded Workshop To run the High-performance Embedded Workshop, refer to section 3.8, System Check. 6.3 Setting up the E8a Emulator This section describes the basic settings of the emulator. REJ10J1655-0400 Rev.4.00 Apr ...

Page 115

E8a Emulator User's Manual 6.4 Setting the [Configuration] Dialog Box • Select [Emulator] then [Systems…] from the [Setup] menu for the basic settings of the emulator. The [Configuration] dialog box is displayed. Note: The items that can be set in ...

Page 116

E8a Emulator User's Manual Set options as follows: Table 6.1 [General] Page Options Option Device Emulation mode User interface clock Flash memory synchronization Click the [OK] button to set a configuration. REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Select a device you ...

Page 117

E8a Emulator User's Manual 6.5 Checking the Operation of RAM Check that RAM is operating correctly. Display and edit the contents of the memory in the [Memory] window to check that the memory is operating correctly. Note: The memory can ...

Page 118

E8a Emulator User's Manual • Placing the mouse cursor on a point in the display of data in the [Memory] window and double-clicking allows the values at that point to be changed. Data can also be directly edited around the ...

Page 119

E8a Emulator User's Manual 6.6 Downloading the Tutorial Program 6.6.1 Downloading the Tutorial Program Download the object program to be debugged. In this emulator enabled to download the program and set the PC breakpoint in the internal flash ...

Page 120

E8a Emulator User's Manual 6.6.2 Displaying the Source Program The High-performance Embedded Workshop allows the user to debug a user program at the source level. • Double-click [tutorial.c] under [C source file]. Figure 6.5 [Source] Window (Displaying the Source Program) ...

Page 121

E8a Emulator User's Manual 6.7 Setting a PC Breakpoint A PC breakpoint is a simple debugging function. The [Source] window provides a very simple way of setting a PC breakpoint at any point in a program. For example, to set ...

Page 122

E8a Emulator User's Manual 6.8 Setting Registers Set values of the program counter and the stack pointer before executing the program. • Select [Registers] from the [CPU] submenu of the [View] menu. The [Register] window is displayed. REJ10J1655-0400 Rev.4.00 Apr ...

Page 123

E8a Emulator User's Manual • To change the value of the program counter (PC), double-click the value area in the [Register] window with the mouse. The following dialog box is then displayed, and the value can be changed. Set the ...

Page 124

E8a Emulator User's Manual 6.9 Executing the Program Execute the program as described in the following: • To execute the program, select [Go] from the [Debug] menu, or click the [Go] button on the toolbar. When the program execution is ...

Page 125

E8a Emulator User's Manual Figure 6.10 [Source] Window (Break State) REJ10J1655-0400 Rev.4.00 Apr 30, 2010 6. Tutorial Page 109 of 158 ...

Page 126

E8a Emulator User's Manual The user can see the cause of the break that occurred last time in the [Status] window. • Select [Status] from the [CPU] submenu of the [View] menu. After the [Status] window is displayed, open the ...

Page 127

E8a Emulator User's Manual 6.10 Reviewing Breakpoints The user can see all the breakpoints set in the program in the [Event] window. • Select [Eventpoints] from the [Code] submenu of the [View] menu. The [Event] window is displayed. Select the ...

Page 128

E8a Emulator User's Manual 6.11 Viewing Memory When the label name is specified, the user can view the memory contents that the label has been registered in the [Memory] window. For example, to view the memory contents corresponding to _main ...

Page 129

E8a Emulator User's Manual 6.12 Watching Variables As the user steps through a program possible to watch that the values of variables used in the user program are changed. For example, set a watch on the long-type array ...

Page 130

E8a Emulator User's Manual The user can also add a variable to the [Watch] window by specifying its name. • Click the [Watch] window with the right-hand mouse button and select [Add Watch…] from the popup menu. The following dialog ...

Page 131

E8a Emulator User's Manual The user can click mark ‘+’ at the left side of array a in the [Watch] window to watch all the elements. Figure 6.19 [Watch] Window (Displaying Array Elements) REJ10J1655-0400 Rev.4.00 Apr 30, 2010 6. Tutorial ...

Page 132

E8a Emulator User's Manual 6.13 Stepping Through a Program The High-performance Embedded Workshop provides a range of step menu commands that allow efficient program debugging. Table 6.2 Step Option Menu Command Step In Executes each statement, including statements within functions. ...

Page 133

E8a Emulator User's Manual 6.13.2 Executing [Step Out] Command The [Step Out] command steps out of the called function and stops at the next statement of the calling statement in the main function. • To step out of the sort ...

Page 134

E8a Emulator User's Manual 6.13.3 Executing [Step Over] Command The [Step Over] command executes a function call as a single step and stops at the next statement of the main program. • To step through all statements in the change ...

Page 135

E8a Emulator User's Manual 6.14 Forced Breaking of Program Executions The High-performance Embedded Workshop can force a break in the execution of a program. • Cancel all breaks. • To execute the remaining sections of the main function, select [Go] ...

Page 136

E8a Emulator User's Manual 6.15 Displaying Local Variables The user can display local variables in a function using the [Locals] window. For example, we will examine the local variables in the main function, which declares four local variables ...

Page 137

E8a Emulator User's Manual 6.16 Break Function The emulator has PC and hardware break functions. With the High-performance Embedded Workshop breakpoint can be set using the [Breakpoint] sheet of the [Event] window, and a hardware break condition can ...

Page 138

E8a Emulator User's Manual • Click the [Event] window with the right-hand mouse button and select [Add…] from the popup menu. • Enter H'0E1FE in the [Address] edit box. • Click the [OK] button. REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Figure ...

Page 139

E8a Emulator User's Manual The PC breakpoint that has been set is displayed in the [Event] window. Figure 6.31 [Event] Window (PC Breakpoint Setting) To stop the tutorial program at the PC breakpoint, the following procedure must be executed: • ...

Page 140

E8a Emulator User's Manual The [Status] window displays the following contents. Figure 6.33 Displayed Contents of the [Status] Window (PC Break) Note: The items that can be set in this window differ depending on the product. For the settings for ...

Page 141

E8a Emulator User's Manual 6.17 Hardware Break Function A method is given below in which the address bus condition is set under Break Condition 1 as hardware break conditions. • Select [Eventpoints] from the [Code] submenu of the [View] menu. ...

Page 142

E8a Emulator User's Manual • The [Break condition 1] dialog box is displayed. • Clear the [Don't care] check box in the [Address] group box. • Select the [Only program fetched address after] radio button and enter H'0E1F2 as the ...

Page 143

E8a Emulator User's Manual The program runs and then stops at the condition specified under Break Condition 1. Figure 6.36 [Source] Window at Execution Stop (Break Condition 1) The [Status] window displays the following contents. Figure 6.37 Displayed Contents of ...

Page 144

E8a Emulator User's Manual 6.18 Trace Functions The emulator has a branch-instruction trace function. The branch source addresses, mnemonics, operands, source lines, and labels are displayed for four branches. Note: The trace function uses the trace buffer housed in the ...

Page 145

E8a Emulator User's Manual 6.19 Stack Trace Function The emulator uses the information on the stack to display the names of functions in the sequence of calls that led to the function to which the program counter is currently pointing. ...

Page 146

E8a Emulator User's Manual • After the break in program execution, select [Stack Trace] from the [Code] submenu of the [View] menu to open the [Stack Trace] window. Figure 6.40 shows that the position of the program counter is currently ...

Page 147

E8a Emulator User's Manual 6.20 What Next? This tutorial has described the major features of the emulator and the use of the High-performance Embedded Workshop. Sophisticated debugging can be carried out by using the emulation functions that the emulator offers. ...

Page 148

E8a Emulator User's Manual REJ10J1655-0400 Rev.4.00 Apr 30, 2010 6. Tutorial Page 132 of 158 ...

Page 149

... E8a Emulator User's Manual Appendix A Components of the E8a Emulator Table A.1 lists the components of the E8a emulator. Table A.1 Components of the Emulator (R0E00008AKCE00) Classi- Component fication Hard- E8a emulator ware (Model: R0E00008AKCE00) User system interface cable USB cable Soft- E8a emulator setup ...

Page 150

E8a Emulator User's Manual Note: To our customers, On April 1st, 2010, NEC Electronics Corporation merged with Renesas Technology Corporation, and Renesas Electronics Corporation took over all the business of both companies. Therefore, although the old company name remains in ...

Page 151

E8a Emulator User's Manual Appendix B Window Functions This section describes the window functions that can be used with the High-performance Embedded Workshop for E8a emulator. Here, the High-performance Embedded Workshop common functions are omitted, and only the emulation functions ...

Page 152

E8a Emulator User's Manual Table B.1 Window Functions (cont) Menu Option Setup Radix Hexadecimal Decimal Octal Binary Emulator System… Emulator Setting… Start/Stop Function Setting… Debug Debug Sessions… Debug Settings… Reset CPU Go Reset Go REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Appendix ...

Page 153

E8a Emulator User's Manual Table B.1 Window Functions (cont) Menu Option Debug Go To Cursor (cont) Set PC To Cursor Run… Display PC Step In Step Over Step Out Step… Step Auto Mode Assembly Source Halt Program Initialize Connect REJ10J1655-0400 ...

Page 154

E8a Emulator User's Manual Table B.1 Window Functions (cont) Menu Option Debug Disconnect (cont) Save Memory… Verify Memory… Download Modules Unload Modules REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Toolbar Shortcut Button Disconnects the debugging platform. This option cannot be used in ...

Page 155

E8a Emulator User's Manual Appendix C Command-Line Functions The emulator supports the commands that can be used in the command-line window. For details, refer to the online help. REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Appendix C Command-Line Functions Page 139 of ...

Page 156

E8a Emulator User's Manual REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Appendix C Command-Line Functions Page 140 of 158 ...

Page 157

E8a Emulator User's Manual Appendix D Notes on High-performance Embedded 1. Note on Moving Source File Position after Creating Load Module When the source file is moved after creating the load module, the [Open] dialog box may be displayed to ...

Page 158

E8a Emulator User's Manual ⎯ Variable updating For updating of the content of the variable that has been registered in the [Watch] window, read the data after the break in user program execution. The realtime operation for the user program ...

Page 159

E8a Emulator User's Manual 10. Note on [Register] Window Operation During Program Execution The register value cannot be changed in the [Register] window during program execution. Even if the changed value is displayed, the register contents are not changed actually. ...

Page 160

E8a Emulator User's Manual ⎯ MEMORY_FILL command The [Format] specification in the [Copy Memory] dialog box is ignored. Memory is copied in a byte unit. 17. Note on Using the [Run Program] Dialog Box When [Run...] is selected from the ...

Page 161

E8a Emulator User's Manual 24 Usage with Other Products To install the SuperH™ RISC engine C/C++ compiler package or H8, H8/300 series C/C++ compiler package after installing the emulator debugger for High-performance Embedded Workshop, select [High-performance Embedded Workshop] as the ...

Page 162

E8a Emulator User's Manual REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Appendix D Notes on High-performance Embedded Workshop Page 146 of 158 ...

Page 163

E8a Emulator User's Manual Appendix E E8aSCP (E8a Self-Check Program) This appendix describes the troubleshooting procedure that applies the self-check program for the E8a emulator (E8aSCP). E.1. Flowchart of the Procedure to Execute the Self-Check Program Install the High-performance Embedded ...

Page 164

E8a Emulator User's Manual E.2. System Setup to Execute the E8aSCP (1) The following equipment is required to execute the check program. • E8a emulator main unit • USB cable included with the E8a emulator • User system interface cable ...

Page 165

E8a Emulator User's Manual Insert the user system interface cable into the self-check connector with the faulty-insertion-prevention nose below. Figure E.2 Connecting the User System Interface Cable to the Self-Check Connector Connecting to the Self-Check Connector: ● Make sure to ...

Page 166

E8a Emulator User's Manual E.3. Executing the Self-Check Program (1) Execute [Program]-[Renesas]-[High-performance Embedded Workshop]-[E8a Self Check Program]. REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Appendix E E8aSCP (E8a Self-Check Program) Figure E.3 Starting Up the E8aSCP Page 150 of 158 ...

Page 167

E8a Emulator User's Manual (2) Click the ‘START’ button. The following message will be displayed: ‘Please confirm that the User interface cable is connected to the self-check connector in a correct direction’. Confirm that the user system interface cable is ...

Page 168

E8a Emulator User's Manual (3) The message ‘TEST1 is running.’ or ‘TEST2 is running.’ will appear in the window. This indicates the start of the self-check program. Figure E.5 Running the Self-Check Program REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Appendix E ...

Page 169

E8a Emulator User's Manual (4) When ‘TEST3 is waiting.’ starts, the following message will be displayed: ‘Please remove the User interface cable from the self-check connector to execute TEST3.’ When the above message is displayed, remove the user system interface ...

Page 170

E8a Emulator User's Manual (5) The message ‘TEST3 is running.’ will appear in the window. This starts execution of the self- check program. Figure E.7 Running the Self-Check Program REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Appendix E E8aSCP (E8a Self-Check Program) ...

Page 171

E8a Emulator User's Manual (6) The message ‘PASS’ or ‘FAIL’ will be displayed. ‘PASS’ indicates that the emulator is working correctly. Click the [QUIT] button to exit the self-check program. Figure E.8 Quitting the Self-Check Program REJ10J1655-0400 Rev.4.00 Apr 30, ...

Page 172

E8a Emulator User's Manual If ‘FAIL’ is displayed during execution of the self-check program, the content of an error is displayed at the center of the window. Table E.1 shows error messages. Clicking the [LOG] button opens the dialog box ...

Page 173

E8a Emulator User's Manual Table E.1 Error Messages Error Message The E8a has failed. Please connect the User interface cable with the self-check connector in a correct direction. Because the User interface cable was connected with to self-check connector, TEST3 ...

Page 174

E8a Emulator User's Manual REJ10J1655-0400 Rev.4.00 Apr 30, 2010 Appendix E E8aSCP (E8a Self-Check Program) Page 158 of 158 ...

Page 175

... E8a Emulator (R0E00008AKCE00) User's Manual Publication Date: Apr 30, 2010 Published by: Renesas Electronics Corporation Microcomputer Tool Development Department 2 Edited by: Renesas Solutions Corporation Rev.4.00 ...

Page 176

... SALES OFFICES Refer to "http://www.renesas.com/" for the latest and detailed information. Renesas Electronics America Inc. 2880 Scott Boulevard Santa Clara, CA 95050-2554, U.S.A. Tel: +1-408-588-6000, Fax: +1-408-588-6130 Renesas Electronics Canada Limited 1101 Nicholson Road, Newmarket, Ontario L3Y 9C3, Canada Tel: +1-905-898-5441, Fax: +1-905-898-3220 Renesas Electronics Europe Limited Dukes Meadow, Millboard Road, Bourne End, Buckinghamshire, SL8 5FH, U ...

Page 177

... E8a Emulator (R0E00008AKCE00) Additional Document for User's Manual REJ10J1655-0400 ...