Renesas REJ10J1837-0100 User Manual

REJ10J1837-0100

High-performance Embedded Workshop V.4.05

User's Manual

Renesas Microcomputer Development Environment System

Rev.1.00
Nov. 16, 2008

Notes regarding these materials

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.

High-performance Embedded Workshop Introduction

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 applicatio n.

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 CT RL key

and then, whilst holding the CTRL key down, press the N key.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008

High-performance Embedded Workshop Introduction

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 a ny t y pes 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 tr ademarks of their respective companies.

For inquiries about the contents of this document or product, email to your local d istributor.
Renesas Tools Homepage http://www.renesas.com/tools

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008

High-performance Embedded Workshop Contents

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

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
i

High-performance Embedded Workshop Contents

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

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
ii

High-performance Embedded Workshop Contents

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 Wor kshop re gist ration 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

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
iii

High-performance Embedded Workshop Contents

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

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
iv

High-performance Embedded Workshop Contents

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 Em bedded Wor kshop pr oducts )........................217

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
v

High-performance Embedded Workshop Contents

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

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
vi

High-performance Embedded Workshop Contents

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

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
vii

High-performance Embedded Workshop Contents

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

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
viii

High-performance Embedded Workshop Contents

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

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
ix

High-performance Embedded Workshop 1. Overview

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 though t 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 lib rary 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).

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
1

High-performance Embedded Workshop 1. Overview

1.2.1 Title bar

Th

e 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

e menu bar initially contains eleven menus: File, Edit, View, Project, Build *, Debug, Setup, Tools, Test, Window

Th
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 bee n created by Hi g h- performance Embedded Workshop
earlier than V.4.01.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
2

High-performance Embedded Workshop 1. Overview

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 Embedd ed Wor kshop 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

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
3

High-performance Embedded Workshop 1. Overview

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.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
4

High-performance Embedded Workshop 1. Overview

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 Wor

kspace window has four tabs (Projects, Templates, Navigation, and Test).

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
5

High-performance Embedded Workshop 1. Overview

• Projects tab

Allows you to show the current workspace, projects and files. You can quickly open any project file or dependent file
by double-clicking on its icon. See section 2.2, Configuring the Projects tab of the Workspace window, for more
information on the Projects tab.

If you hover the mouse pointer over a file in the Projects tab then the file’s full path will be displayed in a tool tip.

• Templates tab

Allows you to display template settings. See section 4.11, Templates, for more information about a template.

• Navigation tab

Allows you to provide jumps to various textual constructs within your project’s files. What is actually displayed within
the Navigation tab depends upon what components are currently installed. The figure above shows C macro definitions
(C Defines) and C functions (C Functions) conforming to the ANSI standard. See Chapter 12, Navigation Facilities, for
more information about navigation.

• Test tab

Allows you to setup or view test suites as part of the test-support facility. See Chapter 16, Using the Test Support
Facility, for more information about the test-support facility.

To allow the Workspace window or the Output window docking

Right-click anywhere inside the Workspace window or the Output window. Then a pop-up menu will be displayed.

If the Allow Docking option is checked, docking is allowed. Otherwise, docking is not allowed. Select the Allow
Docking option to check or un-check it.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
6

High-performance Embedded Workshop 1. Overview

When the Allow Docking option is checked, you can dock a window, toolbar or menu bar to the edge of the High­performance Embedded Workshop main window or to the edge of another docked window. You can also float them
‘above’ the other High-performance Embedded Workshop windows or outside the High-per fo rmance Embedded
Workshop main window. Figure (i) below shows a docked “Workspace” window, and figure (ii) below shows a floating
“Workspace” window.

When the Workspace window or the Output window is docked, it has a control bar as shown below.
If you want to move a docked window, click and drag its control bar to the new location.

To dock the Workspace window or the Output window

1. Ensure that the Allow Docking option is checked on the window’s pop-up menu.

2. Select one of the following operations:

• Double-click on the title bar of a floating window, OR

