Renesas H8S/2628 Technical Information

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

IV SAFETY PAGE READ FIRST • READ this user's manual before using this emulator product. • KEEP the user's manual handy for future reference

74 4.9 Splitting a Window The High-performance Embedded Workshop editor allows you to split a text window into two. Figure 4.9 shows the split bar b

75 4.10 Configuring Text The following sections detail how to change the appearance of the text displayed in the editor windows. 4.10.1 Changing t

76 4.11 Syntax Coloring To enhance code readability, the HEW editor can display specific strings (i.e. keywords) in different colors. For instance, C

77 Figure 4.12: Format Views Dialog Keywords Tab 4. Click the “Add…” button to add a keyword. Then the “Add Keyword” dialog (figure 4.13) will be l

78 4.12 Templates When developing software it is often necessary to enter the same text repeatedly, for instance, when typing a function definition,

79 Figure 4.14: Define Template Dialog 4.12.2 Deleting a Template To delete a template: 1. Select [Edit->Templates->Define Templates...], s

80 4.13 Editor Column Management The editor in HEW has the ability to manage columns apart from the main editor column. These can be added and used

81 Figure 4.16: Global Editor Column States Dialog

82

83 5. Tools Administration You control the components, which can be used by the High-performance Embedded Workshop via the “Tools Administration” dia

V WARNING Observe the precautions listed below. Failure to do so will result in a FIRE HAZARD and will damage the user system and the emula

84 5.1 Tool Locations The HEW maintains the locations of HEW compatible components automatically as each new tool is installed. After installation, t

85 5.3 Registering Components The HEW will automatically attempt to register any new components installed since the last time it was invoked. However

86 5.3.2 Registering a Single Component The HEW allows you to navigate directly to a single component in order to register it. The HEW Registration

87 5.5 Viewing and Editing Component Properties To view information regarding a component, select it from the “Registered components” list and then

88 Select the “Environment” tab, if it exists, to view and edit a component’s environment settings (figure 5.6). This dialog is most commonly used to

89 5.6 Uninstalling Components The HEW provides a built in uninstaller method, which can remove unregistered components. To uninstall a compone

90 Figure 5.9: Unable to Uninstall Tool If a tool is not registered with the HEW then the dialog shown in figure 5.10 will be displayed when the “Un

91 5.7 Technical Support Issues The “Tools Administration” dialog is also capable of displaying information regarding “hidden” system components. T

92 5.8 Custom Project Types The [Project->Create Project Type…] menu item in HEW allows you to create a template for your project. This menu ite

93 6. Customizing the Environment 6.1 Customizing the Toolbar The High-performance Embedded Workshop provides 2 standard toolbars as detailed in ch

VI CAUTION This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the FCC Rules.

94 When a new toolbar is created it will appear undocked (i.e. “floating”) and empty. To add buttons to a toolbar: 1. Select [Tools->Customize…]

95 To remove buttons from a toolbar: 1. Select [Tools->Customize…]. The dialog shown in figure 6.1 will be displayed. Select the “Commands” tab

