Renesas M3T-ICC740 Manual de usuario

Revision Date: Jun. 21, 2007 Renesas Microcomputer Development Environment SystemR0E00008AKCE00E Rev.1.00 E8a EmulatorUser’s Manual REJ10J

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

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

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

86 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 d

87 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

88 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

89 5.4.25 Deleting Break Conditions Select a break condition and choose [Delete] from the popup menu to remove the selected break condition. To reta

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

91 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] Wi

92 5.5.3 Clearing the Trace Information When [Clear] is selected from the popup menu, the trace buffer that stores the trace information becomes empt

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

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

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

95 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 firmwa

96

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

98 6.2 Running the High-performance Embedded Workshop To run the High-performance Embedded Workshop, refer to section 3.8, System Check. 6.3 Sett

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

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

101 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

102 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 th

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

104 6.6.2 Displaying the Source Program The High-performance Embedded Workshop allows the user to debug a user program at the source level. • Doub

105 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 brea

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

107 • 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

108 6.9 Executing the Program Execute the program as described in the following: • To execute the program, select [Go] from the [Debug] menu, or c

109 Figure 6.10 [Source] Window (Break State)

110 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] m

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

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

113 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

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

114 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 s

115 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 (Displayin

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

117 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 stat

118 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 m

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

120 6.15 Displaying Local Variables The user can display local variables in a function using the [Locals] window. For example, we will examine the

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

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

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

5.3.1 Address Match Breakpoints ... 82 5.4 Using the Event Points..

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

125 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 condit

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

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

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

129 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

130 • After the break in program execution, select [Stack Trace] from the [Code] submenu of the [View] menu to open the [Stack Trace] window. Fig

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

132

133 Appendix A Components of the E8a Emulator Table A.1 lists the components of the E8a emulator. Table A.1 Components of the Emulator (R0E00008A

6.6.2 Displaying the Source Program... 104 6.7 Setting a PC Breakpoint

134

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

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

137 Table B.1 Window Functions (cont) Menu Option ShortcutToolbar Button Remarks Debug (cont) Go To Cursor Starts executing the user program at

138 Table B.1 Window Functions (cont) Menu Option Shortcut Toolbar Button Remarks Debug (cont) Disconnect Disconnects the debugging platform. Thi

139 Appendix C Command-Line Functions The emulator supports the commands that can be used in the command-line window. For details, refer to the onl

140

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

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

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

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

145 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 installi

146

147 Appendix E E8aSCP (E8a Self-Check Program) This appendix describes the troubleshooting procedure that applies the self-check program for the E8

148 Figure E.1 Connecting the User System Interface Cable when Using the E8aSCP

149 Figure E.2 Connecting the User System Interface Cable to the Self-Check Connector (3) Start up the host computer, and connect the E8a emulator

150 E.2. Executing the Self-Check Program (1) Execute [Program]-[Renesas]-[High-performance Embedded Workshop]-[E8a Self Check Program]. Figure E.3

151 (2) Click the ‘START’ button. The following message will be displayed: ‘Please confirm that the User interface cable is connected to the self-ch

152 (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

153 (4) When ‘TEST3 is waiting.’ starts, the following message will be displayed: ‘Please remove the User interface cable from the self-check connec

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

154 (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-Ch

155 (6) The message ‘PASS’ or ‘FAIL’ will be displayed. ‘PASS’ indicates that the emulator is working correctly. Click the [QUIT] button to exit the

156 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 sh

157 Table E.1 Error Messages Error Message Description The E8a has failed. The E8a emulator has become faulty. If this applies to the contents gu

158

Renesas Microcomputer Development Environment System User's Manual E8a EmulatorPublication Date: 1st Edition

Sales Strategic Planning Div. Nippon Bldg., 2-6-2, Ohte-machi, Chiyoda-ku, Tokyo 100-0004, Japanhttp://www.renesas.comRefer to

E8a Emulator User's Manual

2 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 debug

3 (8) Compact debugging environment A laptop computer can be used as a host computer, creating a debugging environment in any place.

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

5 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 illeg

6 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 co

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

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

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

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

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

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

13 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. Selec

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

14

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

16 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

17 The names of each section of the emulator are explained next. Emulator Upper-side Panel: Figure 3.3 Emulator Upper-side Panel (a) ACT LED: An

18 Emulator Host-Computer-Side Panel: Figure 3.4 Emulator Host-Computer-Side Panel (a) Host-side connector: A USB cable connector to connect the

19 Emulator User-System-Side Panel: Figure 3.5 Emulator User-System-Side Panel (a) User-system-side connector: A user system interface cable is

20 Emulator Bottom Panel: Figure 3.6 Emulator Bottom Panel (a) Seal for product management: The serial number and a description of the emulator

21 Emulator Left-Side Panel: Figure 3.7 Emulator Left-Side Panel (a) Self-check connector: A connector for the user system interface cable when

22 3.3 Emulator Software Configuration The following item is included with the emulator debugger when it is purchased: • E8a Emulator Software: R0

23 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 th

24 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 ea

25 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 config

26 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

27 (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

28 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 malfun

29 3.8 System Check When the software is executed, use the procedure below to check that the emulator is connected correctly. Here, use the workspa

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

31  H8/Super Low Power Drive where the OS has been installed: \WorkSpace\Tutorial\E8a\H8\TutorialSLP 6. The [Emulator Setting] dialog box is d

32 Note: The emulator occupies the user’s flash memory area according to the target MCUs. For details, refer to the additional document, Notes on Co

33 CAUTION Before carrying out the power supply, check the power specification of the user system and there is no short circuit in the user system. I

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

34 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

35 When no power is supplied from the emulator, click the [OK] button without selecting the [Power Target from Emulator. (MAX 300mA)] check box. When

36 11. When "Connected" is displayed in the [Output] window of the High-performance Embedded Workshop, the emulator initiation is complete

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

38 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

39 3. If an incorrect driver has been selected, the following dialog box will appear. Figure 3.24 [Unable to restore the previous driver setti

40 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

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

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

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

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

44

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

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

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

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

49 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 Gen

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

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

52 3. Make the required setting for the toolchain. Figure 4.8 [New Project-1/6-Select Target CPU. Toolchain version] Dialog Box Select your tool

53 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

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

54 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

55 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

56 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 Sy

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

58 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

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

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

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

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

63 4.2 Setting at E8a Emulator Activation 4.2.1 Setting at Emulator Activation When the emulator is activated, the command chain can be automatical

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

64 Figure 4.19 [Debug Settings] Dialog Box ([Options] Page) The command chain that is automatically executed at the specified timing is registered

65 4.2.2 Downloading a Program A download module is added under [Download modules] in the [Workspace] window. Open the load module of [Download modu

66 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

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

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

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

70 (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 B

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

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

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

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

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

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

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

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

78 5.2 Downloading a Program This section describes how to download a program and view it as source code or assembly-language mnemonics. Note: Afte

79 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

80 In this window, the following items are shown on the left as line information. The first column (Line Number column) Line number The second co

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

82 5.3 Stopping Your Program This section describes how you can halt execution of your application's code. This section describes how to stop t

83 5.4 Using the Event Points The emulator has the event point function that performs breaking by specifying higher-level conditions along with the