• Drag the title bar of a floating window and draw it toward an edge of a docked window, menu bar or

toolbar, or the High-performance Embedded Workshop main frame, on whose edge you would like to dock
the windows.

To float the Workspace window or the Output window

1. Ensure that the Allow Docking option is checked on the window’s pop-up menu.

2. Select one of the following operations:

• Double-click on the contro l bar of a docked window, OR

• Drag the control bar of a docked window 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 toolbar.

• Drag the control bar of a docked window while pressing the "CTRL" key.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
7

High-performance Embedded Workshop 1. Overview

To hide the Workspace window or the Output window

Select one of the following operations:

• Click on the close button, which is located in the top right corner of the window, OR

• Right-click anywhere inside a floating window and select the Hide option on the pop-up menu.

To show the Workspace window or the Output window
Select [View -> Workspace] or [View -> Output] respectively.

1.2.5 Editor window

e editor window is where you will work with the files of your project. The High-performance Embedded Workshop

Th
allows you to have many files open at one time, to switch between them, to arrange them and to edit them in whichever
order you want to. By default, the editor window is displayed in a notebook style. This means that each file has a
separate tab associated with it to aid in navigating between files (see the figure below).

The editor contains a gutter (column) on the left-hand side of the window. The standard column allows the user to
configure the position of bookmarks and software breakpoints (*) quickly and easily. If you are unsure what purpose a
column has or what the information it is displaying is if you place the mouse pointer over the column a tool tip (pop-up
window) is displayed showing its identity.

The editor window can be customized via the Format Views dialog box, which can be invoked via [Setup -> Format
Views]. This dialog box allows you to configure fonts, colors, tabs and so on for the editor window. It also allows the
user to change the look of other views, which have been installed by High-performance Embedded Workshop. If you
would prefer to use your favorite editor rather than th e High-p erformance Embedd ed Workshop internal editor then
specify your alternative in the Options dialog box, which can be invoked via [Setup -> Options]. For further details on
how to use the editor, see Chapter 4, Using the Editor.

Note:
*. Allows you to set software breakpoints only when the debugger is connected to the session.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
8

High-performance Embedded Workshop 1. Overview

1.2.6 Output window

The Output window, by default, has seven tabs (Build, Debug, Find in Files 1, Find in Files 2, Macro, Test, and
Version Control) on display.

Build tab

The Build tab shows the output from any build process (e.g. compiler, assembler and so on). If an error is encountered
in a source file, an icon and the error message will be displayed in the Build tab, along with the source file name and
line number.

If you click on a toolbar button or pop-up menu option associated with display of error messages, the line of the error
message will be highlighted and the editor will show the source code of that line (if the line has any source code).

Double-clicking the line of an error message will also show the source code in the editor.
When you attempt an operation to display an error or warning, the status bar shows this error or warning message.
Right-clicking displays a pop-up menu containing available options.
A basic operation is allocated to the toolbar.
The functions of Toolbar display and Customize toolbar are also included in the pop-up menu displayed by right-

clicking the toolbar area.

Pop-up Menu Option Toolbar Button Function

-

-

-

­Display next

Error/Warning/Info
Display previous

Error/Warning/Info
Help

Go to Error/Warning/Info - Goes to the associated source line.
Clear Window

Save
Copy

Toolbar display - Shows or hides the toolbar.
Customize toolbar - Customizes toolbar buttons.

Highlights the next occurrence of error and shows the source code in the editor.
Highlights the previous occurrence of error and shows the source code in the editor.
Highlights the next occurrence of warning and shows the source code in the editor.
Highlights the previous occurrence of warning and shows the source code in the editor.
Displays the editor that generated the next build error or warning.

Displays the editor that generated the previous build error or warning.

Shows the help information about the line.

Clears the contents of the window.
Saves the contents of the window into a text file.
Copies the selected contents onto the Windows® clipboard.

The Build tab also shows an icon corresponding to the error message output by build execution.

Icon Name Icon Error Message Level

Build Error
Build Warning
Information

Error
Warning
Information

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
9

