Renesas Emulator System E8 Manual do Utilizador

To our customers, Old Company Name in Catalogs and Other Documents On April 1st, 2010, NEC Electronics Corporation merged with Renesas Technology C

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 t

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

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 ar

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

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 t

The [Address] group box sets address bus conditions. Option Description [Don’t care] check box Does not set address conditions. [Address] radio butto

5.5 Viewing the Trace Information For the description on the trace function, refer to section 2.2, Trace Functions. Note: The R8C/Tiny series MCUs d

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.

5.6 Using the Start/Stop Function The emulator executes the specified routine of the user program immediately before starting and immediately after ha

If no specified routine is executed immediately before starting user program execution, do not select the [The specified routine is executed immediate

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.

WARNING 1. Do not repair or remodel the emulator product by yourself for electric shock prevention and quality assurance. 2. Always swit

92

Section 6 Tutorial 6.1 Introduction This section describes the main functions of the emulator by using a tutorial program. The tutorial program is

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

6.4 Setting the [Configuration] Dialog Box • Select [Emulator] then [Systems…] from the [Setup] menu for the basic settings of the emulator. The [C

Set options as follows: Table 6.1 [General] Page Options Option Value Device Select a device you use Emulation mode Normal (normal execution, defa

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

Figure 6.3 [Memory] Window • Placing the mouse cursor on a point in the display of data in the [Memory] window and double-clicking allows the val

6.6 Downloading the Tutorial Program 6.6.1 Downloading the Tutorial Program Download the object program to be debugged. In this emulator, it is en

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-cl

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 breakpoin

6.8 Setting Registers Set values of the program counter and the stack pointer before executing the program. • Select [Registers] from the [CPU] sub

z 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 t

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

Figure 6.10 [Source] Window (Break State) 105

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.

6.10 Reviewing Breakpoints The user can see all the breakpoints set in the program in the [Eventpoint] window. • Select [Eventpoints] from the [Cod

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] windo

6.12 Watching Variables As the user steps through a program, it is possible to watch that the values of variables used in the user program are chang

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

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 Arr

Contents Contents 1 Section 1 Overview... 1 1.1 Warnings...

6.13 Stepping Through a Program The High-performance Embedded Workshop provides a range of step menu commands that allow efficient program debugging

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

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 p

6.14 Forced Breaking of Program Executions The High-performance Embedded Workshop can force a break in the execution of a program. • Cancel all bre

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

6.16 Break Function The emulator has PC and hardware break functions. With the High-performance Embedded Workshop, a PC breakpoint can be set using

• Click the [Event] window with the right-hand mouse button and select [Add…] from the popup menu. • Enter H'0E1F2 in the [Address] edit box.

The PC breakpoint that has been set is displayed in the [Eventpoint] window. Figure 6.31 [Eventpoint] Window (PC Breakpoint Setting) To stop the tu

The [Status] window displays the following contents. Figure 6.33 Displayed Contents of the [Status] Window (PC Break) Note: The items that can be

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.

5.1.1 Opening the [Configuration] Dialog Box ...71 5.1.2 [General] Page ...

• The [Break condition 1] dialog box is displayed. • Clear the [Don't care] check box in the [Address] group box. • Select the [Only program f

The program runs and then stops at the condition specified under Break Condition 1. Figure 6.36 [Source] Window at Execution Stop (Break Condition

6.18 Trace Functions The emulator has a branch-instruction trace function. The branch source addresses, mnemonics, operands, source lines, and label

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

• 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

6.20 What Next? This tutorial has described the major features of the emulator and the use of the High-performance Embedded Workshop. Sophisticated

128

Appendix A Components of the E8 Emulator Table A.1 lists the components of the R8C E8 emulator. Table A.1 Components of the Emulator (R0E000080KCE

130

Appendix B Window Functions This section describes the window functions that can be used with the High-performance Embedded Workshop for E8 emulator

5.6 Using the Start/Stop Function...89 5.6.1 Opening the

Table B.1 Window Functions (cont) Menu Option ShortcutToolbar ButtonRemarks Setup Radix Hexadecimal Uses a hexadecimal for displaying a radix in

Table B.1 Window Functions (cont) Menu Option ShortcutToolbar Button Remarks Run… Launches the [Run Program] dialog box allowing the user to ent

Table B.1 Window Functions (cont) Menu Option ShortcutToolbar Button Remarks Download Modules Downloads the object program. Unload Modules Un

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 h

136

Appendix D Notes on High-performance Embedded Workshop 1. Note on Moving Source File Position after Creating Load Module When the source file is mo

⎯ 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

10. Note on [Register] Window Operation During Program Execution The register value cannot be changed in the [Register] window during program executio

⎯ 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 [

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 th

E.1. System Setup to Execute the Check Program...143 E.2. Executing the Check Progra

142

Appendix E Diagnostic Hardware Program This manual describes the troubleshooting procedure that applies the check program for the E8 emulator. E.1.

(2) Click the ‘START’ button appeared on the window. This starts execution of the check program showing the message ‘RUNNING’. Figure E.2 Running t

E.3 When an Error Occurs (1) If ‘FAIL’ is displayed during execution of the check program, a status number is also displayed at the right bottom of t

146

E8 Emulator User's Manual Publication Date: Aug. 1, 2004 Aug. 1, 2007 Rev.1.00 Rev.10.00 Published by: Sales Str

1753, Shimonumabe, Nakahara-ku, Kawasaki-shi, Kanagawa 211-8668 JapanE8 EmulatorREJ10J0768-1000User’s Manual R0E000080KCE00E

Section 1 Overview The High-performance Embedded Workshop is a Graphical User Interface intended to ease the development and debugging of applicatio

Notice 1. All information included in this document is current as of the date this document is issued. Such information, however, is subject to chang

The emulator has three activation modes: (1) A mode in which the emulator program is started after it has been downloaded to the target device: This

1.1 Warnings CAUTION READ the following warnings before using the emulator product. Incorrect operation will damage the user system and the emulator

1.2 Environmental Conditions CAUTION Observe the conditions listed in tables 1.1 and 1.2 when using the emulator. Failure to do so will cause illegal

1.3 Components Check all the components unpacking. For details on the E8 emulator components, refer to the component list provided at the side of the

6

Section 2 E8 Emulator Functions This section describes the emulator functions. They differ according to the device supported by the emulator. 2.1

Table 2.1 Emulator Functions (cont) No. Item Function 5 Memory access function • Downloading to RAM • Downloading to flash memory • Single-line a

2.2 Trace Functions The branch source addresses, mnemonics, operands, and source lines are displayed. Since this function uses the trace buffer buil

2.3 Break Functions The E8 emulator has the following four break functions. (1) Hardware break function H8 R8C series Uses a break controller incorp

2.4 Memory Access Functions The emulator has the following memory access functions. (1) Memory read/write function [Memory] window: The memory cont

www.renesas-electoronics.comE8 EmulatorUser’s Manual R0E000080KCE00EUser’s ManualRev.10.00 2007.08Renesas Microcomputer Development Environment Syst

(6) Other memory operation functions Other functions are as follows: • Memory fill • Memory copy • Memory save • Memory verify • Memory search

Section 3 Preparation before Use 3.1 Emulator Preparation Unpack the emulator and prepare it for use as follows: WARNING READ the reference sectio

14

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

The names of each section of the emulator are explained next. Emulator Upper-side Panel: (a)(b)(c)(d)(e) Figure 3.3 Emulator Upper-side Panel (a) E

Emulator Host-side Panel: (a) Figure 3.4 Emulator Host-side Panel (a) Host-side connector: A USB connector for the host computer. Be sure to conne

Emulator Bottom Panel: (a) Figure 3.6 Emulator Bottom Panel (a) Seal for product management: The serial number, revision, and safety standard, etc

3.3 Emulator Software Configuration The following item is included with the emulator debugger when it is purchased: • E8 Emulator Debugger: R0E0000

3.4 Installing Emulator’s Debugger When the CD is inserted in the host computer’s CD drive, execute Setup.exe from the root directory of the CD. 20

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 c

1. This document is provided for reference purposes only so that Renesas customers may select the appropriate Renesas products for their use.

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.7 shows the system configurat

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 cab

(2) The pin assignments of the connector are shown in section 2 in the additional documents, Notes on Connecting the xxxxx. Figure 3.9 Connecting t

3.7 Connecting System Ground WARNING Separate the frame ground from the signal ground at the user system. Failure to do so will result in a FIRE HAZ

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 f

When the [Open workspace] dialog box is opened, specify the following directory: <OS installation directory> \WorkSpace\Tutorial\E8\xxxx\Tutoria

6. The [Select Emulator mode] dialog box is displayed. Figure 3.13 [Emulator Setting] Dialog Box Select the device name in use from the [MCU Group

⎯ Program Flash This mode is used when the emulator is used as a flash memory programmer. It cannot be used for debugging programs. Register the load

7. The [Connecting] dialog box is displayed and the emulator connection is started. Figure 3.14 [Connecting] Dialog Box 8. When the version of th

9. When [Power supply is carried out. (MAX 300mA)] is not checked, the dialog box shown in Figure 3.17 will be displayed. Figure 3.16 Dialog Box o

Introduction This manual describes the followings - E8 Emulator functions - Preparation before use - Debugger functions - Tutorial - Appendix: (Comp

11. When [Power supply is carried out. (MAX 300mA)] is not checked, power on the user system and click the [OK] button. 12. When "Connected&qu

Notes: 1. If the user system interface cable is disconnected from the connector on the user system, the following dialog box will appear. Figure 3

(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, if a

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 ins

Click the [+] mark at the left of [Debugger Components] in the [Registered components] list box to list the installed components. Then, highlight the

Figure 3.29 [Uninstall HEW Tool] Dialog Box Click the [Start] button to list the installed components. Figure 3.30 Highlighting the Product to

Highlight the product name to be uninstalled and click the [Uninstall] button. This is the end of uninstallation. CAUTION A shared file may be detecte

Section 4 Preparations for Debugging 4.1 Method for Activating High-performance Embedded Workshop To activate the High-performance Embedded Worksho

4.1.1 Creating the New Workspace (Toolchain Not Used) 1. In the [Welcome!] dialog box that is displayed when the High-performance Embedded Workshop

Figure 4.3 [New Project Workspace] Dialog Box [Workspace Name] edit box: Enter the new workspace name. Here, enter ‘test’. [Project Name] edit bo

Document Conventions This manual uses the following typographic conventions: Table 1 Typographic Conventions Convention Meaning [Menu->Menu Optio

3. The following dialog box is displayed. Figure 4.4 [Setting the Target System for Debugging] Dialog Box Select the target system for debugging a

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 Genera

4.1.2 Creating the New Workspace (Toolchain Used) 1. In the [Welcome!] dialog box that is displayed when the High-performance Embedded Workshop is a

Figure 4.7 [New Project Workspace] Dialog Box 45

[Workspace Name] edit box: Enter the new workspace name. Here, enter ‘test’. [Project Name] edit box: Enter the project name. When the project name

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

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

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 th

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

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

IMPORTANT READ FIRST Before using this product, be sure to read the user’s manual (this user's manual) carefully. Keep this user’s manual, and r

8. Set a configuration file name. The configuration file saves the settings of the High-performance Embedded Workshop except for the emulator. Figu

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

10. After the High-performance Embedded Workshop has been activated, connect the emulator. However, it is not needed to connect the emulator immediate

(b) Connecting the emulator without the setting at emulator activation The emulator can be easily connected by switching the session file that the set

4.1.3 Selecting an Existing Workspace 1. In the [Welcome!] dialog box that is displayed when the High-performance Embedded Workshop is activated, se

2. The [Open Workspace] dialog box is displayed. Select a directory in which you have created a workspace. After that, select the workspace file (.hw

4.2 Setting at E8 Emulator Activation 4.2.1 Setting at Emulator Activation When the emulator is activated, the command chain can be automatically ex

Figure 4.19 [Debug Settings] Dialog Box ([Options] Page) xecuted at the specified timing is registered. The following three timings can be specifi

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]

4.2.3 Setting the Writing Flash Memory Mode The following describes the procedures when the emulator is used as the programming tool. The load module

Usage restrictions: This emulator has been developed as a means of supporting system development by users. Therefore, do not use it as a device used f

(b) Select the target MCU and click the [Next] button. Figure 4.22 [Setting the Target System for Debugging] Dialog Box 62

(c) Set a configuration file name and click the [Finish] button. Figure 4.23 [Setting he Debugger Options] Dialog Box 63

(d) The [Emulator Setting] dialog box is displayed. Figure 4.24 [Select Emulator mode] Dialog Box Select the [Program Flash] mode. When the [Power

(e) When [Power supply is carried out. (MAX 300mA)] is not checked, the dialog box shown in Figure 4.25 will be displayed. Figure 4.25 Dialog Box

(g) Select [Debug Setting…] from the [Debug] menu. Figure 4.27 High-performance Embedded Workshop Window 66

(h) Select the target MCU and then the download module with the [Add…] button. Figure 4.28 [Debug Setting] Dialog Box ([Target] Page) (i) The dow

(j) Select and download the file with the right-hand mouse button. Figure 4.30 Download Menu of the [Workspace] Window ([Project Files]) (k) The

(l) When the following dialog box is displayed, close and restart or exit the workspace. Figure 4.32 Message for Restarting or Exiting Writing Fl

70

Section 5 Debugging This section describes the debugging operations and their related windows and dialog boxes. For details on the common functions

Precautions for Safety READ FIRST Before using this product, be sure to read the user’s manual (this user's manual) carefully. Keep this user’s m

5.1.2 [General] Page Sets the emulator operation conditions. Figure 5.1 [Configuration] Dialog Box ([General] Page) Items that can be displayed in

[Flash memory synchronization] combo box Selects whether or not the contents of the flash memory are acquired by the emulator when the user program is

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

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 Emb

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

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 [

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 p

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 b

This window displays and sets the breakpoints. Items that can be displayed in the sheet are listed below. [Type] Breakpoint [State] Whether the break

5.4.11 Go to Source Only enabled when one breakpoint is selected. Opens the [Source] window at the address of the breakpoint. 5.4.12 [Set Break] Dial