User’s Manual
H8 Family E10T-USB Emulator
User’s Manual
H8 Family E10T-USB
HS0005TCU01HE

All information contained in these materials, including products and product specifications,represents information on the product at the time of publication and is subject to change byRenesas Electronics Corporation without notice. Please review the latest information publishedby Renesas Electronics Corporation through various means, including the Renesas Electronics
Corporation website (http://www.renesas.com).

www.renesas.com

Rev. 5.00

Aug. 2012Notice1.

Descriptions of circuits, software and other related information in this document are provided only to illustrate the operation ofsemiconductor products and application examples. You are fully responsible for the incorporation of these circuits, software,and information in the design of your equipment. Renesas Electronics assumes no responsibility for any losses incurred by youor third parties arising from the use of these circuits, software, or information.

2.

Renesas Electronics has used reasonable care in preparing the information included in this document, but Renesas Electronics
does not warrant that such information is error free. Renesas Electronics assumes no liability whatsoever for any damages
incurred by you resulting from errors in or omissions from the information included herein.

3.

Renesas Electronics does not assume any liability for infringement of patents, copyrights, or other intellectual property rights ofthird parties by or arising from the use of Renesas Electronics products or technical information described in this document. No
license, express, implied or otherwise, is granted hereby under any patents, copyrights or other intellectual property rights ofRenesas Electronics or others.

4.

You should not alter, modify, copy, or otherwise misappropriate any Renesas Electronics product, whether in whole or in part.
Renesas Electronics assumes no responsibility for any losses incurred by you or third parties arising from such alteration,
modification, copy or otherwise misappropriation of Renesas Electronics product.

5.

Renesas Electronics products are classified according to the following two quality grades: “Standard” and “High Quality”. The
recommended applications for each Renesas Electronics product depends on the product’s quality grade, as indicated below.
“Standard”:

Computers; office equipment; communications equipment; test and measurement equipment; audio and visualequipment; home electronic appliances; machine tools; personal electronic equipment; and industrial robots etc.

“High Quality”: Transportation equipment (automobiles, trains, ships, etc.); traffic control systems; anti-disaster systems; anticrime systems; and safety equipment etc.
Renesas Electronics products are neither intended nor authorized for use in products or systems that may pose a direct threat tohuman life or bodily injury (artificial life support devices or systems, surgical implantations etc.), or may cause serious property
damages (nuclear reactor control systems, military equipment etc.). You must check the quality grade of each Renesas
Electronics product before using it in a particular application. You may not use any Renesas Electronics product for any
application for which it is not intended. Renesas Electronics shall not be in any way liable for any damages or losses incurredby you or third parties arising from the use of any Renesas Electronics product for which the product is not intended by Renesas
Electronics.
6.

You should use the Renesas Electronics products described in this document within the range specified by Renesas Electronics,
especially with respect to the maximum rating, operating supply voltage range, movement power voltage range, heat radiation
characteristics, installation and other product characteristics. Renesas Electronics shall have no liability for malfunctions or
damages arising out of the use of Renesas Electronics products beyond such specified ranges.

7.

Although Renesas Electronics endeavors to improve the quality and reliability of its products, semiconductor products havespecific characteristics such as the occurrence of failure at a certain rate and malfunctions under certain use conditions. Further,
Renesas Electronics products are not subject to radiation resistance design. Please be sure to implement safety measures toguard them against the possibility of physical injury, and injury or damage caused by fire in the event of the failure of a Renesas
Electronics product, such as safety design for hardware and software including but not limited to redundancy, fire control andmalfunction prevention, appropriate treatment for aging degradation or any other appropriate measures. Because the evaluationof microcomputer software alone is very difficult, please evaluate the safety of the final products or systems manufactured by
you.

8.

Please contact a Renesas Electronics sales office for details as to environmental matters such as the environmental compatibilityof each Renesas Electronics product. Please use Renesas Electronics products in compliance with all applicable laws andregulations that regulate the inclusion or use of controlled substances, including without limitation, the EU RoHS Directive.
Renesas Electronics assumes no liability for damages or losses occurring as a result of your noncompliance with applicable laws
and regulations.

9.

Renesas Electronics products and technology may not be used for or incorporated into any products or systems whose
manufacture, use, or sale is prohibited under any applicable domestic or foreign laws or regulations. You should not use
Renesas Electronics products or technology described in this document for any purpose relating to military applications or use
by the military, including but not limited to the development of weapons of mass destruction. When exporting the Renesas
Electronics products or technology described in this document, you should comply with the applicable export control laws andregulations and follow the procedures required by such laws and regulations.

10. It is the responsibility of the buyer or distributor of Renesas Electronics products, who distributes, disposes of, or otherwise
places the product with a third party, to notify such third party in advance of the contents and conditions set forth in thisdocument, Renesas Electronics assumes no responsibility for any losses incurred by you or third parties as a result of
unauthorized use of Renesas Electronics products.
11. This document may not be reproduced or duplicated in any form, in whole or in part, without prior written consent of Renesas
Electronics.
12. Please contact a Renesas Electronics sales office if you have any questions regarding the information contained in this document
or Renesas Electronics products, or if you have any other inquiries.
(Note 1) “Renesas Electronics” as used in this document means Renesas Electronics Corporation and also includes its majorityowned subsidiaries.
(Note 2) “Renesas Electronics product(s)” means any product developed or manufactured by or for Renesas Electronics.
(2012.4)

Regulatory Compliance Notices
z European Union regulatory notices
This product complies with the following EU Directives. (These directives are only valid in the European Union.)

CE Certifications:• Electromagnetic Compatibility (EMC) Directive 2004/108/EC
EN 55022 Class A

WARNING:

This is a Class A product. In a domestic environment this product may cause radio
interference in which case the user may be required to take adequate measures.

EN 55024• Information for traceability• Authorised representative
Name:
Renesas Electronics Corporation
Address:
1753, Shimonumabe, Nakahara-ku, Kawasaki,
Kanagawa, 211-8668, Japan• Manufacturer
Name:
Renesas Solutions Corp.
Address:
Nippon Bldg., 2-6-2, Ote-machi, Chiyoda-ku, Tokyo
100-0004, Japan• Person responsible for placing on the market
Name:Renesas Electronics Europe GmbH
Address:
Arcadiastrasse 10, 40472 Dusseldorf, Germany• Trademark and Type nameTrademark:Renesas
Product name:
E10T-USB Emulator
Type name:
HS0005TCU01H

Environmental Compliance and Certifications:• Restriction of the Use of Certain Hazardous Substances in Electrical and Electronic Equipment (RoHS)
Directive 2002/95/EC• Waste Electrical and Electronic Equipment (WEEE) Directive 2002/96/EC

z United States Regulatory notices
This product complies with the following EMC regulation. (This is only valid in the United States.)

FCC Certifications:This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part
15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference
when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiateradio frequency energy and, if not installed and used in accordance with the instruction manual, may cause
harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause
harmful interference in which case the user will be required to correct the interference at his own expense.

This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:(1) this device may not cause harmful interference, and (2) this device must accept any interference received,
including interference that may cause undesired operation.

CAUTION:

Changes or modifications not expressly approved by the party responsible forcompliance could void the user's authority to operate the equipment.

IMPORTANT INFORMATIONREAD FIRST• READ this user's manual before using this emulator product.
• KEEP the user's manual handy for future reference.
Do not attempt to use the emulator product until you fully understand its mechanism.
Emulator Product:
Throughout this document, the term "emulator product" shall be defined as the following
products produced only by Renesas Electronics Corp. excluding all subsidiary products.
• Emulator• User system interface cable
The user system or a host computer is not included in this definition.
Purpose of the Emulator Product:
This emulator product is a software and hardware development tool for systems employing theRenesas microcomputer. This emulator product must only be used for the above purpose.
Limited Applications:This emulator product is not authorized for use in MEDICAL, atomic energy, aeronautical or
space technology applications without consent of the appropriate officer of a Renesas sales
company. Such use includes, but is not limited to, use in life support systems. Buyers of thisemulator product must notify the relevant Renesas sales offices before planning to use the productin such applications.
Improvement Policy:
Renesas Electronics Corp. (including its subsidiaries, hereafter collectively referred to as
Renesas) pursues a policy of continuing improvement in design, performance, and safety of theemulator product. Renesas reserves the right to change, wholly or partially, the specifications,design, user's manual, and other documentation at any time without notice.
Target User of the Emulator Product:
This emulator product should only be used by those who have carefully read and thoroughly
understood the information and restrictions contained in the user's manual. Do not attempt to use
the emulator product until you fully understand its mechanism.
It is highly recommended that first-time users be instructed by users that are well versed in theoperation of the emulator product.
R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page I of VI

LIMITED WARRANTY
Renesas warrants its emulator products to be manufactured inaccordance with published specifications and free from defects inmaterial and/or workmanship. Renesas, at its option, will replace any
emulator products returned intact to the factory, transportation charges
prepaid, which Renesas, upon inspection, shall determine to be defective
in material and/or workmanship. The foregoing shall constitute the sole
remedy for any breach of Renesas’ warranty. See the Renesas warranty
booklet for details on the warranty period. This warranty extends only
to you, the original Purchaser. It is not transferable to anyone who
subsequently purchases the emulator product from you. Renesas is notliable for any claim made by a third party or made by you for a third
party.

DISCLAIMER
RENESAS MAKES NO WARRANTIES, EITHER EXPRESS OR
IMPLIED, ORAL OR WRITTEN, EXCEPT AS PROVIDEDHEREIN, INCLUDING WITHOUT LIMITATION THEREOF,
WARRANTIES AS TO MARKETABILITY, MERCHANTABILITY,
FITNESS FOR ANY PARTICULAR PURPOSE OR USE, OR
AGAINST INFRINGEMENT OF ANY PATENT. IN NO EVENTSHALL RENESAS BE LIABLE FOR ANY DIRECT, INCIDENTAL
OR CONSEQUENTIAL DAMAGES OF ANY NATURE, OR
LOSSES OR EXPENSES RESULTING FROM ANY DEFECTIVE
EMULATOR PRODUCT, THE USE OF ANY EMULATORPRODUCT, OR ITS DOCUMENTATION, EVEN IF ADVISEDOF THE POSSIBILITY OF SUCH DAMAGES. EXCEPT AS
EXPRESSLY STATED OTHERWISE IN THIS WARRANTY,THIS EMULATOR PRODUCT IS SOLD "AS IS ", AND YOU
MUST ASSUME ALL RISK FOR THE USE AND RESULTSOBTAINED FROM THE EMULATOR PRODUCT.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page II of VI

State Law:
Some states do not allow the exclusion or limitation of implied warranties or liability forincidental or consequential damages, so the above limitation or exclusion may not apply to you.
This warranty gives you specific legal rights, and you may have other rights which may vary fromstate to state.
The Warranty is Void in the Following Cases:
Renesas shall have no liability or legal responsibility for any problems caused by misuse,abuse, misapplication, neglect, improper handling, installation, repair or modifications of theemulator product without Renesas’ prior written consent or any problems caused by the user
system.
All Rights Reserved:
This user's manual and emulator product are copyrighted and all rights are reserved byRenesas. No part of this user's manual, all or part, may be reproduced or duplicated in any form,in hard-copy or machine-readable form, by any means available without Renesas’ prior writtenconsent.
Other Important Things to Keep in Mind:
1. Circuitry and other examples described herein are meant merely to indicate the characteristics
and performance of Renesas’ semiconductor products. Renesas assumes no responsibility for
any intellectual property claims or other problems that may result from applications based on
the examples described herein.
2. No license is granted by implication or otherwise under any patents or other rights of any third
party or Renesas.
Figures:
Some figures in this user's manual may show items different from your actual system.
Device names:
This user’s manual uses H8/xxxx as an example of the device name.
Limited Anticipation of Danger:
Renesas cannot anticipate every possible circumstance that might involve a potential hazard.
The warnings in this user's manual and on the emulator product are therefore not all inclusive.
Therefore, you must use the emulator product safely at your own risk.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page III of VI

SAFETY PAGE
READ FIRST• READ this user's manual before using this emulator product.
• KEEP the user's manual handy for future reference.
Do not attempt to use the emulator product until you fully understand its mechanism.

DEFINITION OF SIGNAL WORDS
This is the safety alert symbol. It is used to alert you to potential personal
injury hazards. Obey all safety messages that follow this symbol to avoid
possible injury or death.

DANGERWARNINGCAUTIONCAUTIONDANGER indicates an imminently hazardous situation which, if not
avoided, will result in death or serious injury.
WARNING indicates a potentially hazardous situation which, if not
avoided, could result in death or serious injury.
CAUTION indicates a potentially hazardous situation which, if not
avoided, may result in minor or moderate injury.
CAUTION used without the safety alert symbol indicates apotentially hazardous situation which, if not avoided, may resultin property damage.

NOTE emphasizes essential information.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page IV of VI

WARNING
Observe the precautions listed below. Failure to do sowill result in a FIRE HAZARD and will damage the user
system and the emulator product or will result in
PERSONAL INJURY. The USER PROGRAM will be
LOST.
1. Do not repair or remodel the emulator product by
yourself for electric shock prevention and quality
assurance.
2. Always switch OFF the host computer and user systembefore connecting or disconnecting any CABLES or
PARTS.
3. Connect the connectors in the user system and in theuser interface cable by confirming the correct direction.

CAUTION
Caution to Be Taken for Disposal:
Penalties may be applicable for incorrect disposal of this waste, in accordancewith your national legislation.

European Union regulatory notices:
The WEEE (Waste Electrical and Electronic Equipment) regulations put
responsibilities on producers for the collection and recycling or disposal ofelectrical and electronic waste. Return of WEEE under these regulations isapplicable in the European Union only. This equipment (including allaccessories) is not intended for household use. After use the equipment
cannot be disposed of as household waste, and the WEEE must be treated,recycled and disposed of in an environmentally sound manner.
Renesas Electronics Europe GmbH can take back end of life equipment,
register for this service at “http://www.renesas.eu/weee”.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page V of VI

Warnings on Emulator Usage
Be sure to read and understand the warnings below before using this emulator. Note that these are
the main warnings, not the complete list.

WARNING
Always switch OFF the host computer and user systembefore connecting or disconnecting any CABLES or PARTS.
Failure to do so will result in a FIRE HAZARD and will
damage the user system and the emulator product or will
result in PERSONAL INJURY. The USER PROGRAM will be
LOST.

CAUTION
Place the host computer and user system so that nocable is bent or twisted. A bent or twisted cable will impose
stress on the user interface leading to connection or contact
failure.
Make sure that the host computer and the user system
are placed in a secure position so that they do not move
during use nor impose stress on the user interface.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page VI of VI

Introduction
The High-performance Embedded Workshop is a powerful development environment for embedded applications targeted
at Renesas microcontrollers. The main features are:
• A configurable build engine that allows you to set-up compiler, assembler and linker options via an easy to useinterface.
• An integrated text editor with user customizable syntax coloring to improve code readability.
• A configurable environment 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, witha set of powerful development tools and, secondly, to unify and present them in a way that is easy to use.

About This ManualThis manual describes preparation before using the emulator, emulator functions, debugging functions specific to theemulator, tutorial, and emulator's hardware and software specifications.
Refer to the High-performance Embedded Workshop User's Manual for details on the information on the basic usage ofthe High-performance Embedded Workshop, customization of the environment, build functions, and debugging functions
common to each High-performance Embedded Workshop product.
This 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 manuals.
Microsoft® and Windows® are registered trademarks of Microsoft Corporation.
Visual SourceSafe is a trademark of Microsoft Corporation.
IBM is a registered trademark of International Business Machines Corporation.
All brand or product names used in this manual are trademarks or registered trademarks of their respective companies ororganizations.

Document Conventions
This manual uses the following typographic conventions:
Table 1

Typographic Conventions
Convention[Menu->Menu Option]

Meaning
Bold text with ‘->’ is used to indicate menu options(for example, [File->Save As...]).

FILENAME.C

Uppercase names are used to indicate filenames.

“enter this string”

Used to indicate text that must be entered (excluding the “” quotes).

Key + Key

Used to indicate required key presses. For example, CTRL+N
means press the CTRL key and then, whilst holding the CTRL key
down, press the N key.

(The “how to” symbol)

When this symbol is used, it is always located in the left handmargin. It indicates that the text to its immediate right is describing“how to” do something.

User Registration
When you install debugger software, a text file for user registration is created on your PC. Fill it in and email it to yourlocal distributor. If you have replaced an emulator main unit or emulation probe, rewrite an emulator name and serial
number in the text file you filled in earlier to register your new hardware products.

Your registered information is used for only after-sale services, and not for any other purposes. Without user registration,
you will not be able to receive maintenance services such as a notification of field changes or trouble information. So be
sure to carry out the user registration.

For more information about user registration, please contact your local distributor.

Table of Contents
Section 1 Overview................................................................................................................................ 1
1.1
1.2
1.3

Warnings ................................................................................................................................................................... 3
Environmental Conditions ........................................................................................................................................ 4
Components .............................................................................................................................................................. 5

Section 2 Emulator Functions ................................................................................................................ 7
2.1
2.2

Overview................................................................................................................................................................... 7
Trace Functions......................................................................................................................................................... 9
2.2.1
Branch Trace Function ................................................................................................................................... 9
2.3
Break Function........................................................................................................................................................ 10
2.4
Memory Access Functions...................................................................................................................................... 11
2.5
Stack Trace Function .............................................................................................................................................. 12
2.6
Online Help............................................................................................................................................................. 12

Section 3 Preparation before Use......................................................................................................... 13
3.1
Emulator Preparation .............................................................................................................................................. 13
3.2
Emulator Hardware Configuration.......................................................................................................................... 14
3.3
CD-R....................................................................................................................................................................... 19
3.4
Installing Emulator’s Software ............................................................................................................................... 19
3.5
Connecting the Emulator to the Host Computer ..................................................................................................... 20
3.6
Connecting the Emulator to the User System ......................................................................................................... 22
3.7
Connecting System Ground .................................................................................................................................... 25
3.8
Setting the DIP Switches......................................................................................................................................... 26
3.9Interface Circuits in the Emulator ........................................................................................................................... 28
3.10 Setting up the Emulator........................................................................................................................................... 30
3.10.1
Setting up at Purchasing the Emulator or Updating the Version of Software .............................................. 30
3.11 System Check.......................................................................................................................................................... 35
3.12 Uninstalling the Emulator’s Software..................................................................................................................... 46

Section 4 Preparations for Debugging ................................................................................................. 51
4.1

Method for Activating High-performance Embedded Workshop........................................................................... 51
4.1.1
Creating the New Workspace (Toolchain Not Used) ................................................................................... 52
4.1.2
Creating the New Workspace (Toolchain Used) .......................................................................................... 56
4.1.3
Selecting an Existing Workspace ................................................................................................................. 62
4.2
Setting at Emulator Activation................................................................................................................................ 64
4.2.1
Setting at Emulator Activation ..................................................................................................................... 64
4.2.2
Downloading a Program............................................................................................................................... 66
4.2.3
Setting the Program Flash Mode .................................................................................................................. 68
4.3
Debug Sessions ....................................................................................................................................................... 75
4.3.1
Selecting a Session ....................................................................................................................................... 75
4.3.2
Adding and Removing Sessions................................................................................................................... 77
4.3.3
Saving Session Information.......................................................................................................................... 80
4.4
Connecting the Emulator ........................................................................................................................................ 81
4.5
Reconnecting the Emulator ..................................................................................................................................... 82
4.6
Ending the Emulator ............................................................................................................................................... 83

Section 5 Debugging............................................................................................................................ 85
5.1

Setting the Environment for Emulation .................................................................................................................. 85
5.1.1
Opening the [Configuration] Dialog Box..................................................................................................... 85
5.1.2[General] Page.............................................................................................................................................. 85
5.2
Downloading a Program ......................................................................................................................................... 88
5.2.1
Downloading a Program............................................................................................................................... 88
5.2.2
Viewing the Source Code............................................................................................................................. 89
5.2.3
Viewing the Assembly-Language Code ....................................................................................................... 92

5.2.4
Modifying the Assembly-Language Code.................................................................................................... 94
5.2.5
Viewing a Specific Address ......................................................................................................................... 95
5.2.6
Viewing the Current Program Counter Address........................................................................................... 95
5.3
Using the Event Points ............................................................................................................................................ 96
5.3.1
PC Breakpoints............................................................................................................................................. 96
5.3.2
Break Conditions.......................................................................................................................................... 96
5.3.3
Opening the [Event] Window....................................................................................................................... 96
5.3.4
Setting PC Breakpoints ................................................................................................................................ 97
5.3.5
Add............................................................................................................................................................... 98
5.3.6
Edit ............................................................................................................................................................... 98
5.3.7
Enable........................................................................................................................................................... 98
5.3.8
Disable.......................................................................................................................................................... 98
5.3.9
Delete ........................................................................................................................................................... 98
5.3.10
Delete All ..................................................................................................................................................... 98
5.3.11
Go to Source................................................................................................................................................. 98
5.3.12[Set Break] Dialog Box ................................................................................................................................ 99
5.3.13
Setting Break Conditions............................................................................................................................ 101
5.3.14
Edit... .......................................................................................................................................................... 102
5.3.15
Enable......................................................................................................................................................... 102
5.3.16
Disable........................................................................................................................................................ 102
5.3.17
Delete ......................................................................................................................................................... 102
5.3.18
Delete All ................................................................................................................................................... 102
5.3.19Go to Source............................................................................................................................................... 103
5.3.20
Editing Break Conditions ........................................................................................................................... 103
5.3.21
Modifying Break Conditions...................................................................................................................... 103
5.3.22
Enabling Break Conditions ........................................................................................................................ 103
5.3.23Disabling Break Conditions ....................................................................................................................... 103
5.3.24
Deleting Break Conditions ......................................................................................................................... 103
5.3.25
Deleting All Break Conditions ................................................................................................................... 103
5.3.26
Viewing the Source Line for Break Conditions ......................................................................................... 104
5.3.27[Break condition 1] Dialog Box ................................................................................................................. 104
5.4
Viewing the Trace Information............................................................................................................................. 106
5.4.1
Opening the [Trace] Window..................................................................................................................... 106
5.4.2
Acquiring Trace Information...................................................................................................................... 106
5.4.3
Clearing the Trace Information .................................................................................................................. 107
5.4.4
Saving the Trace Information in a File....................................................................................................... 107
5.4.5
Viewing the [Editor] Window .................................................................................................................... 107
5.4.6
Trimming the Source.................................................................................................................................. 107
5.5
Synchronizing Multiple Debugging Platforms ..................................................................................................... 108
5.5.1
Distinguishing Two Emulators................................................................................................................... 109

Section 6 Tutorial............................................................................................................................... 113
6.1
6.2
6.3
6.4
6.5
6.6

Introduction........................................................................................................................................................... 113
Running the High-performance Embedded Workshop ......................................................................................... 113
Setting up the Emulator......................................................................................................................................... 113
Setting the [Configuration] Dialog Box ................................................................................................................ 114
Checking the Operation of RAM .......................................................................................................................... 116
Downloading the Tutorial Program ...................................................................................................................... 118
6.6.1
Downloading the Tutorial Program............................................................................................................ 118
6.6.2
Displaying the Source Program.................................................................................................................. 119
6.7
Setting a PC Breakpoint........................................................................................................................................ 120
6.8
Setting Registers ................................................................................................................................................... 121
6.9
Executing the Program.......................................................................................................................................... 123
6.10 Reviewing Breakpoints ......................................................................................................................................... 126
6.11 Viewing Memory .................................................................................................................................................. 127
6.12 Watching Variables............................................................................................................................................... 129
6.13 Stepping Through a Program ................................................................................................................................ 133
6.13.1
Executing [Step In] Command ................................................................................................................... 133

6.13.2
Executing [Step Out] Command ................................................................................................................ 135
6.13.3
Executing [Step Over] Command .............................................................................................................. 136
6.14 Forced Breaking of Program Executions .............................................................................................................. 138
6.15 Displaying Local Variables................................................................................................................................... 139
6.16 Break Function...................................................................................................................................................... 140
6.16.1
PC Break Function ..................................................................................................................................... 140
6.17 Hardware Break Function ..................................................................................................................................... 146
6.18 Trace Functions..................................................................................................................................................... 151
6.18.1
Displaying the Trace Window.................................................................................................................... 151
6.19 Stack Trace Function ............................................................................................................................................ 152
6.20 What Next? ........................................................................................................................................................... 154

Section 7 Maintenance and Guarantee............................................................................................... 155
7.1
7.2
7.3
7.4

User Registration .................................................................................................................................................. 155
Maintenance.......................................................................................................................................................... 155
Guarantee .............................................................................................................................................................. 155
Repair Provisions .................................................................................................................................................. 156
7.4.1
Repair with Extra-Charge........................................................................................................................... 156
7.4.2
Replacement with Extra-Charge................................................................................................................. 156
7.4.3
Expiration of the Repair Period.................................................................................................................. 156
7.4.4
Transportation Fees at Sending Your Product for Repair .......................................................................... 156
7.5
How to Make a Request for Repair....................................................................................................................... 157

Appendix A

Troubleshooting ....................................................................................................... 159

Appendix B

Window Functions.................................................................................................... 161

Appendix C

Command-Line Functions ........................................................................................ 167

Appendix D

Notes on High-performance Embedded Workshop ................................................. 169

Appendix E

Diagnostic Test Procedure ........................................................................................ 175

Appendix F

Repair Request Sheet ................................................................................................ 177

H8 Family E10T-USB Emulator

Section 1 Overview

Section 1 Overview
The High-performance Embedded Workshop is a graphical user interface intended to ease thedevelopment and debugging of applications written in C/C++ programming language andassembly language for Renesas microcomputers. Its aim is to provide a powerful yet intuitive wayof accessing, observing and modifying the debugging platform in which the application is running.
The E10T-USB emulator (hereafter referred to as the emulator) is a software and hardware
development support tool for application systems using the Renesas original microcomputer.
The main unit of the emulator is connected, through the dedicated debugging interface, to the user
system. The user system can be debugged under the conditions similar to the actual application
conditions. The emulator enables debugging anywhere indoors or out. The host computer forcontrolling the emulator must be an IBM PC compatible machine with USB 1.1/2.0 (Full-Speed).
Figure 1.1 shows the system configuration using the emulator.

Connected to
the USB connector

USB cable (1.5 m)

US

B

US
B

T

E10

I/F

RENESAS

Host computer (with USB interface)

User system interface cable

ACT

CD-R

User system

Emulator (main unit)

HEW

Connected to
the USB connector

User system connector

Figure 1.1 System Configuration with the Emulator

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 1 of 180

H8 Family E10T-USB Emulator

Section 1 Overview

The emulator provides the following features:• Excellent cost-performance emulator
Compactness and connection to the USB are obtained.
• Realtime emulation
Realtime emulation of the user system is enabled at the maximum operating frequency of theCPU.
• Excellent operability®

®

Using the High-performance Embedded Workshop on the Microsoft Windows 2000 or®
®
Microsoft Windows XP operating system enables user program debugging using a pointing
device such as a mouse. The High-performance Embedded Workshop enables high-speed
downloading of load module files.
• Various debugging functions
Various break and trace functions enable efficient debugging. Breakpoints and breakconditions can be set by the specific window, trace information can be displayed on a window,
and command-line functions can be used.
• Debugging of the user system in the final development stage
The user system can be debugged under conditions similar to the actual application conditions.
• Compact debugging environment
When the emulator is used, a laptop computer can be used as a host computer, creating a
debugging environment in any place.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 2 of 180

H8 Family E10T-USB Emulator

1.1

Section 1 Overview

Warnings

CAUTION
READ the following warnings before using the emulator
product. Incorrect operation will damage the user system andthe emulator product. The USER PROGRAM will be LOST.
1. Check all components against the component list after unpacking the emulator.
2. Never place heavy objects on the casing.
3. Protect the emulator from excessive impacts and stresses. For details, refer to section 1.2,
Environmental Conditions.
4. When moving the host computer or user system, take care not to vibrate or damage it.
5. After connecting the cable, check that it is connected correctly. For details, refer to section 3,
Preparation before Use.
6. Supply power to the connected equipment after connecting all cables. Cables must not be
connected or removed while the power is on.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 3 of 180

H8 Family E10T-USB Emulator

1.2

Section 1 Overview

Environmental Conditions

CAUTION
Observe the conditions listed in tables 1.1 and 1.2 whenusing the emulator. Failure to do so will cause illegal
operation in the user system, the emulator product, and theuser program.
Table 1.1 Environmental Conditions
Item

Specifications

Temperature

Operating:Storage:+10°C to +35°C–10°C to +50°C

Humidity

Operating:Storage:

35% RH to 80% RH, no condensation
35% RH to 80% RH, no condensation

Vibration

Operating:2.45 m/s max.
2
Storage:
4.9 m/s max.
2
Transportation:
14.7 m/s max.

Ambient gases

No corrosive gases may be present

2

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 4 of 180

H8 Family E10T-USB Emulator

Section 1 Overview

Table 1.2 lists the acceptable operating environments.
Table 1.2 Operating Environments
Item

Description

Host computer

Built-in Pentium III or higher-performance CPU (1 GHz or higher
recommended); IBM PC or compatible machine with USB 1.1/2.0 (FullSpeed).

Operating system

Windows 2000 or Windows XP

Minimum memory
capacity

128 Mbytes or more (512 Mbytes recommended)

Hard-disk capacity

Installation disk capacity: 400 Mbytes or more. (Prepare an area atleast double the memory capacity (four-times or more recommended)as the swap area.)

Pointing device such as
mouse

Connectable to the host computer; compatible with Windows 2000 or®
Windows XP.

Display

Monitor resolution: 1024 x 768 or higher

Power voltage

5.0 ± 0.25 V (USB-bus power type)

Current consumption

HS0005TCU01H: 260 mA (max.)

CD-ROM drive

Required to install the High-performance Embedded Workshop for theemulator or refer to the emulator user’s manual.

1.3

®

®

®

®

Components

Check that all of the components are present when unpacking the product. For details on theemulator components, refer to section 1.1 in the additional document, Supplementary Information
on Using the H8/xxxx. If all of the components are not present, contact your nearest Renesas sales
office.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 5 of 180

H8 Family E10T-USB Emulator

Section 1 Overview

R20UT2177EJ0500 Rev. 5.00

Page 6 of 180

Aug 30, 2012

H8 Family E10T-USB Emulator

Section 2 Emulator Functions

Section 2 Emulator Functions
This section describes the emulator functions. They differ according to the device supported by
the emulator. For the usage of each function, refer to section 6, Tutorial.

2.1

Overview

Table 2.1 gives a functional overview of the emulator.
For details on the functions of each product, refer to the online help.
Table 2.1 Emulator Functions
No.

Item

Function

1

User program executionfunction

Executes a program with the operating frequency within a range
guaranteed by devices.
Reset emulation
Step functions:Single step (one step: one instruction)
Source-level step (one step: one-line source)
Step over (a break did not occur in a subroutine)
Step out (when the PC points to a location within a subroutine,
execution continues until it returns to the calling function)

2

Reset function

3

Trace functions

Issues a power-on reset from the High-performance Embedded
Workshop to the device during break.
Trace function incorporated in the device
Branch trace (conditions and the number of branches differ
depending on the device)

4

Break functions

Hardware break condition (conditions and the number ofconditions differ depending on the device)
PC break condition (255 points)
Forced break function

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 7 of 180

H8 Family E10T-USB Emulator

Section 2 Emulator Functions

Table 2.1 Emulator Functions (cont)
No.

Item

5

Memory access functions

Function•

Downloading to RAM•

Downloading to flash memory•

Single-line assembly•

Reverse assembly (disassembly)•

Reading of memory•

Writing to memory•

Automatic updating of a display of selected variables during
user program execution

•

Fill

•

Search

•

Move

•

Copy

6

General/control register
access function

Reads or writes the general/control registers.

7

Internal I/O register
access function

Reads or writes the internal I/O registers.

8

Source-level debugging
function

Various source-level debugging functions.

9Command line function

Supports command input.
Batch processing is enabled when a file is created by arranging
commands in input order.

10

Help function

Describes the usage of each function or command syntax input
from the command line window.

The specific functions of the emulator are described in the next section.
Note: The number of hardware break conditions, trace conditions, and branches differs
depending on the MCU. For the specification of each MCU, refer to the online help or the
additional document.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 8 of 180

H8 Family E10T-USB Emulator

2.2

Section 2 Emulator Functions

Trace Functions

The emulator has a trace function.
Notes: 1. The number of branch instructions that can be acquired by a trace differs according to
the product. For the number that can be specified for each product, refer to the online
help.
2. The bus trace function is not supported for all products. For details on thespecifications of each product, refer to the online help.
2.2.1

Branch Trace Function

The branch source addresses, mnemonics, operands, and source lines are displayed. Since thisfunction uses the trace buffer built into the device, a realtime trace can be acquired.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 9 of 180

H8 Family E10T-USB Emulator

2.3

Section 2 Emulator Functions

Break Function

The emulator has the following three break functions.
(1) Hardware break function (Break condition)
Uses a break controller incorporated in the device.
The access address, instruction fetch address, data, or bus cycle condition can be set. The
logical address is the address condition.
This function can be also set from the [EVENT] column in the source window. For the setting,refer to section 5.2, Downloading a Program.
(2) PC break function (BREAKPOINT)
Breaks when the dedicated instruction at the specified address that has been replaced is
executed.
This function can be set in the [Breakpoint] page of the [Event] dialog box.
It can also be set when the [S/W breakpoint] column for the line to be set is double-clicked inthe [Source] or [Disassembly] window.
(3) Forced break function
Forcibly breaks the user program.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 10 of 180

H8 Family E10T-USB Emulator

2.4

Section 2 Emulator Functions

Memory Access Functions

The emulator has the following memory access functions.
(1) Memory read/write function[Memory] window: The memory contents are displayed in the window. Only the amountspecified when the [Memory] window is opened can be read. Since there isno cache in the emulator, read cycles are always generated. If the memory is
written in the [Memory] window, read cycles in the range displayed in the[Memory] window will occur for updating the window. When the [Memory]
window is not to be updated, change the setting in [Lock Refresh] from the
popup menu.
me command:

A command line function that reads or writes the specified amount ofmemory at the specified address.

(2) User program downloading function
A load module registered in the workspace can be downloaded. Such module can be selectedfrom [Download Module] in the [Debug] menu. Downloading is also possible by a popup menu
that is opened by right-clicking on the mouse at the load module in the workspace. The user
program is downloaded to the RAM or flash memory.
This function also downloads information required for source-level debugging such as debugging
information.
(3) Memory data uploading function
The specified amount of memory from the specified address can be saved in a file.
(4) Memory data downloading function
The memory contents saved in a file can be downloaded. Select [Load] from the popup menu in
the [Memory] window.
(5) Displaying the variable contents
The variable contents specified in the user program are displayed.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 11 of 180

H8 Family E10T-USB Emulator

Section 2 Emulator Functions(6) Other memory operation functions
Other functions are as follows:• Memory fill
• Memory copy
• Memory save
• Memory verify• Memory search• Internal I/O display• Displaying label and variable names and their contents
For details, refer to the online help.
Note: Memory access during user program execution:
When memory is accessed from the memory window, etc. during execution of the user
program, the user program is resumed after it has stopped in the emulator to access thememory. Therefore, realtime emulation cannot be performed.

2.5

Stack Trace Function

The emulator uses the information on the stack to display the names of functions in the sequenceof calls that led to the function to which the program counter is currently pointing. This function
can be used only when the load modules that have the following formats are loaded:–H8, H8/300 series C/C++ compiler (such as [R0C40008XSW06R]): Elf/Dwarf2
For the usage of this function, refer to section 6.19, Stack Trace Function.

2.6

Online Help

An online help explains the usage of each function or the command syntax that can be enteredfrom the command line window.
Select [Emulator Help] from the [Help] menu to view the emulator help.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 12 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

Section 3 Preparation before Use
3.1

Emulator Preparation

Unpack the emulator and prepare it for use as follows:

WARNINGREAD the reference sections shaded in figure 3.1 before
using the emulator product. Incorrect operation will damage
the user system and the emulator product. The USERPROGRAM will be LOST.
Reference
Unpack the emulator

Component list

Check the components against the component list
When the emulator
is used first.
Set up the emulator- Install the emulator's software(Check the components and register the user information.)- Insert the emulator

Start the High-performance Embedded Workshop

Section 3

Section 4
When the emulator
is used for second
time or later.

Turn on the user system
Input the user system reset signal

Figure 3.1 Emulator Preparation Flow Chart

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 13 of 180

H8 Family E10T-USB Emulator

3.2

Section 3 Preparation before Use

Emulator Hardware Configuration

As shown in figure 3.2, the emulator consists of an emulator, a USB cable, and a user systeminterface cable. The emulator is connected to the host computer via USB 1.1, and also to the USB
port conforming to USB 2.0.

Figure 3.2 Emulator Hardware Configuration (when the 20-pin Type Connector is Used)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 14 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

The names of each section of the emulator are explained next.
Emulator Top View:

Figure 3.3 Emulator Top View(a) E10T-USB logo plate: A blue plate (for HS0005TCU01H) dedicated for the emulator isprovided to be easily distinguished from other E-series emulators.
(b) Sliding switch cover:A cover to protect switches for setting the emulator, which is closed
to prevent incorrect operation. Be sure to close this cover during
emulation.

(c) ACTION LED:

Marked ‘ACT’. When this LED is lit, the E10T-USB control
software is in operation.

(d) Host connector:

Marked ‘’. A connector for the host computer is provided at theside of this mark.

(e) User connector:

Marked ‘USER I/F’. A connector for the user system interface cableis provided at the side of this mark.

Note: Even if the LED is not lit, the USB is not disconnected or malfunctioned.
R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 15 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

Emulator Host-side View:

Figure 3.4 Emulator Host-side View(a)Host-side connector:

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

A USB connector for the host computer. Be sure to connect theprovided USB cable.

Page 16 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

Emulator User-side View:

Figure 3.5 Emulator User-side View(a) User-side connector:

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

A user system interface cable is connected.

Page 17 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

Emulator Bottom View:(a)Figure 3.6 Emulator Bottom View(a) Label for product management:

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

The serial number, revision, and safety standard, etc. ofthe emulator are written to. The contents differ dependingon the time when you purchased the product.

Page 18 of 180

H8 Family E10T-USB Emulator

3.3

Section 3 Preparation before Use

CD-R

The root directory of the CD-R contains a setup program for installing the emulator’s software.
The folders contain the files and programs listed below.
Table 3.1 Contents of the CD-R Directories
Directory Name

Contents®

Description

Dlls

Microsoft runtime library

A runtime library for the High-performance
Embedded Workshop. The version is checked
at installation and this library is copied to thehard disk as part of the installation process.

Drivers

E10T-USB emulator driver

USB drivers for the E10T-USB emulator.

Help

Online help for the E10T-USB
emulator

An online help file. This is copied to the harddisk as part of the installation process.

Manuals

E10T-USB emulator manuals

E10T-USB emulator user’s manuals. They areprovided as PDF files.

3.4

Installing Emulator’s Software

Execute HewInstMan.exe from the root directory of the CD-R.
Follow the cues given by the installation wizard to install the software.
Note: When a driver is installed in Windows® XP, a warning message on the Windows® logo
test may be displayed, but it is not a problem. Select [Continue Anyway] to proceed withdriver installation.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 19 of 180

H8 Family E10T-USB Emulator

3.5

Section 3 Preparation before Use

Connecting the Emulator to the Host ComputerThis section describes how to connect the emulator to the host computer. For the position of eachconnector of the emulator, refer to section 3.2, Emulator Hardware Configuration.
Notes: 1. When [Add New Hardware Wizard] is displayed, select the [Search for the best driverfor your device. (Recommended)] radio button and then the [Specify a location] checkbox to select the path to be searched for drivers. The location must be specified as<Drive>:\DRIVERS. (<Drive> is the CD drive letter.)
2. Be sure to install the software for the emulator before putting the emulator in place.

WARNING
Always switch OFF the emulator product and the user
system before connecting or disconnecting any CABLES
except for the USB interface cable. Failure to do so will resultin a FIRE HAZARD and will damage the user system and theemulator product or will result in PERSONAL INJURY.
The USER PROGRAM will be LOST.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 20 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

The emulator is connected to the host computer via the USB 1.1, and also to the USB port
conforming to USB 2.0. Figure 3.7 shows the system configuration.

Figure 3.7 System Configuration when Connecting the Emulator to the Host Computer

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 21 of 180

H8 Family E10T-USB Emulator

3.6

Section 3 Preparation before Use

Connecting the Emulator to the User System

Use the procedure below to connect the emulator to the user system with the user system interface
cable, or to disconnect them when moving the emulator or the user system.
1. Check that the host computer is turned off or the emulator is not connected to the hostcomputer with the USB cable.
2. Connect the user system interface cable to the user-side connector of the emulator.
3. Connect the USB cable to the host-side connector of the emulator.
Figure 3.8 shows the position of the connector.

Figure 3.8 Position of the Connector

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 22 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use(1) The connector must be installed to the user system. Table 3.2 shows the recommended
connector for the emulator.
Table 3.2 Recommended H-UDI Port Connector
Connector

Type Number

Manufacturer

Specifications

20-pin connector

2520-6002

3M Limited

20-pin straight type(2) The pin assignments of the connector are shown in section 1 in the additional document,
Supplementary Information on Using the H8/xxxx.
(3) Connect pins 2, 4, 6, 8, 10, 12, 14, 16, and 20 (when using the 20-pin user system interface
cable) of the user system connector to GND firmly on the PCB. These pins are used aselectrical GND and to monitor the connection of the H-UDI port connector. Note the pin
assignments of the user system connector.
User system interface cableTab

GND line

User system
connector
Pin 2User system GND
connection

Pin 1

User system

Figure 3.9 Connecting the User System Interface Cable to the User System
when the 20-pin Type Connector is Used

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 23 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

CAUTION
Note that the pin number assignments of the connector
differ from those of the connector manufacturer.
Notes: 1. Connection of the signals differs depending on the package. For details, refer to the
MCU pin assignments.
2. To remove the 20-pin type user system interface cable from the user system, pull thetab on the connector upward.
3. The range of communication that the emulator operates at is different depending on the
MCU used.
4. To connect the signals from the connector, refer to section 1 in the additional
document, Supplementary Information on Using the H8/xxxx.
5. Connect the GND line of the user system interface cable firmly to GND so that it does
not touch the user system or other peripheral equipment.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 24 of 180

H8 Family E10T-USB Emulator

3.7

Section 3 Preparation before Use

Connecting System Ground

WARNING
Separate the frame ground from the signal ground at theuser system. Failure to do so will result in a FIRE HAZARD
and will damage the user system and the emulator product orwill result in PERSONAL INJURY.
The emulator's signal ground is connected to the user system's signal ground. In the emulator, thesignal ground and frame ground are connected. In the user system, connect the frame ground only;
do not connect the signal ground to the frame ground (figure 3.10).
If it is difficult to separate the frame ground from the signal ground in the user system, set the
GND for DC power input (AC adapter) of the host computer and the frame ground of the user
system as the same potential. If the GND potential is different between the host computer and thetarget system, an overcurrent will flow in the low-impedance GND line and thin lines might beburned.
Signal groundE10T-USB emulator

SignalSignalHostcomputerUser system
Logic

Logic
USB

Signal ground

Signal groundPowersupplyFrame groundFigure 3.10 Connecting System Ground

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 25 of 180

H8 Family E10T-USB Emulator

3.8

Section 3 Preparation before Use

Setting the DIP Switches

WARNING
Do not change switches (SW2 and SW3) while theemulator and the user sytem are turned on. The changing ofswitches (SW2 and SW3) will result in a FIRE HAZARD andwill damage the user system and the emulator product. The
USER PROGRAM will be LOST.
The emulator incorporates three switches; set all of them to 1 in general, and set SW1 to 0 only
when the emulator is set up.

USER I/F

RENESAS

B

US

0T

E1

1
0

ACT

1
0

1

1

2

2

3

3

ON

OFF

Figure 3.11 DIP Switches

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 26 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

Table 3.3 shows the relationships between settings and functions of DIP switches 1 to 3. Use thesettings depending on the usage of the user system.

CAUTIONUse only the settings shown in table 3.3. Use of othersettings will not activate the emulator. The USER PROGRAM
will be LOST.
• Settings for use of the 20-pin interface cable
Description: The settings of the UVCC pin of the user interface connector apply to SW2. In the
H8 family E10T-USB emulator, connect the UVCC pin to the VCC power supply that isconnected to the VCC pin of the microcomputer for the user system.
Table 3.3 Switch Settings of the E10T-USB
Switch Settings

State of the E10T-USB

SW1

SW2

SW3

UVCC

Condition

0 (off)

1

1-

The emulator is set up

1 (on)

1 (on)

1 (on)

3.0 V to 5.5 V*

NormalNote: The range differs depending on the MCU.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 27 of 180

H8 Family E10T-USB Emulator

3.9

Section 3 Preparation before UseInterface Circuits in the Emulator

Figure 3.12 shows interface circuits in the emulator. Use them as a reference to determine thevalue of the pull-up resistance.
Note: The 74LVC2G125 operates at VCC (1.8 to 5.0 V) from the user connector.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 28 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

SW2

3.3 V
0

Emulator control circuit
1

PI74AVC164245

SN74LVC2G125

AY

18 UVCC *4

1.8 V

VCC
B

User system port
connector on theuser system

22 Ω

10 kΩ
5 MD0

A

SN74LVC2G125
VCC
A

PI74AVC164245

Y

SN74LVC2G125

1.8 V

VCC
B

A

Y

22 Ω

10 kΩ
7 MD1

A

SN74LVC2G125
VCC
A

PI74AVC164245

Y

SN74LVC2G125

1.8 V

VCC
B

A

Y

22 Ω

10 kΩ
9 MD2

A

SN74LVC2G125
VCC
A

Y

SN74LVC2G125
VCC

22 Ω

A

10 kΩ
19 P95/SCK1

Y

SN74LVC2G125
VCC

22 Ω

A

PI74AVC164245

A

PI74AVC164245

SN74LVC2G125

Y

22 Ω

A

10 kΩ
15 P91/TxD1

A

SN74LVC2G125

1.8 V
22 Ω

VCC
B

17 P93/RxD1

1.8 V

VCC
B

10 kΩ

Y

Y

10 kΩ
3 FWE

A

SN74LVC2G125
VCC
A

PI74AVC164245

Y

SN74LVC2G125
VCC

B

A

Y

1.8 V
22 Ω

10 kΩ

A

1 RES# *1

SN74LVC2G125
VCC
OE
A

Y

Notes: 1. The symbol (#) means that the signal is active-low.
2. Pins 4, 6, 8, 10, 12, 14, and 16 of the user system port connector are Vss and connected to GND of the emulator.
3. Pin 2 of the user system port connector is set to Vss. However, it is connected to the input circuit equal to that forpin 15 to decide whether the user system is connected or not.
4. Pin 20, as well as pin 18, is set to VCC in accordance with the on-board flash writer. However, pin 20 can be N.C.
because it is not connected in the emulator.

Figure 3.12 Interface Circuits in the Emulator

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 29 of 180

H8 Family E10T-USB Emulator

3.10

Section 3 Preparation before Use

Setting up the Emulator

Set up the emulator’s firmware using the following procedures. Here describes how to set up theH8 device group.

CAUTION
Do not disconnect the USB cable unless instructed to do
so by an on-screen message. Incorrect operation will damage
the emulator product.
3.10.1

Setting up at Purchasing the Emulator or Updating the Version of Software

Note: The firmware needs not be updated because the latest firmware is included whenpurchasing the emulator.
1. Open the sliding switch cover and check that the switch (SW1) for setting the emulator isturned to ‘1’.
2. Select [Renesas] -> [High-performance Embedded Workshop] -> [Setup tool for E10T-USB
Emulator] -> [Setup tool for E10T-USB Emulator] from [Programs] in the [Start] menu. A tool
for setting up the emulator is activated.

Figure 3.13 [Start] Menu

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 30 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

Figure 3.14 Setup Tool for Emulator(a) Device group of the emulator firmware:Name of the device group currently set.

(b) Version number of the emulator firmware:

The version number of software for controllingthe H8 family in the emulator. This item isdisplayed only when the H8 family is available.

(c) Version number of the setup program:

The version number of the setup program.

Notes: 1. If the version numbers shown in (b) and (c) are the same, setup of the emulator is not
required. Setup the emulator only when “-.-.--.---“ is shown in (b) or the version
number of (b) is older than that of (c).
2. If an emulator other than the H8/xxxx E10T-USB is connected, the following error
message will be displayed to exit the setup tool.

Figure 3.15 Error Message

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 31 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

3. If the following error message is displayed, the host computer is not connected to theemulator or the setup switch (SW1) is turned to ‘0’.

Figure 3.16 Error Message
If the setup switch (SW1) is turned to ‘0’, set it to ‘1’ and connect the USB cable again.
3. Clicking the [Setup] button displays the following dialog box.

Figure 3.17 [Setup tool for E10T-USB Emulator] Dialog Box
4. Turn the setup switch (SW1) to ‘0’, connect the USB cable again, and click the [OK] button.
Setting up the emulator’s firmware is started.
Notes: 1. When [Add New Hardware Wizard] is displayed, select the [Search for the best driverfor your device. (Recommended)] radio button and then the [Specify a location] checkbox to select the path to be searched for drivers. The location must be specified as<Drive>:\DRIVERS. (<Drive> is the CD drive letter.)
The above case only applies when the emulator is setup initially or the USB port on thehost computer side is changed and used for first connection. The time may be required
until [Add New Hardware Wizard] is displayed.
2. When using Windows® 2000 or Windows® XP, a dialog box will be displayed to show
the disconnection of the USB. However, this is not a problem.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 32 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

Figure 3.18 Start of Setting up the Emulator
Note: Do not turn off the host computer or disconnect the USB cable while setting up theemulator. The emulator may be damaged.
5. When the following dialog box is displayed, setting up the emulator is completed.

Figure 3.19 Message for Completion of Setting up the Emulator
6. When setting up the emulator has been completed, the following message will be displayed.
Turn the setup switch (SW1) to ‘1’, connect the USB cable again, and click the [OK] button.

Figure 3.20 [Setup Tool for E10T-USB Emulator] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 33 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

Notes: 1. Be sure to turn the setup switch (SW1) to ‘1’ except when the setup tool is used.
2. To use the license tool for another device group, it is necessary to set up the firmware
by using the setup tool or license tool that corresponds to the device group. To use thesetup tool, however, the license tool must also be installed. For details on the license
tool, refer to the following section.
3. If the following dialog message is displayed, exit the setup tool by clicking the[Cancel] button. To insert the USB cable again, turn SW1 to ‘1’.

Figure 3.21 [Setup tool for E10T-USB Emulator] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 34 of 180

H8 Family E10T-USB Emulator

3.11

Section 3 Preparation before Use

System Check

When the software is executed, use the procedure below to check that the emulator is connected
correctly. Here, use the workspace for a tutorial provided on the product.
Refer to section 4, Preparations for Debugging, for the other activating method to create a new
project or use an existing workspace.
1. Connect the emulator to the host computer.
2. Connect the user system interface cable to the connector of the emulator.
3. Connect the user system interface cable to the connector in the user system.
4. Select [Renesas] -> [High-performance Embedded Workshop] -> [High-performance
Embedded Workshop] from [Programs] in the [Start] menu.

Figure 3.22 [Start] Menu
Note: The [High-performance Embedded Workshop] -> [Tools] is not displayed depending on
the user’s environment.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 35 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

5. The [Welcome!] dialog box is displayed.

Figure 3.23 [Welcome!] Dialog Box[Create a new project workspace] radio button:

Creates a new workspace.

[Open a recent project workspace] radio button:

Uses an existing workspace and displays
the history of the opened workspace.

[Browse to another project workspace] radio button:

Uses an existing workspace; this radio
button is used when the history of theopened workspace does not remain

To use a workspace for the tutorial, select the [Browse to another project workspace] radio buttonand click the [OK] button.
When the [Open workspace] dialog box is opened, specify the following directory:<Drive where the OS has been installed>:\WorkSpace\Tutorial\E10T-USB\3048F_ONE\Tutorial_1M: 1-Mbyte mode
\WorkSpace\Tutorial\E10T-USB\3048F_ONE\Tutorial_16M: 16-Mbyte mode

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 36 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

After the directory has been specified, select the following file and click the [Open] button.

Figure 3.24 [Open Workspace] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 37 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

6. The [Select Emulator mode] dialog box is displayed.

Figure 3.25 [Select Emulator mode] Dialog Box
Select the MCU name in use from the [Device] drop-down list box. The following items are
selected in the [Mode] group box.
⎯ E10T-USB Emulator
The E10T-USB emulator for the specified MCU is activated. Debugging the program isenabled.
⎯ Program FlashThe user program is programmed to the internal flash memory. Debugging the program isdisabled. To download the load module, register it in the workspace.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 38 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

7. The [Connecting] dialog box is displayed and the emulator connection is started.

Figure 3.26 [Connecting] Dialog Box
8. The dialog box is displayed as shown in figure 3.27.

Figure 3.27 Dialog Box of the Power-on Request Message
9. Power on the user system.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 39 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

10. When using the H8 family microcomputer, the dialog box shown in figure 3.28 is opened.
Input the system clock value.
The system clock is the input clock.

Figure 3.28 [System Clock] Dialog Box
11. Set an eight-digit hexadecimal ID code as a security code for the flash memory. To read thedata that has been written to the internal flash memory, input this ID code when [E10T-USB
Emulator] is selected and the [New ID code] check box is unselected on activating theemulator. If the ID code is not matched or the [New ID code] check box is selected, the flash
memory contents are erased.

Figure 3.29 [ID Code] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 40 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

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

Figure 3.30 High-performance Embedded Workshop Window
Note: When the user program has already been downloaded to the flash memory, source-level
debugging cannot be executed because there is no debugging information on the user
program after the emulator has been activated. Be sure to load the debugging information
file. For details, refer to section 4.2.1, Setting at Emulator Activation.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 41 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

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

Figure 3.31 [Connector disconnected] Dialog Box
2. If the emulator is not properly initialized, one of the dialog boxes shown in figures 3.32
through 3.38 will appear.
(a) The following dialog box is displayed when the flash memory cannot be erased.
Exchange the MCU since the flash memory has been reprogrammed more times thanthe limitation.

Figure 3.32 [Flash memory erase error!] Dialog Box
Note: If a mode is illegally set, the error message shown in figure 3.32 will be displayed.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 42 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use(b) The following dialog box is displayed when the flash memory cannot be programmed.
An incorrect system clock value has been input or the flash memory has been
reprogrammed more times than the limitation.

Figure 3.33 [Error sending Flash memory write program] Dialog Box(c) The following dialog box is displayed when an incorrect ID code has been input. For
security, the flash memory is completely erased.

Figure 3.34 [ID code error!] Dialog Box(d) The following dialog box is displayed when the MCU cannot communicate with theemulator. The MCU may not operate correctly; check the MCU settings.

Figure 3.35 [Boot Failed!] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 43 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use(e) If the following dialog box is displayed, check that the user system connector on theuser system is correctly connected.

Figure 3.36 [Connector disconnected] Dialog Box(f) If the following dialog box is displayed, the connected emulator will not be E10T-USB.
Check that the E10T-USB emulator has been connected correctly.

Figure 3.37 [The product currently connected] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 44 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use(g) If the following dialog box is displayed, the version of the firmware in the emulator
may be old. Set up the firmware by using the setup tool. For the usage of the setup
tool, refer to section 3.10, Setting up the Emulator.

Figure 3.38 [The version of the emulator firmware is incorrect] Dialog Box
3. If an incorrect driver has been selected, the following dialog box will appear.

Figure 3.39 [Unable to restore the previous driver settings] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 45 of 180

H8 Family E10T-USB Emulator

3.12

Section 3 Preparation before Use

Uninstalling the Emulator’s Software

Follow this procedure to remove the installed emulator’s software from the user’s host computer.
As the installed product is registered with the High-performance Embedded Workshop, uninstall
the product on the High-performance Embedded Workshop screen.
It is also possible to uninstall the emulator's software by using [Add/Remove Programs] in thecontrol panel. In this case, however, note that all the tools (including the compiler) in the Highperformance Embedded Workshop will be removed.
1. Activate the High-performance Embedded Workshop.
2. Click the [Administration…] button in the [Welcome!] dialog box.

Figure 3.40 [Welcome!] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 46 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

3. The [Tools Administration] dialog box is opened.

Figure 3.41 [Tools Administration] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 47 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

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

Figure 3.42 Highlighting the Product to be Uninstalled

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 48 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

5. Click the [Unregister] button. After the following message box is displayed, click the [Yes]button.

Figure 3.43 [Unregistering this tool] Message Box
This is the end of canceling the High-performance Embedded Workshop registration. Then,remove the file for the emulator from the host computer.
6. Click the [Uninstaller…] button in the [Tools Administration] dialog box to open the[Uninstall HEW Tool] dialog box.

Figure 3.44 [Uninstall HEW Tool] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 49 of 180

H8 Family E10T-USB Emulator

Section 3 Preparation before Use

7. Click the [Start] button to list the installed components.

Figure 3.45 Highlighting the Product to be Uninstalled
Highlight the product name to be uninstalled and click the [Uninstall] button. This is the endof uninstallation.

CAUTIONA shared file may be detected while the program is being
removed. If another product may be using the shared file, do
not remove the file. If another product does not start up after
the removal process, re-install that product.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 50 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

Section 4 Preparations for Debugging
4.1

Method for Activating High-performance Embedded Workshop

To activate the High-performance Embedded Workshop, follow the procedure listed below.
1. Connect the emulator to the host computer and the user system, then turn on the user system.
2. Select [High-performance Embedded Workshop] from [Renesas High-performance Embedded
Workshop] of [Programs] in the [Start] menu.
3. The [Welcome!] dialog box is displayed.

Figure 4.1 [Welcome!] Dialog Box[Create a new project workspace] radio button:

Creates a new workspace.

[Open a recent project workspace] radio button:

Uses an existing workspace and displays
the history of the opened workspace.

[Browse to another project workspace] radio button:

Uses an existing workspace; this radio
button is used when the history of theopened workspace does not remain.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 51 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

In this section, we describe the following three ways to start up the High-performance Embedded
Workshop:• [Create a new project workspace] - a toolchain is not in use• [Create a new project workspace] - a toolchain is in use• [Browse to another project workspace]
The operation of [Open a recent project workspace] radio button is same as the operation without
specifying the workspace file when [Browse to another project workspace] is selected.
4.1.1

Creating the New Workspace (Toolchain Not Used)

1. In the [Welcome!] dialog box that is displayed when the High-performance Embedded
Workshop is activated, select [Create a new project workspace] radio button and click the[OK] button.

Figure 4.2 [Welcome!] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 52 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

2. The Project Generator is started. In this section, we omit description of the settings for thetoolchain.
If you have not purchased the toolchain, the following dialog box is displayed.

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

Enter the project name. When the project name is the same as
the workspace name, it needs not be entered.

Other list boxes are used for setting the toolchain; the fixed information is displayed when the
toolchain has not been installed.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 53 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

3. The following dialog box is displayed.

Figure 4.4 [New Project –7/9– Setting the Target System for Debugging] Dialog Box
Check [H8/xxxx E10T-USB SYSTEM] and click the [Next] button.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 54 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

4. Set the configuration file name. The configuration file saves the state of High-performance
Embedded Workshop except for the emulator.

Figure 4.5 [New Project –8/9– Setting the Debugger Options] Dialog Box
This is the end of the emulator setting.
Click the [Finish] button to exit the Project Generator. The High-performance Embedded
Workshop is activated.
5. After the High-performance Embedded Workshop has been activated, the emulator is
automatically connected. For operation during connection, refer to section 3.11, System
Check.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 55 of 180

H8 Family E10T-USB Emulator

4.1.2

Section 4 Preparations for Debugging

Creating the New Workspace (Toolchain Used)

1. In the [Welcome!] dialog box that is displayed when the High-performance Embedded
Workshop is activated, select [Create a new project workspace] radio button and click the[OK] button.

Figure 4.6 [Welcome!] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 56 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

2. The Project Generator is started.
If you have purchased the toolchain, the following dialog box is displayed.

Figure 4.7 [New Project Workspace] Dialog Box[Workspace Name] edit box:

Enter the new workspace name. Here, for example, enter ‘test’.

[Project Name] edit box:

Enter the project name. When the project name is the same as
the workspace name, it needs not be entered.

[CPU family] drop-down list box: Select the target CPU family.
[Tool chain] drop-down list box: Select the target toolchain name when using the toolchain.
Otherwise, select [None].
[Project type] list box:

Select the project type to be used.

Note: When [Demonstration] is selected in the emulator, note the following:
The [Demonstration] is a program for the simulator. When the generated program is usedby the emulator, delete the Printf statement.
R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 57 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

3. Make the required setting for the toolchain. When the setting has been completed, thefollowing dialog box is displayed.

Figure 4.8 [New Project -7/9- Setting the Target System for Debugging] Dialog Box
Check [H8/xxxx E10T-USB SYSTEM] and click the [Next] button. Mark other products as
required.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 58 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

4. Set the configuration file name. The configuration file saves the state of High-performance
Embedded Workshop except for the emulator.

Figure 4.9 [New Project -8/9- Setting the Debugger Options] Dialog Box
This is the end of the emulator setting.
Exit the Project Generator according to the instructions on the screen. The High-performance
Embedded Workshop is activated.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 59 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

5. After the High-performance Embedded Workshop has been activated, connect the emulator.
However, it is not needed to connect the emulator immediately after the High-performance
Embedded Workshop has been activated.
To connect the emulator, use one of the methods (a) and (b) below. For operation during
connection, refer to section 3.11, System Check.
(a) Connecting the emulator after the setting at emulator activation
Select [Debug settings] from the [Debug] menu to open the [Debug Settings] dialog box. It is
possible to register the download module or the command chain that is automatically executedat activation. For details on the [Debug Settings] dialog box, refer to section 4.2, Setting at
Emulator Activation.
After the [Debug Settings] dialog box has been set, when the dialog box is closed, the emulator
is connected.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 60 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging(b) Connecting the emulator without the setting at emulator activation
The emulator can be easily connected by switching the session file that the setting for theemulator use has been registered.

Figure 4.10 Selecting the Session FileIn the list box that is circled in figure 4.10, select the session file name including the character
string that has been set in the [Target name] text box in figure 4.9, [New Project -8/9- Setting the
Debugger Options] dialog box. The setting for using the emulator has been registered in thissession file.
After selected, the emulator is automatically connected.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 61 of 180

H8 Family E10T-USB Emulator

4.1.3

Section 4 Preparations for Debugging

Selecting an Existing Workspace

1. In the [Welcome!] dialog box that is displayed when the High-performance Embedded
Workshop is activated, select [Browse to another project workspace] radio button and click the[OK] button.

Figure 4.11 [Welcome!] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 62 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

2. The [Open Workspace] dialog box is displayed. Select a directory in which you have created aworkspace.
After that, select the workspace file (.hws) and press the [Open] button.

Figure 4.12 [Open Workspace] Dialog Box
3. This activates the High-performance Embedded Workshop and recovers the state of theselected workspace at the time it was saved.
When the saved state information of the selected workspace includes connection to theemulator, the emulator will automatically be connected. To connect the emulator when the
saved state information does not include connection to the emulator, refer to section 4.4,
Connecting the Emulator.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 63 of 180

H8 Family E10T-USB Emulator

4.2

Setting at Emulator Activation

4.2.1

Setting at Emulator Activation

Section 4 Preparations for Debugging

When the emulator is activated, the command chain can be automatically executed. It is also
possible to register multiple load modules to be downloaded. The registered load modules are
displayed on the workspace window.
1. Select [Debug Settings…] from the [Debug] menu to open the [Debug Settings] dialog box.

Figure 4.13 [Debug Settings] Dialog Box ([Target] Page)
2. Select the product name to be connected in the [Target] drop-down list box.
3. Select the format of the load module to be downloaded in the [Default Debug Format] dropdown list box, then register the corresponding download module in the [Download Modules]
list box.
R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 64 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

Note: Here, no program has been downloaded. For downloading, refer to section 5.2,
Downloading a Program.
4. Click the [Options] tab.

Figure 4.14 [Debug Settings] Dialog Box ([Options] Page)
The command chain that is automatically executed at the specified timing is registered. The
following three timings can be specified:• At connecting the emulator• Immediately before downloading• Immediately after downloading
Specify the timing for executing the command chain in the [Command batch file load timing]
drop-down list box. In addition, register the command-chain file that is executed at the specified
timing in the [Command Line Batch Processing] list box.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 65 of 180

H8 Family E10T-USB Emulator

4.2.2

Section 4 Preparations for Debugging

Downloading a Program

A download module is added under [Download modules] in the [Workspace] window.
Open the load module of [Download modules] in the [Workspace] window by clicking the righthand mouse button and select [Download module] to start downloading the module.

Figure 4.15 Download Menu of the [Workspace] Window ([Projects])

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 66 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

Notes: 1. When load modules are downloaded, select [Debug] -> [Download] -> [All DownLoad
Modules].
2. The emulator downloads programs to the flash memory just before execution of theuser program.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 67 of 180

H8 Family E10T-USB Emulator

4.2.3

Section 4 Preparations for Debugging

Setting the Program Flash Mode

The following describes the procedures when the emulator is used as the programming tool. The
load module to be downloaded to the new workspace is registered and programmed.
(a) Select the new project workspace.

Figure 4.16 [New Project Workspace] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 68 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging(b) Select the target MCU and click the [Next] button.

Figure 4.17 [New Project -7/9- Setting the Target System for Debugging] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 69 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging(c) The [Select Emulator mode] dialog box is displayed.

Figure 4.18 [Select Emulator mode] Dialog Box
Select the [Program Flash] mode.
(d) Turn on the target board and press the [OK] button.

Figure 4.19 Dialog Box of the Power-on Request Message

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 70 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging(e) Input the system clock value.

Figure 4.20 [System Clock] Dialog Box(f) Select [Debug Setting] from the [Debug] menu.

Figure 4.21 High-performance Embedded Workshop Window

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 71 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging(g) Select the target MCU and then the download module with the [Add…] button.

Figure 4.22 [Debug Setting] Dialog Box ([Target] Page)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 72 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging(h) The download file is displayed on [Project Files].

Figure 4.23 [Workspace] Window ([Project Files])(i) Select and download the file with the right-hand mouse button.

Figure 4.24 Download Menu of the [Workspace] Window ([Project Files])

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 73 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging(j) The dialog box for sum checking is displayed and programming is completed. Sum data is avalue that data in the internal ROM area has been added by byte. If no user program exists, thevalue is calculated by H’FF.

Figure 4.25 Message for Completion of Flash Memory Programming(k) When the following dialog box is displayed, close and restart or exit the workspace.
To write the same data to the MCU continuously, select [Debug -> Initialize…] and go back tostep (c) (displaying [Select Emulator mode]). To exit, close the workspace.

Figure 4.26 Message for Restarting or Exiting Program Flash Mode

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 74 of 180

H8 Family E10T-USB Emulator

4.3

Section 4 Preparations for Debugging

Debug Sessions

The High-performance Embedded Workshop stores all of your builder options into a
configuration. In a similar way, the High-performance Embedded Workshop stores your debugger
options in a session. The debugging platforms, the programs to be downloaded, and eachdebugging platform’s options can be stored in a session.
Sessions are not directly related to a configuration. This means that multiple sessions can sharethe same download module and avoid unnecessary program rebuilds.
Each session’s data should be stored in a separate file in the High-performance Embedded
Workshop project. Debug sessions are described in detail below.
4.3.1

Selecting a Session

The current session can be selected in the following two ways:• From the toolbar
Select a session from the drop-down list box (figure 4.27) in the toolbar.

Figure 4.27 Toolbar Selection

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 75 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging• From the dialog box
1. Select [Debug -> Debug Sessions…]. This will open the [Debug Sessions] dialog box(figure 4.28).

Figure 4.28 [Debug Sessions] Dialog Box
2. Select the session you want to use from the [Current session] drop-down list.
3. Click the [OK] button to set the session.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 76 of 180

H8 Family E10T-USB Emulator

4.3.2

Section 4 Preparations for Debugging

Adding and Removing Sessions

A new session can be added by copying settings from another session or removing a session.
• To add a new empty session
1. Select [Debug -> Debug Sessions…] to display the [Debug Sessions] dialog box (figure4.28).
2. Click the [Add…] button to display the [Add new session] dialog box (figure 4.29).
3. Check the [Add new session] radio button.
4. Enter a name for the session.
5. Click the [OK] button to close the [Debug Sessions] dialog box.
6. This creates a file with the name entered in step 4. If a file with this name already exists,
an error is displayed.

Figure 4.29 [Add new session] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 77 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging• To import an existing session into a new session file
1. Select [Debug -> Debug Sessions…] to display the [Debug Sessions] dialog box (figure4.28).
2. Click the [Add…] button to display the [Add new session] dialog box (figure 4.29).
3. Check the [Use an existing session file] radio button.
4. Enter a name for the session.
5. Enter the name of an existing session file that you would like to import into the existing
project or click the [Browse] button to select the file location.
If the [Open and maintain link to session file] check box is not checked, the imported new
session file is generated in the project directory.
If the [Open and maintain link to session file] check box is checked, a new session file is
not generated in the project directory but is linked to the existing session file.
If the [Make session file link read only] check box is checked, the linked session file isused as read-only.
6. Click the [OK] button to close the [Debug Sessions] dialog box.
• To remove a session
1. Select [Debug -> Debug Sessions…] to display the [Debug Sessions] dialog box (figure4.28).
2. Select the session you would like to remove.
3. Click the [Remove] button.
Note that the current session cannot be removed.
4. Click the [OK] button to close the [Debug Sessions] dialog box.
• To view the session properties
1. Select [Debug -> Debug Sessions…] to display the [Debug Sessions] dialog box (figure4.28).
2. Select the session you would like to view the properties for.
3. Click the [Properties] button to display the [Session Properties] dialog box (figure 4.30).

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 78 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

Figure 4.30 [Session Properties] Dialog Box• To make a session read-only
1. Select [Debug -> Debug Sessions…] to display the [Debug Sessions] dialog box (figure4.28).
2. Select the session you would like to make read-only.
3. Click the [Properties] button to display the [Session Properties] dialog box (figure 4.30).
4. Check the [Read only] check box to make the link read-only. This is useful if you aresharing debugger-setting files and you do not want data to be modified accidentally.
5. Click the [OK] button.
• To save a session with a different name
1. Select [Debug -> Debug Sessions…] to display the [Debug Sessions] dialog box (figure4.28).
2. Select the session you would like to save.
3. Click the [Save as…] button to display the [Save Session] dialog box (figure 4.31).
4. Specify the location to save the new file.
5. If you want to export the session file to another location, leave the [Maintain link] checkbox unchecked. If you would like the High-performance Embedded Workshop to use thislocation instead of the current session location, check the [Maintain link] check box.
6. Click the [Save] button.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 79 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

Figure 4.31 [Save Session] Dialog Box
4.3.3

Saving Session Information• To save a session
Select [File -> Save Session].

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 80 of 180

H8 Family E10T-USB Emulator

4.4

Section 4 Preparations for Debugging

Connecting the Emulator

Select either of the following two ways to connect the emulator:(1) Connecting the emulator after the setting at emulator activation
Select [Debug settings] from the [Debug] menu to open the [Debug Settings] dialog box. It is
possible to register the download module or the command chain that is automatically executedat activation. For details on the [Debug Settings] dialog box, refer to section 4.2, Setting at
Emulator Activation.
When the dialog box is closed after setting the [Debug Settings] dialog box, the emulator willautomatically be connected.
(2) Connecting the emulator without the setting at emulator activation
Connect the emulator by simply switching the session file to one in which the setting for theemulator use has been registered.

Figure 4.32 Selecting the Session FileR20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 81 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

In the list box that is circled in figure 4.32, select the session file name including the character
string that has been set in the [Target name] text box in figure 4.9, [New Project -8/9- Setting the
Debugger Options] dialog box. The setting for using the emulator has been registered in thissession file.
After the session file name is selected, the emulator will automatically be connected. For details
on the session file, refer to section 4.3, Debug Sessions.

4.5

Reconnecting the Emulator

When the emulator is disconnected, use the following way for reconnection:
Select [Debug -> Connect] or click the [Connect] toolbar button (). The emulator is connected.

Note: The emulator must be selected in the [Target] drop-down list box of the [Debug Settings]
dialog box that is opened by selecting [Debug settings] from the [Debug] menu (see 4.2.1,
Setting at Emulator Activation).

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 82 of 180

H8 Family E10T-USB Emulator

4.6

Section 4 Preparations for Debugging

Ending the Emulator

When using the toolchain, the emulator can be exited by using the following two methods:• Canceling the connection of the emulator being activated• Exiting the High-performance Embedded Workshop(1) Canceling the connection of the emulator being activatedSelect [Disconnect] from the [Debug] menu or click the [Disconnect] toolbar button ().

(2) Exiting the High-performance Embedded Workshop
Select [Exit] from the [File] menu.
A message box may be displayed. If necessary, click the [Yes] button to save a session. Aftersaving a session, the High-performance Embedded Workshop exits. If not necessary, click the[No] button to exit the High-performance Embedded Workshop.

Figure 4.33 [Session has been modified] Message Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 83 of 180

H8 Family E10T-USB Emulator

Section 4 Preparations for Debugging

R20UT2177EJ0500 Rev. 5.00

Page 84 of 180

Aug 30, 2012

H8 Family E10T-USB Emulator

Section 5 Debugging

Section 5 Debugging
This section describes the debugging operations and their related windows and dialog boxes.

5.1

Setting the Environment for Emulation

5.1.1

Opening the [Configuration] Dialog Box

Selecting [Options -> Emulator -> System…] or clicking the [Emulator System] toolbar button( ) opens the [Configuration] dialog box.
5.1.2

[General] Page

Sets the emulator operation conditions.

Figure 5.1 [Configuration] Dialog Box ([General] Page)
Note: The contents to be displayed differ depending on the MCU.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 85 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

Items that can be displayed in the sheet are listed below.
[Device] combo box

Displays the MCU name.

[Emulation mode] combo box

Selects the emulation mode at user program execution.
Select Normal to perform normal emulation.
Select No break to disable breakpoint settings.

[Step option] combo box

Enables or disables interrupts during step operation.
Disables interrupts during single step execution: Interrupts
during step operation are masked.
Enables interrupts during single step execution: Interrupts
during step operation are released.

[User interface clock] combo box

Displays the transfer clock of the user interface.

[Operating mode] combo box

Displays the following MCU operating modes that have been*1
specified with the MD pin :[Flash memory synchronization]
combo box•

1-Mbyte expanded mode with on-chip ROM enabled•

16-Mbyte expanded mode with on-chip ROM enabled•

Single-chip advanced mode

Selects whether or not the contents of the flash memory are
acquired by the emulator when the user program is stopped or
the position where the PC break is set is put back as theoriginal code.
When the flash memory is not rewritten by the user program,its contents need not be acquired by the emulator.
If there is no problem with the state that the program in the
flash memory has been replaced as the PC break code, theposition where the PC break is set needs not be put back as theoriginal code.
Disable: Read or write is not performed for the flash memory
except when the emulator is activated, the flash
memory area is modified, and the settings of the PC
break to the flash memory area are changed.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 86 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

PC to flash memory: When the user program is stopped, thespecified PC break code is replaced as
the original instruction. Select thisoption if there is a problem with the statethat the program in the flash memory
has been replaced as the PC break code.
Flash memory to PC: When the user program is stopped, thecontents of the flash memory are read by
the emulator. Select this option if the
flash memory is rewritten by the user
program.
PC to flash memory, Flash memory to PC:
When the user program is stopped, the contents of the flash
memory are read by the emulator and the specified PC breakcode is replaced as the original instruction. Select this option if
the flash memory is rewritten by the user program and there isa problem with the state that the program in the flash memory
has been replaced as the PC break code.
[Step Over option] combo box

Enables or disables programming of the flash memory while
executing step operation.
Programming of the flash memory: Uses a software break forstep operation (e.g. Step Over) and enables programming of
the flash memory.
No Programming of the flash memory: Uses Break Condition
for step operation (e.g. Step Over) and disables programming*2of the flash memory .

[Flash memory write after
download] group box

Enables or disables programming of the flash memory after
downloading the program.
Disable: Disables programming of the flash memory after
downloading the program.
Enable: Enables programming of the flash memory after
downloading the program.

[Short break] group box

Selects whether or not memory should be accessed during user
program execution.
Disable: Disables access to memory during user program
execution.
Enable: Enables access to memory during user program
execution.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 87 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

Notes: 1. The content specified for the MCU operating mode differs depending on the product.
For the settings of each product, refer to the additional document, Supplementary
Information on Using the H8/xxxx.
2. When Step Over is performed after selecting [No Programming of the flash memory] for[Step Over option], the instruction that follows a JSR, BSR, or TRAPA instruction will
also be executed. If there are consecutive JSR, BSR, or TRAPA instructions, execution
proceeds until it reaches an instruction that is not JSR, BSR, or TRAPA. (When there
are consecutive function calls in C language, the program steps all of these functions.)

5.2

Downloading a ProgramThis section describes how to download a program and view it as source code or assemblylanguage mnemonics.
Note: After a break has been detected, the High-performance Embedded Workshop displays thelocation of the program counter (PC). In most cases, for example if an Elf/Dwarf2-based
project is moved from its original path, the source file may not be automatically found. In
this case, the High-performance Embedded Workshop will open a source file browser
dialog box to allow you to manually locate the file.
5.2.1

Downloading a Program

A load module to be debugged must be downloaded.
To download a program, select the load module from [Debug -> Download] or select [Download]from the popup menu opened by clicking the right-hand mouse button on the load module in[Download modules] of the [Workspace] window.
Note: Before downloading a program, it must be registered to the High-performance Embedded
Workshop as a load module. For registration, refer to section 4.2, Setting at Emulator
Activation.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 88 of 180

H8 Family E10T-USB Emulator

5.2.2

Section 5 Debugging

Viewing the Source Code

Select a source file name in the [Workspace] window and click [Open] in the popup menu to makethe High-performance Embedded Workshop display the source file in the editor. It is also possible
to display your source files by double-clicking on their names in the [Workspace] window.

Figure 5.2 [Editor] Window

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 89 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

In this window, the following items are shown on the left as line information.
The first column (Line number column): Source-line information
The second column (Source address column): Address information
The third column (Event column): Event information (break condition)
The fourth column (S/W breakpoint column): PC, bookmark, and breakpoint information
Line number column
The line number that corresponds to the source file is displayed.
Source address column
When a program is downloaded, an address for the current source file is displayed on the Source
address column. These addresses are helpful when setting the PC value or a breakpoint.
Event column
The Event column displays the following item:: An address condition as a break condition; only one such a position can be set.
This is also set by using the popup menu.
The bitmap symbol above is shown by double-clicking the Event column. This is also set by using
the popup menu.

Figure 5.3 Popup Menu
Notes: 1. The contents of the Event column are erased when conditions other than the addresscondition are added to each channel by using the [Edit] menu or in the [Event] window.
2. The conditions for setting the break condition differ depending on the device. For
details, refer to the online help.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 90 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

S/W breakpoint column
S/W breakpoint column displays the following items:: A bookmark is set.
: A PC Break is set.
: PC location
To switch off a column in all source files
1. Click the right-hand mouse button on the [Editor] window or select the [Edit] menu.
2. Click the [Define Column Format…] menu item.
3. The [Global Editor Column States] dialog box is displayed.
4. A check box indicates whether the column is enabled or not. If it is checked, the column isenabled. If the check box is gray, the column is enabled in some files and disabled in others.
Deselect the check box of a column you want to switch off.
5. Click the [OK] button for the new column settings to take effect.

Figure 5.4 [Global Editor Column States] Dialog Box
To switch off a column in one source file
1. Open the source file which contains the column you want to remove and click the [Edit] menu.
2. Click the [Columns] menu item to display a cascaded menu item. The columns are displayedin this popup menu. If a column is enabled, it has a tick mark next to its name. Clicking theentry will toggle whether the column is displayed or not.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 91 of 180

H8 Family E10T-USB Emulator

5.2.3

Section 5 Debugging

Viewing the Assembly-Language CodeIf there is an address at the cursor position in the [Editor] window, selecting [Go to Disassembly]
in the pop-up menu opens the [Disassembly] window.
The first address displayed in the [Disassembly] window is the address where the cursor is placedin the [Editor] window.
If you do not have a source file, but wish to view code in the assembly-language level, either
choose [View] -> [Disassembly…] or click on the [Disassembly] window’s toolbar button ( ).
The [Disassembly] window opens at the current PC location and shows [Address] and [Code](optional) which show the disassembled mnemonics (with labels when available).
Selecting the [Mixed display] toolbar button (following shows an example in this case.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

) displays both the source and the code. The

Page 92 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

Figure 5.5 [Disassembly] Window

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 93 of 180

H8 Family E10T-USB Emulator

5.2.4

Section 5 Debugging

Modifying the Assembly-Language CodeYou can modify the assembly-language code by double-clicking on the instruction that you want
to change. The [Assembler] dialog box will be opened.

Figure 5.6 [Assembler] Dialog Box
The address, instruction code, and mnemonic are displayed. Enter the new instruction or edit theold instruction in the [Mnemonics] field. Pressing the [Enter] key will replace the memory content
with the new instruction and move on to the next instruction. Clicking the [OK] button will
replace the memory content with the new instruction and close the dialog box. Clicking the[Cancel] button or pressing the [Esc] key will close the dialog box without modifying the memory
contents.
Note: The assembly-language code being displayed is the current memory content. If thememory contents are changed the [Assembler] dialog box and the [Disassembly] window
will show the new assembly-language code, but the source file displayed in the [Editor]
window will be unchanged. This is the same even if the source file contains assembly
codes.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 94 of 180

H8 Family E10T-USB Emulator

5.2.5

Section 5 Debugging

Viewing a Specific Address

When you are viewing your program in the [Disassembly] window, you may wish to look at
another area of your program's code. Rather than scrolling through a lot of code in the program,you can go directly to a specific address. Select [Set Address…] from the popup menu, and the
dialog box shown in figure 5.7 is displayed.

Figure 5.7 [Set Address] Dialog Box
Enter the address in the [Address] edit box and either click on the [OK] button or press the [Enter]key. A label name can also be specified as the address. The [Disassembly] window will be updated
to show the code at the new address. When an overloaded function or a class name is entered, the[Select Function] dialog box opens for you to select a function.
5.2.6

Viewing the Current Program Counter Address

Wherever you can enter an address or value into the High-performance Embedded Workshop, you
can also enter an expression. If you enter a register name prefixed by the hash character (#), thecontents of that register will be used as the value in the expression. Therefore, if you enter the
expression #pc in the [Set Address] dialog box, the [Editor] or [Disassembly] window will display
the current PC address. It also allows the offset of the current PC to be displayed by entering an
expression with the PC register plus an offset, e.g., #PC+0x100.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 95 of 180

H8 Family E10T-USB Emulator

5.3

Section 5 Debugging

Using the Event Points

The emulator has the event point function that performs breaking by specifying higher-level
conditions along with the PC breakpoints standard for the High-performance Embedded
Workshop.
5.3.1

PC Breakpoints

When the instruction of the specified address is fetched, the user program is stopped. Up to 255
points can be set.
5.3.2

Break Conditions

Break conditions can be used for higher-level conditions such as the data condition as well as
specification of the single address.
5.3.3

Opening the [Event] Window

Select [View -> Code -> Eventpoints] or click the [Eventpoints] toolbar button ([Event] window.

) to open the

The [Event] window has the following two sheets:[Breakpoint] sheet:

Displays the settings made for PC breakpoints. It is also possible to set,
modify, and cancel PC breakpoints.

[Breakcondition] sheet:

Displays or sets the settings made for break condition channels.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 96 of 180

H8 Family E10T-USB Emulator

5.3.4

Section 5 Debugging

Setting PC Breakpoints

It is possible to display, modify, and add PC breakpoints on the [Breakpoint] sheet.

Figure 5.8 [Event] Window ([Breakpoint] Sheet)This window displays and sets the breakpoints. Items that can be displayed in the sheet are listed
below.
[Type]Breakpoint[State]Whether the breakpoint is enabled or disabled[Condition] An address that the breakpoint is set
Address = Program counter (Corresponding file name, line, and symbol name)[Action]Operation of the emulator when a break condition is satisfied
Break: Breaks program execution

When a breakpoint is double-clicked in this window, the [Set Break] dialog box is opened andbreak conditions can be modified.
A popup menu containing the following options is available by right-clicking within the window.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 97 of 180

H8 Family E10T-USB Emulator

5.3.5

Section 5 Debugging

Add

Sets breakpoints. Clicking this item will open the [Set Break] dialog box and break conditions canbe specified.
5.3.6

Edit

Only enabled when one breakpoint is selected. Select a breakpoint to be edited and click this item.
The [Set Break] dialog box will open and break conditions can be changed.
5.3.7

EnableEnables the selected breakpoint(s).
5.3.8DisableDisables the selected breakpoint(s). When a breakpoint is disabled, the breakpoint will remain in
the list; when specified conditions have been satisfied, a break will not occur.
5.3.9

DeleteRemoves the selected breakpoint. To retain the details of the breakpoint but not have it cause abreak when its conditions are met, use the Disable option (see section 5.3.8, Disable).
5.3.10

Delete All

Removes all breakpoints.
5.3.11

Go to Source

Only enabled when one breakpoint is selected. Opens the [Editor] window at the address of the
breakpoint.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 98 of 180

H8 Family E10T-USB Emulator

5.3.12

Section 5 Debugging[Set Break] Dialog Box

Figure 5.9 [Set Break] Dialog Box
This dialog box specifies break conditions.
A breakpoint address to be set is specified in the [Address] edit box. The PC register can also be
specified such as #PC. Up to 255 breakpoints can be specified.
The contents to be set differ depending on the product. For details, refer to the on-line help foreach product.
When [Address] is selected, if an overloaded function or class name including a member functionis specified in address, the [Select Function] dialog box opens.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 99 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

Clicking the [OK] button sets the break conditions. Clicking the [Cancel] button closes this dialog
box without setting the break conditions.
Notes on Setting the [Set Break] Dialog Box
1. When an odd address is set, the address is rounded down to an even address.
2. A software break is accomplished by replacing instructions. Accordingly, it can be set only tothe flash memory or RAM area. However, a software break cannot be set to the following
addresses:⎯ An area other than the flash memory or RAM⎯ An area occupied by the E10T-USB emulator program⎯ An instruction in which Break Condition 1 is satisfied
3. During step execution, a software breakpoint is disabled.
4. A condition set at Break Condition 1 is disabled immediately after starting execution when an
instruction at a software breakpoint is executed. A break does not occur even if a condition of
Break Condition 1 is satisfied immediately after starting the execution.
5. When execution resumes from the breakpoint address after the program execution stops at thesoftware breakpoint, single-step execution is performed at the address before execution
resumes. Therefore, realtime operation cannot be performed.
6. Settings of software breakpoint and Break Condition 1 are invalid while the STEP OVER
function is being used.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 100 of 180

H8 Family E10T-USB Emulator

5.3.13

Section 5 Debugging

Setting Break Conditions

On the [Breakcondition] sheet, the settings for break conditions are displayed, modified, andadded.

Figure 5.10 [Event] Window ([Breakcondition] Sheet)
Note: The items that can be set in this window differ depending on the product. For details on
the settings for each product, refer to the online help.
This window displays and sets the break condition.
Notes on Setting the Break Condition:
1. When [Step In], [Step Over], or [Step Out] is selected, the settings of Break Condition 1 aredisabled.
2. Setting of Break Condition 1 is disabled when an instruction to which a BREAKPOINT has
been set is executed.
3. When step over function is used, the settings of BREAKPOINT and Break Condition 1 aredisabled.
Items that can be displayed in the sheet are listed below.
[Type]Break channel number[State]Whether the breakpoint is enabled or disabled[Condition]

A condition that satisfies a break

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 101 of 180

H8 Family E10T-USB Emulator[Action]Section 5 Debugging

Operation of the emulator when a break condition is satisfied
Break: Breaks program execution

When a breakpoint is double-clicked in this window, the [Break condition 1] dialog box is
opened and break conditions can be modified. For details on the [Break condition 1] dialog box,
refer to the online help for each product.
A popup menu containing the following options is available by right-clicking within the window.
5.3.14

Edit...

Only enabled when one break channel is selected. Select a break channel to be edited and click
this item. The [Break condition 1] dialog box will open and break conditions can be changed.
5.3.15

EnableEnables the selected break channel(s). A break channel that the condition has not been set is notenabled.
5.3.16

DisableDisables the selected break channel(s). When a break channel is disabled, a break will not occur
even if specified conditions have been satisfied.
5.3.17

DeleteInitializes the condition of the selected break channel. To retain the details of the break channel
but not have it cause a break when its conditions are met, use the Disable option (see section
5.3.16, Disable).
5.3.18

Delete All

Initializes conditions of all break channels.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 102 of 180

H8 Family E10T-USB Emulator

5.3.19Section 5 Debugging

Go to Source

Only enabled when one break channel is selected. Opens the [Editor] window at address of breakchannel.
If an address value has not been set to the break channel, this option cannot be used.
5.3.20

Editing Break Conditions

Handlings for settings other than PC breakpoints and break conditions are common. The following
describes examples of such handling.
5.3.21

Modifying Break Conditions

Select a break condition to be modified, and choose [Edit...] from the popup menu to open the
dialog box for the event, which allows the user to modify the break conditions. The [Edit...] menu
is only available when one break condition is selected.
5.3.22

Enabling Break Conditions

Select a break condition and choose [Enable] from the popup menu to enable the selected breakcondition.
5.3.23Disabling Break Conditions

Select a break condition and choose [Disable] from the popup menu to disable the selected breakcondition. When a break condition is disabled, the break condition will remain in the list, but an
event will not occur when the specified conditions have been satisfied.
5.3.24

Deleting Break Conditions

Select a break condition and choose [Delete] from the popup menu to remove the selected breakcondition. To retain the break condition but not have it cause an event when its conditions are met,
use the [Disable] option (see section 5.3.24, Disabling Break Conditions).
5.3.25

Deleting All Break Conditions

Choose [Delete All] from the popup menu to remove all break conditions.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 103 of 180

H8 Family E10T-USB Emulator

5.3.26

Section 5 Debugging

Viewing the Source Line for Break Conditions

Select a break condition and choose [Go to Source] from the popup menu to open the [Editor] or[Disassembly] window at the address of the break condition. The [Go to Source] menu is only
available when break conditions that have the corresponding source file are selected.
5.3.27[Break condition 1] Dialog Box

Figure 5.11 [Break condition 1] Dialog Box
This page sets the address bus, data bus, and read/write cycle conditions.
Note: The items that can be set in this dialog box differ depending on the MCU. For details on
the settings for each MCU, refer to the online help.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 104 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

The [Address] group box sets address bus conditions.
OptionDescription[Don’t care] check box

Does not set address conditions.

[Address] radio button

Sets the use of the normal address bus as breakconditions.

[Only program fetched address after]
radio button

Sets a break after prefetched address execution as breakconditions.

[Address] edit box

Sets the address bus value with a number or a symbol.

[Mask] edit box

Sets a value to be masked when [User mask] is selected.
For masked bits, the break condition is satisfied for any
values.

The contents of an option that can be will change depending on the radio button selected.
OptionDescription[Address] radio button

All options can be set.

[Only program fetched address after]
radio button

The [Address] option can be set.

The [Data] group box sets the data bus conditions.
OptionDescription[Don’t care] check box

No data conditions are set.

[Value] edit box

Sets the data bus with a number.

[Low byte] radio button

Sets data access size as the lower 8-bit access.

[High byte] radio button

Sets data access size as the upper 8-bit access.

[Word] radio button

Sets data access size as the word access.

The [Read/Write] group box sets the read/write cycle conditions.
OptionDescription[Read/Write] radio button

Sets the read/write cycle conditions as break conditions.

[Read] radio button

Sets read cycles as break conditions.

[Write] radio button

Sets write cycles as break conditions.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 105 of 180

H8 Family E10T-USB Emulator

5.4

Section 5 Debugging

Viewing the Trace Information

For the description on the trace function, refer to section 2.2, Trace Functions.
5.4.1

Opening the [Trace] Window

To open the [Trace] window, choose [View -> Code -> Trace] or click the [Trace] toolbar button
( ).
5.4.2

Acquiring Trace Information

The acquired trace information is displayed in the [Trace] window.

Figure 5.12 [Trace] Window
This window displays the following trace information items:[PTR]

Pointer to a location in the trace buffer (+0 for the last executed instruction)[IP]

The amount of acquired trace information[Type]

Type of branch:
BRANCH: branch source[Address]

Instruction address[Instruction]

Instruction mnemonic[Source]

The C/C++ or assembly-language source program

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 106 of 180

H8 Family E10T-USB Emulator[Label]Section 5 Debugging

Label information

It is possible to hide any column not necessary in the [Trace] window. Selecting a column you
want to hide from the popup menu displayed by clicking the right-hand mouse button on theheader column hides that column. To display the hidden column, select the column from the said
popup menu again.
Note: The number of branch instructions that can be acquired by a trace and the trace display
differ depending on the product. For details on the specifications of each product, refer tothe online help.
5.4.3

Clearing the Trace Information

When [Clear] is selected from the popup menu, the trace buffer that stores the trace information
becomes empty. If several [Trace] windows are open, all [Trace] windows will be cleared as they
all access the same buffer.
5.4.4

Saving the Trace Information in a File

Select [Save...] from the popup menu to open the [Save As] file dialog box, which allows the user
to save the information displayed in the [Trace] window as a text file. A range can be specified
based on the [PTR] number. Note that this file cannot be reloaded into the [Trace] window.
5.4.5

Viewing the [Editor] Window

The [Editor] window corresponding to the selected trace record can be displayed in the following
two ways:• Select a trace record and choose [View Source] from the popup menu.
• Double-click a trace record
The [Editor] or [Disassembly] window opens and the selected line is marked with a cursor.
5.4.6

Trimming the Source

Choose [Trim Source] from the popup menu to remove the white space from the left side of thesource.
When the white space is removed, a check mark is shown to the left of the [Trim Source] menu.
To restore the white space, choose [Trim Source] while the check mark is shown.
R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 107 of 180

H8 Family E10T-USB Emulator

5.5

Section 5 Debugging

Synchronizing Multiple Debugging Platforms

Multiple debugging platforms can be operated at the same time in the High-performance
Embedded Workshop. Initiating a High-performance Embedded Workshop from another Highperformance Embedded Workshop synchronizes multiple debugging platforms. The Highperformance Embedded Workshop that initiates another High-performance Embedded Workshop
is called the master, and the initiated High-performance Embedded Workshop is called the slave.
Choose [Tools -> Launch Slave HEW...] or click the [Launch Slave HEW] toolbar button ( ) toinitiate a slave High-performance Embedded Workshop.
The slave High-performance Embedded Workshop has the same functionality as the master Highperformance Embedded Workshop.
The slave High-performance Embedded Workshop is notified of the following actions done in themaster High-performance Embedded Workshop to ensure synchronization of the slave Highperformance Embedded Workshop and the master High-performance Embedded Workshop.
• Reset go• Go• Stop debugging
Note: The master High-performance Embedded Workshop can initiate multiple slave Highperformance Embedded Workshop applications, but slave High-performance Embedded
Workshop applications cannot be nested (no slave High-performance Embedded
Workshop can initiate another slave High-performance Embedded Workshop).
When selecting [Renesas High-performance Embedded Workshop] -> [High-performance
Embedded Workshop] from [Programs] in the [Start] menu to initiate another High-performance
Embedded Workshop, two emulators can be used separately for debugging.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 108 of 180

H8 Family E10T-USB Emulator

5.5.1

Section 5 Debugging

Distinguishing Two Emulators

Connect two emulators to the USB connector. Then, initiate the High-performance Embedded
Workshop using the tutorial workspace. The following message is displayed.

Figure 5.13 Message for Driver Selection
Click the [OK] button. The following dialog box will appear.

Figure 5.14 [Driver Details] Dialog Box (1)R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 109 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

Select [Renesas E-Series USB Driver] from the [Driver] drop-down list box and open the[Channel] drop-down list box. Channel information for two emulators is displayed in the[Channel] drop-down list box as shown in figure 5.15.

Figure 5.15 [Driver Details] Dialog Box (2)Information displayed in figure 5.15 is the information of the USB connector to which theemulators are connected.
Note: The displayed character strings of the information differ according to the host computer’s
environment.
Check which of the character strings of information show emulators.
Select [<no driver selected>] in the [Driver] drop-down list box and disconnect one emulator fromthe USB connector. After that, select [Renesas E-Series USB Driver] in the [Driver] drop-down
list box. Only information on the USB connector that the emulator is connected to is displayed inthe [Channel] drop-down list box.
The above procedures are used to discern which of the emulators are indicated by the displayed
character strings of information in the [Channel] drop-down list box.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 110 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

When initiating the High-performance Embedded Workshop, in the [Channel] drop-down list box,
select the information on the USB connector of the emulator that is connected to the master CPU.
Initiate the High-performance Embedded Workshop using the normal procedures.
When initiating the slave High-performance Embedded Workshop, in the [Channel] drop-down
list box, select the information on the USB connector of the emulator that is connected to the slave
CPU.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 111 of 180

H8 Family E10T-USB Emulator

Section 5 Debugging

R20UT2177EJ0500 Rev. 5.00

Page 112 of 180

Aug 30, 2012

H8 Family E10T-USB Emulator

Section 6 Tutorial

Section 6 Tutorial
6.1

Introduction

This section describes the main functions of the emulator by using a tutorial program.
The tutorial program is based on the C++ program that sorts ten random data items in ascending ordescending order. The tutorial program performs the following actions:• The main function generates random data to be sorted.
• The sort function sorts the generated random data in ascending order.
• The change function then sorts the data in descending order.
The file tutorial.cpp contains source code for the tutorial program of the H8 family devices.
The file Tutorial.abs is a compiled load module in the Elf/Dwarf2 format.
Note: After recompilation, the addresses may differ from those given in this section.

6.2

Running the High-performance Embedded Workshop

To run the High-performance Embedded Workshop, refer to section 3.11, System Check.

6.3

Setting up the Emulator

This section describes the basic settings of the emulator.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 113 of 180

H8 Family E10T-USB Emulator

6.4

Section 6 Tutorial

Setting the [Configuration] Dialog Box• Select [Emulator] then [Systems…] from the [Setup] menu for the basic settings of theemulator. The [Configuration] dialog box is displayed.

Figure 6.1 [Configuration] Dialog Box
Note: The items that can be set in this dialog box differ depending on the product. For details on
the settings for each product, refer to the online help.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 114 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

Set options as follows:
Table 6.1 [General] Page Options
OptionValue

DeviceH8/xxxx (default)

Emulation mode

Normal (normal execution, default)

Step option

Disables interrupts during single step execution (default)

User interface clock

According to the system clock frequency, the maximum
user interface clock is automatically set.

Operating mode

Displays the MCU operating modes that have been
specified with the MD pin.

Flash memory synchronization

Disable (default)

Step Over option

Programming of the flash memory (default)

Flash memory write after download

Disable (default)

Short break

Enable (default)• Click the [OK] button to set a configuration.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 115 of 180

H8 Family E10T-USB Emulator

6.5

Section 6 Tutorial

Checking the Operation of RAM

Check that RAM is operating correctly.
Display and edit the contents of the memory in the [Memory] window to check that the memory is
operating correctly.
Note: The memory can be installed on the board in some microcomputers. In this case,however, the above way of checking the operation of memory may be inadequate. It is
recommended that a program for checking the memory be created.
• Select [Memory…] from the [CPU] submenu of the [View] menu and enter the RAM addressin the [Display Address] edit box. Here, enter H’FFC000. Then enter H’000000 and
H’FFFFFF in the [Scroll Start Address] and [Scroll End Address] edit boxes, respectively.

Figure 6.2 [Display Address] Dialog Box
Note: The settings of the RAM area differ depending on the product. For details, refer to thehardware manual.
• Click the [OK] button. The [Memory] window is displayed and shows the specified memory
area.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 116 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

Figure 6.3 [Memory] Window• Placing the mouse cursor on a point in the display of data in the [Memory] window anddouble-clicking allows the values at that point to be changed. Data can also be directly edited
around the current position of the text cursor.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 117 of 180

H8 Family E10T-USB Emulator

6.6

Downloading the Tutorial Program

6.6.1

Downloading the Tutorial Program

Section 6 Tutorial

Download the object program to be debugged.
In this emulator, it is enabled to download the program and set the PC breakpoint in the internal
flash memory area. For the method to set the PC breakpoint, refer to section 6.16.1, PC Break
Function.
• Select [Download module] from [Tutorial.abs] under [Download modules].

Figure 6.4 Downloading the Tutorial Program

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 118 of 180

H8 Family E10T-USB Emulator

6.6.2

Section 6 Tutorial

Displaying the Source Program

The High-performance Embedded Workshop allows the user to debug a user program at thesource level.
• Double-click [tutorial.cpp] under [C++ source file].

Figure 6.5 [Editor] Window (Displaying the Source Program)• Select the [Display] option from the [Setup] menu to set a font and size that are legible, if
necessary.
Initially the [Editor] window shows the start of the user program, but the user can use the scroll
bar to scroll through the user program and look at the other statements.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 119 of 180

H8 Family E10T-USB Emulator

6.7

Section 6 Tutorial

Setting a PC BreakpointA PC breakpoint is a simple debugging function.
The [Editor] window provides a very simple way of setting a PC breakpoint at any point in a
program. For example, to set a PC breakpoint at the sort function call:• Select by double-clicking the [S/W breakpoint] column on the line containing the sort
function call.

Figure 6.6 [Editor] Window (Setting a PC Breakpoint)
The symbol • will appear on the line containing the sort function. This shows that a PC
breakpoint has been set.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 120 of 180

H8 Family E10T-USB Emulator

6.8

Section 6 Tutorial

Setting Registers

Set values of the program counter and the stack pointer before executing the program.
• Select [Registers] from the [CPU] submenu of the [View] menu. The [Register] window isdisplayed.

Figure 6.7 [Register] Window

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 121 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial• To change the value of the program counter (PC), double-click the value area in the [Register]
window with the mouse. The following dialog box is then displayed, and the value can bechanged. Set the program counter to H’400 in this tutorial program, and click the [OK] button.

Figure 6.8 [Register] Dialog Box (PC)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 122 of 180

H8 Family E10T-USB Emulator

6.9

Section 6 Tutorial

Executing the Program

Execute the program as described in the following:• To execute the program, select [Go] from the [Debug] menu, or click the [Go] button on the
toolbar.

Figure 6.9 [Go] Button
When the program execution is started, ‘**RUNNING’ is displayed on the status bar.
The program will be executed up to the breakpoint that has been set, and an arrow will be
displayed in the [S/W breakpoint] column to show the position that the program has halted, withthe message [BREAKPOINT] in the status bar.
Note: When the source file is displayed after a break, a path of the source file may be inquired.
The location of the source file is as follows:<Drive where the OS has been installed>:\Workspace\Tutorial\E10T-USB\3048F_ONE\Tutorial_1M\sourceor\Workspace\Tutorial\E10T-USB\3048F_ONE\Tutorial_16M\source

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 123 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

Figure 6.10 [Editor] Window (Break State)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 124 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

The user can see the cause of the break that occurred last time in the [Status] window.
• Select [Status] from the [CPU] submenu of the [View] menu. After the [Status] window isdisplayed, open the [Platform] sheet, and check the Status of Cause of last break.

Figure 6.11 [Status] Window
Note: The items that can be displayed in this window differ depending on the product. For theitems that can be displayed, refer to the online help.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 125 of 180

H8 Family E10T-USB Emulator

6.10

Section 6 Tutorial

Reviewing Breakpoints

The user can see all the breakpoints set in the program in the [Event] window.
• Select [Eventpoints] from the [Code] submenu of the [View] menu. The [Event] window isdisplayed. Select the [Breakpoint] sheet.

Figure 6.12 [Event] Window
The popup menu, opened by clicking the [Event] window with the right-hand mouse button,allows the user to set or change breakpoints, define new breakpoints, and delete, enable, ordisable breakpoints.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 126 of 180

H8 Family E10T-USB Emulator

6.11

Section 6 Tutorial

Viewing Memory

When the label name is specified, the user can view the memory contents that the label has beenregistered in the [Memory] window. For example, to view the memory contents corresponding to_main in word size:• Select [Memory…] from the [CPU] submenu of the [View] menu and enter the RAM addressin the [Display Address] edit box. Here, enter H’FFC000. Then enter H’000000 and
H’FFFFFF in the [Scroll Start Address] and [Scroll End Address] edit boxes, respectively.

Figure 6.13 [Display Address] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 127 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial• Click the [OK] button. The [Memory] window showing the specified area of memory isdisplayed.

Figure 6.14 [Memory] Window

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 128 of 180

H8 Family E10T-USB Emulator

6.12

Section 6 Tutorial

Watching Variables

As the user steps through a program, it is possible to watch that the values of variables used in theuser program are changed. For example, set a watch on the long-type array a declared at the
beginning of the program, by using the following procedure:• Click the left of displayed array a in the [Editor] window to position the cursor.
• Select [Instant Watch...] with the right-hand mouse button.
The following dialog box will be displayed.

Figure 6.15 [Instant Watch] Dialog Box

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 129 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial• Click the [Add] button to add a variable to the [Watch] window.

Figure 6.16 [Watch] Window (Displaying the Array)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 130 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

The user can also add a variable to the [Watch] window by specifying its name.
• Click the [Watch] window with the right-hand mouse button and select [Add Watch…] fromthe popup menu.
The following dialog box will be displayed. Enter variable i.

Figure 6.17 [Add Watch] Dialog Box• Click the [OK] button.
The [Watch] window will now also show the int-type variable i.

Figure 6.18 [Watch] Window (Displaying the Variable)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 131 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

The user can click mark ‘+’ at the left side of array a in the [Watch] window to watch all theelements.

Figure 6.19 [Watch] Window (Displaying Array Elements)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 132 of 180

H8 Family E10T-USB Emulator

6.13

Section 6 Tutorial

Stepping Through a Program

The High-performance Embedded Workshop provides a range of step menu commands that allow
efficient program debugging.
Table 6.2 Step Option
Menu
Command

Description

Step In

Executes each statement, including statements within functions.

Step Over

Executes a function call in a single step.

Step Out

Steps out of a function, and stops at the statement following the statement in the
program that called the function.

Step…

Steps the specified times repeatedly at a specified rate.

6.13.1

Executing [Step In] Command

The [Step In] command steps into the called function and stops at the first statement of the called
function.
• To step through the sort function, select [Step In] from the [Debug] menu, or click the [StepIn] button on the toolbar.

Figure 6.20 [Step In] Button

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 133 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

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

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 134 of 180

H8 Family E10T-USB Emulator

6.13.2

Section 6 Tutorial

Executing [Step Out] Command

The [Step Out] command steps out of the called function and stops at the next statement of thecalling statement in the main function.
• To step out of the sort function, select [Step Out] from the [Debug] menu, or click the [StepOut] button on the toolbar.
Note: It takes time to execute this function. When the calling source is clarified, use [Go To
Cursor].

Figure 6.22 [Step Out] Button

Figure 6.23 [High-performance Embedded Workshop] Window (Step Out)The data of variable a displayed in the [Watch] window is sorted in ascending order.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 135 of 180

H8 Family E10T-USB Emulator

6.13.3

Section 6 Tutorial

Executing [Step Over] Command

The [Step Over] command executes a function call as a single step and stops at the next statementof the main program.
• To step through all statements in the change function at a single step, select [Step Over] fromthe [Debug] menu, or click the [Step Over] button on the toolbar.

Figure 6.24 [Step Over] Button

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 136 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

Figure 6.25 [Editor] Window (Step Over)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 137 of 180

H8 Family E10T-USB Emulator

6.14

Section 6 Tutorial

Forced Breaking of Program Executions

The High-performance Embedded Workshop can force a break in the execution of a program.
• Cancel all breaks.
• To execute the remaining sections of the main function, select [Go] from the [Debug] menu
or the [Go] button on the toolbar.

Figure 6.26 [Go] Button• The program goes into an endless loop. To force a break in execution, select [Halt] from the[Debug] menu or the [Stop] button on the toolbar.

Figure 6.27 [Stop] Button

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 138 of 180

H8 Family E10T-USB Emulator

6.15

Section 6 Tutorial

Displaying Local Variables

The user can display local variables in a function using the [Locals] window. For example, wewill examine the local variables in the main function, which declares four local variables: a, j, i,and p_sam.
• Select [Locals] from the [Symbol] submenu of the [View] menu. The [Locals] window isdisplayed.
The [Locals] window shows the local variables in the function currently pointed to by the program
counter, along with their values. Note, however, that the [Locals] window is initially empty
because local variables are yet to be declared.

Figure 6.28 [Locals] Window• Click mark ‘+’ at the left side of array a in the [Locals] window to display the elements.
• When the user refers to the elements of array a before and after the execution of the sort
function, it is clarified that random data is sorted in descending order.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 139 of 180

H8 Family E10T-USB Emulator

6.16

Section 6 Tutorial

Break Function

The emulator has PC and hardware break functions. With the High-performance Embedded
Workshop, a PC breakpoint can be set using the [Breakpoint] sheet of the [Event] window, and a
hardware break condition can be set using the [Breakcondition] sheet.
An overview and setting of the break function are described below.
6.16.1

PC Break Function

The emulator can set up to 255 PC breakpoints. Other methods for setting a PC breakpoint than in
section 6.7, Setting a PC Breakpoint, are described below.
• Select [Eventpoints] from the [Code] submenu of the [View] menu. The [Event] window isdisplayed.
• Select the [Breakpoint] sheet.

Figure 6.29 [Event] Window (Before Setting a PC Breakpoint)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 140 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial• Double-click the [S/W breakpoint] column on the [Editor] window. A PC breakpoint is set.

Figure 6.30 [Editor] Window (Setting a PC Breakpoint)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 141 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial• When the PC breakpoint is set in the [Event] window, click the [Event] window with the righthand mouse button and select [Edit…] from the popup menu.

Figure 6.31 [Set Break] Dialog Box• Click the [OK] button.
Note: The address values described in this section will differ depending on the tutorial for eachproduct.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 142 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

The PC breakpoint that has been set is displayed in the [Event] window.

Figure 6.32 [Event] Window (PC Breakpoint Setting)Note: The items that can be displayed in this window differ according to the product. For theitems that can be displayed, refer to the online help.
To stop the tutorial program at the PC breakpoint, the following procedure must be executed:• Close the [Event] window.
• Set the program counter value (PC = H’400) that was set in section 6.8, Setting Registers, inthe [Register] window. Click the [Go] button.
• If program execution is failed, reset the device and execute again the procedures above.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 143 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

The program runs, and stops at the set PC breakpoint.

Figure 6.33 [Editor] Window at Execution Stop (PC Break)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 144 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

The [Status] window displays the following contents.

Figure 6.34 Displayed Contents of the [Status] Window (PC Break)Note: The items that can be displayed in this window differ depending on the product. For theitems that can be displayed, refer to the online help.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 145 of 180

H8 Family E10T-USB Emulator

6.17

Section 6 Tutorial

Hardware Break Function

A method is given below in which the address bus condition is set under Break Condition 1 as
hardware break conditions.
• Select [Eventpoints] from the [Code] submenu of the [View] menu. The [Event] window isdisplayed.
• The PC breakpoint that has been previously set is deleted. Click the [Event] window with theright-hand mouse button and select [Delete All] from the popup menu to cancel all PC
breakpoints that have been set.
• Double-click the [Event] column in the [Editor] window. The specified address shows
a Break Condition is set.

and

• Click the [Break condition] tab.
• Select a line of Break condition in the [Event] window. When highlighted, double-click thisline.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 146 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

Figure 6.35 [High-performance Embedded Workshop] Window ([Break condition 1])• The [Break condition 1] dialog box is displayed.
• The data condition can be set besides the address condition.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 147 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

Figure 6.36 [condition] Page ([Break condition 1] Dialog Box)
• Click the [OK] button.
• The content that has been set is reflected in the [Event] window.
• The first point display in the State line changes from Disable to Enable.
• The first point display in the Condition line changes from None to Address = H’00107E(Tutorial.cpp/47) pcafter.
• Set the program counter value (PC = H’400) that was set in section 6.8, Setting Registers, inthe [Register] window. Click the [Go] button.
Notes: 1. The items that can be set in this page differ depending on the product. For details on
the settings for each product, refer to the online help.
2. The address values described in this section will differ depending on the tutorial foreach product.
The program runs and then stops at the condition specified under Break Condition 1.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 148 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

Figure 6.37 [Editor] Window at Execution Stop (Break Condition 1)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 149 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial

The [Status] window displays the following contents.

Figure 6.38 Displayed Contents of the [Status] Window (Break Condition 1)
Note: The items that can be displayed in this window differ depending on the product. For theitems that can be displayed, refer to the online help.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 150 of 180

H8 Family E10T-USB Emulator

6.18

Section 6 Tutorial

Trace Functions

The emulator has a branch-instruction trace function.
The branch source addresses, mnemonics, operands, source lines, and labels are displayed for four
branches.
6.18.1

Displaying the Trace Window

Select [Trace] from the [Code] submenu of the [View] menu.
Run the program as shown in the example of section 6.16.1, PC Break Function. The trace results
are displayed in the [Trace] window after the program execution is completed.

Figure 6.39 [Trace] Window
If necessary, adjust the column widths by dragging borders in the header bar (immediately below
the title bar).
Note: The number of branch instructions that can be acquired by a trace and the trace display
differ depending on the product. For details on the specifications of each product, refer tothe online help.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 151 of 180

H8 Family E10T-USB Emulator

6.19

Section 6 Tutorial

Stack Trace Function

The emulator uses the information on the stack to display the names of functions in the sequenceof calls that led to the function to which the program counter is currently pointing.
Note: This function can be used only when the load module that has the Elf/Dwarf2-type
debugging information is loaded. Such load modules are supported in H8C/C++ compiler
V3.0 or later.
• Double-click the [S/W breakpoint] column in the sort function and set a PC breakpoint.

Figure 6.40 [Editor] Window (PC Breakpoint Setting)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 152 of 180

H8 Family E10T-USB Emulator

Section 6 Tutorial• Set the same program counter value (PC = H’400) as was set in section 6.8, Setting Registers(again, use the [Register] window). Click the [Go] button.
• After the break in program execution, select [Stack Trace] from the [Code] submenu of the[View] menu to open the [Stack Trace] window.

Figure 6.41 [Stack Trace] Window
Figure 6.41 shows that the position of the program counter is currently at the selected line of thesort() function, and that the sort() function is called from the tutorial() function.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 153 of 180

H8 Family E10T-USB Emulator

6.20

Section 6 Tutorial

What Next?

This tutorial has described the major features of the emulator and the use of the High-performance
Embedded Workshop.
Sophisticated debugging can be carried out by using the emulation functions that the emulator
offers. This provides for effective investigation of hardware and software problems by accurately
isolating and identifying the conditions under which such problems arise.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 154 of 180

H8 Family E10T-USB Emulator

Section 7 Maintenance and Guarantee

Section 7 Maintenance and Guarantee
This section describes maintenance, guarantee, repair provisions, and how to request for repair ofthe emulator.

7.1

User Registration

When you purchase our product, be sure to register as a user. For user registration, refer to thesection of ‘User Registration’ (p. iii) of this user's manual.

7.2

Maintenance

1. If dust or dirt collects on any equipment of this product, wipe the board dry with a soft cloth.
Do not use thinner or other solvents because these chemicals can cause the equipment's surface
coating to separate.
2. When you do not use this product for a long period, for safety purposes, disconnect the power
cable from the power supply.

7.3

Guarantee

If your product becomes faulty within one year after its purchase while being used under goodconditions by observing ‘IMPORTANT INFORMATION’ described in this user's manual, we will
repair or replace your faulty product free of charge. Note, however, that if your product's fault is
raised by any one of the following causes, we will repair it or replace it with new one with extracharge:• Misuse, abuse, or use under extraordinary conditions• Unauthorized repair, remodeling, maintenance, and so on• Inadequate user's system or misuse of it• Fires, earthquakes, and other unexpected disasters
In the above cases, contact your local distributor. If your product is being leased, consult theleasing company or the owner.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 155 of 180

H8 Family E10T-USB Emulator

7.4

Repair Provisions

7.4.1

Repair with Extra-Charge

Section 7 Maintenance and Guarantee

The products elapsed more than one year after purchase can be repaired with extra-charge.
7.4.2

Replacement with Extra-Charge

If your product's fault falls in any of the following categories, the fault will be corrected byreplacing the entire product instead of repair, or you will be advised to purchase new one,depending on the severity of the fault.
• Faulty or broken mechanical parts• Flaw, separation, or rust in coated or plated parts• Flaw or cracks in plastic parts• Faults or breakage caused by improper use or unauthorized repair or modification• Heavily damaged electric circuits due to overvoltage, overcurrent or shorting of power supply• Cracks in the printed circuit board or burnt-down patterns• Wide range of faults that makes replacement less expensive than repair• Unlocatable or unidentified faults
7.4.3

Expiration of the Repair Period

When a period of one year elapses after the model was dropped from production, repairing
products of the model may become impossible.
7.4.4

Transportation Fees at Sending Your Product for Repair

Send your product to us for repair at your expense.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 156 of 180

H8 Family E10T-USB Emulator

7.5

Section 7 Maintenance and Guarantee

How to Make a Request for Repair

If your product is found faulty, follow the procedure below to send your product for repair.
Fill in the Repair Request Sheet included with this product, then send it along with this product for
repair to your local distributor. Make sure that information in the Repair Request Sheet is written
in as much detail as possible to facilitate repair.

CAUTION
Note on Transporting the Product:
When sending your product for repair, use the packing
box and cushion material supplied with this product when
delivered to you and specify handling caution for it to behandled as precision equipment. If packing of your product is
not complete, it may be damaged during transportation. Whenyou pack your product in a bag, make sure to use conductive
polyvinyl supplied with this product (usually a blue bag).
When you use other bags, they may cause a trouble on yourproduct because of static electricity.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 157 of 180

H8 Family E10T-USB Emulator

Section 7 Maintenance and Guarantee

R20UT2177EJ0500 Rev. 5.00

Page 158 of 180

Aug 30, 2012

H8 Family E10T-USB Emulator

Appendix A Troubleshooting

Appendix A Troubleshooting
1. I have a text file open in the editor but syntactic color-coding is not being displayed.
Ensure that you have named the file (i.e. saved it) and that the “Syntax coloring” check box isset on the “Editor” tab of the “Options” dialog box, which is launched via [Tools ->Options...]. The High-performance Embedded Workshop looks up the filename extension todetermine the group to which the file belongs and decides whether or not coloring should beapplied to the file. To view the currently defined filename extensions and file groups, select[Project -> File Extensions...] to launch the “File Extensions” dialog box. To view thecoloring information, select [Tools -> Format] to display the “Color” tab of the “Format”
dialog box.
2. I want to change the settings of a tool but the [Tools->Administration…] menu option is notselectable.
[Tools->Administration...] is not selectable while a workspace is open. To open the “ToolAdministration” dialog box, close the current workspace.
3. I opened a workspace from my PC, and one of my colleagues opened the same workspace
simultaneously from another PC. I changed the settings of the workspace and saved it. My
colleague saved the workspace after me. I opened the workspace again and found that thesettings of the workspace differed from those I had made.
The last settings to be saved are effective. While a workspace is open in the HEW, updating of
the workspace is within the memory. The settings are not saved in a file unless the user
intentionally saves the workspace.
In addition to above, refer to FAQs on the emulator and High-performance Embedded Workshop
on the Renesas web site (www.renesas.com).

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 159 of 180

H8 Family E10T-USB Emulator

Appendix A Troubleshooting

R20UT2177EJ0500 Rev. 5.00

Page 160 of 180

Aug 30, 2012

H8 Family E10T-USB Emulator

Appendix B Window Functions

Appendix B Window Functions
This section describes the window functions that can be used with the E10T-USB emulator Highperformance Embedded Workshop. Here, the High-performance Embedded Workshop common
functions are omitted, and only the emulation functions are described.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 161 of 180

H8 Family E10T-USB Emulator

Appendix B Window Functions

Table B.1 Window Functions
Toolbar
ButtonMenu

OptionShortcut

View

Disassembly

Ctrl + D

Opens the [Disassembly]
window.

Command Line

Ctrl + L

Opens the [Command Line]window.

TCL toolkit

Shift +
Ctrl + L

Opens the [Console] window.

Workspace

Alt + K

Opens the [Workspace]window.

OutputAlt + U

Opens the [Output] window.

DifferenceCPU

SymbolCode

Opens the [Difference]
window.

Registers

Ctrl + R

Opens the [Register] window.

Memory…

Ctrl + M

Opens the [Memory] window.

IO

Ctrl + I

Opens the [IO] window.

StatusCtrl + U

Opens the [Status] window.

Labels

Shift +
Ctrl + A

Opens the [Labels] window.

Watch

Ctrl + W

Opens the [Watch] window.

Locals

Shift +
Ctrl + W

Opens the [Locals] window.

Eventpoints

Ctrl + E

Opens the [Event] window.

Trace

Ctrl + T

Opens the [Trace] window.

Stack Trace

Ctrl + K

Opens the [Stack Trace]
window.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Remarks

Page 162 of 180

H8 Family E10T-USB Emulator

Appendix B Window Functions

Table B.1 Window Functions (cont)
Menu

OptionView(cont)

Graphic

Setup

Radix

Emulator

Debug

Shortcut

Remarks

Image…

Shift +
Ctrl + G

Opens the [Image] window.

Waveform…

Shift +
Ctrl + V

Opens the [Waveform] window.

HexadecimalUses a hexadecimal for
displaying a radix in which thenumerical values will be
displayed and entered bydefault.

DecimalUses a decimal for displaying aradix in which the numericalvalues will be displayed andentered by default.

Octal

Uses an octal for displaying aradix in which the numericalvalues will be displayed andentered by default.

BinaryUses a binary for displaying aradix in which the numericalvalues will be displayed andentered by default.

System…

Opens the [Configuration
Properties] dialog box allowing
the user to modify the
debugging platform settings.

Debug Sessions…

Opens the [Debug Sessions]dialog box to list, add, or
remove the debug session.

Debug Settings…

Opens the [Debug Settings]
dialog box to set the debugging
conditions or download
modules.

Reset CPU

Resets the target hardware
and sets the PC to the reset
vector address.

Go

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Toolbar
ButtonF5Starts executing the user
program at the current PC.

Page 163 of 180

H8 Family E10T-USB Emulator

Appendix B Window Functions

Table B.1 Window Functions (cont)
Menu

OptionShortcutDebug(cont)

Reset Go

Shift + F5

Remarks
Resets the target microcomputerand executes the user programfrom the reset vector address.

Go To Cursor

Starts executing the user
program at the current PC until
the PC reaches the address
indicated by the current text
cursor position.

Set PC To Cursor

Sets the PC to the address at
the row of the text cursor.

Display PC

Shift +
Ctrl + Y

Run…

Displays the current PC value.
Launches the [Run Program]dialog box allowing the user toenter the PC or PC breakpoint
during executing the user
program.

Step In

F11

Executes a block of user
program before breaking.

Step Over

F10

Executes a block of user
program before breaking. If a
subroutine call is reached, thenthe subroutine will not beentered.

Step Out

Shift +
F11

Executes the user program toreach the end of the current
function.

Step…

Step
Mode

Launches the [Step Program]dialog box allowing the user tomodify the settings for stepping.
Auto

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Toolbar
ButtonSteps only one source line whenthe [Editor] window is active.
When the [Disassembly] window
is active, stepping is executed ina unit of assembly instructions.

Page 164 of 180

H8 Family E10T-USB Emulator

Appendix B Window Functions

Table B.1 Window Functions (cont)
Menu

OptionDebug(cont)Step
Mode(cont)

Shortcut

Remarks

Assembly

Executes stepping in a unit ofassembly instructions.

SourceSteps only one source line.

Halt Program

Esc

Stops the execution of the user
program.

Connect

Connects the debugging
platform.

Initialize

Disconnects the debugging
platform and connects it again.

Disconnect

Disconnects the debugging
platform. This option cannot be
used in some products.

Download Modules

Downloads the object program.

Unload Modules

Unloads the object program.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Toolbar
ButtonPage 165 of 180

H8 Family E10T-USB Emulator

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Appendix B Window Functions

Page 166 of 180

H8 Family E10T-USB Emulator

Appendix C Command-Line Functions

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

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 167 of 180

H8 Family E10T-USB Emulator

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Appendix C Command-Line Functions

Page 168 of 180

H8 Family E10T-USB Emulator

Appendix D Notes on High-performance Embedded Workshop

Appendix D Notes on High-performance Embedded
Workshop
1. Note on Moving Source File Position after Creating Load Module
When the source file is moved after creating the load module, the [Open] dialog box may bedisplayed to specify the source file during the debugging of the created load module. Selectthe corresponding source file and click the [Open] button.
2. Source-Level Execution⎯ Source fileDo not display source files that do not correspond to the load module in the program
window. For a file having the same name as the source file that corresponds to the load
module, only its addresses are displayed in the program window. The file cannot be
operated in the program window.
⎯ StepEven standard C libraries are executed. To return to a higher-level function, enter Step
Out. In a for statement or a while statement, executing a single step does not move
execution to the next line. To move to the next line, execute two steps.
3. Operation During Accessing Files
Do not perform other operations during downloading the load module or saving in the [Verify
Memory], [Save Memory], or [Trace] window because this will not allow correct fileaccessing to be performed.
4. Watch⎯ Local variables at optimization
Depending on the generated object code, local variables in a C source file that is compiled
with the optimization option enabled will not be displayed correctly. Check the generated
object code by displaying the [Disassembly] window.
If the allocation area of the specified local variable does not exist, displays as follows.
Example:The variable name is asc.
asc = ? - target error 2010 (xxxx)⎯ Variable name specification
When a name other than a variable name, such as a symbol name or function name, isspecified, no data is displayed.
Example:The function name is main.
main =

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 169 of 180

H8 Family E10T-USB Emulator

Appendix D Notes on High-performance Embedded Workshop

5. Line Assembly⎯ Input radix
Regardless of the Radix setting, the default for line assembly input is decimal. Specify H’or 0x for the H8 series microcomputers and xxxxh for the R8C series microcomputers as
the radix for a hexadecimal input.
6. Command Line Interface⎯ Batch file
To display the message “Not currently available” while executing a batch file, enter the
sleep command. Adjust the sleep time length which differs according to the operating
environment.
Example:To display “Not currently available” during memory_fill execution:
sleep d’3000
memory_fill 0 ffff 0⎯ File specification by commands
The current directory may be altered by file specifications in commands. It is
recommended to use absolute paths to specify the files in a command file so that thecurrent directory alteration is not affected.
Example:FILE_LOAD C\HEW\Tools\Renesas\DebugComp\Platform\E10T-USB\Tutorial\Debug_H8_xxxx_E10T-USB_SYSTEM\Tutorial.abs

7. Memory Save During User Program Execution
Do not execute saving, verifying, comparing, or searching of memory during user program
execution.
8. Load of Motorola S-type Files
This High-performance Embedded Workshop does not support Motorola S-type files with only
the CR code (H'0D) at the end of each record. Load Motorola S-type files with the CR and LF
codes (H'0D0A) at the end of each record.
9. [I/O] Window⎯ Display and modification
Do not change values in the [I/O Registers] window because the emulator uses the address
break controller.
⎯ Note that the emulator does not support the display of the invalid module or bit informationin the [I/O] window.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 170 of 180

H8 Family E10T-USB Emulator

Appendix D Notes on High-performance Embedded Workshop

10. Note on [Register] Window Operation During Program Execution
The register value cannot be changed in the [Register] window during program execution.
Even if the changed value is displayed, the register contents are not changed actually.
11. Break Functions
When the PC breakpoint is set in the flash memory area, the program is written to the flash
memory each time the user program is executed. At this time, note that the number ofrewritable times will be decreased.
⎯ BREAKPOINT cancellation
When the contents of the BREAKPOINT address is modified during user program
execution, the following message is displayed when the user program stops.
BREAKPOINT IS DELETED Address=xxxxxxx
If the above message is displayed, the BREAKPOINT setting of the displayed address will
be disabled. Cancel the BREAKPOINT setting with the [Delete All] or [Disable] button in
the [Breakpoints] window.
12. Number of BREAKPOINT and [Stop At] Settings in the [Run...] Menu
The maximum number of BREAKPOINTs and [Stop At] settings allowed in the [Run...] menu
is 255. Therefore, when 255 BREAKPOINTs are set, specification by [Stop At] in the [Run...]menu becomes invalid. Use the BREAKPOINTs and [Stop At] in the [Run...] menu with 255
or less total settings.
13. Note on RUN-TIME Display
The execution time of the user program displayed in the [Status] window is not a correct value
since the timer in the host computer has been used.
14. Note on Displaying Timeout error
If Timeout error is displayed, the emulator cannot communicate with the target
microcomputer. Turn off the emulator and the user system and connect the emulator again byusing the High-performance Embedded Workshop.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 171 of 180

H8 Family E10T-USB Emulator

Appendix D Notes on High-performance Embedded Workshop

15. Support of Double Float Format
In the following memory operations, the double float format is not supported:⎯ [Fill Memory] dialog box⎯ [Search Memory] dialog box⎯ MEMORY_FILL command
The [Format] specification in the [Copy Memory] dialog box is ignored. Memory is
copied in a byte unit.
16. Note on Using the [Run Program] Dialog Box
When [Run...] is selected from the [Debug] menu to specify the stop address, there is thefollowing note:⎯ When the breakpoint that has been set as Disable is specified as the stop address, note thatthe breakpoint becomes Enable when the user program stops.
17. Memory Access during User Program Execution
When a memory is accessed from the memory window, etc. during user program execution,
the user program is resumed after it has stopped in the emulator to access the memory.
Therefore, realtime emulation cannot be performed.
The stopping time of the user program is as follows:
Environment:
Host computer: 550 MHz x 2 (Xeon® III)H8/3048F-ONE: 25 MHz (system clock frequency)
When a one-byte memory is read from the command-line window, the stopping time will be
about 308 ms.
18. Internal Flash Memory
The emulator is also available as the programming tool for mass production.
However, the actual MCU, which has been used by connecting to the emulator, has been
programmed to the flash memory at emulation and stressed. Do not use the MCU that has
been used for debugging for the mass products.
19. Suspend during Emulator Use
Do not set the host computer as the suspend mode while using the emulator. If the hostcomputer enters the suspend mode, exit and restart the High-performance Embedded
Workshop.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 172 of 180

H8 Family E10T-USB Emulator

Appendix D Notes on High-performance Embedded Workshop

20. Verification of Memory
Use the FILE_VERIFY command to verify memory. Do not use [Verify Memory…] in the[File] menu.
21. Overwrite of a FileIn command line interface, a file that has the same name as the output file is overwritten
without asking the user.
22. Usage with Other Products
To install the SuperH™ RISC engine C/C++ compiler package or H8, H8/300 series C/C++
compiler package after installing the emulator software for High-performance Embedded
Workshop, select [High-performance Embedded Workshop] as the component to be installedin [Select Components] during installation of the compiler package.
23. Download of Load Modules
When load modules are downloaded, select [Debug] -> [Download] -> [All Download
modules].
24. Program Flash Mode
When microcomputers are continuously programmed, be sure to turn the target on or off.
25. Memory Access in the Program Flash Mode
Memory cannot be accessed in the Program Flash mode. In this mode, values displayed in the[Memory] or [IO] window are dummy.
26. Memory Access during Flash Memory Programming
During flash memory programming (e.g., user program execution), operation for memory
accessing such as opening the [Memory] window is not allowed. Values displayed here are
dummy. Access the memory again after flash memory programming has been completed.
27. Download of Programs
When programs are downloaded, the verify function of memory is not available.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 173 of 180

H8 Family E10T-USB Emulator

Appendix D Notes on High-performance Embedded Workshop

R20UT2177EJ0500 Rev. 5.00

Page 174 of 180

Aug 30, 2012

H8 Family E10T-USB Emulator

Appendix E Diagnostic Test Procedure

Appendix E Diagnostic Test Procedure
For the diagnostic test procedure using the emulator test program, refer to the E10T-USB
Emulator Test Program Manual (file name: E10T-USBTME.PDF) in the ‘E10T-USB Emulator
software’ CD.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 175 of 180

H8 Family E10T-USB Emulator

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Appendix E Diagnostic Test Procedure

Page 176 of 180

H8 Family E10T-USB Emulator

Appendix F Repair Request Sheet

Appendix F Repair Request Sheet
Thank you for purchasing the E10T-USB emulator (HS0005TCU01H).
In the event of a malfunction, fill in the repair request sheet on the following pages and send it toyour distributor.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 177 of 180

H8 Family E10T-USB Emulator

Appendix F Repair Request Sheet

Repair Request Sheet
To Distributor
Your company name:
Person in charge:
Tel.:
Item

Symptom

1. Date and time when the malfunction
occurredMonth/Day/Year {at system initiation, in system
operation}*Circle either of items in the braces { }.

2. Frequency of generation of themalfunction( ) times in ( ) {day(s), week(s), or month(s)}3. System configuration when themalfunction occurred

System configuration of the emulator:*Enter the appropriate numbers in the parentheses ( )and circle one of the three items in the braces { }.
•E10T-USB emulator (HS0005TCU01H):
Serial No.:
Revision:
The above items are written on the label for productmanagement at the bottom of the emulator unit; theserial no. is the five-digit number and the revision is
the string of letters following the number.

•

Provided CD-R (HS0005TCU01SR):
Version: V.
Shown as ‘V.x.xx release xx’ on the CD-R (x:numeral).

•Host computer in use:
Manufacturer:Type number:
OS: (Windows® 2000 or Windows® XP)

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 178 of 180

H8 Family E10T-USB Emulator

Appendix F Repair Request Sheet

Item

Symptom

4. Settings when the malfunction
occurred(1) MCU: Type number:(2) Operating frequency:MHz

5. Failure phenomenon
6. Error in debugging
7. Error in the diagnostic program
8. The High-performance Embedded
Workshop does not link-up with theemulator.

Content of the error message

For errors other than the above, fill in the box below.

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Page 179 of 180

H8 Family E10T-USB Emulator

R20UT2177EJ0500 Rev. 5.00
Aug 30, 2012

Appendix F Repair Request Sheet

Page 180 of 180

H8 Family E10T-USB Emulator
User’s Manual

Publication Date:

Rev.5.00

August 30, 2012

Published by:Renesas Electronics Corporation

http://www.renesas.com

SALES OFFICES
Refer to "http://www.renesas.com/" for the latest and detailed information.
Renesas Electronics America Inc.
2880 Scott Boulevard Santa Clara, CA 95050-2554, U.S.A.
Tel: +1-408-588-6000, Fax: +1-408-588-6130
Renesas Electronics Canada Limited
1101 Nicholson Road, Newmarket, Ontario L3Y 9C3, Canada
Tel: +1-905-898-5441, Fax: +1-905-898-3220
Renesas Electronics Europe Limited
Dukes Meadow, Millboard Road, Bourne End, Buckinghamshire, SL8 5FH, U.K
Tel: +44-1628-651-700, Fax: +44-1628-651-804
Renesas Electronics Europe GmbH
Arcadiastrasse 10, 40472 Düsseldorf, Germany
Tel: +49-211-65030, Fax: +49-211-6503-1327
Renesas Electronics (China) Co., Ltd.
7th Floor, Quantum Plaza, No.27 ZhiChunLu Haidian District, Beijing 100083, P.R.China
Tel: +86-10-8235-1155, Fax: +86-10-8235-7679
Renesas Electronics (Shanghai) Co., Ltd.
Unit 204, 205, AZIA Center, No.1233 Lujiazui Ring Rd., Pudong District, Shanghai 200120, China
Tel: +86-21-5877-1818, Fax: +86-21-6887-7858 / -7898
Renesas Electronics Hong Kong Limited
Unit 1601-1613, 16/F., Tower 2, Grand Century Place, 193 Prince Edward Road West, Mongkok, Kowloon, Hong Kong
Tel: +852-2886-9318, Fax: +852 2886-9022/9044
Renesas Electronics Taiwan Co., Ltd.
13F, No. 363, Fu Shing North Road, Taipei, Taiwan
Tel: +886-2-8175-9600, Fax: +886 2-8175-9670
Renesas Electronics Singapore Pte. Ltd.
80 Bendemeer Road, Unit #06-02 Hyflux Innovation Centre Singapore 339949
Tel: +65-6213-0200, Fax: +65-6213-0300
Renesas Electronics Malaysia Sdn.Bhd.
Unit 906, Block B, Menara Amcorp, Amcorp Trade Centre, No. 18, Jln Persiaran Barat, 46050 Petaling Jaya, Selangor Darul Ehsan, Malaysia
Tel: +60-3-7955-9390, Fax: +60-3-7955-9510
Renesas Electronics Korea Co., Ltd.
11F., Samik Lavied' or Bldg., 720-2 Yeoksam-Dong, Kangnam-Ku, Seoul 135-080, Korea
Tel: +82-2-558-3737, Fax: +82-2-558-5141© 2012 Renesas Electronics Corporation. All rights reserved.
Colophon 1.3

H8 Family E10T-USB Emulator
User's Manual

R20UT2177EJ0500