High-performance Embedded Workshop 1. Overview

Debug tab

Shows the output from any debugger process. Any debug component that needs to display information will send its
output to this window.

Right-clicking displays a pop-up menu containing available options.
A basic operation is allocated to the toolbar.
The functions of Toolbar display and Customize toolbar are also included in the pop-up menu displayed by right-

clicking the toolbar area.

Pop-up Menu Option Toolbar Button Function

Clear Window
Save
Copy

Toolbar display - Shows or hides the toolbar.
Customize toolbar - Customizes toolbar buttons.

Clears the contents of the window.
Saves the contents of the window into a text file.
Copies the selected contents onto the Windows® clipboard.

Find in Files 1 and Find in Files 2 tab
Shows the results of the last Find in Files action. To activate find in files, select [Edit -> Find In Files], or click the

Find In Files toolbar button. For further details on using Find in Files, see section 4.4.2, Finding text in multiple files.

Right-clicking displays a pop-up menu containing available options.
A basic operation is allocated to the toolbar.
The functions of Toolbar display and Customize toolbar are also included in the pop-up menu displayed by right-

clicking the toolbar area.

Pop-up Menu Option Toolbar Button Function

Go to Occurrence - Go to the associated source line.
Clear Window

Save
Copy
Toolbar display - Shows or hides the toolbar.

Customize toolbar - Customizes toolbar buttons.

Clears the contents of the window.
Saves the contents of the window into a text file.
Copies the selected contents onto the Windows® clipboard.

Macro tab

Shows the current records of macros (macro-recording support facility). You can view information such as High­performance Embedded Workshop command-line commands recorded into a High-performance Embedded Workshop
macro file from execution of [Tools -> Macro Recording] to [Tools -> Stop Macro]. It is also possible to view this
information while recording. For details on the macro-recording support facility, see Chapter 15, Using the Macro­Recording Support Facility.

Right-clicking displays a pop-up menu containing available options.
A basic operation is allocated to the toolbar.
The functions of Toolbar display and Customize toolbar are also included in the pop-up menu displayed by right-

clicking the toolbar area.

Pop-up Menu Option Toolbar Button Function

Clear Window
Save
Copy
Toolbar display - Shows or hides the toolbar.

Customize toolbar - Customizes toolbar buttons.

Clears the contents of the window.
Saves the contents of the window into a text file.
Copies the selected contents onto the Windows® clipboard.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
10

High-performance Embedded Workshop 1. Overview

Test tab

Shows the results and progress of the current test execution (test support facility). The test execution progress shows
the current test being executed and the number of tests remaining. If errors occur then these are displayed in this
window. For details on the test-support facility, see Chapter 16, Using the Test Support Facility.

Right-clicking displays a pop-up menu containing available options.
A basic operation is allocated to the toolbar.
The functions of Toolbar display and Customize toolbar are also included in the pop-up menu displayed by right-

clicking the toolbar area.

Pop-up Menu Option Toolbar Button Function

Clear Window
Save
Copy

Toolbar display - Shows or hides the toolbar.
Customize toolbar - Customizes toolbar buttons.

Clears the contents of the window.
Saves the contents of the window into a text file.
Copies the selected contents onto the Windows® clipboard.

Version Control tab

Shows the results of version control actions. The tab is only displayed if a version control system is in use. For further
details on version control, see Chapter 7, Version Control.

Right-clicking displays a pop-up menu containing available options.
A basic operation is allocated to the toolbar.
The functions of Toolbar display and Customize toolbar are also included in the pop-up menu displayed by right-

clicking the toolbar area.

Pop-up Menu Option Toolbar Button Function

Clear Window
Save
Copy

Toolbar display - Shows or hides the toolbar.
Customize toolbar - Customizes toolbar buttons.

Clears the contents of the window.
Saves the contents of the window into a text file.
Copies the selected contents onto the Windows® clipboard.

Press the "SHIFT+ESC" key, and the Output window closes.
The color of text or background and font shown in the Output window can be customized in the same manner as in

