Renesas REJ10J1837-0100 User manual

To our customers,
Old Company Name in Catalogs and Other Documents
On April 1st, 2010, NEC Electronics Corporation merged with Renesas Technology
Corporation, and Renesas Electronics Corporation took over all the business of both
companies. Therefore, although the old company name remains in this document, it is a valid
Renesas Electronics document. We appreciate your understanding.
Renesas Electronics website: http://www.renesas.com
April 1st, 2010
Renesas Electronics Corporation
Issued by: Renesas Electronics Corporation (http://www.renesas.com)
Send any inquiries to http://www.renesas.com/inquiry.

Notice
1. All information included in this document is current as of the date this document is issued. Such information, however, is
subject to change without any prior notice. Before purchasing or using any Renesas Electronics products listed herein, please
confirm the latest product information with a Renesas Electronics sales office. Also, please pay regular and careful attention to
additional and different information to be disclosed by Renesas Electronics such as that disclosed through our website.
2. Renesas Electronics does not assume any liability for infringement of patents, copyrights, or other intellectual property rights
of third parties by or arising from the use of Renesas Electronics products or technical information described in this document.
No license, express, implied or otherwise, is granted hereby under any patents, copyrights or other intellectual property rights
of Renesas Electronics or others.
3. You should not alter, modify, copy, or otherwise misappropriate any Renesas Electronics product, whether in whole or in part.
4. Descriptions of circuits, software and other related information in this document are provided only to illustrate the operation of
semiconductor products and application examples. You are fully responsible for the incorporation of these circuits, software,
and information in the design of your equipment. Renesas Electronics assumes no responsibility for any losses incurred by
you or third parties arising from the use of these circuits, software, or information.
5. When exporting the products or technology described in this document, you should comply with the applicable export control
laws and regulations and follow the procedures required by such laws and regulations. You should not use Renesas
Electronics products or the technology described in this document for any purpose relating to military applications or use by
the military, including but not limited to the development of weapons of mass destruction. Renesas Electronics products and
technology may not be used for or incorporated into any products or systems whose manufacture, use, or sale is prohibited
under any applicable domestic or foreign laws or regulations.
6. Renesas Electronics has used reasonable care in preparing the information included in this document, but Renesas Electronics
does not warrant that such information is error free. Renesas Electronics assumes no liability whatsoever for any damages
incurred by you resulting from errors in or omissions from the information included herein.
7. Renesas Electronics products are classified according to the following three quality grades: “Standard”, “High Quality”, and
“Specific”. The recommended applications for each Renesas Electronics product depends on the product’s quality grade, as
indicated below. You must check the quality grade of each Renesas Electronics product before using it in a particular
application. You may not use any Renesas Electronics product for any application categorized as “Specific” without the prior
written consent of Renesas Electronics. Further, you may not use any Renesas Electronics product for any application for
which it is not intended without the prior written consent of Renesas Electronics. Renesas Electronics shall not be in any way
liable for any damages or losses incurred by you or third parties arising from the use of any Renesas Electronics product for an
application categorized as “Specific” or for which the product is not intended where you have failed to obtain the prior written
consent of Renesas Electronics. The quality grade of each Renesas Electronics product is “Standard” unless otherwise
expressly specified in a Renesas Electronics data sheets or data books, etc.
“Standard”: Computers; office equipment; communications equipment; test and measurement equipment; audio and visual
equipment; home electronic appliances; machine tools; personal electronic equipment; and industrial robots.
“High Quality”: Transportation equipment (automobiles, trains, ships, etc.); traffic control systems; anti-disaster systems; anti-
crime systems; safety equipment; and medical equipment not specifically designed for life support.
“Specific”: Aircraft; aerospace equipment; submersible repeaters; nuclear reactor control systems; medical equipment or
systems for life support (e.g. artificial life support devices or systems), surgical implantations, or healthcare
intervention (e.g. excision, etc.), and any other applications or purposes that pose a direct threat to human life.
8. You should use the Renesas Electronics products described in this document within the range specified by Renesas Electronics,
especially with respect to the maximum rating, operating supply voltage range, movement power voltage range, heat radiation
characteristics, installation and other product characteristics. Renesas Electronics shall have no liability for malfunctions or
damages arising out of the use of Renesas Electronics products beyond such specified ranges.
9. Although Renesas Electronics endeavors to improve the quality and reliability of its products, semiconductor products have
specific characteristics such as the occurrence of failure at a certain rate and malfunctions under certain use conditions. Further,
Renesas Electronics products are not subject to radiation resistance design. Please be sure to implement safety measures to
guard them against the possibility of physical injury, and injury or damage caused by fire in the event of the failure of a
Renesas Electronics product, such as safety design for hardware and software including but not limited to redundancy, fire
control and malfunction prevention, appropriate treatment for aging degradation or any other appropriate measures. Because
the evaluation of microcomputer software alone is very difficult, please evaluate the safety of the final products or system
manufactured by you.
10. Please contact a Renesas Electronics sales office for details as to environmental matters such as the environmental
compatibility of each Renesas Electronics product. Please use Renesas Electronics products in compliance with all applicable
laws and regulations that regulate the inclusion or use of controlled substances, including without limitation, the EU RoHS
Directive. Renesas Electronics assumes no liability for damages or losses occurring as a result of your noncompliance with
applicable laws and regulations.
11. This document may not be reproduced or duplicated, in any form, in whole or in part, without prior written consent of Renesas
Electronics.
12. Please contact a Renesas Electronics sales office if you have any questions regarding the information contained in this
document or Renesas Electronics products, or if you have any other inquiries.
(Note 1) “Renesas Electronics” as used in this document means Renesas Electronics Corporation and also includes its majority-
owned subsidiaries.
(Note 2) “Renesas Electronics product(s)” means any product developed or manufactured by or for Renesas Electronics.

High-performance Embedded
Workshop V.4.05
User’s Manual
User’s Manual
Rev.1.00 2008.11
Renesas Microcomputer Development
Environment System

1. This document is provided for reference purposes only so that Renesas customers may select the appropriate
Renesas products for their use. Renesas neither makes warranties or representations with respect to the
accuracy or completeness of the information contained in this document nor grants any license to any intellectual
property rights or any other rights of Renesas or any third party with respect to the information in this document.
2. Renesas shall have no liability for damages or infringement of any intellectual property or other rights arising out
of the use of any information in this document, including, but not limited to, product data, diagrams, charts,
programs, algorithms, and application circuit examples.
3. You should not use the products or the technology described in this document for the purpose of military
applications such as the development of weapons of mass destruction or for the purpose of any other military
use. When exporting the products or technology described herein, you should follow the applicable export
control laws and regulations, and procedures required by such laws and regulations.
4. All information included in this document such as product data, diagrams, charts, programs, algorithms, and
application circuit examples, is current as of the date this document is issued. Such information, however, is
subject to change without any prior notice. Before purchasing or using any Renesas products listed in this
document, please confirm the latest product information with a Renesas sales office. Also, please pay regular
and careful attention to additional and different information to be disclosed by Renesas such as that disclosed
through our website. (http://www.renesas.com)
5. Renesas has used reasonable care in compiling the information included in this document, but Renesas
assumes no liability whatsoever for any damages incurred as a result of errors or omissions in the information
included in this document.
6. When using or otherwise relying on the information in this document, you should evaluate the information in light
of the total system before deciding about the applicability of such information to the intended application.
Renesas makes no representations, warranties or guaranties regarding the suitability of its products for any
particular application and specifically disclaims any liability arising out of the application and use of the
information in this document or Renesas products.
7. With the exception of products specified by Renesas as suitable for automobile applications, Renesas products
are not designed, manufactured or tested for applications or otherwise in systems the failure or malfunction of
which may cause a direct threat to human life or create a risk of human injury or which require especially high
quality and reliability such as safety systems, or equipment or systems for transportation and traffic, healthcare,
combustion control, aerospace and aeronautics, nuclear power, or undersea communication transmission. If you
are considering the use of our products for such purposes, please contact a Renesas sales office beforehand.
Renesas shall have no liability for damages arising out of the uses set forth above.
8. Notwithstanding the preceding paragraph, you should not use Renesas products for the purposes listed below:
(1) artificial life support devices or systems
(2) surgical implantations
(3) healthcare intervention (e.g., excision, administration of medication, etc.)
(4) any other purposes that pose a direct threat to human life
Renesas shall have no liability for damages arising out of the uses set forth in the above and purchasers who
elect to use Renesas products in any of the foregoing applications shall indemnify and hold harmless Renesas
Technology Corp., its affiliated companies and their officers, directors, and employees against any and all
damages arising out of such applications.
9. You should use the products described herein within the range specified by Renesas, especially with respect to
the maximum rating, operating supply voltage range, movement power voltage range, heat radiation
characteristics, installation and other product characteristics. Renesas shall have no liability for malfunctions or
damages arising out of the use of Renesas products beyond such specified ranges.
10. Although Renesas endeavors to improve the quality and reliability of its products, IC products have specific
characteristics such as the occurrence of failure at a certain rate and malfunctions under certain use conditions.
Please be sure to implement safety measures to guard against the possibility of physical injury, and injury or
damage caused by fire in the event of the failure of a Renesas product, such as safety design for hardware and
software including but not limited to redundancy, fire control and malfunction prevention, appropriate treatment
for aging degradation or any other applicable measures. Among others, since the evaluation of microcomputer
software alone is very difficult, please evaluate the safety of the final products or system manufactured by you.
11. In case Renesas products listed in this document are detached from the products to which the Renesas products
are attached or affixed, the risk of accident such as swallowing by infants and small children is very high. You
should implement safety measures so that Renesas products may not be easily detached from your products.
Renesas shall have no liability for damages arising out of such detachment.
12. This document may not be reproduced or duplicated, in any form, in whole or in part, without prior written
approval from Renesas.
13. Please contact a Renesas sales office if you have any questions regarding the information contained in this
document, Renesas semiconductor products, or if you have any other inquiries.
Notes regarding these materials

High-performance Embedded Workshop Introduction
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
Introduction
The High-performance Embedded Workshop is a powerful development environment for embedded applications
targeted at Renesas micro-controllers. The main features are:
•A configurable build engine that allows you to set-up compiler, assembler and linker options by using GUI.
•An integrated text editor with user customizable syntax coloring to improve code readability.
•A configurable environment, which allows you to run your own tools.
•An integrated debugger, which allows you to build and debug in the same application.
•Version control support.
The High-performance Embedded Workshop has been designed with two key aims; firstly to provide you, the user,
with a set of powerful development tools and, secondly, to unify and present them in a way that is easy to use.
About This User’s Manual
This user’s manual describes the High-performance Embedded Workshop system. This user’s manual describes
information on the basic “look and feel” of the High-performance Embedded Workshop and customizing the High-
performance Embedded Workshop environment and detail the build and the debugging functions common to the High-
performance Embedded Workshop products. The figures in this document show the High-performance Embedded
Workshop operating with the SuperH family debugging platform.
The term “debugging platform” refers to an emulator or simulator/debugger that operates with the integrated
development environment “High-performance Embedded Workshop”.
For details on the debugging platform, see the user’s manual or online help information packaged with the emulator or
simulator.
This user’s manual does not intend to explain how to write C/C++ or assembly language programs, how to use any
particular operating system or how best to tailor code for the individual devices. These issues are left to the respective
user’s manuals.
The High-performance Embedded Workshop is customized in various languages. This user’s manual gives descriptions
on the English version of the High-performance Embedded Workshop application.
Document Conventions
This user’s manual uses the following typographic conventions:
Convention Meaning
[Menu -> Menu Option] ‘->’ is used to indicate menu options (for example, [File -> Save As]).
FILENAME.C Uppercase names are used to indicate filenames.
Key + Key Used to indicate required key presses. For example, CTRL+N means press the CTRL key
and then, whilst holding the CTRL key down, press the N key.

High-performance Embedded Workshop Introduction
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
Figures
Some figures in this user’s manual may differ from the objects they represent.
Operating Environment for the High-performance Embedded Workshop
This user’s manual, online help, and release notes do not indicate that the correct operation of the High-performance
Embedded Workshop is guaranteed for any types of host computers or peripheral devices.
Trademarks
Microsoft, MS-DOS, Visual SourceSafe, Windows and Windows Vista are either registered trademarks or trademarks
of Microsoft Corporation in the United States and/or other countries.
All other company and product names are registered trademarks or trademarks of their respective companies.
For inquiries about the contents of this document or product, email to your local distributor.
Renesas Tools Homepage http://www.renesas.com/tools

High-performance Embedded Workshop Contents
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
i
Contents
1. Overview......................................................................................................................................1
1.1 Workspaces, projects and files...................................................................................................................................1
1.2 Main window.............................................................................................................................................................1
1.2.1 Title bar...........................................................................................................................................................2
1.2.2 Menu bar.........................................................................................................................................................2
1.2.3 Toolbars ..........................................................................................................................................................3
1.2.4 Workspace window.........................................................................................................................................5
1.2.5 Editor window.................................................................................................................................................8
1.2.6 Output window................................................................................................................................................9
1.2.7 Status bar.......................................................................................................................................................12
1.3 Help system .............................................................................................................................................................12
1.4 Launching the High-performance Embedded Workshop.........................................................................................13
1.5 Creating a new workspace.......................................................................................................................................13
1.6 Opening a workspace...............................................................................................................................................14
1.7 Using old workspaces..............................................................................................................................................15
1.8 Saving a workspace .................................................................................................................................................15
1.9 Closing a workspace................................................................................................................................................16
1.10 Exiting the High-performance Embedded Workshop..............................................................................................16
1.11 Component system overview...................................................................................................................................16
1.12 Management information files of High-performance Embedded Workshop...........................................................16
1.13 Overview of Configurations and Sessions...............................................................................................................17
1.14 Overview of Macro-Recording Support facility and Test Support facility..............................................................21
1.14.1 Example of test procedures...........................................................................................................................24
1.14.2 Step 1: Recording a macro............................................................................................................................25
1.14.3 Step 2: Editing a macro (viewing records)....................................................................................................27
1.14.4 Step 3: Playing a macro.................................................................................................................................28
1.14.5 Step 4: Creating a test suite...........................................................................................................................28
1.14.6 Step 5: Editing a test suite.............................................................................................................................28
1.14.7 Step 6: Creating a test image file ..................................................................................................................30
1.14.8 Step 7: Modifying the program before the test..............................................................................................32
1.14.9 Step 8: Viewing the test result (unmatched) .................................................................................................33
1.14.10 Step 9: Modifying the program back and executing the test again................................................................34
1.14.11 Step 10: Viewing the test result (matched) ...................................................................................................34
2. Build Basics ...............................................................................................................................35
2.1 The build process.....................................................................................................................................................35
2.2 Configuring the Projects tab of the Workspace window..........................................................................................36
2.3 Project files..............................................................................................................................................................38
2.3.1 Adding files to a project................................................................................................................................39
2.3.2 Drag and drop of files and folders.................................................................................................................40
2.3.3 Removing files from a project.......................................................................................................................41
2.3.4 Excluding a project file from build...............................................................................................................42
2.3.5 Including a project file in build.....................................................................................................................43
2.4 User folders in the workspace..................................................................................................................................43
2.5 File extensions and file groups ................................................................................................................................44
2.5.1 Associating an application with a file group.................................................................................................45
2.5.2 Creating a new file extension and file group.................................................................................................47
2.5.3 Creating a new file extension........................................................................................................................48
2.6 Setting build options................................................................................................................................................49
2.7 Build configurations ................................................................................................................................................49
2.7.1 Selecting a build configuration .....................................................................................................................50

High-performance Embedded Workshop Contents
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
ii
2.7.2 Adding a new build configuration.................................................................................................................50
2.7.3 Removing a build configuration....................................................................................................................50
2.8 Building a project ....................................................................................................................................................51
2.8.1 Building individual files................................................................................................................................51
2.8.2 Building a project..........................................................................................................................................51
2.8.3 Building multiple projects.............................................................................................................................52
2.8.4 Stopping tool execution.................................................................................................................................52
2.8.5 Deleting intermediate and output files produced in building........................................................................53
2.8.6 Configuring the Build tab of the Output window..........................................................................................54
2.8.7 Controlling the content of the Build tab of the Output window....................................................................56
2.8.8 Displaying out of date files in the Workspace window.................................................................................56
2.9 File dependencies.....................................................................................................................................................57
2.10 Configuring the Workspace window .......................................................................................................................60
2.11 Inserting a project into the workspace .....................................................................................................................61
2.12 Setting the current project........................................................................................................................................62
2.13 Specifying dependencies between projects..............................................................................................................63
2.14 Removing a project from the workspace .................................................................................................................64
2.15 Relative projects paths in the workspace.................................................................................................................64
3. Advanced Build Features...........................................................................................................65
3.1 The build process revisited......................................................................................................................................65
3.1.1 What is a build?.............................................................................................................................................65
3.2 Creating a custom build phase.................................................................................................................................66
3.3 Ordering build phases..............................................................................................................................................70
3.3.1 Build Order tab..............................................................................................................................................70
3.3.2 Build File Order tab ......................................................................................................................................73
3.3.3 File Mappings tab..........................................................................................................................................74
3.4 Setting custom build phase options..........................................................................................................................75
3.4.1 Options tab....................................................................................................................................................75
3.4.2 Output Files tab.............................................................................................................................................76
3.4.3 Dependent Files tab.......................................................................................................................................76
3.5 Controlling the build................................................................................................................................................77
3.6 Logging build output ...............................................................................................................................................78
3.7 Changing toolchain version .....................................................................................................................................78
3.8 Generating a makefile..............................................................................................................................................79
3.9 Using a makefile inside the High-performance Embedded Workshop system........................................................81
3.10 Customizing the High-performance Embedded Workshop linkage order...............................................................83
4. Using the Editor.........................................................................................................................86
4.1 Editor window .........................................................................................................................................................86
4.2 Working with multiple files.....................................................................................................................................87
4.3 Standard file operations...........................................................................................................................................87
4.3.1 Creating a new file........................................................................................................................................87
4.3.2 Editing a file..................................................................................................................................................87
4.3.3 Saving a file ..................................................................................................................................................88
4.3.4 Opening a file................................................................................................................................................89
4.3.5 Closing files ..................................................................................................................................................90
4.3.6 Pop-up menu to close the window ................................................................................................................91
4.4 Searching and navigating through files....................................................................................................................91
4.4.1 Finding text...................................................................................................................................................91
4.4.2 Finding text in multiple files.........................................................................................................................92
4.4.3 Replacing text ...............................................................................................................................................94
4.4.4 Jumping to a specified line............................................................................................................................95
4.5 Bookmarks...............................................................................................................................................................95

High-performance Embedded Workshop Contents
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
iii
4.6 Printing a file ...........................................................................................................................................................96
4.7 Configuring text layout............................................................................................................................................96
4.7.1 Page set-up....................................................................................................................................................96
4.7.2 Changing tabs................................................................................................................................................97
4.7.3 Auto indentation............................................................................................................................................98
4.8 Splitting a window...................................................................................................................................................98
4.9 Changing the editor font..........................................................................................................................................99
4.10 Syntax coloring........................................................................................................................................................99
4.10.1 Changing text colors ...................................................................................................................................100
4.10.2 Creating new keywords...............................................................................................................................100
4.10.3 Enabling/disabling syntax coloring.............................................................................................................101
4.11 Templates...............................................................................................................................................................102
4.11.1 Defining a template.....................................................................................................................................102
4.11.2 Deleting a template .....................................................................................................................................104
4.11.3 Inserting a template.....................................................................................................................................104
4.12 Brace matching......................................................................................................................................................104
4.13 Setting the read-only attribute for a file.................................................................................................................105
4.14 Preventing modification of files while debugging.................................................................................................105
4.15 Managing the editor columns.................................................................................................................................105
4.16 Showing/hiding the column header .......................................................................................................................106
4.17 Opening a file within the editor.............................................................................................................................107
4.18 Tooltip watch.........................................................................................................................................................107
4.19 Evaluate an expression...........................................................................................................................................108
5. Tools Administration ...............................................................................................................109
5.1 Tool locations ........................................................................................................................................................109
5.2 High-performance Embedded Workshop registration files ...................................................................................110
5.3 Registering a component .......................................................................................................................................111
5.4 Unregistering a component....................................................................................................................................112
5.5 Viewing and editing component properties ...........................................................................................................112
5.6 Technical support...................................................................................................................................................114
5.7 Using On-Demand components.............................................................................................................................115
5.8 Custom project types .............................................................................................................................................116
6. Customizing the Environment .................................................................................................118
6.1 Customizing the toolbars.......................................................................................................................................118
6.2 Customizing the Tools menu.................................................................................................................................120
6.3 Using custom placeholders....................................................................................................................................121
6.4 Using the workspace and project log facilities ......................................................................................................122
6.5 Configuring the help system..................................................................................................................................123
6.6 Keyboard shortcut customization ..........................................................................................................................124
6.7 Scope of a control in the setup...............................................................................................................................125
6.7.1 Scope of a control in the Customize dialog box..........................................................................................125
6.7.2 Scope of a control in the Options dialog box..............................................................................................126
6.8 Specifying workspace options ...............................................................................................................................126
6.8.1 Opening the last workspace at start-up........................................................................................................126
6.8.2 Restoring files on opening a workspace......................................................................................................126
6.8.3 Displaying workspace information on opening a workspace......................................................................127
6.8.4 Saving the workspace before executing any tools.......................................................................................127
6.8.5 Prompting before saving a workspace.........................................................................................................127
6.8.6 Prompting before saving a session..............................................................................................................128
6.8.7 Enabling auto-backup facilities...................................................................................................................128
6.8.8 Setting the projects to load on workspace open ..........................................................................................129
6.8.9 Specifying a default directory for new workspaces ....................................................................................129
6.9 Using an external editor.........................................................................................................................................130

High-performance Embedded Workshop Contents
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
iv
6.10 Customizing the font in your views.......................................................................................................................132
6.11 Using the virtual desktop.......................................................................................................................................133
7. Version Control........................................................................................................................134
7.1 Selecting a Version Control System......................................................................................................................135
7.2 Importing and exporting a set-up...........................................................................................................................136
8. Using the Custom Version Control System.............................................................................137
8.1 Defining Version Control menu options................................................................................................................137
8.1.1 System-defined menu options.....................................................................................................................138
8.1.2 User-defined menu options.........................................................................................................................139
8.2 Defining Version Control commands....................................................................................................................140
8.3 Specifying arguments ............................................................................................................................................141
8.4 Specifying comments.............................................................................................................................................141
8.5 Executable return code...........................................................................................................................................141
8.6 Specifying file locations ........................................................................................................................................142
8.7 Specifying file locations example..........................................................................................................................143
8.8 Specifying environment.........................................................................................................................................144
8.9 Controlling execution of a Version Control System..............................................................................................144
8.10 Specifying a user name and password ...................................................................................................................145
8.11 Usage example of the Custom Version Control System........................................................................................146
8.11.1 Connecting the High-performance Embedded Workshop with RCS..........................................................146
8.11.2 Connecting the High-performance Embedded Workshop with CVS..........................................................151
9. Using Visual SourceSafe .........................................................................................................158
9.1 Attaching Visual SourceSafe to a workspace ........................................................................................................158
9.2 Visual SourceSafe commands................................................................................................................................160
9.2.1 Adding files to Visual SourceSafe..............................................................................................................161
9.2.2 Removing files from Visual SourceSafe.....................................................................................................162
9.2.3 Getting read-only copy of files from Visual SourceSafe ............................................................................162
9.2.4 Checking out writable copy of files from Visual SourceSafe.....................................................................163
9.2.5 Checking in writable copy of files into Visual SourceSafe.........................................................................164
9.2.6 Viewing the status of files in Visual SourceSafe........................................................................................165
9.2.7 Undoing a check out command in Visual SourceSafe ................................................................................165
9.2.8 Viewing the history of files in Visual SourceSafe ......................................................................................166
9.3 Visual SourceSafe command options ....................................................................................................................167
9.4 Version Control setup............................................................................................................................................167
9.5 Specifying file locations ........................................................................................................................................167
9.6 Adding Visual SourceSafe commands...................................................................................................................169
10. Sharing Projects by Network Facilities....................................................................................171
10.1 Sharing projects by network facilities in a PC with Windows® XP Service Pack 2 or later.................................172
10.2 Enabling network facilities to share projects .........................................................................................................174
10.3 Setting the administrator user's password..............................................................................................................174
10.4 Adding new users to the system.............................................................................................................................175
10.5 Changing your password .......................................................................................................................................176
10.6 Note on using the network facilities to share projects ...........................................................................................176
11. Comparing Files.......................................................................................................................178
11.1 Opening the Difference window............................................................................................................................178
12. Navigation Facilities................................................................................................................181
12.1 C function and #define navigation component ......................................................................................................183
12.2 C++ navigation component....................................................................................................................................183
12.3 Jump to a definition from the editor ......................................................................................................................185

High-performance Embedded Workshop Contents
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
v
12.4 Drag and drop navigation items.............................................................................................................................186
12.5 Smart edit capability..............................................................................................................................................187
13. Map ..........................................................................................................................................189
13.1 Managing section settings......................................................................................................................................190
13.1.1 Opening the Map Section Information window..........................................................................................190
13.1.2 Entering/exiting the edit mode....................................................................................................................193
13.1.3 Adding a section group ...............................................................................................................................194
13.1.4 Adding a section..........................................................................................................................................194
13.1.5 Adding an overlay group.............................................................................................................................195
13.1.6 Automatically registering the unregistered section.....................................................................................195
13.1.7 Editing a selected item................................................................................................................................196
13.1.8 Setting the primary section..........................................................................................................................196
13.1.9 Setting a memory map ................................................................................................................................197
13.1.10 Automatically allocating the memory resource...........................................................................................197
13.1.11 Printing out the section settings tree ...........................................................................................................198
13.1.12 Viewing unallocated areas ..........................................................................................................................198
13.1.13 Viewing sections of size 0...........................................................................................................................198
13.1.14 Viewing the source code for the address.....................................................................................................198
13.1.15 Printing out the section list..........................................................................................................................199
13.2 Viewing symbols...................................................................................................................................................199
13.2.1 Opening the Map Symbol Information window..........................................................................................199
13.2.2 Printing out the map list..............................................................................................................................201
13.2.3 Finding symbols..........................................................................................................................................201
13.2.4 Filtering the symbol information.................................................................................................................201
13.2.5 Viewing the source code for the address.....................................................................................................202
13.2.6 Printing out the symbol information ...........................................................................................................203
14. Using the Command Line........................................................................................................204
14.1 Opening the Command Line window....................................................................................................................204
14.2 Specifying a batch file ...........................................................................................................................................207
14.3 Executing a batch file ............................................................................................................................................208
14.4 Stopping command execution................................................................................................................................208
14.5 Specifying a log file...............................................................................................................................................208
14.6 Starting or stopping logging ..................................................................................................................................209
14.7 Entering a full path to the file................................................................................................................................209
14.8 Pasting a placeholder.............................................................................................................................................209
14.9 Selecting all the window contents..........................................................................................................................209
14.10 Copying the selection onto the clipboard...............................................................................................................209
14.11 Cutting out the selection to the clipboard..............................................................................................................209
14.12 Pasting the contents of the clipboard .....................................................................................................................209
14.13 Clearing the contents of the Command Line window............................................................................................210
14.14 Undoing the last operation.....................................................................................................................................210
14.15 Checking brace matching.......................................................................................................................................210
14.16 Resetting the status of a batch file .........................................................................................................................210
14.17 Single-stepping in a batch file................................................................................................................................211
14.18 Setting a breakpoint in a batch file ........................................................................................................................212
15. Using the Macro-Recording Support Facility..........................................................................213
15.1 Macro menu and toolbar........................................................................................................................................213
15.2 Using the Macro dialog box...................................................................................................................................214
15.3 Importing a macro file with existing macros .........................................................................................................216
15.4 Recording a macro.................................................................................................................................................216
15.5 Functions that can be recorded into macro files.....................................................................................................217
15.5.1 Recordable functions (common to all High-performance Embedded Workshop products)........................217

High-performance Embedded Workshop Contents
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
vi
15.5.2 Recordable functions (dependent on the debugger)....................................................................................221
15.6 Playing a macro .....................................................................................................................................................229
15.7 Editing a macro......................................................................................................................................................229
15.8 Assigning a macro .................................................................................................................................................230
15.9 Configuring the Macro tab of the Output window.................................................................................................231
16. Using the Test Support Facility ...............................................................................................232
16.1 Creating a test suite................................................................................................................................................232
16.2 Opening and closing test suites..............................................................................................................................233
16.3 Editing a test suite..................................................................................................................................................233
16.4 Adding tests to the test suite ..................................................................................................................................235
16.5 Creating a test image file .......................................................................................................................................236
16.6 Functions that can be saved as test-image data into test-image files .....................................................................237
16.6.1 Functions that can be saved into test-image files (common to all High-performance Embedded Workshop
products) 238
16.6.2 Functions that can be saved into test-image files (dependent on the debugger)..........................................243
16.7 Comparing a test image file...................................................................................................................................255
16.8 Running tests .........................................................................................................................................................256
16.9 Using the test browser............................................................................................................................................257
16.10 Configuring the Test pane of the Workspace window...........................................................................................258
16.11 Configuring the Test tab of the Output window ....................................................................................................259
17. Using the Debugger .................................................................................................................261
17.1 Preparations for debugging....................................................................................................................................261
17.1.1 Compiling for debug...................................................................................................................................261
17.1.2 Selecting a debugging platform...................................................................................................................261
17.1.3 Editing project configuration ......................................................................................................................272
17.1.4 Configuring the debugging platform...........................................................................................................272
17.1.5 Downloading modules ................................................................................................................................278
17.1.6 Debugger sessions.......................................................................................................................................290
17.2 Viewing a program ................................................................................................................................................295
17.2.1 Opening the Editor window........................................................................................................................296
17.2.2 Opening the Disassembly window..............................................................................................................302
17.2.3 Looking at the current PC position .............................................................................................................308
17.2.4 Highlighting the line at the PC....................................................................................................................308
17.3 Operating memory.................................................................................................................................................309
17.3.1 Opening the Memory window.....................................................................................................................309
17.3.2 Modifying memory contents.......................................................................................................................311
17.3.3 Selecting a memory range...........................................................................................................................312
17.3.4 Filling an area of memory with constant data.............................................................................................313
17.3.5 Copying an area of memory........................................................................................................................313
17.3.6 Comparing the memory contents ................................................................................................................314
17.3.7 Testing an area of memory..........................................................................................................................315
17.3.8 Saving memory contents in a text file.........................................................................................................315
17.3.9 Finding a value in memory .........................................................................................................................316
17.3.10 Changing the display address......................................................................................................................316
17.3.11 Changing the scroll area..............................................................................................................................317
17.3.12 Starting address to value of the register ......................................................................................................317
17.3.13 Tracking the stack pointer position.............................................................................................................317
17.3.14 Changing the program display position immediately after downloading....................................................318
17.3.15 Refreshing the Memory window.................................................................................................................318
17.3.16 Disabling refresh of the Memory window ..................................................................................................318
17.3.17 Regularly refreshing the Memory window .................................................................................................318
17.3.18 Specifying the refresh interval ....................................................................................................................319

High-performance Embedded Workshop Contents
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
vii
17.3.19 Changing the data length.............................................................................................................................319
17.3.20 Changing the radix......................................................................................................................................319
17.3.21 Changing the code.......................................................................................................................................320
17.3.22 Setting the layout ........................................................................................................................................320
17.3.23 Changing the number of digits displayed....................................................................................................320
17.3.24 Switching display or non-display of measurement result............................................................................320
17.3.25 Saving an area of memory...........................................................................................................................321
17.3.26 Loading a memory area from a file.............................................................................................................321
17.3.27 Splitting up the window display..................................................................................................................322
17.3.28 Verifying a memory area ............................................................................................................................322
17.3.29 Changing text colors ...................................................................................................................................323
17.4 Displaying memory contents as an Image.............................................................................................................323
17.4.1 Opening the Image window........................................................................................................................324
17.4.2 Regularly refreshing the Image window.....................................................................................................327
17.4.3 Refreshing the Image window.....................................................................................................................327
17.4.4 Specifying the refresh interval ....................................................................................................................327
17.4.5 Viewing Images as Consecutive Frames.....................................................................................................328
17.4.6 Displaying the pixel information.................................................................................................................330
17.5 Displaying memory contents as Waveforms .........................................................................................................331
17.5.1 Opening the Waveform window.................................................................................................................331
17.5.2 Regularly refreshing the Waveform window..............................................................................................332
17.5.3 Refreshing the Waveform window .............................................................................................................333
17.5.4 Specifying the refresh interval ....................................................................................................................333
17.5.5 Zoom-in display..........................................................................................................................................333
17.5.6 Zoom-out display........................................................................................................................................333
17.5.7 Resetting the zoom display .........................................................................................................................333
17.5.8 Setting the zoom magnification...................................................................................................................333
17.5.9 Setting the horizontal scale .........................................................................................................................334
17.5.10 Non-display of cursor..................................................................................................................................334
17.5.11 Displaying the sampling information..........................................................................................................334
17.6 Looking at I/O memory .........................................................................................................................................334
17.6.1 Opening the IO window..............................................................................................................................335
17.6.2 Expanding an I/O register display...............................................................................................................336
17.6.3 Modifying the values of I/O registers .........................................................................................................336
17.6.4 Refreshing the IO window ..........................................................................................................................337
17.6.5 Disabling refresh of the IO window............................................................................................................337
17.6.6 Selecting the I/O register(s) to view............................................................................................................337
17.6.7 Loading an I/O file......................................................................................................................................338
17.6.8 Printing the currently displayed contents....................................................................................................339
17.6.9 Saving the currently displayed contents......................................................................................................339
17.6.10 Finding an I/O register................................................................................................................................339
17.6.11 Finding the next ..........................................................................................................................................339
17.7 Looking at registers ...............................................................................................................................................340
17.7.1 Opening the Register window.....................................................................................................................340
17.7.2 Changing the register display radix.............................................................................................................341
17.7.3 Switching Register Bank.............................................................................................................................341
17.7.4 Setting the layout ........................................................................................................................................342
17.7.5 Choosing a register to be displayed.............................................................................................................342
17.7.6 Modifying register contents ........................................................................................................................343
17.7.7 Setting the flag value...................................................................................................................................344
17.7.8 Splitting up the window display..................................................................................................................344
17.7.9 Saving register contents ..............................................................................................................................344

High-performance Embedded Workshop Contents
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
viii
17.7.10 Refreshing the Register window.................................................................................................................344
17.7.11 Disabling refresh of the Register window...................................................................................................344
17.7.12 Using register contents................................................................................................................................345
17.7.13 Changing text colors ...................................................................................................................................345
17.8 Resetting the target MCU......................................................................................................................................345
17.9 Setting PC to the address at cursor ........................................................................................................................345
17.10 Initializing the debugging platform .......................................................................................................................345
17.11 Connecting/disconnecting the debugging platform ...............................................................................................346
17.12 Executing your program ........................................................................................................................................346
17.12.1 Continuing run ............................................................................................................................................346
17.12.2 Running from reset......................................................................................................................................346
17.12.3 Running program, ignoring any breakpoints...............................................................................................347
17.12.4 Running to cursor........................................................................................................................................347
17.12.5 Running from a specified address...............................................................................................................347
17.12.6 Continuing execution to a main function at a reset.....................................................................................348
17.12.7 Single step...................................................................................................................................................348
17.12.8 Multiple steps..............................................................................................................................................349
17.13 Stopping your program..........................................................................................................................................350
17.13.1 Stopping the program by the Halt toolbar button........................................................................................350
17.13.2 Standard breakpoints (PC breakpoints).......................................................................................................350
17.14 Viewing the current status .....................................................................................................................................351
17.15 Viewing the function call history...........................................................................................................................352
17.15.1 Opening the Stack Trace window ...............................................................................................................352
17.15.2 Viewing the source program.......................................................................................................................353
17.15.3 Specifying the view.....................................................................................................................................353
17.16 Using an external debugger ...................................................................................................................................353
17.16.1 Configuring the Hitachi Debugging Interface to integrate with High-performance Embedded Workshop354
17.16.2 Configuring the PD debugger to integrate with High-performance Embedded Workshop.........................354
17.16.3 Configuring an external debugger to integrate with High-performance Embedded Workshop..................355
17.17 Debugging functions dependent on the debugger..................................................................................................356
17.17.1 Looking at labels.........................................................................................................................................356
17.17.2 Elf/Dwarf2 support .....................................................................................................................................359
17.17.3 Looking at variables....................................................................................................................................363
18. Synchronized Debugging.........................................................................................................376
18.1 The Synchronized Debug dialog box.....................................................................................................................376
18.1.1 Managing configurations ............................................................................................................................377
18.1.2 Defining the synchronized Debuggers........................................................................................................378
18.1.3 Setting the synchronization options ............................................................................................................381
18.1.4 Setting the memory update option ..............................................................................................................382
18.1.5 Synchronized debugging mode...................................................................................................................382
18.1.6 Start synchronized debugging.....................................................................................................................382
18.1.7 Update synchronized debugging.................................................................................................................383
18.1.8 Stop synchronized debugging.....................................................................................................................383
18.2 Using High-performance Embedded Workshop while synchronized....................................................................383
18.2.1 Common functionality ................................................................................................................................383
18.2.2 Parallel mode functionality.........................................................................................................................386
18.2.3 Internal mode functionality.........................................................................................................................387
18.3 Using the command line window when synchronized...........................................................................................388
18.4 Glossary of terms...................................................................................................................................................389
19. Technical Support....................................................................................................................390
19.1 Viewing the version information ...........................................................................................................................390

High-performance Embedded Workshop Contents
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
ix
19.2 Check for updates ..................................................................................................................................................390
19.3 Creating a bug report .............................................................................................................................................391
Reference ...........................................................................................................................................392
1. Main Menus .............................................................................................................................393
1.1 File Menu Options.................................................................................................................................................393
1.2 Edit Menu Options.................................................................................................................................................393
1.3 View Menu Options...............................................................................................................................................394
1.4 Project Menu Options............................................................................................................................................395
1.5 Build Menu Options...............................................................................................................................................395
1.6 Debug Menu Options.............................................................................................................................................396
1.7 Setup Menu Options ..............................................................................................................................................397
1.8 Tools Menu Options ..............................................................................................................................................397
1.9 Test Menu Options ................................................................................................................................................398
1.10 Window Menu Options..........................................................................................................................................398
1.11 Help Menu Options................................................................................................................................................398
2. Windows ..................................................................................................................................399
3. Commands ...............................................................................................................................400
3.1 Command List (Alphabetic Order)........................................................................................................................400
3.2 Command List (Listed by Function)......................................................................................................................401
4. Regular Expressions.................................................................................................................404
5. Placeholders.............................................................................................................................405
5.1 What is a placeholder?...........................................................................................................................................405
5.2 Inserting a placeholder...........................................................................................................................................405
5.3 Available placeholders...........................................................................................................................................406
5.4 Placeholder tips......................................................................................................................................................407
6. I/O File Format.........................................................................................................................408
7. Symbol File Format .................................................................................................................410
8. Keyboard Shortcuts..................................................................................................................411
9. Drag and Drop in the Debugger...............................................................................................413
10. Using Labels to View Your Code............................................................................................414
11. Integrated Toolbars in a Components View ............................................................................416
12. To Build in Toolchain for High-performance Embedded Workshop V.1.x............................418
13. HMAKE User Guide................................................................................................................419
13.1 Command line........................................................................................................................................................419
13.2 File syntax..............................................................................................................................................................419
13.3 Description blocks .................................................................................................................................................420
13.4 Comments..............................................................................................................................................................422
13.5 Message commands...............................................................................................................................................422

High-performance Embedded Workshop 1. Overview
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
1
1. Overview
The functions for High-performance Embedded Workshop version 4.05.00 are explained in this manual.
This chapter describes the fundamental concepts of the High-performance Embedded Workshop.
1.1 Workspaces, projects and files
Just as a word processor allows you to create and modify documents, the High-performance Embedded Workshop
allows you to create and modify workspaces.
A workspace can be thought of as a container of projects and, similarly, a project can be thought of as a container of
project files. Thus, each workspace contains one or more projects and each project contains one or more files. The
figure below illustrates this graphically:
Workspaces allow you to group related projects together. For example, you may have an application that needs to be
built for different processors, or you may be developing an application and library at the same time. Projects can also be
linked hierarchically within a workspace, which means that when one project is built all of its ‘child’ projects are built
first.
However, workspaces on their own are not very useful – we need to add a project to a workspace and then add files to
that project before we can actually do anything.
1.2 Main window
There are three main windows: the workspace window, the editor window and the output window. The workspace
window shows the projects and files that are currently in the workspace; the editor window provides file viewing and
editing facilities; and the output window shows the results of a various processes (e.g. build, version control commands
and so on).

High-performance Embedded Workshop 1. Overview
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
2
1.2.1 Title bar
The title bar displays the name of current activate project and file. It also contains the standard Minimize, Maximize
and Close buttons. Click the Minimize button to minimize the High-performance Embedded Workshop on the
Windows® task bar. Click the Maximize button to force High-performance Embedded Workshop to fill the screen.
Click the Close button to close the High-performance Embedded Workshop (this has the same effect as selecting [File -
> Exit], or pressing ALT+F4).
1.2.2 Menu bar
The menu bar initially contains eleven menus: File,Edit,View,Project,Build *,Debug,Setup,Tools,Test, Window
and Help. All of the menu options are grouped logically under these headings. For instance, if you want to open a file
then the File menu is where you will find the right menu option; if you want to set-up a tool then the Tools menu is the
correct selection.
Note:
*.If you use a debug-only project "Debugger only - xxxxxx" created by High-performance Embedded Workshop
V.4.01 or a later version, the Build menu will not be displayed by default. The Build menu is displayed, however, if
the debug-only project "Debugger only - xxxxxx" has been created by High-performance Embedded Workshop
earlier than V.4.01.

High-performance Embedded Workshop 1. Overview
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
3
1.2.3 Toolbars
The toolbars provide a shortcut to the options that you will use the most often. There are twelve default toolbars:
Editor, Search, Templates, Bookmarks, Default Window, Standard, Version Control, Map, Macros, Debug,
Debug Run,and System Tools (as shown in the figures below).
With the default session, the High-performance Embedded Workshop does not initially display buttons of Version
Control and peripheral functions on the toolbar.
If you use a debug-only project “Debugger only – xxxxxx” created by High-performance Embedded Workshop V.4.01
or a later version, Editor, Search, Templates, Bookmarks, Default Window, and Standard will not be displayed by
default.
Toolbars can be created, modified and removed via [Tools -> Customize] (see section 6.1, Customizing the toolbars,
for further information).
Editor toolbar
Search toolbar
Templates toolbar
Bookmarks toolbar
Default Window toolbar

High-performance Embedded Workshop 1. Overview
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
4
Standard toolbar
Version Control toolbar
This toolbar is only available when a version control tool is being used in the current project.
Map toolbar
Macros toolbar
You can add a customized button, to which a created macro has been assigned, on the right to the standard macro
buttons on the toolbar as shown below.
Debug toolbar
This toolbar is only available when a session is being used which has a target attached.
Debug Run toolbar
This toolbar is only available when a session is being used which has a target attached.

High-performance Embedded Workshop 1. Overview
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
5
System Tools toolbar
You can add an external tool button, to which an external tool menu has been assigned, on the right to the system tool
button on the toolbar as shown below.
When the Standard toolbar is docked, it has a Control bar as shown in the figure below. If you want to move the docked
Standard toolbar, click and drag its Control bar to the new location. The figure below shows the Standard toolbar when
it is docked and also when it is floating.
To dock a toolbar
Select one of the following operations:
•Double-click on the title bar of a floating toolbar, OR
•Drag the title bar of a floating toolbar and draw it toward an edge of a docked window, menu bar, toolbar or
the High-performance Embedded Workshop main frame, on whose edge you would like to dock the window,
until the shape of the floating bar changes.
To float a toolbar
Select one of the following operations:
•Double-click on the control bar of a docked toolbar, OR
•Drag the control bar of a docked toolbar and draw it away from the edge of the High-performance Embedded
Workshop main frame and from an edge of the other docked windows, menu bar or toolbars.
1.2.4 Workspace window
The Workspace window has four tabs (Projects, Templates, Navigation, and Test).