96 6.2 Customizing the Tools Menu The “Tools” menu can be customized to include your own menu options. To add a new menu option: 1. Select [Tools

97 Figure 6.5: Add Tool Dialog New menu options are added to the bottom of the list (i.e. bottom of the tools menu) by default. The order of menu op

98 6.3 Configuring the Help System The High-performance Embedded Workshop provides context sensitive help within the editor window. In other words,

99 To make a help file the default choice, select it from the “Default help file” drop-down list or set it to “(None)” if you would like to be prompt

100 6.4.3 Display workspace information dialog on opening workspace When many workspaces are being used, it is sometimes difficult to remember exact

101 6.4.6 Default directory for new workspaces When a new workspace is created the High-performance Embedded Workshop invokes the “New Workspace” di

102 6.5 Using an External Editor The High-performance Embedded Workshop allows you to use an external editor. Once an external editor has been speci

103 2. Check the “Use external editor” check box. The “External Editor” dialog will be displayed (figure 6.12). Figure 6.12: External Editor Dia

i Introduction The E6000 emulator is an advanced realtime in-circuit emulator, which allows programs to be developed and debugged for the H8S family

104 6.7 Using an External Debugger The High-performance Embedded Workshop can launch an external debugger tool. If you want to use another debugger

105 6.8 Using Custom Placeholders Throughout the High-performance Embedded Workshop the user can use a number of pre-defined placeholders for dir

106 Figure 6.14: New Custom Placeholder Dialog 6.9 Using Confirmation Dialog Boxes The HEW allows users to specify many items for confirmation eve

107 7. Version Control The High-performance Embedded Workshop provides facilities for connecting to a version control tool. Some of the reasons why v

108 7.1 Selecting a Version Control System Initially, the version control sub-menu will appear as shown in figure 7.2. At this time only the [Versio

109 Note: Only those version control systems which have been installed with the HEW will appear in the “Select Version Control System” dialog (figur

110

111 8. Using the Custom Version Control System The custom version control system is a configurable addition to the High-performance Embedded Worksho

112 Figure 8.1: Version Control Setup Dialog Commands Tab

113 The “Commands” tab contains two lists of menu options. The first list, “System menu options and toolbar buttons”, represents those menu options w

ii About This Manual This manual is comprised of two parts: HEW Part and Emulator Debugger Part. HEW Part: Information on the basic “look and feel”

114 Figure 8.3: Modify System Menu Option (Example)

115 8.1.2 User menu options You can create as many user defined menu options as you like, name them how you want and define their order in the menu.

116 To remove an existing version control menu option: 1. Select [Version Control->Configure…]. The dialog shown in figure 8.1 will be displayed

117 8.2 Defining Version Control Commands Commands are defined when the “Add…” or “Modify…” buttons are clicked on the dialogs shown in figure 8.3 a

118 8.3 Specifying Arguments It is obvious that arguments must be specified correctly, otherwise the version control tool executed will not function

119 Table 8.2: Arguments Field Placeholders Placeholder Value and How its Determined User login name Current user login (“General” tab) User login

120 Figure 8.7: Version Control Setup Dialog Projects Tab To define a new mapping: 1. Select [Version Control->Configure…]. The dialog shown i

121 To modify an existing mapping: 1. Select [Version Control->Configure…]. The dialog shown in figure 8.1 will be displayed. Select the “Proje

122 C:\work\application\project1 \ file1.c$(VCDIR) \ $(FILENAME)X:\vc\sw\app\project1 \ file1.cArguments:Project File:Command:(1) (2) Figure 8.10: Ex

123 8.3.3 Specifying Comments If a command contains the placeholder “$(COMMENT)” then the HEW will request that you enter the comment when the comman

iii Contents HEW Part 1. Overview... 1 1.1 Workspaces, Projec

124 8.3.4 Specifying a User Name and Password Most version control tools will require you to pass a user name and password on the command line in or

125 In order to give the $(USERNAME) and $(PASSWORD) fields a value you will first need to login. If you have not logged in before a command is execu

126 8.4 Controlling Execution The “General” tab of the “Version Control Setup” dialog (figure 8.13) allows you to control the way in which the versio

127 To import a version control set-up: 1. Select [Version Control->Configure…]. The dialog shown in figure 8.1 will be displayed. 2. Click the

128

129 9. Using Visual SourceSafe The High-performance Embedded Workshop provides specific support for the Visual SourceSafe version control system. At

130 Figure 9.2: Create SourceSafe Project The HEW has now created the necessary projects within Visual SourceSafe and sets-up the version control to

131 9.2 Visual SourceSafe Commands The following 8 operations are available: • Add a file to version control • Remove a file from version control

132 9.2.4 Checking In a Writable Copy of a File into Version Control Visual SourceSafe protects your source files and ensures that only one user can

133 9.3 Visual SourceSafe Integration Options You can control the way in which the history and status commands are displayed by selecting [Tools->

iv 3.1 The Build Process Revisited...37 3.1.1 What is a Buil

134

Emulator Debugger Part

135 Section 1 Overview 1.1 Features • The breakpoint, memory map, performance, and trace can be set through the dialog box.  Intuitive user inter

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

137 1.3 Environmental Conditions CAUTION Observe the conditions listed in table 1.1 when using the emulator. Failure to do so will cause illegal

138

139 Section 2 Preparation before Use 2.1 Emulator Preparation Unpack the emulator and prepare it for use as follows: WARNING READ the reference

140 2.3 Connecting to the User System To connect the emulator to a user system, proceed as follows: • Connect the user system interface cable head

141 • Screw the cable head to the socket with the screws provided. Progressively tighten the screws in the sequence shown in figure 2.4 until all ar

v 5. Tools Administration ... 83 5.1 Tool Locations...

142 2.4 Power Supply 2.4.1 AC Adapter The AC adapter supplied with the emulator must be used at all times. 2.4.2 Polarity Figure 2.6 shows the polari

143 2.6 Hardware Interface All signals are directly connected to the MCU in the emulator with no buffering with the exception of those listed in sect

144 The interface circuit for the external probe 1 is shown in figure 2.8. 10 kExternal probe 1, 2, 3, 4HD15101522VccΩΩ Figure 2.8 Interface Circui

145 2.6.6 Voltage Follower Circuit CAUTION 1. Do not connect the user system interface cable to the emulator without user system connection.

146 2.7 System Check When the software is executed, use the procedure below to check that the emulator is connected correctly. Here, use the works

147 5. The [Welcome!] dialog box is displayed. Figure 2.12 [Welcome!] Dialog Box To use a workspace for the tutorial, select the [Browse to anot

148 When no compiler package or that of a different version is installed, the following message box will be displayed. Figure 2.14 Message Box 6.

149 7. Set up the emulator. During this process, the following dialog box is displayed. Figure 2.16 [Connecting] Dialog Box 8. When "Conn

150 2.8 Communication Problems The following message box will be displayed when the emulator power is turned off or the PC interface cable is not cor

151 Section 3 E6000 Emulator Functions 3.1 Debugging Features 3.1.1 Breakpoints The emulator provides a comprehensive range of alternative types of

vi 9.1.1 Selecting Visual SourceSafe...129 9.1.2 Adding files to Visual S

152 3.1.5 Bus Monitoring The emulator incorporates a bus monitoring function that monitors and displays the contents of the accessed area in HEW wind

153 3.2.3 Breaks Use breaks to interrupt program execution when a specified event, or sequence of events, is activated. For example, you can set up a

154 3.3.2 Clocks The clock can be specified as emulator internal clock or target clock. The frequencies that can be specified as the emulator intern

155 Section 4 Preparation before Use 4.1 Workspaces, Projects, and Files Just as a word processor allows you to create and modify documents, HEW a

156 4.2 Method for Activating HEW To activate the HEW, follow the procedure listed below. 1. Connect the emulator to the host computer. 2. Connect

157 4.2.1 Creating a New Workspace (Toolchain Not Used) 1. In the [Welcome!] dialog box that is displayed when the HEW is activated, select [Create

158 2. Creation of a new workspace is started. The following dialog box is displayed. Figure 4.4 [New Project Workspace] Dialog Box [Workspace N

159 3. Make the required setting for the toolchain. When the setting has been completed, the following dialog box is displayed. Figure 4.5 [New

160 4. Set the configuration file name. The configuration file saves the state of HEW except for the emulator. Figure 4.6 [New Project – Step 8

161 4.2.2 Creating a New Workspace (Toolchain Used) 1. In the [Welcome!] dialog box that is displayed when the HEW is activated, select [Create a

vii 3.2 Complex Event System (CES)...152 3.2.1 Event Channels.

162 2. Creation of a new workspace is started. The following dialog box is displayed. Figure 4.8 [New Project Workspace] Dialog Box [Workspace N

163 3. Make the required setting for the toolchain. When the setting has been completed, the following dialog box is displayed. Figure 4.9 [New

164 4. Set the configuration file name. The configuration file saves the state of HEW except for the emulator. Figure 4.10 [New Project – Step

165 4.2.3 Selecting an Existing Workspace 1. In the [Welcome!] dialog box that is displayed when the HEW is activated, select [Browse to another p

166 4.3 Setting at Emulator Activation When the emulator is activated, the command chain can automatically be executed. It is also possible to regi

167 Figure 4.14 [Debug Settings] Dialog Box ([Options] Page) The command chain that is automatically executed at the specified timing is registere

168 4.4 Debugger Sessions The HEW stores all of your builder options into a configuration. In a similar way, the HEW stores your debugger options in

169 4.4.2 Adding and Deleting Sessions A new session can be added by copying settings from another session or deleting a session. • To add a new em

170 • To import an existing session into a new session file 1. Select [Options -> Debug Sessions…] to display the [Debug Sessions] dialog box (f

171 • To make a session read-only 1. Select [Options -> Debug Sessions…] to display the [Debug Sessions] dialog box (figure 4.16). 2. Select th

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

viii 5.4.4 Using Register Contents ...190 5.5 Operating Memory...

172 4.5 Connecting the Emulator Select either of the following two ways to connect the emulator: (a) Connecting the emulator after the setting at e

173 4.6 Ending the Emulator When using the toolchain, the emulator can be exited by using the following two methods: • Canceling the connection of

174

175 Section 5 Debugging This section describes the debugging operations and their related windows and dialog boxes. 5.1 Setting the Environment fo

176 [General] page [Device] Selects the MCU to be emulated. To use an MCU not included in the list, select CUSTOM to specify the functions required

177 5.1.2 Selecting an MCU Not Included in the List Selecting [Custom] in [Device] of the [Configuration Properties] dialog box adds the [Custom Dev

178 5.1.3 Selecting the Interface to be Connected Checking [Change driver in start up] on the [Configuration Properties] dialog box allows a selecti

179 5.1.4 Opening the [Memory Mapping] Dialog Box Selecting [Options -> Emulator -> Memory Resource…] or clicking the [Emulator Memory Resourc

180 5.1.5 Changing the Memory Map Setting Clicking the [Add…] button on the [Memory Mapping] dialog box or clicking the [Modify…] button after selec

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

ix 5.13 Elf/Dwarf2 Support...219 5.13.1 C/C++

182 5.2.2 Viewing the Source Code Select your source file and click the [Open] button to make the HEW open the file in the integrated editor. It is

183 Source address column When a program is downloaded, an address for the current source file is displayed on the Source address column. These addre

184 To switch off a column in all source files 1. Click the right-hand mouse button on the [Editor] window. 2. Click the [Define Column Format…]

185 5.2.3 Viewing the Assembly-Language Code Click the right-hand mouse button on the [Source] window to open the popup menu and select [Go to Disas

186 The address, machine code, and disassembled instruction are displayed. Enter the new instruction or edit the old instruction in the [Mnemonic] fi

187 5.3 Debugging with the Command Line Interface Use the [Command Line] window to enter text-based commands instead of window menus and commands. 5

188 5.3.3 Executing a Command File Click the [Play] button in the [Set Batch File] dialog box or choose [Play] from the popup menu to execute the co

189 5.4 Viewing the Registers If you are debugging at assembly-language level, then you will probably find it useful to see the contents of the CPU&

190 5.4.3 Modifying Register Contents To change a register's content, open the [Edit Register] dialog box in one of the following methods: • D

191 5.5 Operating Memory This section describes how to look at memory areas in the CPU's address space. How to look at a memory area in differen

x 5.19.2 Automatically Updating the Window Contents...285 5.19.3 Updating the Window Contents...

192 5.5.2 Displaying Data in Different Formats If you want to change the display format of the [Memory] window, select [Format] from the popup menu.

193 5.5.5 Modifying the Memory Contents The memory contents can be modified via the [Edit Memory] dialog box. Move the cursor on the memory unit (ac

194 5.5.7 Finding a Value in Memory To find a value in memory, open the [Memory] window and select [Search] from the popup menu. The [Search Memory

195 5.5.8 Filling a Memory Area with a Value A value can be set as the contents of a memory address range using the memory fill function. To fill a

196 The source start address and end address selected in the [Memory] window will be displayed in the [Begin] and [End] fields. Checking the [Verify]

197 5.5.11 Disabling Update of the Window Contents Automatic update of the [Memory] window contents, which is performed when user program execution

198 5.5.14 Loading a Memory Area from a File A file can be loaded to the debugging platform’s memory. Select [Load…] from the popup menu of the [Mem

199 5.6 Viewing the I/O Memory A microcomputer contains on-chip peripheral modules. The exact number and type of peripheral modules differ between d

200 5.6.3 Modifying the I/O Register Contents To edit the value in an I/O register, double-click or press the [Enter] key on the register to open a

201 5.8 Reading and Displaying the Emulator Information Regularly Use the [Extended Monitor] window to know the changing information on the emulator

xi 7.1.1 Supported MCUs and User System Interface Cables...349 7.1.2 Operating Voltage and Frequency Specific

202 5.8.2 Selecting Items to be Displayed Selecting [Properties…] from the popup menu displays the [Extended Monitor Configuration] dialog box. Fig

203 5.9 Displaying Memory Contents in Realtime Use the [Monitor] window to monitor the memory contents during user program execution. In the Monitor

204 [Name]: Decides the name of the monitor window. [Options]: Sets monitor conditions. [Address]: Sets the start address for monitoring. [Siz

205 Figure 5.33 [Monitor] Window During user program execution, the display is updated according to the setting value of the auto-update interval.

206 5.9.6 Hiding the [Monitor] Window When using the Monitor function to monitor the value of a variable from the [Watch] window, hide the [Monitor]

207 [Add]: Adds a new monitoring condition. [Edit]: Changes the settings of the selected [Monitor] window (disabled when selecting multiple items

208 5.10 Viewing the Labels Symbol information is included in the debugging information, which is used when the HEW links the user program source co

209 5.10.2 Adding a Label Choose [Add..] from the popup menu and open the [Add Label] dialog box to add a label: Figure 5.37 [Add Label] Dialog B

210 5.10.4 Deleting a Label To delete a label, select the label and choose [Delete] from the popup menu. A confirmation message box appears: Figure

211 5.10.6 Loading Labels from a File A symbol file can be loaded and merged into the HEW's current symbol table. Choose [Load...] from the pop

xii H.1 System Set-Up for Test Program Execution ...395 H.2 Diagnostic Test Procedur

212 Enter all or part of the label name that you wish to find into the edit box and click [OK] or press the [Enter] key. The HEW searches the label l

213 5.11 Executing Your Program This section describes how you can execute your program's code. You will learn how to do this by either running

214 5.11.4 Running from a Specified Address The [Run Program] dialog box allows the user to run the program from any address. Choose [Debug -> Ru

215 5.11.5 Single Step To debug your code it is very useful to be able to step a single line or instruction at a time and examine the effect of that

216 5.11.6 Multiple Steps You can step several instructions at a time by using the [Step Program] dialog box. The dialog box also provides an automat

217 5.12 Stopping Your Program This section describes how you can halt execution of your application's code. This section describes how to do t

218 • To set a PC breakpoint by using the [Breakpoints] dialog box Selecting [Edit -> Source Breakpoint…] displays the [Breakpoints] dialog box.

219 5.13 Elf/Dwarf2 Support The HEW supports the Elf/Dwarf2 object file format for debugging applications written in C/C++ and assembly language for

220 5.13.3 Supporting Duplicate Labels In some languages, for example C++ overloaded functions, a label may represent more than one address. When suc

221 Setting a Function Click the [OK] button to set the functions displayed in the [Set Function Name] list box. The functions are set and the [Selec

HEW Part

222 Â Setting section group When using the overlay function, the highest-priority section group must be selected in the [Overlay] dialog box; otherwi

223 5.14 Viewing the Variables This section describes how you can look at variables in the source program. 5.14.1 Tooltip Watch The quickest way to

224 5.14.3 [Watch] Window You can view any value in the [Watch] window. Opening a [Watch] Window To open a [Watch] window, choose [View->Symbol-&g

225 The [R] mark shows that the value of the variable can be updated during user program execution. For updating of the content of the variable that

226 Adding a Watch Item Use the [Add Watch] dialog box in the [Watch] window to add Watch items to the [Watch] window. Â To use Add Watch from a [Wat

227 Editing a Watch Item's Value You may wish to change the value of a watch variable, e.g. for testing purposes or if the value is incorrect du

228 Deleting a Watch Item To delete a watch item, select it and choose [Delete] from the popup menu. The item is deleted and the [Watch] window is up

229 5.14.4 [Locals] Window The local variables and their values can be displayed in the [Locals] window. Opening the [Locals] Window To open the [Loc

230 5.15 Using the Event Points The emulator has the event point function that performs breaking, tracing, and execution time measurement by specify

231 Range Channels (Ch9 to Ch12): The emulator has 4 range channels. The range channel can be defined as a combination of one or more of the followi

232 Table 5.2 Area Signals Acquired by the Emulator Area Trace Display (Status) Description On-chip ROM ROM ROM On-chip RAM RAM RAM On-chip I/

233 Select [Add...] or the PC breakpoint displayed in this window and then select [Edit...] from the popup menu to display the [Breakpoint/Event Prop

234 5.15.7 Setting Event Points On the [Event] sheet, the settings for event points are displayed, modified, and added. Figure 5.59 [Event] Window

235 (1) [General] page The address and data conditions are set. Figure 5.60 [Breakpoint/Event Properties] Dialog Box ([General] Page) [Type]: S

236 [Data Compare]: Sets the data condition. [Compare]: Checking this box compares data. [Use Mask]: Sets a mask condition (available when [Compar

237 (2) [Bus/Area] page Use this page to set the bus status and the memory area being accessed. Figure 5.61 [Breakpoint/Event Properties] Dialog

238 (3) [Signals] page Use this page to set external signals. Figure 5.62 [Breakpoint/Event Properties] Dialog Box ([Signals] Page) [Probe4]: D

239 [Probe1]: Detects the status of the input probe signal 1 [High]: Detects the high level of the input probe signal [Low]: Detects the low l

240 [Required number of event occurrences]: Allows a 16-bit pass count to be set. The event must occur the specified number of times before the actio

241 The state where the condition is satisfied is retained until the user program is stopped or the event point is reset. When the condition on the e

1 1. Overview This chapter describes the fundamental concepts of the High-performance Embedded Workshop. It is intended to give users who are new to

242 5.15.8 Setting Trigger Points The trigger point is an event to output a trigger when the specified address has been accessed. Up to four trigger

243 Notes: 1. When the condition set for the trigger output (1 to 4) is satisfied, the high-level signal will be output from the corresponding pin

244 5.16 Viewing the Trace Information The emulator acquires the results of each instruction execution into the trace buffer as trace information an

245 [Status]: Bus status during this cycle; DTC operation, PROG (prefetch), Data (CPU data access cycle), Refresh (refresh cycle), or DMAC (DMAC cyc

246 5.16.3 Specifying Trace Acquisition Conditions The capacity of the trace buffer is limited. When the buffer becomes full, the oldest trace infor

247 [Suppress]: Acquires no trace information of the specified types of bus cycle. [Time Stamp]: Sets a condition for time stamping. [Clock]: Sele

248 (2) [Stop] page Sets trace stop conditions. It is possible to set trace stop conditions with and without delay, with both allowed simultaneously.

249 (3) [Delayed Stop] page Sets trace stop conditions. It is possible to set trace stop conditions with and without delay, with both allowed simulta

250 (4) [1] to [4] pages Sets a range trace. This is only available when the free trace mode is disabled. Select either of the following four modes:

251 • Point to Point Acquires trace information in the specified range. Figure 5.72 Range Trace Setting (Point to Point) [Start Address]: Addr

2 1.2 The Main Window The HEW main window appears as shown in figure 1.2. Figure 1.2: HEW Main Window There are three main windows; the workspace

252 • Range Only acquires the trace information that satisfies the specified condition. Figure 5.73 Range Trace Setting (Range) [Range Event]:

253 • Event Acquires trace information, controlling the start and end of trace acquisition with the specified condition. Figure 5.74 Range Trace

254 5.16.4 Searching for a Trace Record Use the [Trace Find] dialog box to search for a trace record. To open this dialog box, choose [Find...] from

255 (1) [General] page Set the range for searching. Figure 5.75 [Trace Find] Dialog Box ([General] Page) [Trace search range]: Sets the range for

256 (2) [Address] page Set an address condition. Figure 5.76 [Trace Find] Dialog Box ([Address] Page) [Don't care]: Detects no address when

257 (3) [Data] page Set a data condition. Figure 5.77 [Trace Find] Dialog Box ([Data] Page) [Don't care]: Detects no data when this box is c

258 (4) [R/W] page Select the type of access cycles. Figure 5.78 [Trace Find] Dialog Box ([R/W] Page) [Don't care]: Detects no read/write co

259 (5) [Area] page Select the area being accessed. The selection is not available when a time stamp is acquired. Figure 5.79 [Trace Find] Dialog

260 (6) [Status] page Select the status of a bus. The selection is not available when a time stamp is acquired. Figure 5.80 [Trace Find] Dialog Bo

261 (7) [Probes] page Select the status of four probe signals. The selection is not available when a time stamp is acquired. Figure 5.81 [Trace Fi

3 1.2.3 The Toolbars The toolbars provide a shortcut to the options, which you will use the most often. There are eight default toolbars: Bookmarks,

262 (8) [IRQ7-0] page Select the status of IRQ signals. The selection is not available when a time stamp is acquired. Figure 5.82 [Trace Find] Dia

263 (9) [Timestamp] page Specify the time stamp value for bus cycles. The specification is not available when a time stamp is acquired. Figure 5.83

264 5.16.7 Viewing the [Source] Window The [Source] window corresponding to the selected trace record can be displayed in the following two ways: •

265 5.16.12 Extracting Records from the Acquired Information Use the filtering function to extract the records you need from the acquired trace info

266 (1) [General] page Set the range for filtering. Figure 5.84 [Trace Filter] Dialog Box ([General] Page) [Don't care other pages]: Only se

267 (2) [Address] page Set address conditions. Figure 5.85 [Trace Filter] Dialog Box ([Address] Page) [Don't care]: Detects no address when

268 (3) [Data] page Set a data condition. Figure 5.86 [Trace Filter] Dialog Box ([Data] Page) [Don't care]: Detects no data when this box is

269 (4) [R/W] page Select the type of access cycles. Figure 5.87 [Trace Filter] Dialog Box ([R/W] Page) [Don't care]: Detects no read/write

270 (5) [Area] page Select the area being accessed. The selection is not available when a time stamp is acquired. Figure 5.88 [Trace Filter] Dialo

271 (6) [Status] page Select the status of a bus. The selection is not available when a time stamp is acquired. Figure 5.89 [Trace Filter] Dialog

H8S/2628 E6000 EmulatorUser’s ManualUser’s Manual Rev.1.0 2003.12H8S/2628 E6000 HS2628EPI61HE-U2Renesas Microcomputer Development Environment Syste

4 Figure 1.8: Standard Toolbar Figure 1.9: Templates Toolbar Figure 1.10: Version Control Toolbar When the Standard toolbar or a toolbar is docked

272 (7) [Probes] page Select the status of four probe signals. The selection is not available when a time stamp is acquired. Figure 5.90 [Trace Fi

273 (8) [IRQ7-0] page Select the status of IRQ signals. The selection is not available when a time stamp is acquired. Figure 5.91 [Trace Filter] D

274 (9) [Timestamp] page Specify the time stamp value for bus cycles. The specification is not available when a time stamp is acquired. Figure 5.92

275 5.16.13 Calculating the Difference in Time Stamping Select [Timestamp Difference…] from the popup menu to calculate the time difference between

276 5.16.14 Analyzing Statistical Information Choose [Statistic] from the popup menu to open the [Statistic] dialog box and analyze statistical info

277 This dialog box allows the user to analyze statistical information concerning the trace information. Set the target of analysis in [Item] and the

278 5.17 Viewing the Function Call History The [Stack Trace] window shows the function call history. 5.17.1 Opening the [Stack Trace] Window To ope

279 5.17.3 Specifying the View Choose [View Setting...] from the popup menu to open the [Stack Trace Setting] dialog box, which allows the user to s

280 5.18 Displaying Memory Contents as an Image The memory contents can be displayed as an image in the [Image View] window. 5.18.1 Opening the [Im

281 The following items are to be specified: [Color Information]: Specifies the color information of the image to be displayed. [Mode]: Specifies

5 1.2.4 The Workspace Window The “Workspace” window when the HEW is launched only has a single pane. This is the “Projects” tab. If a workspace i

282 [Position]: Specifies the start position of the image where part of the image is to be displayed. (Valid when [Part Size] is selected) [X P

283 5.18.3 Updating the Window Contents Selecting [Refresh Now] from the popup menu immediately updates the window contents. 5.18.4 Displaying the

284 5.19 Displaying Memory Contents as Waveforms Memory contents can be displayed as waveforms in the [Waveform View] window. 5.19.1 Opening the Wa

285 Figure 5.102 [Waveform View] Window Displays the memory contents as waveforms. The X axis shows the number of sampling data and the Y axis sho

286 5.19.9 Non-Display of Cursor Selecting [Clear Cursor] from the popup menu hides the cursor display. 5.19.10 Displaying the Sampling Information

287 5.20 Analyzing Performance Use the performance analysis function to measure the rate of execution time. The performance analysis function does no

288 Table 5.8 Mode Settings for Measurement Point Page 1 2 3 4 5 6 7 8 Time Of Specified Range Measurement Ο Ο Ο Ο Ο Ο Ο Ο Start Point To En

289 5.20.1 Opening the [Performance Analysis] Window Choose [View -> Performance -> Performance Analysis] or click the [PA] toolbar button ()

290 5.20.2 Setting Conditions for Measurement Conditions for measurement can be displayed and changed in the [Performance Analysis] window. Select a

291 (1) Time Of Specified Range Measurement Figure 5.107 Time Of Specified Range Settings [Range Name]: The name of the range to be measured [Ran

6 Figure 1.14: Workspace Window, Docked and Floating When the “Workspace” window or the “Output” window is docked, it has a control bar as shown in

292 (2) Start Point To End Point Measurement Figure 5.108 Start Point To End Point Measurement Settings [Range Name]: The name of the range to be

293 Notes: 1. When [Time Out] is selected in the Start Point To End Point Measurement mode, the execution time will not be measured correctly. 2.

294 (3) Start Range To End Range Measurement Figure 5.109 Start Range To End Range Measurement Settings [Range Name]: The name of the range to be

295 (4) Access Count Of Specified Range Measurement Figure 5.110 Access Count Of Specified Range Measurement Settings [Range Name]: The name of t

296 (5) Called Count Of Specified Range Measurement Figure 5.111 Called Count Of Specified Range Measurement Settings [Range Name]: The name of t

297 5.20.3 Selecting the Address Detection Mode and Resolution In measurement of hardware performance, there are two types of address detection mode

298

299 Section 6 Tutorial 6.1 Introduction The following describes the main functions of the emulator by using a tutorial program. The tutorial prog

300 6.2 Running the HEW Open a workspace by following the procedure listed in section 4.2.3, Selecting an Existing Workspace. Select the following

301 6.3 Downloading the Tutorial Program 6.3.1 Downloading the Tutorial Program Download the object program to be debugged. • Select [Download m

7 To float the “Workspace” window or the “Output” window: [Allow Docking] must be checked on the pop-up menu of the window to float the “Workspace”

302 6.3.2 Displaying the Source Program The HEW allows the user to debug a user program at the source level. • Double-click [Tutorial.cpp] under [

303 6.4 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

304 6.5 Setting Registers Set a value of the program counter before executing the program. • Select [Registers] from the [CPU] submenu of the [Vie

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

306 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

307 6.7 Reviewing Breakpoints The user can see all the breakpoints set in the program in the [Event] window. • Select [Eventpoints] from the [Code

308 6.8 Referring to Symbols The [Label] window can be used to display the information on symbols in modules. Select [Label] from the [Symbol] subm

309 6.9 Viewing Memory When the label name is specified, the user can view the memory contents that the label has been registered in the [Memory] w

310 6.10 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

311 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

8 The editor window can be customized via the “Format Views” dialog box, which can be invoked via the [Tools->Format Views…] menu option. This dia

312 The user can click mark ‘+’ at the left side of array a in the [Watch] window to watch all the elements. Figure 6.18 [Watch] Window (Displayin

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

314 6.12 Stepping Through a Program The HEW provides a range of step menu commands that allow efficient program debugging. Table 6.1 Step Option

315 Figure 6.21 [Source] Window (Step In) • The highlighted line moves to the first statement of the sort function in the [Source] window.

316 6.12.2 Executing the [Step Out] Command The [Step Out] command steps out of the called function and stops at the next statement of the calling

317 6.12.3 Executing the [Step Over] Command The [Step Over] executes a function call as a single step and stops at the next statement of the main

318 6.13 Forced Breaking of Program Executions The HEW can force a break in the execution of a program. • Cancel all the breaks. • To execute the

319 6.15 Break Function The emulator’s break functions are of two types: PC breaks and breaks at event points. PC breakpoints and event points are

320 Figure 6.31 [Breakpoint/Event Properties] Dialog Box • Check the [PC Break] radio button in the [Type] group box. • Use the [Source] window

321 • Close the [Event] window. • To stop the tutorial program at the breakpoint, select [Reset Go] from the [Debug] menu. The program runs until i

9 1.3 The Help System The help menu is the rightmost menu on the HEW menu bar. It contains the menu option “Contents” which, when selected, takes yo

322 6.15.2 Breaking Execution at Event Points Setting up of an event point on event channel 1 (Ch1) such that a break is triggered when the event p

323 Figure 6.36 [General] Page ([Breakpoint/Event Properties] Dialog Box) • Click the [OK] button. The [Event] window is displayed, as shown belo

324 Figure 6.38 [Source] Window at Execution Stop The [Status] window displays the following contents. Figure 6.39 Displayed Contents of the [S

325 6.16 Trace Functions The trace functions of the emulator use the realtime trace buffer, which is able to store the information on up to 32,768

326 6.16.1 Displaying a Trace (when Time Stamping is not Available) The method used to specify an address as an event condition for the tracing of

327 (2) Register an address as an event condition for trace acquisition. Click the [Add…] button in the [Trace Events] group box on the [General] pag

328 (4) The event that has been set is now displayed in the [Event] combo box of the [Trace Events] group box on the [General] page of the [Trace Acq

329 (5) To enable the event condition that has been set, uncheck the [Free Trace] check box on the [General] page. This will add pages [1] to [4] to

330 (6) Select page [1] and click the [Range] radio button in the [Conditions] group box. This will display the [Range Event] combo box and the [Edit

331 (7) Select the event you have registered from the [Range Event] combo box. The event is now enabled. Click the [OK] button to complete the trace

10 1.4 Launching the HEW To run the HEW, open the “Start” menu of Windows®, select “Programs”, select “High-performance Embedded Workshop” and then

332 6.16.2 Displaying a Trace (when Time Stamping is Available) The following procedure is for obtaining and displaying, with time stamps, trace i

333 (5) The event that has been set in the [Event] combo box of the [Trace Events] group box on the [General] page of the [Trace Acquisition] dialog

334 (7) To enable the event condition that has been set, uncheck the [Free Trace] check box on the [General] page. This will add pages [1] to [4] (se

335 (12) Remove the event points that have been set and clear the trace information. Clicking the right-hand mouse button on the [Breakpoints] windo

336 (4) Select R/W in the [Item] combo box and enter WR in the [Start] edit box. After that, click the [New] button. “R/W=WR” is now displayed in th

337 (5) Then, select Area from the [Item] combo box and enter RAM in the [Start] edit box. After that, click the [Add] button; the new condition is

338 (6) To start statistical analysis of the specified condition, press the [Result] button. The number of write operations that satisfy the conditi

339 6.16.4 Function Calls This mechanism is used to only collect trace information on the function calls. (1) Make the setting such that a break occ

340 6.17 Stack Trace Function The emulator uses the stack’s information to display the function call history. Notes: 1. This function can be used

341 6.18 Performance Measurement Function Performance measurement by the emulator is in the following modes: • Time Of Specified Range Measurement

11 2. Build Basics This chapter explains the general functions of the HEW whilst the more advanced features can be found in chapter 3, “Advanced Buil

342 (3) Select the line of the [Performance Analysis] window that has 1 in its [No] column and click the right-hand mouse button to display a popup m

343 (6) Click the [Settings…] button in the [Common Settings of Performance(PA1-8)] group box to display the [Common Settings of Performance(PA1-8)]

344 6.19 Monitor Function The emulator allows monitoring of the content of specified addresses in memory during execution of the user program. In t

345 (2) Set the items in the [Monitor Setting] dialog box as follows: • Enter monitor1 in the [Name] edit box. • Set the parameters in the [Options

346 (3) Click the [OK] button to open the [Monitor] window. Figure 6.71 [Monitor] Window

347 (4) Select [Reset Go] from the [Debug] menu. When the content of the address range changes with execution, the updated values are red (i.e. the c

348 6.20 What Next? This tutorial has described the major features of the emulator and the use of the HEW. Sophisticated debugging can be carried o

349 Section 7 Hardware Specifications Specific to This Product This section describes the hardware specifications on the H8S/2628 E6000 emulator. 7

350 7.2 User System Interface All user system interface signals are directly connected to the MCU in the emulator with no buffering except for thos

351 PF0: User system interface cableMCU47 VccΩPF0CBTS330647 kΩ Figure 7.3 User System Interface Circuit for PF0 PC0-PC7: User system interface cabl

12 2.2 Project Files In order for the HEW to be able to build your application, you must first tell it, which files should be in the project, and how

352 7.3 Differences between MCU and Emulator When the emulator is turned on or initialized, or the system is reset, there are some differences in th

353 Section 8 Software Specifications Specific to This Product This section describes the software specifications of the H8S/2628 E6000 emulator. 8

354 8.1.3 [Configuration Properties] Dialog Box ([General] Page) Items that can be set in this dialog box are listed below. Figure 8.1 [Configura

355 [General] page [Device] Selects the MCU to be emulated. To use an MCU not included in the list, select [Custom] to specify the functions require

356 [General] page (cont) [Enable internal ROM area write] When this box is checked, writing to the internal ROM area is enabled. For the result of

357 8.1.4 [Configuration Properties] Dialog Box ([Custom] Page) Items that can be set in this dialog box are listed below. Figure 8.2 [Configurat

358 [Custom Device] page [ROM] Specify the internal ROM area size. None: - 48kB: Sets the internal ROM area to be 48 kbytes (H’000000 to H’00BFFF).

359 [Custom Device] page (cont) [Modules] Check this box to validate on-chip peripherals. Enable DTC: Uses a part of the internal RAM as DTCRAM. Ena

360 8.1.5 Memory Mapping Function This emulator supports four blocks of user memory. These can be 256 kbyte or 1 Mbyte each, depending on the SIMM f

361 (2) [Platform] Sheet Selecting the [Platform] tab on the [Status] window displays this sheet. Table 8.4 [Platform] Sheet Items [Item] Column [

13 2.2.1 Adding Files to a Project Before you can build your application you must first inform the High-performance Embedded Workshop, which files i

362 8.1.7 Extended Monitor Function Selecting [View -> CPU -> Extended Monitor] or clicking the [Extended Monitor] toolbar button displays the

363 8.1.8 Signals to Indicate Bus States and Areas The following tables show examples of signals to indicate the bus states and areas that can be ac

364 8.1.11 Trace Information Selecting [View -> Code -> Trace] or clicking the [Trace] toolbar button displays the [Trace] window. Trace inform

365 8.1.12 Searching for a Trace Record While using the emulator, the [Trace Find] dialog box has the following pages: Table 8.9 [Trace Find] Dialo

366 [Don't care]: Detects no IRQ input condition when this box is checked. [Setting]: Detects the specified IRQ input condition. [IRQ5] to [IR

367 • [IRQ5-0] page Select the status of IRQ signals. The selection is not available when a time stamp is acquired. Figure 8.4 [Trace Filter] Dia

368 8.2 Notes on Usage of the H8S/2628 E6000 Emulator There are the following notes on usage of the emulator. 8.2.1 Environment for Execution of th

369 8.2.6 HCAN When the CPU accesses the HCAN register and the operating frequency is 20 MHz or lower, the access counts are the same as those of the

370

371 Appendix A Troubleshooting • I have a text file in the editor but it does not show any syntax coloring. Ensure that you have named the file (i

14 There are a number of other ways to add new files to the project. These are described below: • Clicking right button on an open file in the edit

372

373 Appendix B Regular Expressions The HEW editor allows you to include special characters in search strings when performing a find or replace oper

374 • Symbol: \t Meaning: This character matches the tab character. Example 1: \t8 Finds every occurrence of a tab character followed by an 8. E

375 Appendix C Placeholders This appendix describes how to use the placeholders, a feature provided by several of the HEW components. C.1 What is

376 Figure C.3 Placeholder Combo Box In the fourth example, type the placeholder into the field directly. Ensure that you type the placeholder nam

377 C.3 Available Placeholders Table C.1 lists the placeholders and their meanings. Table C.1 Placeholders Placeholder Meaning $(FULLFILE) Filenam

378 For example, the placeholders will be expanded as shown in table C.2. Table C.2 Placeholder Expansions (Example) Placeholder Expanded placeho

379 Note: Not all of the placeholders are relevant in every field. For example, the $(LINE) placeholder has no meaning when specifying a dependent f

380

381 Appendix D I/O File Format HEW formats the [IO] window based on information it finds in an I/O Register definition file. When you select a debu

15 2.2.2 Removing Files from a Project Files can be individually removed from a project, selections of files can be removed or all files can be remo

382 Example: ; H8S/2655 Series I/O Register Definitions File [Modules] BaseAddress=0 Module1=Power_Down_Mode_Registers Module2=DMA_Channel_Common

383 D.2 File format (Bit Field Supported) Each module name must be defined in the [Modules] definition section and the numbering of each module must

384 Example: ; H8S/2655 Series I/O Register Definitions File [Modules] FileVersion=2 BaseAddress=0 Module1=Power_Down_Mode_Registers Module2=DMA_

385 Appendix E Symbol File Format In order for HEW to be able to understand and decode the symbol file correctly, the file must be formatted as a P

386

387 Appendix F Menus Table F.1 shows GUI menus. Table F.1 GUI Menus Menu Option Shortcut Toolbar Button Remarks View Disassembly Ctrl + D

388 Table F.1 GUI Menus (cont) Menu Option Shortcut Toolbar Button Remarks View (cont) Gra-phic Image… Shift + Ctrl + G Opens the [Image] wind

389 Table F.1 GUI Menus (cont) Menu Option Shortcut Toolbar Button Remarks Debug Reset CPU Resets the target hardware and sets the PC to the

390 Table F.1 GUI Menus (cont) Menu Option Shortcut Toolbar Button Remarks Debug (cont) Halt Program Esc Stops the execution of the user prog

391 Appendix G Command Lines Table G.1 lists the HEW commands. Table G.1 HEW Commands No. Command Name Abbreviation Function 1 ! - Comment 2 A

16 2. Select the file or files which you want to remove from the “Project files” list. 3. Click the “Remove” button to remove the selected files or

392 Table G.1 HEW Commands (cont) No. Command Name Abbreviation Function 27 GO GO Executes user program 28 GO_RESET GR Executes user program

393 Table G.1 HEW Commands (cont) No. Command Name Abbreviation Function 60 SUBMIT SU Executes a command file 61 SYMBOL_ADD SA Defines a symb

394

395 Appendix H Diagnostic Test Procedure This section describes the diagnostic test procedure using the E6000 test program. H.1 System Set-Up for

396 H.2 Diagnostic Test Procedure Using Test Program Insert the CD-R (HS2628EPI61SR supplied with the emulator) into the CD-ROM drive of the host co

397 The following messages are displayed during test. This test consists of steps 1 to 19. Message Description E6000 H8S/2628 Emulator Tests Vx.x Tes

398 3) Test Firmware RAM A) Decode Test page[H'700 - H'71f] ...OK Shows the results of decoding test for the firmware RA

399 8) Test Emulation RAM STEP Operation A) Step Operation ...OK Shows the check results for the step executio

400 16) Test PERFM G/A A) Time Measurement ...OK B) RESERVED C) Subroutine Count Measurement ...

H8S/2628 E6000 Emulator User's ManualPublication Date: Rev.1.00, December 19, 2003Published by: Sales

17 2.2.3 Excluding a Project File from Build A file in a project can be individually excluded from build on a configuration by configuration basis.

1753, Shimonumabe, Nakahara-ku, Kawasaki-shi, Kanagawa 211-8668 JapanH8S/2628 E6000 EmulatorREJ10B0100-0100HUser’s Manual

18 The “File Extensions” list shown in figure 2.7 is divided into two columns. On the left are the file extensions themselves, whilst on the right ar

19 To create a new file extension in a new file group: 1. Select [Project->File Extensions...] from the menu bar. The “File Extensions” dialog w

20 If you want to create a new extension because your project uses a different extension from those accepted by the HEW. For example, a phase might

21 Figure 2.11: File Groups and Applications To associate an application with a file group: 1. Select the file group to be associated from the “F

22 Figure 2.13: Add Application Dialog 5. Enter the name of the tool into the “Name” field. Enter the full path to the tool in the “Command” field

23 2.4 Specifying How to Build a File Once you have added the necessary files to the project the next step is to instruct the HEW on how to build ea

Cautions Keep safety first in your circuit designs! 1. Renesas Technology Corp. puts the maximum effort into making semiconductor products better and

24 2.5 Build Configurations The HEW allows you to store all of your build options into a build configuration (figure 2.14). This means that you can “

25 2.5.1 Selecting a Configuration The current configuration can be set in two ways: Either: 1. Select it from the drop down list box (figure 2.15)

26 2.5.2 Adding and Deleting Configurations You can add a new configuration by copying settings from another configuration or delete a configuration

27 2.6 Building a Project The outline of the build process is shown in figure 2.1. 2.6.1 Building a Project The build option only compiles or assem

28 2.6.3 Stopping a Build The High-performance Embedded Workshop allows you to halt the build process. To stop a build: 1. Select [Build->Stop

29 2.6.6 Controlling the Content of the Output Window It is often useful to display low-level information (such as the command line options that are

30 2.7 File Dependencies A typical project will contain dependencies between files, for example, one C file may “#include” one or more header files.

31 2.8.2 Show Standard Library Includes By default, any dependent files found in standard include paths will not be shown (figure 2.21.i). For examp

32 2.9 Setting the Current Project A workspace can contain more than one project but only one of the projects can be active at any time. This acti

33 To insert an existing project into a workspace: 1. Select [Project->Insert Project…]. The “Insert Project” dialog will be displayed. 2. Set

34 2.12 Removing a Project from a Workspace To remove a project from a workspace: 1. Select the project from the “Projects” tab of the “Workspace

35 2.14 Relative Projects Paths in the Workspace In the High-performance Embedded Workshop when you add a project to the workspace you can choose to

36

37 3. Advanced Build Features This chapter explains the more advanced build concepts. 3.1 The Build Process Revisited Chapter 2, “Build Basics” beg

38 The High-performance Embedded Workshop provides the ability to change this build process via its “Build Phases” dialog, which can be, accessed via

39 3.2 Creating a Custom Build Phase If you want to execute another tool before, during or after a standard build process then this can be achieved

40 The second step (figure 3.3b) asks what type of phase you would like to create. There are two choices: multiple or single. When a multiple phase i

41 Once this choice has been made the input file group selection is displayed as “Multiple Groups…” This dialog allows the user to choose multiple in

42 The fourth and final step (figure 3.3e) allows you to specify any environment variables, which the phase requires. Figure 3.3e: New Build Phase D

43 3.3 Ordering Build Phases In a standard build (shown in figure 3.5), you could add a phase at four different positions: before the compiler, befo

I IMPORTANT INFORMATION READ FIRST • READ this user's manual before using this emulator product. • KEEP the user's manual handy for future

44 3.3.1 Build Phase Order The “Build Order” tab (figure 3.6) displays the current order in which phases will be executed when the build () or build

45 To modify a custom phase: 1. Select the custom phase that you would like to modify. 2. Click the “Modify…” button. The modify phase dialog wi

46 3.3.2 Build File Phase Order If you were to select a C source file from the “Workspace” window and then activate [Build->Build File] (or press

47 3.4 Setting Custom Build Phase Options Once you have defined a custom phase, you will want to specify the command line options that should be use

48 3.4.1 Options Tab The “Options” tab (figure 3.11) allows you to define the command line options that will be passed to the phase. The “Command” fi

49 3.4.2 Output Files Tab The “Output Files” tab (figure 3.12) is where you can specify the output file or files that will be produced by the phase.

50 To modify an output file: 1. Select the output file that you would like to modify. 2. Click “Modify…”. The “Modify Output File” dialog, which

51 To add a dependent file: 1. Click “Add…”. The “Add Dependent File” dialog will be invoked (figure 3.15). 2. Enter the file path or browse to i

52 3.5 File Mappings By default, the files input to a phase are only taken from the project, i.e. all project files of the type specified in the “Sel

53 A file mapping states that you would like the HEW to pass output files of a certain type produced by one phase (referred to as the source phase) t

II LIMITED WARRANTY Renesas warrants its emulator products to be manufactured in accordance with published specifications and free from defect

54 3.6 Controlling the Build By default, the High-performance Embedded Workshop will execute all of the phases in a build and only stop if a fatal e

55 3.7 Logging Build Output If you would like to write the results of each build to file then invoke the “Customize” dialog by selecting [Tools->

56 3.8 Changing Toolchain Version If two or more versions of the same toolchain are registered in the HEW, you can choose a version of the toolchain

57 3.9 Using an External Debugger The High-performance Embedded Workshop can launch an external debugger tool. If you want to use another debugger

58 3.10 Generating a Makefile The HEW allows you to generate a makefile, which can be used to build parts of your workspace without HEW. This is pa

59 4. Using the Editor This chapter describes how to use the editor that is provided with the High-performance Embedded Workshop. 4.1 The Editor Wi

60 4.2 Working with Multiple Files The file area is where you will work with the files of your project. The editor allows you to have many files ope

61 4.2.2 Editor Toolbar Buttons New File The new file button creates a new source file window with a default name. When you save the file, you can s

62 Insert Template To insert a pre-defined template at the current cursor position, click this toolbar button. The “Insert Template” dialog box wil

63 4.2.5 Templates Toolbar Buttons Define Template Specify template text for subsequent insertion. Insert Template Insert the template selected in

III State Law: Some states do not allow the exclusion or limitation of implied warranties or liability for incidental or consequential damages, so

64 4.3.4 Opening a File To open a file: 1. Select [File->Open...] or click the open file toolbar button () or press CTRL+O. 2. An open file dia

65 4.4 Editing a File The High-performance Embedded Workshop editor supports standard editing functionality. This is available through the usual met

66 4.5 Searching and Navigating through Files The High-performance Embedded Workshop editor provides find, replace and file navigation functionality

67 4.5.2 Finding Text in Multiple Files To search for text in many files: 1. Select [Edit->Find in Files...], select [Find in Files...] from th

68 4.5.3 Replacing Text Replacing text is similar to finding text, as discussed in the previous section. The difference is that when the text is fou

69 4.5.4 Jumping to a Specified Line To jump to a line in a file: 1. Ensure that the window, whose contents you want to replace, is the active wi

70 4.6 Bookmarks When working with many large files at a time, it can become difficult to locate specific lines or areas of interest. Bookmarks enabl

71 4.8 Configuring Text Layout The following sections detail how to set-up the layout of the text within the editor windows. 4.8.1 Page Set-up Whe

72 4.8.2 Changing Tabs To change tab size: 1. Select [Tools->Options...]. The “Options” dialog will be displayed. Select the “Editor” tab (figur

73 4.8.3 Auto Indentation When you press return in a standard editor the insertion cursor will move to the next line down, at the first column (i.e.