other windows. You can also customize the Build tab of the Output window so that the texts in the lines of error
messages will be highlighted in a color different from that of the texts in other lines.

To customize the current colors

1. Select [Setup -> Format Views] to open the Format Views dialog box.

2. Select the Output item from the tree in the left-hand section of the dialog box and expand it.

3. Select the category for which you wish to change the color from the table below.

Category Foreground Color of the

Color Tab (Default)

Text SYSTEM SYSTEM All tabs All
Build Error Text Black White Build Error
Build Warning Text Black White Build Warning
Information Text Black White Build Information

Background Color of the
Color Tab (Default)

Tab(s) to be
Applied

Type of Output to
be Applied

4. Change the selection in the Foreground and Background lists of the Color tab.

5. Click the OK button.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
11

High-performance Embedded Workshop 1. Overview

1.2.7 Status bar

The status bar displays various information about the current state of the High-performance Embedded Workshop. The
figure below shows the status bar.

The customizable status bar feature allows the user to customize the display of the status bar area and its contents. The
status bar will also now show target-related information where required by the specific target being used.

The bottom section of the status bar area shows the standard application-based information as in previous version of
High-performance Embedded Workshop. Abo ve this is the target-related information. The information displayed here is
completely target dependant, and in some cases there may not be any target-related information to display.

The status bar can be switched on and off via [View -> Status Bar]. When any part of the status bar area is visible, this
main menu option will completely switch off the status bar area. When the status bar is completely hidden, this main
menu option will switch on the application-based section of the status bar.

The status bar can also be switched off via the status bar pop-up menu. The pop-up menu allows individual status bar
items to be toggled on and off; including both application and target related areas as well as individual items on each.

The pop-up menu can be displayed by selecting the right-mouse button over the status bar area.

Note:
*. The entire target related area of the status bar is hidden depending on the target being used.

All target related status bar items are switched off, the entire target related area of the status bar will be hidden by
default. This can be re-shown by switching on one or more target related individual status bar items.

1.3 Help system

The Help menu is the rightmost menu on the High-performance Embedded Workshop menu bar. It contains the Help
Topics menu option, which, when selected, takes you to the main High-performance Embedded Workshop help

window.
To obtain help on specific dialogs click the context-sensitive help button, which is located in the top right-hand corner

of each dialog (as shown in the figure below).

When this is clicked, the mouse pointer will change to a pointer with a question mark above it. Whilst the mouse
pointer is in this state, click on the part of the dialog that you require assistance on. Alternatively, select the control for
which you require help, and press the F1 key.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
12

High-performance Embedded Workshop 1. Overview

1.4 Launching the High-performance Embedded Workshop

To initiate the High-performance Embedded Workshop, open the Start menu of Windows®, select Programs, select
Renesas, select High-performance Embedded Workshop, and then select the shortcut of the High-performance

Embedded Workshop. The Welcome! dialog box will be displayed after the start-up screen.

If you have recently used a workspace, Open a recent project workspace is selected by default. Otherwise Create a
new project workspace is selected.

To create a new workspace select the Create a new project workspace button and click the OK button.
To open one of the recent project workspaces select the Open a recent project workspace button, select a workspace

from the drop-down list, and click the OK button. The Recent Workspace list displays the same content as that seen in
the workspace most recently used File list. This list also appears on the File menu.

To open a workspace by specifying a workspace file (".HWS" file), select the Browse to another project workspace
button, and click the OK button.

To open the Synchronized Debug dialog box select the Start synchronized session button and select a configuration
from the drop-down list and click the OK button. This item is only available when a synchronized debugging facility
has been used.

To register or un-register a tool from the High-performance Embedded Workshop, click the Administration button.
Click the Cancel button to use the High-performance Embedded Workshop without opening a workspace.
If you do not wish to open the Welcome! dialog box next time you launch the High-performance Embedded Workshop,

select [Setup -> Options]. The Options dialog box opens. Remove a tick mark from the Display Welcome Dialog
checkbox in the Confirmation tab.

If you do not wish to view the start-up screen when launching the High-performance Embedded Workshop, remove a
tick mark from the Display Splash Screen checkbox in the Confirmation tab of the Options dialog box.

1.5 Creating a new workspace

To create a new workspace

1. Select the Create a new project workspace option from the Welcome! dialog box and click the OK button or

select [File -> New Workspace]. The New Project Workspace dialog box will be displayed.

2. Enter the name of the new workspace into the Workspace Name field. This can be up to 32 characters in

length and contain letters, numbers, and the underscore character. Especially, do not use a minus sign, or a
space. As you enter the workspace name, the High-performance Embedded Workshop will add a sub-directory
and Project Name for you automatically. This can be changed if desired. This allows the workspace and

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
13

High-performance Embedded Workshop 1. Overview

project name to be different. To select the directory in which you would like to create the workspace, use the
Browse button or type the directory into the Directory field manually.

3. Select the CPU family and Tool chain upon which you would like to base the workspace.

4. When a new workspace is created, the High-performance Embedded Workshop will also automatically create

a project with the name specified in the Project Name field and place it inside the new workspace. The
project types list displays all of the available project types (e.g. Application, Library etc.). Select the type of
project that you want to create from this list. The project types displayed will be all valid types for the current
pair of CPU family and Tool chain. The project types are classified in three classes: toolchain-only, debug­only (Debugger only - xxxxxx), and full project generator that configures both the debugger and toolchain
aspect of the High-performance Embedded Workshop.

5. Click the OK button to create the new workspace and project. This then launches the wizard you have selected

to guide you through the creation process.

Note:
It is not possible to create a workspace if one already exists in the same directory.

1.6 Opening a workspace

To open a workspace

1. Select Browse to another project workspace option from the Welcome! dialog box and click the OK button

or select [File -> Open Workspace]. The Open Workspace dialog box will be displayed.

2. Select the workspace file (".HWS" file) that you want to open.

3. Click the Select button to open the workspace. If the High-performance Embedded Workshop is set up to

display information when a workspace is opened, the Workspace Properties dialog box will be displayed.
Otherwise, the workspace will be opened.
Note that whether the Workspace Properties dialog box is shown depends on the setting of either the Show
workspace information on workspace open check box in the Workspace Properties dial og bo x o r the
Display workspace information dialog on opening workspace check box on the Workspace tab of the Options
dialog box. The Options dialog box can be invoked via [Setup -> Option s]. Click the OK button in the
Workspace Properties dialog box to open the workspace. Click the Cancel button to stop opening the
workspace.

The High-performance Embedded Workshop keeps track of the last workspaces that you have opened and adds them to
the File menu under the Recent Workspaces submenu. This gives you a shortcut to opening workspaces, which you
have used recently.

To open a recently used workspace

Select Open a recent project workspace in the Welcome! dialog box, select the name of the workspace from the
drop-down list, and then click the OK button.

Another way is to select [File -> Recent Workspaces], and then from this submenu select the name of the workspace.

Note:
The High-performance Embedded Workshop only permits one workspace to be open at a time. Consequently, if you

attempt to open a second workspace, the first will be closed before the new one is opened.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
14

High-performance Embedded Workshop 1. Overview

1.7 Using old workspaces

The High-performance Embedded Workshop can open any workspace that was created on a previous version of the
High-performance Embedded Workshop. This should be automatically upgraded when the workspace is opened. A
back-up version of the initial workspace or project file must be saved in the current directory of the file that has been
upgraded.

1.8 Saving a workspace

The amount of information on workspaces (and projects) to be saved increases as the High-performance Embedded
Workshop is upgraded. Thus the format in which workspaces can be saved is slightly different depending on the version
of the High-performance Embedded Worksh op.

To save a High-performance Embedded Workshop workspace in the current version's format, select [File -> Save
Workspace].

To save the workspace in a previous version's format, select [File -> Save Workspace As]. If the current workspace
has changed since it was last changed, you will be prompted to save it (to the current file and version). The Save
Workspace As dialog box will then be launched:

This contains a list of all the files currently associated with the workspace, a drop-list control containing a list of
available versions (the current version is selected by default) and an edit control where you can enter a short prefix that
will be used to change the name of all the associated files. When the prefix is changed, the File list is updated to display
the new names.

For example, to save the workspace in a format that can be loaded from High-performance Embedded
Workshop V.4.02.00

1. Set the Format drop-down list: HEW 4.02.00 Format

2. Enter Prefix: 402_

3. Click OK.

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
15

High-performance Embedded Workshop 1. Overview

A copy of the workspace will be saved into the current directory (so all the source files, etc. will remain in use) but with
the entered prefix, e.g.:

C:\Workspace\Workspace_Name\402_Workspace_Name.hws

C:\Workspace\Workspace_Name\Projet_Name\402_Projet_Name.hwp

C:\Workspace\Workspace_Name\Projet_Name\402_DefaultSession.hsf
C:\Workspace\Workspace_Name\Projet_Name\402_SimSessionSH-1.hsf

Note that the current workspace (in this example 4.05.00) remains loaded as the working copy.

1.9 Closing a workspace

To close a High-performance Embedded Workshop workspace, select the [File -> Close Workspace] menu option. If
there are any outstanding changes to the workspace or any of its projects you will be requested whether or not you wish
to save them.

1.10 Exiting the High-performance Embedded Workshop

The High-performance Embedded Workshop can be exited by selecting [File -> Exit], pressing ALT+F4, or by
selecting the close option from the system menu (which is opened by clicking the icon at the upper-left corner of the
High-performance Embedded Workshop title bar).

1.11 Component system overview

The High-performance Embedded Workshop allows the user to extend the High-performance Embedded Workshop
functionality by adding additional components to the system. This is achieved by registering the component in the
Tools Administration dialog box. These components can add windows, menus and toolbars to the High-performance
Embedded Workshop system. Examples of the components are the debugger and builder components of High­performance Embedded Workshop. The debugger component adds all of the menus and toolbars associated with the
debugger and the builder component does the same for the build functionality. The components you have registered in
the system will modify the look and feel of High-performance Embedded Workshop. In some cases you may not have
some of the menus which you can see in this manual. For instance if the builder component is not installed you will not
have the toolchain menu option in the Build menu.

1.12 Management information files of High-performance Embedded Workshop

The High-performance Embedded Workshop has the following files containing management information necessary for
its correct operation.

• A file in which application-level setting is stored

• A file in which the default positions of windows are recorded

• High-performance Embedded Workshop database files

• Component's data files *

• Keyboard shortcut layout files

• Macro information file and newly added macro files

• Custom project-type wizard files

• Syntax highlighting files

• Templates files

• Synchronized debug option config urati o n fi l e s *

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
16

High-performance Embedded Workshop 1. Overview

Note:
*. Support for this function depends on the debugger.

These files are specific to each user account on the host computer. When multiple versions of the High-per fo rmance
Embedded Workshop are installed, the files specific to each High-performance Embedded Workshop are saved for each
user account.

1.13 Overview of Configurations and Sessions

The drop-down list box on the Standard toolbar shows the current configuration and session.
This example shows the configuration and session in which the Renesas SuperH Standard toolchain was selected at

creation of a project and "SH-4 Simulator" was selected as the target debugging platform.
You can switch between different configurations and sessions by selecting one in the drop-down list box.
It is also possible to add or delete configurations or sessions as necessary.

• Configuration

What is config uration?

Configurations are the build option settings (e.g., output of debug information or optimization) having their own names.
The term "configuration" can also be referred to as "build configuration".

In the figure of the Standard toolbar shown as an example, configurations "SimDebug_SH-4", "Debug", and "Release"
are available.

Configurations created by the High-performance Embedded Workshop
When a project is created after selection of the toolchain, the High-performance Embedded Workshop automatically

creates configurations "Debug" and "Release".

REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
17