connect_v800s

MULTI: Configuring Connections for
V850 and RH850 Targets
Green Hills Software
30 West Sola Street
Santa Barbara, California 93101
USA
Tel: 805-965-6044
Fax: 805-965-6343
www.ghs.com

---

LEGAL NOTICES AND DISCLAIMERS
GREEN HILLS SOFTWARE MAKES NO REPRESENTATIONS OR WARRANTIES WITH RESPECT TO THE
CONTENTS HEREOF AND SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTIES OF MERCHANTABILITY
OR FITNESS FOR ANY PARTICULAR PURPOSE. Further, Green Hills Software reserves the right to revise this
publication and to make changes from time to time in the content hereof without obligation of Green Hills Software to
notify any person of such revision or changes.
Copyright © 1983-2015 by Green Hills Software. All rights reserved. No part of this publication may be reproduced, stored
in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or
otherwise, without prior written permission from Green Hills Software.
Green Hills, the Green Hills logo, CodeBalance, GMART, GSTART, INTEGRITY, MULTI, and Slingshot are registered
trademarks of Green Hills Software. AdaMULTI, Built with INTEGRITY, EventAnalyzer, G-Cover, GHnet, GHnetLite,
Green Hills Probe, Integrate, ISIM, u-velOSity, PathAnalyzer, Quick Start, ResourceAnalyzer, Safety Critical Products,
SuperTrace Probe, TimeMachine, TotalDeveloper, DoubleCheck, and velOSity are trademarks of Green Hills Software.
All other company, product, or service names mentioned in this book may be trademarks or service marks of their respective
owners.
For a partial listing of Green Hills Software and periodically updated patent marking information, please visit
http://www.ghs.com/copyright_patent.html.
PubID: connect_v800-544152
Branch: http://toolsvc/branches/release-branch-70-bto
Date: October 21, 2015

---

Contents
Preface
vii
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Supported Target Connections for V850 and RH850 . . . . . . . . . . . . viii
The MULTI Document Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Conventions Used in the MULTI Document Set . . . . . . . . . . . . . . . . . . . . . . x
1. Using the Connection Editor
1
General Information Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Target-Specific Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
The Command Line Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Action Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2. Green Hills Monitor (monserv) Connections
7
Supported Features for Green Hills Monitor (monserv) Connections . . . . 8
Connecting to Your Target with a Green Hills Monitor . . . . . . . . . . . . . . . . 8
Creating a Standard Green Hills Monitor (monserv) Connection
Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Using the Green Hills Monitor (monserv) Connection Editor . . . . . . . 9
Using Custom Green Hills Monitor (monserv) Connection
Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3. Renesas V850/V850E ICE (850eserv2)
Connections
19
Target System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Installing Your Renesas V850/V850E ICE . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Additional Windows Setup and Configuration . . . . . . . . . . . . . . . . . . . . . . 20
Required Definition File for Network V850/V850E Interfaces . . . . . 21
Using the Green Hills SuperTrace Probe to Collect Real-time Trace
Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Green Hills Software
iii

---

Contents
Connecting to Your Target with an Renesas V850/V850E ICE . . . . . . . . . 23
Creating a Standard Renesas V850/V850E ICE (850eserv2)
Connection Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Using the Renesas V850/V850E ICE (850eserv2) Connection
Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Using Custom Renesas V850/V850E ICE (850eserv2) Connection
Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Connecting Through a Remote Server (850eserv2_server) . . . . . . . . . . . . 33
Hardware Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
General Troubleshooting Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Target Commands for Renesas V850/V850E ICE (850eserv2)
Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Data and Register Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Execution Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Event, Trigger, and Trace Setting Commands . . . . . . . . . . . . . . . . . . . 37
Trace Display Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Emulator Configuration Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Other Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Target Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
4. RTE (rteserv2) Connections
67
Supported Targets for RTE (rteserv2) Connections . . . . . . . . . . . . . . . . . . . 68
Installing Your RTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Checking Your RTE Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Using the Green Hills SuperTrace Probe to Collect Real-time Trace
Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Connecting the SuperTrace Probe to a Midas RTE Cube . . . . . . . . . . 70
Collecting Trace Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Connecting to a RTE Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Creating a Standard RTE (rteserv2) Connection Method . . . . . . . . . . 71
Using the RTE (rteserv2) Connection Editor . . . . . . . . . . . . . . . . . . . . 71
Commands for RTE (rteserv2) Connections . . . . . . . . . . . . . . . . . . . . . . . . . 73
General rteserv2 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Commands for Specific RTEs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
iv
MULTI: Configuring Connections for V850 and RH850 Targets

---

Contents
5. Multi-core Simulator for V850 and RH850 (simrh850)
Connections
77
Installing the Multi-core Simulator for V850 and RH850 (simrh850) . . . 78
Connecting to the Multi-Core Simulator for V850 and RH850
(simrh850) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Creating a Multi-core Simulator for V850 and RH850 (simrh850)
Connection Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Using the Multi-core Simulator for V850 and RH850 (simrh850)
Connection Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Using Custom Multi-core Simulator for V850 and RH850 (simrh850)
Connection Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Additional Commands for Multi-core Simulator for V850 and RH850
(simrh850) Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Profiling with simrh850 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Simulation Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
OS Simulation Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
ROM Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Unsupported Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Connecting to the Multi-core Simulator for V850 and RH850 (simrh850)
as a Stand-alone Debug Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
A. Green Hills Debug Server Command and Scripting
Reference
89
Green Hills Debug Server Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Generic Debug Server Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Additional Debug Server Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 96
The Green Hills Debug Server Scripting Language . . . . . . . . . . . . . . . . . . 96
General Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Scripting Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Example Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
B. Target-Specific Trace Options and Triggers
105
Renesas V850E IECUBE Target-Specific Options . . . . . . . . . . . . . . . . . . 106
Green Hills Software
v

---

Contents
Renesas V850E2RV3 IECUBE2 Target-Specific Options . . . . . . . . . . . . 108
Renesas RH850 Target-Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . 111
V850E/V850E2R RTE Target-Specific Options . . . . . . . . . . . . . . . . . . . . 113
V850 Target-Specific Trace Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Index
119
vi
MULTI: Configuring Connections for V850 and RH850 Targets

---

Preface
Contents
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
The MULTI Document Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Conventions Used in the MULTI Document Set . . . . . . . . . . . . . . . . . . . . . . . . . . x

---

Preface
This preface discusses the purpose of the manual, the MULTI documentation set,
and typographical conventions used.
About This Book
The MULTI Debugger can be used to debug applications that reside on native,
embedded, or simulated targets. To debug these applications, MULTI must first
connect to the target through a debug server that runs on the host. Each distribution
of the MULTI Integrated Development Environment (IDE) includes multiple debug
servers, each of which supports connections to a specific set of probes, in-circuit
emulators, monitors, and/or target simulators. This book describes how to configure
connections to your target using the appropriate debug server. Specifically:
• The chapters in this book provide connecting instructions, features, commands,
and options specific to each debug server. This information supplements the
general connection instructions described in the documentation about connecting
to your target in the MULTI: Debugging book.
• Appendix A, “Green Hills Debug Server Command and Scripting Reference”,
documents the commands that are supported by some Green Hills debug servers
and describes the scripting language and conventions used for writing target
setup scripts in previous versions of MULTI. The scripting language described
in this appendix has been deprecated beginning with MULTI 5.0. The new
scripting conventions are described in the documentation about MULTI scripts
in the MULTI: Scripting book.
Note
New or updated information may have become available while this book
was in production. For additional material that was not available at press
time, or for revisions that may have become necessary since this book
was printed, please check your installation directory for release notes,
README files, and other supplementary documentation.
Supported Target Connections for V850 and RH850
The following table lists the target connections supported for V850 and RH850.
For detailed information about each type of target connection, see the appropriate
chapter, as identified in the table.
viii
MULTI: Configuring Connections for V850 and RH850 Targets

---

The MULTI Document Set
Debugging interface
Green Hills
Debug server chapter
debug server
Green Hills Monitor
monserv
Chapter 2, “Green Hills Monitor (monserv)
Connections” on page 7
Renesas V850/V850E ICE
850eserv2
Chapter 3, “Renesas V850/V850E ICE
(850eserv2) Connections” on page 19
RTE Server
rteserv2
Chapter 4, “RTE (rteserv2) Connections”
on page 67
Simulator for V850 and
simrh850
Chapter 5, “Multi-core Simulator for V850
RH850
and RH850 (simrh850) Connections”
on page 77
Note
If you are using MULTI with the Green Hills INTEGRITY RTOS, see
the INTEGRITY document set you received with your INTEGRITY
distribution. If you are using another supported OS target, see the
appropriate book from the list below.
• MULTI: Developing for Linux and GNU
• MULTI: Developing for OSE
• MULTI: Developing for ThreadX
This list may not be comprehensive. Contact Green Hills Technical
Support if your particular debugging interface, monitor, simulator, or OS
does not appear in the list.
The MULTI Document Set
The primary documentation for using MULTI is provided in the following books:
• MULTI: Getting Started — Provides an introduction to the MULTI Integrated
Development Environment and leads you through a simple tutorial.
• MULTI: Licensing — Describes how to obtain, install, and administer MULTI
licenses.
• MULTI: Managing Projects and Configuring the IDE — Describes how to
create and manage projects and how to configure the MULTI IDE.
Green Hills Software
ix

---

Preface
• MULTI: Building Applications — Describes how to use the compiler driver
and the tools that compile, assemble, and link your code. Also describes the
Green Hills implementation of supported high-level languages.
• MULTI: Configuring Connections — Describes how to configure connections
to your target.
• MULTI: Debugging — Describes how to set up your target debugging interface
for use with MULTI and how to use the MULTI Debugger and associated tools.
• MULTI: Debugging Command Reference — Describes how to use Debugger
commands and provides a comprehensive reference of Debugger commands.
• MULTI: Scripting — Describes how to create MULTI scripts. Also contains
information about the MULTI-Python integration.
For a comprehensive list of the books provided with your MULTI installation, see
the Help → Manuals menu accessible from most MULTI windows.
All books are available in one or more of the following formats:
• Print.
• Online help, accessible from most MULTI windows via the Help → Manuals
menu.
• PDF, available in the manuals subdirectory of your MULTI or compiler
installation.
Conventions Used in the MULTI Document Set
All Green Hills documentation assumes that you have a working knowledge of your
host operating system and its conventions, including its command line and graphical
user interface (GUI) modes.
Green Hills documentation uses a variety of notational conventions to present
information and describe procedures. These conventions are described below.
x
MULTI: Configuring Connections for V850 and RH850 Targets

---

Conventions Used in the MULTI Document Set
Convention
Indication
Example
bold type
Filename or pathname
C:\MyProjects
Command
setup command
Option
-G option
Window title
The Breakpoints window
Menu name or menu choice
The File menu
Field name
Working Directory:
Button name
The Browse button
italic type
Replaceable text
-o filename
A new term
A task may be called a process
or a thread
A book title
MULTI: Debugging
monospace type
Text you should enter as presented
Type help command_name
A word or words used in a
The wait [-global] command
command or example
blocks command processing,
where -global blocks
command processing for all
MULTI processes.
Source code
int a = 3;
Input/output
> print Test
Test
A function
GHS_System()
ellipsis (...)
The preceding argument or option
debugbutton [name]...
can be repeated zero or more times.
(in command line
instructions)
greater than sign ( > )
Represents a prompt. Your actual
> print Test
prompt may be a different symbol
Test
or string. The > prompt helps to
distinguish input from output in
examples of screen displays.
pipe ( | )
One (and only one) of the
call func | expr
parameters or options separated by
(in command line
the pipe or pipes should be
instructions)
specified.
Green Hills Software
xi

---

Preface
Convention
Indication
Example
square brackets ( [ ] )
Optional argument, command,
.macro name [list]
option, and so on. You can either
(in command line
include or omit the enclosed
instructions)
elements. The square brackets
should not appear in your actual
command.
The following command description demonstrates the use of some of these
typographical conventions.
gxyz [-option]... filename
The formatting of this command indicates that:
• The command gxyz should be entered as shown.
• The option -option should either be replaced with one or more appropriate
options or be omitted.
• The word filename should be replaced with the actual filename of an
appropriate file.
The square brackets and the ellipsis should not appear in the actual command you
enter.
xii
MULTI: Configuring Connections for V850 and RH850 Targets

---

Chapter 1
Using the Connection Editor
Contents
General Information Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Target-Specific Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
The Command Line Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Action Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

---

Chapter 1. Using the Connection Editor
The Connection Editor is a target specific dialog that you can use to configure and
edit Connection Methods.
The Connection Editor window for Standard Connection Methods has four sections,
which are called out in the above graphic and documented in the following sections.
2
MULTI: Configuring Connections for V850 and RH850 Targets

---

General Information Settings
General Information Settings
The first section of the Connection Editor contains fields that display and/or set
basic properties of a Connection Method. These fields are standard and appear on
nearly all Connection Editor windows. The following table describes each field.
Name
Displays the name of the Standard Connection Method you define or edit. You can change the
name of your method by editing this field.
Type
Displays the type of debugging interface the Connection Method is for, which determines which
debug server MULTI uses. The connection type is specified when you create a Standard
Connection Method. You cannot edit this read-only field.
Log Connection to file
Enables you to log transactions between MULTI and your debug server. To specify the file to
write the log to, enter a pathname or click
to browse for the desired file. On Linux/Solaris,
if you check the option box but do not specify a filename, MULTI writes the log to standard
error output. Logging is disabled by default.
Target Setup script
Specifies your target setup script file. This is an optional field because not all targets require
setup scripts.
If you require a setup script to configure your board, specify the filename (and full path, if
necessary) of the appropriate script or click
to browse for it. When this Connection Method
is used, MULTI usually runs the specified script before each download. If you are editing a
default Connection Method created by the Project Wizard for your processor-board combination,
the necessary setup script file (if applicable) appears in this field automatically.
To open the Editor on the target setup script, click
. If no setup script is specified in this field,
the Editor opens on a file with a filename derived from the debug connection's name.
For more information about target setup scripts, see the documentation about configuring your
target hardware in the MULTI: Debugging book.
Green Hills Software
3

---

Chapter 1. Using the Connection Editor
Scripting language radio buttons
Specify the scripting language so that MULTI knows how to interpret the specified target setup
script, where:
• MULTI — Indicates that the specified target setup script was written with the MULTI
scripting language. This is the default setting. For more information about MULTI scripting
in general, see the documentation about MULTI scripts in the MULTI: Scripting book.
• Legacy — Indicates that the specified target setup script was written with the debug server
scripting language. For more information, see Appendix A, “Green Hills Debug Server
Command and Scripting Reference” on page 89.
In previous versions of MULTI, target setup scripts had .dbs extensions and used the Green
Hills debug server scripting conventions and associated debug server commands. Beginning
with the v4.0 release, that scripting language was deprecated, and support for it will be
discontinued in a future release. The default setup scripts created by the Project Wizard have
.mbs extensions and use MULTI Debugger commands and scripting conventions instead. You
must indicate which scripting language your setup script uses so that MULTI interprets it
properly. When using the MULTI scripting language, you can still specify debug server
commands by using the MULTI target command. For information about this command, see
the documentation about general target connection commands in the MULTI: Debugging
Command Reference book.
For more detailed information about editing and using setup scripts, see the documentation
about configuring your target hardware in the MULTI: Debugging book.
Target-Specific Tabs
The second section of the Connection Editor contains one or more tabs that contain
fields for setting options specific to your debugging interface, type of connection,
and target architecture. The number of tabs and the fields that appear vary according
to the type of Standard Connection Method you are editing.
When the Connection Editor is first displayed after you create a new Connection
Method, the settings and options are set to default values. Settings and options that
are not available on your host operating system may appear dimmed. Some of the
fields may require user input before the Connection Method can be used.
The following table describes in general terms the types of settings and options that
appear on the most common tabs.
4
MULTI: Configuring Connections for V850 and RH850 Targets

---

The Command Line Viewer
Tab
Description
Connection tab
The options on this tab usually require input for the Connection
Method to function properly. The settings you choose for the
connection options are probably different for each new target you
connect to.
INTEGRITY tab
The option on this tab is useful if you are debugging an INTEGRITY
system. For more information, see the documentation for
set_runmode_partner in MULTI: Debugging Command Reference.
Download tab
The options on this tab allow you to customize the process of
downloading programs to the target. For example, this tab allows you
to control what program sections are downloaded to the target.
Advanced tab
The options on this tab allow a high degree of control over the details
of your connection. These options can often be left in their default
states. Use this tab sparingly because changing the advanced options
from their default settings may cause problems with your connection.
Debug tab
The options on this tab are provided to help troubleshoot your
connection. You should not change these settings unless instructed
to do so by Green Hills Technical Support.
Most Connection Editors include at least a Connection tab and a Debug tab, but
many contain additional tabs. For most connections, you need to set or edit some
of the fields on these tabs for your Standard Connection Method to work properly.
For more information about the Connection Editor settings available for your
particular target, see the chapter that documents your debug server, or if you are a
Green Hills Probe or SuperTrace Probe user, see the Green Hills Debug Probes
User's Guide.
The Command Line Viewer
The third section of the Connection Editor displays the command line equivalents
of your GUI selections. Default selections do not always have corresponding
commands or options on the command line.
The command line viewer is a read-only field. You cannot make changes to the
command line by typing in this field.
Changes you make in the GUI will not be reflected in the command line viewer
until you click Apply or OK.
Green Hills Software
5

---

Chapter 1. Using the Connection Editor
Action Buttons
The fourth section of the Connection Editor contains buttons that allow you to
discard your edits, apply your edits, or connect using a Connection Method. The
following table describes each button.
Button
Description
Connect
Records your changes, connects to your target using the Standard
Connection Method you are editing, and closes the Connection
Editor.
OK
Records your changes and closes the Connection Editor.
Cancel
Discards your changes and closes the Connection Editor.
Revert
Discards your changes and leaves the Connection Editor open.
Apply
Records your changes and leaves the Connection Editor open.
Note
Clicking Connect, OK, or Apply in the Connection Editor saves your
Standard Connection Method. In the future, the Connection Method will
appear in the list of available Connection Methods in the Connection
Chooser and the Connection Organizer.
6
MULTI: Configuring Connections for V850 and RH850 Targets

---

Chapter 2
Green Hills Monitor
(monserv) Connections
Contents
Supported Features for Green Hills Monitor (monserv) Connections . . . . . . . . 8
Connecting to Your Target with a Green Hills Monitor . . . . . . . . . . . . . . . . . . . . 8

---

Chapter 2. Green Hills Monitor (monserv) Connections
This chapter supplements the general target connection information contained in
Chapter 2, “Setting Up Your Target Hardware” of this book and the documentation
about connecting to your target in the MULTI: Debugging book with specific
information for Green Hills Monitor connections.
Supported Features for Green Hills Monitor (monserv)
Connections
The Green Hills Monitor is a debug monitor that allows MULTI to download, run,
and debug programs. The debug monitor allows you to read and write memory and
program registers, set breakpoints, and perform other debugging functions.
MULTI uses the monserv debug server to connect to your Green Hills Monitor, as
shown in the following diagram.
Connecting to Your Target with a Green Hills Monitor
After you have installed and configured your system, you are ready to connect to
your target and begin debugging. To help you connect to your target quickly and
easily, MULTI allows you to create and save Connection Methods that correspond
to your particular host and target systems and your desired debugging options.
For general instructions on how to create and use Connection Methods, the
documentation about connecting to your target in the MULTI: Debugging book.
The information in the following sections supplements the instructions provided
there with information that is specific to Green Hills Monitor connections.
8
MULTI: Configuring Connections for V850 and RH850 Targets

---

Creating a Standard Green Hills Monitor (monserv) Connection Method
Creating a Standard Green Hills Monitor (monserv) Connection Method
When creating a new Standard Green Hills Monitor Connection Method, select
Green Hills Monitor (monserv) as the connection type in the Create New
Connection Method dialog box.
For detailed information about creating new Standard Connection Methods, see the
documentation about Standard Connection Methods in the MULTI: Debugging
book.
Using the Green Hills Monitor (monserv) Connection Editor
In addition to the generic fields that appear on all Connection Editors for Standard
Connection Methods, the Green Hills Monitor (monserv) Connection Editor
includes Connection, Advanced, and Debug tabs that provide settings and options
specific to your target and host operating systems.
Green Hills Software
9

---

Chapter 2. Green Hills Monitor (monserv) Connections
When the Connection Editor is first displayed after you create a new Connection
Method, the settings and options are set to default values. Settings and options that
are not available on your host operating system may appear dimmed. Some of the
fields may require user input before the Connection Method can be used.
All of the fields on the Connection, Advanced, and Debug tabs of the Green Hills
Monitor (monserv) Connection Editor are described in detail in the tables below.
(See the documentation about the Connection Editor in the MULTI: Configuring
Connections book for a description of the other fields and options, which appear
on all Connection Editors.)
10
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using the Green Hills Monitor (monserv) Connection Editor
Green Hills Monitor (monserv) Connection Settings
Serial Port
Specifies the serial port device to use when connecting to the target. The default for each
supported operating system is:
• (Windows) COM1
• (Solaris) /dev/ttya
• (Linux) /dev/ttyS0
• (HP-UX) /dev/tty00
Baud
Sets the serial port communication speed. The default baud rate is 9600.
Green Hills Monitor (monserv) Advanced Settings
Warning
Use this tab carefully, since changing the advanced options from their
default settings can cause problems with your connection.
Green Hills Software
11

---

Chapter 2. Green Hills Monitor (monserv) Connections
Monitor halt signal
Specifies which signal will interrupt and halt target program execution and return control to the
monitor. Select one of the available halt mechanisms:
• Monitor uses serial break for halt (default)
• Monitor uses '0x00' for halt
• Monitor uses '0xFF' for halt
Load Sections
Controls which sections of your program will be downloaded to the target, as follows:
• Text — If this box is checked, the .text (code) sections of your program will be
downloaded to the target. This box is checked by default.
• Data — If this box is checked, the .data (initialized data) sections of your program will
be downloaded to the target. This box is checked by default.
• BSS — If this box is checked, the .bss (uninitialized data) sections of your program will
be cleared. This box is not checked by default.
Green Hills Monitor (monserv) Debug Settings
Warning
Do not change the settings on the Debug tab unless you are instructed to
do so by Green Hills Technical Support.
12
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using Custom Green Hills Monitor (monserv) Connection Methods
Log Host-Target Debug Output
Enables logging of all communications between monserv and the Green Hills Monitor. Logging
is disabled by default.
Log to stderr/stdout
Log to monserv.log
Allows you to specify the destination for host-target debug output. These fields will be dimmed
unless Log Host-Target Debug Output is selected. Select the appropriate button to send the
debug output to stderr/stdout (the default setting) or monserv.log.
Other Options
Allows you to add other, optional arguments directly to the command line. You should only
use this field if directed to do so by Green Hills Technical Support.
Using Custom Green Hills Monitor (monserv) Connection Methods
To connect to your Green Hills Monitor with a Custom Connection Method, type
the command given below, with the appropriate parameters and options, into the
Start a Custom Connection dialog box and click Connect.
monserv [-sp port] [-baud baud_rate] [options]...
where:
• -sp port is optional and specifies the serial port to use when connecting to the
target. If no serial port is specified, the default is:
○ (Windows) COM1
○ (Solaris) /dev/ttya
○ (Linux) /dev/ttyS0
○ (HP-UX) /dev/tty00
• -baud baud_rate is optional and sets the serial port communication speed. The
valid arguments for baud_rate are 9600, 19200, 38400, 57600, and 115200. If
the -baud option is not used, monserv defaults to 9600 baud.
• options can be any non-conflicting combination of the monserv options listed
in “Other Options for Custom Green Hills Monitor (monserv) Connection
Methods” on page 14.
Green Hills Software
13

---

Chapter 2. Green Hills Monitor (monserv) Connections
Note
You can also enter the above connection command from the Debugger's
command pane, where it must be preceded by the connect command.
See the documentation about Custom Connection Methods in the MULTI: Debugging
book for more information about Custom Connections.
For example connection commands, see “Example Custom Green Hills Monitor
(monserv) Connection Methods” on page 17.
Other Options for Custom Green Hills Monitor (monserv)
Connection Methods
In addition to the specific options described in the custom connection section above,
you can also use any non-conflicting combination of the options listed below when
creating or using a Custom Green Hills Monitor (monserv) Connection Method.
-bss
Sets downloading of .bss (uninitialized data) sections. By default, .bss downloading is disabled
because the default Green Hills startup code clears .bss sections. This option allows you to
clear .bss sections upon download.
-dbreak
Specifies that the character 0xFF will interrupt and halt the target program execution. (If this
option is not used, the default halt monitor signal is a serial break.)
-debug n
Sets the communication channel debugging level to n. See the note and table below for more
information.
-loadall
Enables downloading of all program sections. By default, all sections are loaded except for
uninitialized data (.bss) sections, which are cleared by the default Green Hills startup code.
The -loadall option allows you to download all sections, including .bss.
-nobss
Disables uninitialized data (.bss) clearing by ocdserv. This option is enabled by default and
is documented for backward compatibility only.
-nodata
Disables downloading of initialized data (.data) sections.
14
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using Custom Green Hills Monitor (monserv) Connection Methods
-noload
Disables downloading of any of the program sections in an executable file.
This option is useful when debugging an executable that is already loaded on the target. For
example, use this option when debugging an executable in ROM or flash memory. This option
does not disable stack setup processes, such as setting the stack pointer, writing the stack to
memory, or setting the system call breakpoint.
-notext
Disables downloading of program sections containing executable code (.text sections).
-zbreak
Specifies that the character 0x00 will interrupt and halt the target program execution. (If this
option is not used, the default halt monitor signal is a serial break.)
Note
The -debug option should only be used when troubleshooting the
communications channel between monserv and the debug monitor. The
debugging level specified by n is the sum of the following bit flags.
Green Hills Software
15

---

Chapter 2. Green Hills Monitor (monserv) Connections
Bit Value
Description
1
Displays communications with the debug monitor at the byte level. This shows
every byte as it is transmitted or received. Every line preceded by monserv:
shows what was sent by monserv to the monitor. Every line preceded by monitor:
shows what was sent back by the monitor to monserv.
Example:
monserv: 01 0f 0f
monitor: 05
monitor: 00 00 00 03 04
monitor: 07
2
Displays communications at the message level. Every line preceded by request:
shows a message sent to the monitor and each line preceded by response: shows
the monitor's response in a human readable format.
Example:
request: Monitor cpu/coproc id
response: 304
request: Initialize
response: Okay
request: Write Register 17 = 109ec
response: Okay
4
Displays timeouts, error detection, and retransmits. If MULTI seems too slow,
this will tell you if the slowness is due to a noisy line.
Example:
*Timed out on read from Monitor*
*sending retry, timeout in message body*
*Checksum error in Monitor reply retry*
*retransmitting previous message*
8
Randomly corrupts communications to test the retry mechanism. This option
causes monserv to simulate a very noisy line by randomly changing, deleting, or
inserting bytes.
This option should be invoked as either -debug 13 or -debug 15 (all debugging
options) so that you can see the retry messages and the modified bytes.
Example:
monserv: *********corrupting message*******
monserv: **********randomizing byte ********
16
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using Custom Green Hills Monitor (monserv) Connection Methods
Example Custom Green Hills Monitor (monserv) Connection
Methods
The following are examples of commands that can be entered into the Start a
Custom Connection field of the Connection Chooser. (These example commands
can also be entered, preceded by the connect command, from the MULTI command
pane.)
Example 2.1. Serial Connection
The following command connects monserv to a target through the COM1 serial
port on Windows at 115200 baud.
monserv -baud 115200
Example 2.2. Solaris Connection
The following command connects monserv to a target through /dev/ttyb on Solaris
at 9600 baud and uses 0x00 as the halt signal.
monserv -sp /dev/ttyb -zbreak
Green Hills Software
17

---

---

Chapter 3
Renesas V850/V850E ICE
(850eserv2) Connections
Contents
Target System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Installing Your Renesas V850/V850E ICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Additional Windows Setup and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Connecting to Your Target with an Renesas V850/V850E ICE . . . . . . . . . . . . . 23
Connecting Through a Remote Server (850eserv2_server) . . . . . . . . . . . . . . . . 33
Hardware Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Target Commands for Renesas V850/V850E ICE (850eserv2)
Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
This chapter supplements the general target connection information contained in
Chapter 2, “Setting Up Your Target Hardware” of this book and the documentation
about connecting to your target in the MULTI: Debugging book with specific
information for Renesas V850/V850E In-Circuit Emulator (ICE) connections.
Target System Requirements
The 850eserv2 debug server included with this distribution of MULTI can be used
to connect to hardware from a Microsoft Windows environment. This software runs
under Microsoft Windows 8, Windows 7, Windows Vista, Windows XP, Windows
9x, Windows NT 4.0 and Windows 2000. This software does not run under any
Windows 3.x versions (for example, Windows 3.1, Windows 3.11, or Windows
NT 3.51).
It is also possible to connect indirectly from another host, such as Linux, by running
850eserv2_server on the Windows machine that is attached to hardware, and
connecting through it. See “Connecting Through a Remote Server
(850eserv2_server)” on page 33 for more information.
Installing Your Renesas V850/V850E ICE
Before attempting to connect to your target, you must install your Renesas ICE.
For instructions on hardware setup, diagnostics, and configuration, see your Renesas
ICE documentation. As part of the setup process, you may need to download the
latest EXEC library file, monitor, drivers, and/or device files from the Renesas web
site.
The instructions in the remainder of this chapter assume that you have already
installed MULTI, downloaded any necessary files from the Renesas Electronics
web site, and set up your ICE. You should also know the I/O address of the PC
interface card (for example, if your ICE connects to your PC with a PCI card) and
know how to set environment variables under your operating system.
Additional Windows Setup and Configuration
In addition to following the relevant installation and configuration instructions
contained in your Renesas hardware documentation, “Installing Your Renesas
20
MULTI: Configuring Connections for V850 and RH850 Targets

---

Required Definition File for Network V850/V850E Interfaces
V850/V850E ICE” on page 20, and the documentation about configuring your
target hardware in the MULTI: Debugging book, you must configure your Windows
device drivers and your Windows environment variables.
Drivers for ICE interface cards are provided with the hardware. (You may need to
download the latest drivers from the Renesas Electronics web site. See “Installing
Your Renesas V850/V850E ICE” on page 20.) For proper driver installation, see
your Renesas documentation.
Required Definition File for Network V850/V850E Interfaces
For network connections to V850/V850E ICE, (for example, the IE-70000–MC-SV3
ICE), the exws.ini definition file must be modified to specify the hostname and port
number of theV850/V850E ICE to which you want to connect. This definition file
should then be copied to your Windows directory, which is typically at c:\windows
or c:\winnt.
The following is an example exws.ini file:
;************************************************************
:*
SV3 Driver environment
*
;*
*
;************************************************************
[WSIF]
HOST0=necice 0x7c6
;HostName & Port No.
;File End
The semicolon (;) is a comment character; anything following a semicolon until the
end of a line is ignored.
[WSIF] is the name of a section that is required in the exws.ini file.
The HOST0= option specifies the hostname and port number. The first field is for
the hostname and the second field, delimited by whitespace, is for the port number.
The hostname can also be written in IP address style.
Note
The port number of the IE-70000–MC-SV3 is fixed to 0x7c6 and cannot
be changed.
Green Hills Software
21

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
Using the Green Hills SuperTrace Probe to Collect Real-time Trace Data
The following describes connecting the SuperTrace Probe to an Renesas IE Cube
ICE, configuring the SuperTrace Probe, and collecting trace data. For more
information about the SuperTrace Probe, see the Green Hills Debug Probes User's
Guide. For more information about connecting your debug server see “Connecting
to Your Target with an Renesas V850/V850E ICE” on page 23.
Before connecting a SuperTrace Probe, you must be able to debug a program from
MULTI with an Renesas IE Cube.
Connecting the SuperTrace Probe to an Renesas IE Cube
An IE Cube that can communicate with the SuperTrace Probe is identified by the
Mictor connector located on the front of the IE Cube.
To connect to the IE Cube:
1. Plug the tracepod into the trace adapter (PATV8-01A).
2. Plug the trace adapter into the IE Cube.
Note
If this puts too much strain on the Mictor connector on the IE Cube, a
Mictor extension cable is available from Green Hills Software (part
number GH-ME-V85-mic), which can be inserted between the trace
adapter and the IE Cube.
Configuring the SuperTrace Probe
Use a telnet console, a serial console, or gpadmin to set the following settings:
• Adapter must be set to v850e-trace-24.
• Target must be set to v850e_trace.
Note
There is a hyphen in the adapter name and an underscore in the target
name.
22
MULTI: Configuring Connections for V850 and RH850 Targets

---

Connecting to Your Target with an Renesas V850/V850E ICE
For more information about the SuperTrace Probe, see the documentation about
installing your probe in the Getting Started book for your probe.
Collecting Trace Data
To collect trace data from the target, you must specify the SuperTrace Probe in your
850eserv2 connection. For more information, see "SuperTrace Probe is connected
via" in “Renesas V850/V850E ICE (850eserv2) Connection Settings” on page 26.
After the connection is made, verify that the target-specific trace options dialog is
configured correctly for your target.
Note
Besides capturing trace data using a SuperTrace Probe (option only
available for the IECUBE), trace can be obtained through the internal
trace buffer available in both the IECUBE and IECUBE2
The IECUBE2 can also be used with the QB-V850E2-SP trace memory
extension (also known as LTT or Long Term Trace) to increase the trace
buffer size.
Connecting to Your Target with an Renesas V850/V850E ICE
After you have installed and configured your system, you are ready to connect to
your target and begin debugging. To help you connect to your target quickly and
easily, MULTI allows you to create and save Connection Methods that correspond
to your particular host and target systems and your desired debugging options.
For general instructions on how to create and use Connection Methods, see the
documentation about connecting to your target in the MULTI: Debugging book.
The information in the following sections supplements the instructions provided
there with information that is specific to Renesas V850/V850E ICE connections.
Green Hills Software
23

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
Creating a Standard Renesas V850/V850E ICE (850eserv2) Connection
Method
When creating a new Standard Renesas V850/V850E ICE Connection Method,
select Renesas V850/V850E (850eserv2) as the connection type in the Create New
Connection Method dialog box.
For detailed instructions on creating new Standard Connection Methods, see the
documentation about connecting to your target in the MULTI: Debugging book.
Using the Renesas V850/V850E ICE (850eserv2) Connection Editor
In addition to the generic fields that appear on all Connection Editors for Standard
Connection Methods, the Renesas V850/V850E (850eserv2) Connection Editor
includes Connection, Clock, Advanced, and Debug tabs that provide settings and
options specific to your target and host operating systems.
24
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using the Renesas V850/V850E ICE (850eserv2) Connection Editor
When the Connection Editor is first displayed after you create a new Connection
Method, the settings and options on the Connection, Clock, Advanced, and Debug
tabs are set to default values. The options on these tabs allow a high degree of
control over the details of your connection, but can usually be left in their default
states. Use the Advance tab carefully because changing the advanced options from
their default settings can sometimes cause problems with your connection.
All of the fields on the Connection, Clock, Advanced and Debug tabs of the
Renesas V850/V850E (850eserv2) Connection Editor are described in the
subsequent sections.
Green Hills Software
25

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
Renesas V850/V850E ICE (850eserv2) Connection Settings
Device file
Sets the fully qualified location of the device file corresponding to the target to which you are
connecting. To provide backward compatibility with previous versions of 850eserv, instead of
specifying the device file here, you can alternatively set the IEPATH and DEVICE_FILE
environment variables (where IEPATH is the fully qualified directory containing the device file
and DEVICE_FILE is the name of the device file without directory names). Either this field or
the environment variables must be set to connect to your target.
There are several device files located in the v850e directory within the MULTI installation
directory. Device files might have also been provided with your target. Check the documentation
provided with your target to determine which device file to use.
Debugger
Indicates the type of Renesas debugger or In-Circuit Emulator (ICE) you are using to connect
to your target. The default is the IE Cube. Other options include CD-NW, Mini Cube, Mini
Cube 2, E1 Emulator JTAG, E20 Emulator JTAG, E1 Emulator Serial, E20 Emulator Serial,
E1 Emulator LPD, E20 Emulator LPD.
E1 Core/E2 Core
Selects the V850 core type you are connecting to. When connecting to a V850E1 or V850E2/ME3
core, select E1 Core. When connecting to a V850E2 core, select E2 Core.
Serial port
Sets the port for your Mini Cube 2 or E1/E20 Emulator Serial. This is a required option if you
are using an Renesas Mini Cube 2 ICE or E1/E20 Emulator Serial to connect to your target.
26
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using the Renesas V850/V850E ICE (850eserv2) Connection Editor
SuperTrace Probe is connected via
Allows you to collect trace data from your target using a Green Hills SuperTrace Probe, if your
target supports collecting trace data. The SuperTrace Probe is used in tandem with the existing
Renesas ICE connection (see Debugger).
The trace data collected with the SuperTrace Probe allows you to use TimeMachine and other
trace facilities of the MULTI Debugger (see the documentation about analyzing trace data with
the TimeMachine tool suite in the MULTI: Debugging book).
If you are using a SuperTrace Probe to collect trace data from your target, specify the location
of the SuperTrace Probe here. If the SuperTrace Probe is connected via Ethernet, you must also
specify the IP address or hostname of the SuperTrace Probe in the IP Address field.
For more information about configuring your SuperTrace Probe, see the documentation about
installing your probe in the Getting Started book for your probe.
IP Address
If you are using a SuperTrace Probe to collect trace data from your target and the SuperTrace
Probe is connected via Ethernet, you must specify the IP address or hostname of the SuperTrace
Probe here.
Renesas V850/V850E ICE Clock Settings
Main clock
Specifies the main clock frequency in kHz.
Sub clock
Specifies the sub clock frequency in Hz.
Use sub clock when break is hit?
Specifies whether or not to use the sub clock when the program breaks.
Green Hills Software
27

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
Clock Rate
Specifies the CPU clock rate.
Renesas V850/V850E ICE (850eserv2) Advanced Settings
Protect I/O memory
Prevents 850eserv2 from reading or writing I/O memory, effectively read/write protecting the
I/O memory.
Writes 0's into BSS Section
Writes zeros to the .bss section of the target before running the executable on the target. This
option might be necessary if your setup script does not clear the .bss section.
Debug with RD850 or AZ850 (TIP)
Connect to an Renesas RD850 task debugger or an AZ850 event analyzer.
Registry ID code
Specifies a Windows Registry key. If you do not know what your Windows Registry key is,
leave this field empty.
Environment variables
Sets the specified environment variables before launching 850eserv2. The environment variables
string is of the form:
env1=val1,env2=val2,...
where env1,env2, are the names of environment variables to set and val1, val2 are the
respective values to assign to those variables.
28
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using Custom Renesas V850/V850E ICE (850eserv2) Connection Methods
Renesas V850/V850E ICE (850eserv2) Debug Settings
Communications log with debugger
Controls logging of all communications between 850eserv2 and the Renesas ICE. Log output
can be saved to a file (850eserv2.log), directed to stderr, or disabled.
Log trace retrieval
Logs trace retrieval events to 850eserv2_trace.log.
Display result of flashing target
Displays diagnostic status information when writing to flash memory during download.
Log TIP process in tipserv
Logs TIP events to tipserv.log. This option is available when Debug with RD850 or AZ850
(TIP) is selected in the Advanced tab.
Other Options
Allows you to add other, optional arguments directly to the command line. Only use this field
if directed to do so by Green Hills Technical Support.
Using Custom Renesas V850/V850E ICE (850eserv2) Connection Methods
To connect to your Renesas V850/V850E ICE with a Custom Connection Method,
type the command given below, with the appropriate parameters and options, into
the Start a Custom Connection dialog box and click Connect.
[setup=filename.mbs] 850eserv2 [options]...
where:
Green Hills Software
29

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
• setup=filename.mbs is optional and specifies the target setup script. This
argument is optional because not all targets require setup scripts.
Note
This option can only be used to specify an .mbs setup script. If you
are using an older .dbs script, you must use the -setup option, which
must come after the 850eserv2 command. See the documentation
about configuring your target hardware in the MULTI: Debugging
book for more information about setup scripts.
• options can be any non-conflicting combination of the 850eserv2 options listed
in “Options for Custom Renesas V850/V850E ICE (850eserv2) Connection
Methods” on page 30.
Note
You can also enter the above connection command from the Debugger's
command pane, where it must be preceded by the connect command.
See the documentation about Custom Connection Methods in the MULTI: Debugging
book for more information about Custom Connections.
Options for Custom Renesas V850/V850E ICE (850eserv2)
Connection Methods
The options listed below are available for Custom Renesas V850/V850E ICE
(850eserv2) Connection Methods. For additional information, see the manual
sv-v850e2-us-*.pdf.
-2m
Specifies that the CPU clock operates at 10 MHz. This option is only valid when used with
-cdnw.
-cdnw
Indicates that 850eserv2 is connecting to a CD-NW ICE.
-bsp board
Specifies the board to connect to. The available board names are the same as those supported
by the New Project Wizard. This will set default connection options for the board. This option
is primarily intended as a shortcut when connecting via the command line.
30
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using Custom Renesas V850/V850E ICE (850eserv2) Connection Methods
-D
Enables logging of communications between 850eserv2 and the ICE monitor. The log is written
to 850eserv2.log.
-dck20
Specifies that the CPU clock operates at 20 MHz. This option is only valid when used with
-cdnw or -minicube or E1/E20 Emulator JTAG.
-df=device_file
Specifies the fully qualified location of a device file corresponding to the target to which you
are connecting. This option is the same as the Device File 850eserv2 Connection Editor option
described in “Renesas V850/V850E ICE (850eserv2) Connection Settings” on page 26.
-e1jtag
Indicates that 850eserv2 is connecting to E1 Emulator JTAG.
-e1lpd
Indicates that 850eserv2 is connecting to E1 Emulator LPD.
-e1serial
Indicates that 850eserv2 is connecting to E1 Emulator Serial.
-e20jtag
Indicates that 850eserv2 is connecting to E20 Emulator JTAG.
-e20lpd
Indicates that 850eserv2 is connecting to E20 Emulator LPD.
-e20serial
Indicates that 850eserv2 is connecting to E20 Emulator Serial.
-env=env_vars key
Sets the specified environment variables before launching 850eserv2. env_vars is of the form:
env1=val1,env2=val2
where env1, env2, are the names of environment variables to set, and val1, val2, are the
respective values to assign to those variables.
-I
Enables logging of communications between 850eserv2 and the ICE monitor. The log is written
to stderr.
-id key
Specifies a Windows Registry key. If you do not know what your Windows Registry key is,
leave this field empty.
Green Hills Software
31

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
-iecube
Indicates that 850eserv2 is connecting to an IE Cube ICE.
-minicube
Indicates that 850eserv2 is connecting to a Mini Cube ICE. Note that the -minicube and
-minicube2 options are mutually exclusive.
-minicube2
Indicates that 850eserv2 is connecting to a Mini Cube 2 ICE. For a Mini Cube 2 connection,
you must also specify the -p option. Note that the -minicube and -minicube2 options are
mutually exclusive.
-noiop
Allow 850eserv2 to read and write I/O memory.
By default, 850eserv2 does not read or write I/O memory, effectively read/write-protecting I/O
memory on the target, and gives errors like "I/O Area(0xff400000-0xff741fff) is Protected"
(unless the SFR command is used). This option lifts that self-imposed restraint from 850eserv2,
which allows 850eserv2 to read and write I/O memory.
-p port
Indicates the port for the Mini Cube 2 ICE or E1/E20 Emulator Serial to which you are
connecting.
-server host:port
Specifies a host name and port number of the 850eserv2_server proxy. When run with this
option, 850eserv2 will not connect directly to the hardware, but will instead connect to
850eserv2_server, which may be running on a different machine.
-stp ip_address
Indicates the IP address or hostname of the SuperTrace Probe that you are using to collect trace
data from the target. This is the same as selecting STP for the SuperTrace Probe is connected
via option in the 850eserv2 Connection Editor, which is described in “Renesas V850/V850E
ICE (850eserv2) Connection Settings” on page 26.
-t3v
Specify that the E1 Emulator should supply 3V power to the target. This option is only available
with the E1 Emulator.
-t5v
Specify that the E1 Emulator should supply 5V power to the target. This option is only available
with the E1 Emulator.
32
MULTI: Configuring Connections for V850 and RH850 Targets

---

Connecting Through a Remote Server (850eserv2_server)
-usb
Indicates that you have connected a SuperTrace Probe via USB to collect trace data from the
target. This is the same as selecting USB for the "SuperTrace Probe is connected via option
in the 850eserv2 Connection Editor, which is described in “Renesas V850/V850E ICE
(850eserv2) Connection Settings” on page 26.
-X0
Writes zeros to the .bss section of the target before running the executable on the target. This
option might be necessary if your setup script does not clear the .bss section.
Example Custom Renesas V850/V850E ICE (850eserv2) Connection
Methods
The following are examples of commands that can be entered into the Start a
Custom Connection field of the Connection Chooser. (These example commands
can also be entered, preceded by the connect command, from the MULTI command
pane.)
Example 3.1. Connecting 850eserv2 to a QB-V850ESJG3L-TB board with E1
Emulator Serial
850eserv2 -df=df3738.800 -e1serial -p csib0 -e1 -t3v
-dclock=5000,0,swoff -noiop -id ffffffffffffffffffff
Connecting Through a Remote Server (850eserv2_server)
The 850eserv2 debug server can connect directly to hardware only from a Microsoft
Windows environment. To connect to hardware from another host, such as Linux,
it is necessary to run the 850eserv2_server server from Windows. This server acts
as a proxy and listens on a TCP port for connections from 850eserv2. The
850eserv2_server server must be run from the Windows command line, and takes
the same connection options as are supported on 850eserv2. By default, it listens
for connections on port 27000, but a different port number can be specified with
-port num.
Once 850eserv2_server is running, 850eserv2 can connect from another host
machine, using -server host:port. For example, if 850eserv2_server was run on a
machine named winmachine1 with -port 27001, then 850eserv2 could be used
to connect from another machine with -server winmachine1:27001.
Green Hills Software
33

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
Hardware Breakpoints
There are different types of execute hardware breakpoints supported, and the number
of each type can vary depending on the target. Some (type "f") will stop at the
address where the breakpoint is set (before the instruction is executed), while others
(type "e") stop at the next instruction. 850eserv2 will use the type "f" breakpoints
first. For example, with an IE Cube ICE, the first two execute hardware breakpoints
set will be type "f", and later breakpoints will be type "e". The BRS command can
be used to see the types of the breakpoints that are set.
Troubleshooting
The following sections describe some common problems that may occur when you
connect to or use 850eserv2.
General Troubleshooting Checklist
If you are experiencing problems with your 850eserv2 connection, working through
the following checklist can help you locate the problem.
• Are you using the correct version of Windows? This version of 850eserv2 only
runs under Windows 7, Windows Vista, Windows XP, Windows 9x, Windows
NT 4.0, and Windows 2000. It does not run under any Windows version 3.x,
such as Windows 3.1, Windows 3.11, or Windows NT 3.51.
• Is all of your V850/V850E ICE hardware set up properly? If your ICE requires
a PC interface card, is that card properly installed and configured? Does the
ICE have power?
• Did you reboot the PC after installation?
• Are all the Windows or UNIX environment variables properly set?
• If you are running Windows NT, did you make sure you have the appropriate
privileges to change the Windows NT Registry and to set System or User
variables?
• Does the device file you specified in the Connection Editor under Device File
(or specified by using the IEPATH and DEVICE_FILE environment variables)
exist at the specified location? Is that the correct device file for your target?
34
MULTI: Configuring Connections for V850 and RH850 Targets

---

Error Messages
• If you were using COFF previously, did you rebuild all your object files for
the new ELF format? Do you have COFF-specific assembler directives in your
assembly files that should be ported to ELF?
Error Messages
The examples below show some common error messages and explain their likely
causes.
Example 3.2. Error Message: Unable to connect
If you receive an error message that is something like:
Unable to connect to emulator, error ca1 or0x1a0: fatal err (missing monitor program)
Debug server’c:\green\850eserv2’ has aborted.
remote: no remote connection established.
850eserv2 cannot find the V850/V850E ICE monitor ie850.mon or ie850e.mon.
Make sure the environment variable IEPATH is set up properly.
Example 3.3. Error Message: Unable to connect
If you receive an error message that is something like:
Unable to connect to emulator, error 0x3a0: status err
Debug server ’c:\green\850eserv2’ has aborted.
remote: no remote connection established.
the V850/V850E ICE may not be receiving power. Click OK and then check the
power supply.
Example 3.4. MULTI Dialog Box: Server Message Timed Out
Server Message Timed Out, Terminate Connection?
If you receive this message, click OK. The V850/V850E ICE may not be powered,
or the physical connection may have problems. Check the power and connection.
Example 3.5. Memory Protection Errors (Windows 98)
Windows 98 does not have true memory protection. If you encounter any General
Protection Fault Errors, Fatal Errors, or Illegal Operation Errors, reboot your PC
and reset the V850/V850E ICE.
Green Hills Software
35

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
Target Commands for Renesas V850/V850E ICE (850eserv2)
Connections
Unlike most Green Hills debug servers, 850eserv2 does not support all of the
commands listed in “Generic Debug Server Commands” on page 90. The tables
below list the target commands available to 850eserv2. Full descriptions and
examples of each command appear in “Target Command Descriptions” on page 39.
The commands in the summary tables below have been grouped into the following
function categories:
• Data and register commands
• Execution commands
• Event, trigger, and trace commands
• Trace display commands
• Emulator configuration commands
• Other commands
You can enter all of these commands directly into the 850eserv2 Target pane. You
can also enter these commands into the MULTI Debugger command pane using
the target command. For additional information, see the manual sv-v850e2-us-*.pdf.
Data and Register Commands
The following data and register commands are accepted by 850eserv2. See “Target
Command Descriptions” on page 39 for more detailed descriptions and examples
of each command and its arguments.
Command
Description
A
Assembles code one line at a time
M
Displays or changes memory
REG
Displays or changes register values
SFR
Displays SFR values
U
Disassembles object code
36
MULTI: Configuring Connections for V850 and RH850 Targets

---

Execution Command
Execution Command
The following execution command is accepted by 850eserv2. See “Target Command
Descriptions” on page 39 for more detailed descriptions and examples of this
command and its arguments.
Command
Description
RST
Resets the CPU and/or the emulation hardware
Event, Trigger, and Trace Setting Commands
The following event, trigger, and trace setting commands are accepted by 850eserv2.
See “Target Command Descriptions” on page 39 for more detailed descriptions
and examples of each command and its arguments.
Command
Description
B
Causes a break
BRA
Sets bus event detectors
BRS
Sets execution event detectors
SA or
Displays current trace analyzer settings
SHOWALL
T or TRACE
Specifies conditions for tracing
Trace Display Commands
The following trace display commands are accepted by 850eserv2. See “Target
Command Descriptions” on page 39 for more detailed descriptions and examples
of each command and its arguments.
Command
Description
TD or
Displays the trace buffer
TDISPLAY
TF or TFILTER
Specifies trace buffer filtering
TMODE
Specifies the trace mode
TRUN
Restarts the trace analyzer
TS or TSTOP
Halts the trace analyzer
Green Hills Software
37

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
Command
Description
TSEARCH
Searches the trace buffer
Emulator Configuration Commands
The following emulator configuration commands are accepted by 850eserv2. See
“Target Command Descriptions” on page 39 for more detailed descriptions and
examples of each command and its arguments.
Command
Description
COMBO
Displays or changes the COMBO break status
CPU
Displays or changes the CPU internal ROM/RAM setting
MAP
Specifies the emulator memory configuration
PIN or
Sets the masked processor pins
PINMASK
Other Commands
The following additional commands are accepted by 850eserv2. See “Target
Command Descriptions” on page 39 for more detailed descriptions and examples
of each command and its arguments.
Command
Description
850win
Launches the 850win configuration window.
CLOCK
Specifies the clock source
HELP
Displays command summary
IEPORT0
Controls the internal port0 of the ICE
IEPORT1
Controls the internal port1 of the ICE
LOG
Opens or closes a log file
MODE
Specifies the CPU mode
NOHALT
Exits MULTI without issuing a reset to the ICE
NOLOAD
Turns download suppression on or off
POWER
Turns power on or off
PROFILE
Specifies profiling support
38
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
Command
Description
RMEM
Displays the contents of the real-time RAM periodically
RRAMBASE
Sets or displays the base address of the real-time RAM area
TIMEBASE
Sets or displays the frequency of the CPU clock and the scalar value of the
trace time-tag counter
TIMER
Shows executed clocks
VERIFY
Turns memory verify on or off
Target Command Descriptions
The following commands are accepted by 850eserv2. You can enter these commands
directly into the 850eserv2 Target pane or you can enter them into the MULTI
Debugger command pane using the target command.
A [address]
Assembles code one line at a time, where address specifies the target address for the assembled
code. If no address is specified, assembly begins where the last A command left off.
When this command is issued, the command pane enters an interactive mode in which it displays
the disassembly of the current instruction at the target address and prompts you to enter a new
assembly line. After assembling the input and modifying the emulator memory, the command
pane updates the target address, displays the next disassembled line, and prompts for more
assembly input. If you want the currently displayed instruction to be left unchanged, press Enter.
The instruction will not be changed and the next instruction will be displayed for modification.
To terminate the interactive mode, enter END or a period (.) for the assembly line.
Symbolic constants can be used when specifying either the address or operands in the source
line. The operators sdaoff, zdaoff, hi, and lo are supported. The name ZERO is treated as
register RO.
For an example of how to use this command, see “Additional Examples of 850eserv2 Target
Commands” on page 61.
Green Hills Software
39

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
B [ K | event_expression ...]
Specifies or displays which event detectors cause breaks.
Once you have used the BRA and BRS commands to specify how the event detectors work,
you can use the B command to assign some or all of them to cause a break. The event_expression
argument specifies the event(s) and/or link(s). Multiple events and/or links can be specified if
they are separated by a pipe ( | ) symbol. The K option clears all breakpoints.
If you enter the command without any parameters, the list of currently assigned events will be
displayed.
Any new B command overrides the previous break setting.
Example:
brk>BRS 1 a=main
brk>BRA 2 A=data2, L 0x10 W=0x00xx
brk>B BRS1|BRA2
brk>B
break on:
BRS1: A=main <0x001000ba> P=0xXX
BRA2: A=data2 <0x001002f0>, 0x100300 W=0x000000XX RW
P=0xXX
brk>LINK a 1=brs1
brk>B BRA2|LINKA
brk>B
Break on:
BRA2:
A=data2 <0x001002f0>, 0x100300 W=0x000000XX RW
P=0xXX
LINKA:
1=BRS1
brk>
40
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
BRA [# [A=address_or_range] [x=data/mask] [P=mask4]]
Sets or displays the hardware bus event detectors. If no arguments are specified, the BRA
command will display the current settings.
Each of the optional arguments is described in detail below.
• The # argument specifies the identification number (1-8) of the event detector. If you specify
an ID that is already being used, the previous setting will be overwritten. (If you specify
a range for the address field, you will not be able to use all of the event detectors.)
• A=address_or_range specifies an address or range for the event as follows: A=address
specifies a single address expression, A=start,end specifies an address range beginning at
start and ending at end, A=start, L length specifies an address range beginning at start
and extending for length bytes.
You cannot enter both a single address and a range. If you specify a range for the address
field, you will not be able to use all of the event detectors. If you do not enter an address
value, any address will be used.
• The x=data/mask option specifies the access size and data/mask values. The data comparator
detects reads and writes of specific values at the addresses. The size of the access (x) can
be can be specified as B (byte), H (halfword), W (word), or D (any size, default access).
You can use a symbolic constant to specify the data, but you cannot include a mask if you
do. If you do not enter a data size/value, a halfword access and a mask of all ones will be
assumed.
• The status option specifies the type of bus transaction to detect. Valid arguments for status
are: RW (read or write; this is the default), RO (read only), or WO (write only).
• P=mask4 specifies an external probe qualifier of 4-bit width. You can specify an additional
qualifier based on the external probe tips 1-4. The mask4 value is entered as a 4-bit hex or
binary value/mask.
There are eight bus event detectors, each consisting of an address/range, a data/mask, a status,
and an external probe comparator. The output of each of these comparators are ANDed together
to produce an event. If a starting and ending address range is specified, then two of the bus event
detectors will create the event (one for the start and one for the end).
Hex values are indicated by a 0x prefix, while binary input is indicated by an 0b prefix. To
specify a value with a mask, use X characters for the nibbles or bits you want to be ignored. For
example, D=0x245C will only detect a data access of 0x245C, while D=0x245X will detect any
data value in the range 0x2450-0x245F.
For an example of how to use this command, see “Additional Examples of 850eserv2 Target
Commands” on page 61.
Green Hills Software
41

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
BRS [# [A=address_or_range] [P=mask4]]
Sets or displays the hardware execution event detectors. If no arguments are specified, the BRS
command will display the current settings for all detectors. To display the current settings for
one detector, specify the identification number (#) without any other arguments.
Each of the optional arguments is described in detail below.
• The # argument specifies the identification number (1-14) of the execution event detector.
If you specify an ID that is already being used, the previous settings will be overwritten.
(If you specify a range for the address field, you will not be able to use all of the event
detectors.)
• A=address_or_range specifies an address or range for the event as follows: A=address
specifies a single address expression, A=start,end specifies an address range beginning at
start and ending at end, A=start, L length specifies an address range beginning at start
and extending for length bytes.
You cannot enter both a single address and a range. If you specify a range for the address
field, you will not be able to use all of the event detectors. If you do not enter an address
value, any address will be used.
• P=mask4 specifies an external probe qualifier of 4-bit width. You can specify an additional
qualifier based on the external probe tips 1-4. The mask4 value is entered as a 4 bit hex or
binary value/mask. Hex values are indicated by an 0x prefix, while binary input is indicated
by an 0b prefix.
There are 14 execution event detectors in the emulator, each consisting of an address and an
external probe comparator. The output of the two comparators are ANDed together to generate
an event. They will cause an event when the specified address or an address in a range is executed
and if the external probe pins match the P=mask4 specification. If you specify a range of
addresses, two of the available execution event detectors will be used, one for the start and one
for the end.
Example:
brk>BRS 1 A=0x2000 P=0x1
brk>BRS 2 A=main
brk>BRS
BRS1:
A=0x2000 P=0x1
BRS2:
A=main <0x001000ba> P=0xXX
brk>
42
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
CLOCK [ int | ext ]
Specifies which clock is used. The int argument specifies the internal clock of the ICE. The ext
argument specifies an external clock.
When this command is entered, the RESET signal at the CPU becomes active and internal
registers and the SFR are initialized.
If no argument is specified, the CLOCK command displays the current clock source.
COMBO [ E | D [N] ]
Changes or displays the COMBO break status, as described below. If no arguments are specified,
the COMBO command displays the current COMBO break status.
The COMBO E command enables COMBO mode, which allows interrupts to occur while the
program is halted. COMBO D disables the COMBO break (this is the default).
The N option can only be used if the D option is also set. N specifies that NMIs can be accepted.
If the emulator is in COMBO mode and a program breaks in an interrupt handler (ISR), only
the higher interrupt or NMI can be accepted and processed.
When you enable COMBO, avoid halting program execution at the ISR prologue. If you halt
at the ISR prologue, saving and/or restoring EZPC/EZPSW may cause the program to crash.
Example:
brk>COMBO
COMBO break is disabled
brk>COMBO E
brk>COMBO
COMBO break enabled
brk>
Green Hills Software
43

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
CPU [R=rom] [A=ram]
Changes or displays the CPU internal ROM and RAM sizes (in KB) for emulation. The R=rom
argument sets the internal ROM size and the A=ram argument sets the internal RAM size (see
below for appropriate values). If no arguments are specified, the CPU command displays the
current CPU settings.
Appropriate values for rom are 32, 64, 128, 256, 512, or 1024, depending on the contents of the
device file corresponding to the target.
Appropriate values for ram for the V850 ICE are 1, 2, 3, 4, 6, 8, 10, 12, 16, 20, 24, or 28,
depending on the contents of the device file corresponding to the target.
Appropriate values for ram for the V850E ICE are 1, 2, 3, 4, 6, 8, 10, 12, 16, 20, 24, 28, 36, 44,
52, or 60, depending on the contents of the device file corresponding to the target.
Example:
brk>CPU R=32 A=1
brk>CPU
ROM size=32K RAM size=1K
brk>
HELP
Displays command summary.
IEPORT0 [[R]|[ output0 | output1 ]]
Controls the internal ICE port port0, which generates a special signal in the Evachip. This port
is used in certain ICEs for customized CPUs.
If output0 is specified, the port0 port generates the signal 0. If output1 is specified, the port
generates the signal 1.
If R is also specified (with one of the other options), RESET is asserted first, port0 is set to the
designated value, and then RESET is de-asserted.
IEPORT1 [[R]|[ output0 | output1 ]]
Controls the internal ICE port port1, which generates a special signal in the Evachip. This port
is used in certain ICEs for customized CPUs.
If output0 is specified, the port1 port generates the signal 0. If output1 is specified, the port
generates the signal 1.
If R is also specified (with one of the other options), RESET is asserted first, port1 is set to the
designated value, and then RESET is de-asserted.
44
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
LINK [ A | B | C ] [ K | n=event_expression ...] [C=count]
Links events with a sequencer, where A, B, or C specifies the sequencer, n specifies the level
of enables or disables (see below), and C specifies a pass count for the output of the sequencer.
The K argument clears (kills) all settings.
If you enter the LINK command with only the link number or without any options, the current
settings of the link event(s) will be displayed.
You can link events together with one of three event sequencers (A, B, or C). Each sequencer
has 4 levels of enables and one level of disable, specified by n=event_expression as follows:
• 1=event_expression specifies a list of Enable4 events.
• 2=event_expression specifies a list of Enable3 events.
• 3=event_expression specifies a list of Enable2 events.
• 4=event_expression specifies a list of Enable1 events.
• D=event_expression specifies a list of disable events.
You can link any number of events to each enable level or to disable. To enter a list of events
for an input, put a pipe character ( | ) between the events.
When the events occur in the proper sequence, a link event is generated that may be tied to a
break or trace function. Enable4 will be used as the trigger condition for the PASS counter.
You do not have to specify all levels. Levels that are not specified are assumed to be enabled.
For example, if you specify Enable4 and Enable3 only, a link will be generated when the two
conditions are satisfied. Always begin the events setting from Enable4, Enable3, Enable2, and
Enable1.
If the link will be used as a sectional trace event, only the first three enables can be used as the
start condition. The end condition, specified with the TRACE command, will use the fourth
enable condition. You can clear the current settings for the link by using the K argument.
The C option specifies a pass count for the output of the sequencer and should be specified with
one or more n=event_expression lists.
For an example of how to use this command, see “Additional Examples of 850eserv2 Target
Commands” on page 61.
Green Hills Software
45

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
LOG [ filename | E | D ]
Opens or closes a log file. The filename argument specifies a new log filename and begins
logging. E enables output to the log file. D disables output to the log file. If no arguments are
specified, the LOG command displays the current log status.
You can use the LOG command to open a log file to record all output from the command line
window. The filename can include a drive:path specification. If you do not include an filename
extension, .TXT is assumed. To specify a filename without an extension, enter the name, followed
by a period (that is, FILENAME.). Output logging begins as soon as you enter the LOG
command with a filename.
If there is a log file open, you must disable that log file before opening a new one. If the log
filename specified already exists, you will be asked whether to append to it or to delete the file
before beginning to log. To append to the file, enter A. To delete the current file contents and
start new logging, enter D. The LOG command can be aborted at this point by entering a period
(.).
You can temporarily disable log file output with the D option. To resume log file output, use
the E option.
46
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
M [ B | H | W ] [C] address [=value] [L=length]
Displays or allows changes to memory beginning at address.
The memory contents can be displayed and edited in bytes (B), halfwords (H), or words (W).
The default data size is bytes. If you use B, H, or W to specify a size, the size setting will be
saved in memory and will not need to be entered again.
If you specify C, you will be prompted with the current value of the memory. You can enter a
new value or accept the current value. The program will then prompt with the next memory
location. To terminate input, enter END or a period (.). (The length parameter is not valid when
C is specified.)
You can also change memory contents by using the =value argument to provide data. Interactive
mode will be disabled and only the specified memory location will be modified.
The L= option allows you to specify how many bytes to display. The default number of bytes
to display is 4 rows of 16 bytes (irrespective of the size setting).
If an address is not specified, the last memory display address +1 is used as the start address.
Example:
brk>m c 0x100
0x00000100: 78
0x20
0x00000101: 56.
brk>m c 0x100=0x12345678
brk>m 0x100
0x00000100: 12345678 6C6C6568 000A216F 259F853F
brk>m b 0x100
0x00000100: 78 56 34 12 68 65 6C 6C 6F 21 0A 00 3F 85 9F 25
brk>
Green Hills Software
47

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
MAP [ K | (W=|R=|U=|G=start,end|start, L length) ]
Sets the emulator memory configuration, as described below. If you do not specify any arguments,
the MAP command displays the current memory map.
To direct the emulator to read or write a range of memory, use one of the following options:
W specifies emulator read/write memory.
R specifies emulator read only memory.
U specifies user (target) memory.
G specifies a guard area.
Specify address ranges using the format start, end (an address range beginning at start and
ending at end) or start, L length (an address range beginning at start and extending for length
bytes). Addresses specified for this command must be aligned to a 1 MB boundary.
The K option cancels (kills) all memory ranges.
Target memory is provided on your development board. The emulator will drive the external
bus lines to access it through the pod. For all other types of memory, the emulator will not drive
the external lines.
For all other memory mapping, R (read only) and W (read/write) specify where in the address
space the emulator will provide memory blocks. For blocks specified with R, the emulator will
provide an illegal access break if an attempt is made to write to it.
For the V850 ICE, there are only two contiguous 1 MB blocks of memory that the emulator can
provide. One block is fixed at 0x0 and the other is located on any 1 MB boundary. The fixed
block can be used only when the ROM-less mode is specified with the MODE command (a
total of 2 MB emulation memory is available). When the internal ROM is used, the fixed 1 MB
block is not available (a total of 1 MB emulation memory is available). In this case, you cannot,
for example, set a RAM segment at 0x100000 and another at 0x200000, since both need to
be mapped by the second memory block.
For the V850E ICE, there are two contiguous 1 MB memory blocks that the emulator can
provide. Each block has sixteen 64 KB blocks that can be specified as W, R, U, or G. Mapping
is allowed for these blocks anywhere between 0x0 and 0x3ffffff.
Specifying R=0xfff000,0xffffff is not allowed because this address range maps to the I/O
area, which is readable and writable.
Example:
brk> map w=0x000000,0x0fffff cs0
brk> map r=0x200000,0x2fffff cs1
brk> map tr2=0x100000,0x1fffff
48
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
MODE [ romless16 | romless8 | single16 | single | target ]
Specifies the CPU mode using one of the following arguments:
romless16 specifies ROM-less mode with 16-bit external bus.
romless8 specifies ROM-less mode with 8-bit external bus.
single16 specifies single-chip mode with 16-bit external bus.
single specifies single-chip mode with 8-bit external bus.
target selects a mode by pins MD2 to MD0 on the target
If no argument is specified, the MODE command displays the current CPU mode.
NOHALT [ E | D ]
Controls whether or not to issue a reset when exiting MULTI.
The D option causes a reset to be issued to the ICE when exiting MULTI. This is the default.
The E option specifies that no reset be issued to the ICE when exiting MULTI.
If no arguments are specified, the NOHALT command displays the current settings.
Example:
brk> NOHALT
Disable IE to continue session
brk> NOHALT e
Enable IE to continue execution
brk>
NOLOAD
Toggles suppression of data downloading to the ICE. When NOLOAD is enabled, downloading
is suppressed, even if a LOAD command is entered from MULTI. To disable downloading
suppression, issue the NOLOAD command again.
Green Hills Software
49

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
PIN [ K | [W] [R] [N] [H] [S] [E] ]
PINMASK [ K | [W] [R] [N] [H] [S] [E] ]
Sets masked processor pins using the following arguments:
W disables the WAIT input pin.
R disables the RESET input pin.
N disables the NMI input pin.
H disables the HLDRQ input pin.
S disables the HWSTOP output pin.
E disables the EMWAIT pin (valid only for V850E).
You can use the above arguments in combination to set multiple processor pin masks with one
PINMASK command. Each argument should be delimited by a space.
Any new PINMASK settings override all previous settings.
PINMASK K unmasks (kills) all masks.
If no arguments are specified, the PINMASK command displays the current masked pin settings.
Example:
brk>PINMASK w r
brk>PINMASK
Pin Cond
mask=WAIT RESET
brk>
POWER [ on | off ]
Connects or disconnects a target board from the ICE without powering down the system. After
reconnecting the target board to the ICE, you must reestablish MULTI-to-ICE connections by
executing your setup script (.mbs) file again. (For more information about setup scripts, see the
documentation about configuring your target hardware in the MULTI: Debugging book.)
If no arguments are specified, the current POWER setting is displayed.
Example:
brk> POWER OFF
brk> POWER
Power is OFF
brk>
50
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
PROFILE data | done
PROFILE data gathers and accumulates information from the V850/V850 ICE trace buffer to
the 850eserv2 internal profile data buffers.
PROFILE done writes the data to an output file readable by MULTI and clears the 850eserv2
internal profile data buffers. Therefore, after each PROFILE done command, you must reload
the target program and repeat the process (that, you must. reissue the PROFILE data and
PROFILE done commands) if you want to gather more profiling data.
To use the PROFILE command, you must open the MULTI Profile window before you download
your target program. For further information, see the documentation about recording and viewing
profiling data in the MULTI: Debugging book.
REG [regname [=value]]
Displays or changes register values. Without any parameters, this command will display the
contents of all the registers along with the current program counter, program status word (PSW),
and a disassembly of the next instruction to execute. If the processor is running and the program
counter is in external memory, then the disassembly will not be performed to avoid memory
conflicts.
The PSW is displayed as characters, either uppercase or lowercase, corresponding to the bits
of the register. If the character is uppercase, the bit is set; if lowercase, the bit is clear.
If a register name is specified with the REG command, the current contents of the register will
be displayed and you will be prompted to alter the value. Hit Enter if you do not want to change
the value of the register. You can also use the =value argument to set a new value without being
prompted.
For an example of how to use this command, see “Additional Examples of 850eserv2 Target
Commands” on page 61.
Green Hills Software
51

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
RMEM [K] [L=length] [T=interval]
Displays the contents of real-time RAM periodically while a program is running, as specified
by the following arguments:
L=length specifies the length of memory in bytes to be displayed. The value of length must be
greater than or equal to 1 and less than or equal to 1024. The default is 512 bytes.
T=interval specifies an update interval in seconds. The default is three seconds.
K removes all existing settings.
If no arguments are specified, the RMEM command displays the current settings.
The base address of real-time RAM must be specified with the RRAMBASE command. before
you can use the RMEM command.
When a program starts to execute after the RMEM command has been issued, the contents of
the real-time RAM area are displayed in the target pane and are updated at the specified interval.
When program execution breaks, updating stops. If you resume program execution, updating
restarts unless RMEM K is entered.
If you specify a short period with the T= option, the display of real-time RAM contents may
be updated too frequently. You can stop updating with the K option.
Example:
brk>rrambase 0x3ffe000
brk>rmem l=4 t=5
brk>
run>
0x3FFE000: 6F 80 00 04
0x3FFE000: 97 80 00 04
0x3FFE000: CB 80 00 04
brk>
RRAMBASE [address]
Sets address as the base address of the real-time RAM. If address is not specified, displays the
current setting.
Because the size of the real-time RAM area is fixed to 1 KB, 1 KB of real-time RAM is allocated
at this address. The address should be on a 1 KB boundary and should not be in internal ROM.
RST [ stop | run ]
Resets the CPU and/or emulation hardware.
If stop is specified (default option): After the reset, stops the CPU.
If run is specified: After the reset, runs the CPU freely.
52
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
SA
SHOWALL
Displays the current settings of programmed events, break settings, link settings, trace conditions,
CPU settings, COMBO settings, NOHALT settings, and memory verify setting.
Example:
brk>showall
BRS1: A=0x00100082 P=0xXX
BRS2: A=0x001000B0 P=0xXX
BRA:
<None>
Break on:
Link event:
<None>
Trace start:
BRS1: A=0x00100082 P=0xXX
Trace end (delay = <none>)
BRS2: A=0x001000B0 P=0xXX
ROM size=32 RAM size=2
COMBO break is disabled
NoHalt:
Disabled
Verify:
On
brk>
SFR [name [=newvalue]]
Displays or changes the SFR values.
If name is specified: Displays the SFR specified by name or, if =newvalue is also specified,
changes the value of the SFR name to newvalue.
If no arguments are specified: Displays all SFRs.
The value of name comes from the V850/V850E assembly language specification.
If you enter only the name of an SFR, its value is displayed and you are prompted to enter a
new value. Hit Enter if you do not want to change the SFR value.
For an example of how to use this command, see “Additional Examples of 850eserv2 Target
Commands” on page 61.
Green Hills Software
53

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
T [ A | x=event_expression. . . ] [D=delay] [K]
TRACE [ A | x=event_expression. . . ] [D=delay] [K]
Specifies under what conditions tracing occurs. If no arguments are specified, the T command
displays the current trace settings. Setting the K option clears (kills) all trace settings.
By default, the tracer will trace all frame transactions. You may reset the tracer to this default
mode by entering TRACE A. You can also set the tracer to trace only at specified places in
your code. You can start and stop the tracer with the S (start) and E (stop) arguments, enable
or disable the tracer with the Q (qualify) argument, and/or halt the tracer after the specified
delay time with the T (trigger) argument as follows:
• S=event_expression specifies the event(s) and/or link(s) that start the tracer.
• E=event_expression specifies the event(s) and/or link(s) that stop (end) the tracer.
• Q=event_expression specifies the event(s) and/or link(s) that enable or disable the tracer.
• T=event_expression specifies the trigger event(s) and/or link(s) that halt the tracer after a
delay.
• D=delay specifies the number of frames to capture after the trigger. (A delay is also applied
to events specified by E.)
If you use S and E, the T command automatically creates the LINK condition to perform section
trace.
The value of event_expression can be one or more event and/or link mnemonic(s) separated by
a pipe character ( | ). For example, BRA1|LINKA|BRS2.
You can assign any or all of the events and/or the link specifications to the T, S, and E inputs.
The start and stop inputs are edge-triggered, which means that once the event(s) occur, tracing
will start or stop.
Q inputs may only be tied to events. The qualifying input is level-triggered, which means that
tracing only occurs if the event(s) are true; once the event(s) are no longer true, tracing will
cease. The start/stop and qualify conditions are ANDed together.
The T (trigger) option programs the tracer to stop after an event or link occurs. You can delay
the halting of the tracer by specifying D=delay. This specifies how long after a trigger event
the tracer will halt, where delay is the number of frames you want to record after the trigger.
Once the tracer halts, the system mode switches from TRACE to RUN, at which point you can
view the contents of the trace buffer, change trace settings, and issue other commands.
For an example of how to use this command, see “Additional Examples of 850eserv2 Target
Commands” on page 61.
54
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
TD [ I | F ] [ ($|S|E|T) rel frame ] [L=#frames]
TDISPLAY [ I | F ] [ ($|S|E|T) rel frame ] [L=#frames]
Displays the trace buffer. If no arguments are specified, TD displays frames from the current
frame. Use the optional parameters described below to set the display mode parameters, where:
I specifies Instruction mode.
F specifies Data Access (or Frame) mode.
$ sets the starting frame of the display relative to the current frame.
S sets the starting frame of the display relative to the start of the buffer.
E sets the starting frame of the display relative to the end of the buffer.
T sets the starting frame of the display relative to the trigger point.
rel frame specifies the number of frames (+/-) relative to the starting frame
L=#frames sets the number of frames (max. 32768) to display.
There are two trace buffer display modes: Instruction mode (I) and Data Access (F) mode. In
Instruction mode, a disassembly of executed instructions is displayed and no stall cycles are
displayed. In Data Access mode, program data reads/writes are displayed. The default mode is
Instruction mode. If no display mode is specified, the last mode specified is used.
When a new trace is made, the current frame is reset to the trigger point or to the end of the
trace buffer if no trigger was specified. Each time a portion of the buffer is displayed, the current
frame is updated to the end of the displayed data. If no starting frame number is specified, the
current frame is used.
The default number of displayed frames is 20. You can change the default number with the L
option. If you do not specify a number of frames, the last setting will be used. When displaying
in Instruction mode, there will be fewer lines of disassembled code displayed than the number
of frames, since instruction execution may span more than one frame for data access. Trace data
can be displayed while a program is running, but you must first stop the tracer.
With the V850E ICE, two instructions can be displayed in one frame because the V850E can
execute two instructions in one clock.
By default, the Time field of the trace display shows the number of CPU clocks that have elapsed
from the previous frame to the current frame. If you specify TMODE TS=T, actual time is
displayed instead of the number of clocks. If the elapsed time exceeds 24 hours, 24:00:00 is
displayed. To get the proper time value, set the clock frequency and scalar value with the
TIMEBASE command.
For an explanation of the codes that are used in the Status field of the trace display, see “Trace
Display Status Codes” on page 66. For an example trace display, see the TD example in
“Additional Examples of 850eserv2 Target Commands” on page 61.
Green Hills Software
55

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
TF [I= [T][O] | . | * ] [F= [T][E][C][O][A][D][S][M] | . | * ]
TFILTER [I= [T][O] | . | * ] [F= [T][E][C][O][A][D][S][M] | . | * ]
Specifies or displays what is filtered out before display in the trace buffer. This command affects
only the trace display and does not affect the trace buffer. If no options are specified, TF displays
the current filter settings.
Use the I or F options to specify which fields and bus status types are displayed, where the
letters following the equal sign (=) indicate the fields and status types, as described below. Some
fields are permanent and cannot be removed. Any previous setting of the I= or F= argument
will be overwritten.
For Instruction mode, there are two possible fields that can be controlled with the I= argument.
The T option specifies time-tag and the O option specifies opcode. The frame number, PC
address, and mnemonic fields are permanent. To enable all of the Instruction mode fields, use
I=*. To disable all but the permanent fields, use I=..
For Data Access (or Frame) mode, there are eight possible fields that can be controlled with the
F= command. The T option specifies time-tag, the E command specifies external probe data,
the C option specifies program counter information, the O option specifies opcode, the A option
specifies address, the D option specifies data, the S command specifies status, and the M
command specifies mnemonic. The frame number field is permanent. To enable all of the Data
Access mode fields, use F=*. To disable all but the permanent fields, use F=..
For an example of how to use this command, see “Additional Examples of 850eserv2 Target
Commands” on page 61.
56
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
TIMEBASE [C=clock] [R=rate]
Sets the frequency of the CPU clock and the scalar value of the trace time-tag counter. If no
arguments are specified, the TIMER command displays the current settings.
The C= command specifies the frequency of CPU clock in MHz. For example, if the clock
frequency of your CPU is 25 MHz, you can specify this with C=25.
The R= command specifies the scalar value of the trace time-tag counter, which counts the
number of clocks for each trace frame. Because this counter is 16-bits long, the range of the
counter is 0 to 65535.
If R=X1 is specified, 1 CPU clock increases the counter by 1. If R=X2 is specified, 2 CPU
clocks increase the counter by 1. If R=X1K is specified, 1024 CPU clocks increase the counter
by 1. In short, the larger the value of rate, the longer timer value the counter can hold. The
counter holds at least 1 any time trace data is displayed, which can cause a loss of precision.
The following mnemonics can usually be specified as arguments to R=: X1, X2, X4, X8, X16,
X32, X64, X128, X256, X512, X1K, X2K, X4K, X8K, X16K, X32K, X64K, X128K, X256K, X512K,
X1M, X2M, X4M, X8M, X16M, X32M, X64M, X128M, X256M, X512M, X1G, and X2G, where K
corresponds to 1024, M corresponds to 1024*1024, and G corresponds to 1024*1024*1024.
If you are using a V850 ICE, however, not all of these mnemonics are valid. Specifically, you
cannot use the following values: X2K, X8K, X32K, X128K, X512K, X2M, X4M, X8M, X16M, X32M,
X64M, X128M, X256M, X512M, X1G, and X2G.
By default, the CPU clock frequency is set to 25 MHz and the scalar value is set to X1.
Example:
brk>timebase c=33.33 r=x4
brk>timebase
CPU Clock=33.33MHz Timetag Rate=X4
brk>
TIMER
Displays the current timer value as a number of clocks.
This command takes no arguments. The timer is reset every time the target program execution
is resumed by a call to ex_run(). When the target program breaks, the timer stops and holds
the number of clocks elapsed during execution.
Green Hills Software
57

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
TMODE [M=F|N] [TS=C|T]
Specifies the tracing mode. The M= argument specifies the control mode for the trace memory
and the TS= argument specifies the display format of the TIME field in TDISPLAY, as described
below. If no arguments are specified, TMODE displays the current trace mode settings.
Specifying M=N sets trace memory to nonstop mode, which is the default mode. In nonstop
mode, the tracer overwrites old trace data if the trace buffer becomes full and continues to trace
until a TSTOP command is entered. Specifying M=F, sets trace memory to full stop mode. In
full stop mode, the tracer stops tracing when the trace buffer becomes full.
If TS=C is specified, counts of the time-tag counter are displayed in the TIME field of
TDISPLAY. If TS=T is specified, the time-tag is displayed in real-time units of microseconds,
milliseconds, seconds or minutes.
Example
brk>tmode m=f
brk>
brk>tmode
Trace Mode:
Trace Memory=Full stop
Time Stamp=Count
brk>
TRUN
Restarts the trace analyzer if your program is running but the trace analyzer is stopped.
TS
TSTOP
Halts the trace analyzer but keeps the CPU Evachip running. The emulator mode will switch
from TRACE to RUN mode. Once in RUN mode, you can change the events, links, break, and
trace settings, or display the contents of the trace buffer. Use TRUN to restart the analyzer.
58
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
TSEARCH [frame] [A=address_or_range] [x=data/mask] [C=status] [P=mask4]
Searches the trace buffer for a particular type of frame information and displays, in Frame mode,
the frames that match the specified conditions. The search conditions consist of an address range,
a data/mask value, a bus status type, and an external probe value, as described below. You can
enter a subset of these conditions, in which case the other conditions will be ignored. If you do
not specify any conditions, the last specified set of conditions will be used. The arguments for
setting the conditions are described below.
• The frame argument specifies the starting frame for the search. It is the offset from the top
(the oldest frame) of the trace buffer, not the frame number that is displayed with a
TDISPLAY command. That is, frame number 0 specifies the oldest frame. If a frame
number is not specified, the search begins from the frame next to the current trace pointer,
not from the last position of the previous search. If a frame that matches the specified
condition(s) is found, the current trace pointer is moved to it. The trace contents are
displayed in both Instruction and Data Access mode and the search is stopped. If no frame
matching the specified condition(s) is found, the trace pointer stays at the starting frame
of the search.
• A=address_or_range specifies an address or range to search for, as follows: A=address
specifies a single address expression, A=start,end specifies an address range beginning at
start and ending at end, A=start, L length specifies an address range beginning at start
and extending for length bytes.
• The x=data/mask option specifies the access size and data/mask values. The size of the
access (x) can be can be B (byte), H (halfword), W (word), or D (any size, the default).
• The C=status option specifies the type of bus transaction to search for. Valid arguments
for status are: RW (read or write; this is the default), RO (read only), or WO (write only).
• P=mask4 specifies an external probe qualifier of 4-bit width. The mask4 value is entered
as a 4-bit hex or binary value/mask. Hex values are indicated by a 0x prefix, while binary
input is indicated by a 0b prefix. To specify a value with a mask, use X characters for the
nibbles or bits you want to be ignored.
For an example of how to use this command, see “Additional Examples of 850eserv2 Target
Commands” on page 61.
Green Hills Software
59

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
U [ start | start, end | start, L lines ]
Disassembles object code beginning at the specified address.
If start, end are specified: Disassembles object code in the range beginning at start and ending
at end.
If start, L lines: Disassembles object code in the range beginning at start and extending for lines
lines.
If no address is specified: Disassembles code beginning where the last U command left off.
If no range is specified: Disassembly continues for 11 lines.
Example:
brk>U main
main:
0x1000ba:
5cla add
-4, sp
0x1000bc:
63ff0100 st.w 1p, 0[sp]
0x1000c0:
2096e803 movea 0x3e8, zero, r18
0x1000c4:
64974180 st.w r18, -0x7fc0[gp]
0x1000c8:
40360200 movhi 0x2, zero, r6
0x1000cc:
2636a086 movea
-0x7960, r6, r6
0x1000d0:
bfffbcff jarl
0x10008c, 1p
0x1000d4:
23ff0100 ld.w 0[sp], 1p
0x1000d8:
441a add 4, sp
0x1000da:
7f00 jmp [1p]
0x1000dc:
0969 or r9, r13
brk>U main, L 5
main:
0x1000ba:
5cla add
-4, sp
0x1000bc:
63ff0100 st.w
lp, 0[sp]
0x1000c0:
2096e803 movea 0x3e8, zero, r18
0x1000c4:
64974180 st.w r18, -0x7fc0[gp]
0x1000c8:
40360200 movhi 0x2, zero, r6
brk>
VERIFY [ on | off ]
Sets or clears the memory write verify flag, which turns on or off memory verify.
If on is specified, all subsequent memory writes are verified.
If off is specified, all subsequent writes are not verified.
If no parameters are set, the VERIFY command displays the current setting.
Example:
brk> VERIFY off
brk> VERIFY
VERIFY IS OFF
brk>
60
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
Additional Examples of 850eserv2 Target Commands
This section contains additional example of the target commands for 850eserv2.
For examples of other commands and for detailed descriptions of all the 850eserv2
commands and their parameters, see “Target Command Descriptions” on page 39.
For a brief summary of all of the commands available, see “Target Commands for
Renesas V850/V850E ICE (850eserv2) Connections” on page 36.
Example 3.6. Using the A Command
brk>a 0x100082
main:
0x100082: 1a5c
add
-4, sp
>add 8,sp
481a
0x100084: ff630001
st.w
lp, 0[sp]
>nop
0000
0x100086: 0001
mov
r1, zero
>nop
0000
0x100088: 36400010
movhi
0x10, zero, r6
>end
brk>a
0x100088: 36400010
movhi
0x10, zero, r6
>end
brk>a main
main:
0x100082: 1a48
add
8, sp
>movhi hi(foo),zero,r6
40361000
0x100086: 0000
nop
>.
brk>a
0x100086: 0000
nop
>st.w r18,-0x8000[zero]
60970180
0x10008A: 0010
mov
r16, zero
>.
brk>
Green Hills Software
61

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
Example 3.7. The BRA Command
brk>BRA
Bra:
<None>
brk>BRA 1 H=0x00XX P=0x7
brk>BRA 2 A=data1, 0x1000de
brk>BRA
BRA1: H=0x00XX RW P=0x7
BRA2: A=data1 <0x001000ba>,0x1000de D=0xXXXXXXXX RW P=0xXX
brk>
Example 3.8. The LINK Command
brk>BRS 1 a=main
brk>BRA 2 a=data1
brk>BRS 3 a=data2
brk>BRS 4 a=data3
brk>LINK a 1=brs3|brs4 2=bra2 3=brs1
brk>LINK
LINKA:
1=BRS3, BRS4 2=BRA2 3=BRS1
PASS COUNT=1
AUTO RESET SELECTED
brk>LINK k
brk>LINK
Link:
<None>
brk>
Example 3.9. The REG Command
brk>reg
r0: 0x00000000
r8: 0x00000000
r16: 0x00000000
r24: 0x00000000
r1: 0x0010A8E0
r9: 0x00000000
r17: 0x00000000
r25: 0x00000000
r2: 0x00000000
r10: 0x00000000
r18: 0x00000009
r26: 0x00000100
r3: 0x00120FD4
r11: 0x00000002
r19: 0xFFFFFFFF
r27: 0x00000102
r4: 0x0010A8E0
r12: 0x00000001
r20: 0x000000FF
r28: 0x00120FF8
r5: 0x00010000
r13: 0xFFFFC000
r21: 0x0000FFFF
r29: 0x00000000
r6: 0x00000100
r14: 0xFFFFFFFF
r22: 0x00000000
r30: 0x00103F28
r7: 0x00000102
r15: 0x00000000
r23: 0x00000000
r31: 0x00101F86
pc: 0x00100088
eipc: 0x00100000
fepc: 0x00100000
ecr: 0x00000000
psw: 0x00000028 eipsw: 0x00000061 fepsw: 0x000000FF
psw:
neItCosz eipsw:
NEItcosZ fepsw:
NEITCOSZ
0x100088: 36400010
movhi
0x10, zero, r6
brk>
62
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
Example 3.10. The SFR Command
brk>sfr
p0:RW
p1:RW
p2:RW
p3:RW
p4:RW
p5:RW
p6:RW
0x0B
0xDE
0x01
0xAC
0x18
0x20
0x10
p9:RW
p10:RW
pm0:RW
pm1:RW
pm2:RW
pm3:RW
pm4:RW
0xDD
0xFB
0xFF
0xFF
0xFF
0xFF
0xFF
pm5:RW
pm6:RW
pm9:RW
pm10:RW
pmc0:RW
pmc2:RW
pmc3:RW
0xFF
0xFF
0xFF
0xFF
0x00
0x01
0x00
mm:RW
pmc10:RW
dwc:RW
bcc:RW
psc:RW
sys:RW
unlock:RW
0xB7
0x00
0xFFFF
0xAAAA
0x00
0x00
0x00
brg0:RW
bprm0:RW
csim0:RW
csot0:RW
sio0:RW
brg1:RW
bprm1:RW
0x00
0x00
0x00
0x00
0x00
0x00
0x00
csim1:RW
csot1:RW
sio1:RW
csim2:RW
csot2:RW
sio2:RW
asim00:RW
0x00
0x00
0x44
0x00
0x00
0x40
0x80
asim01:RW
asis0:R
ove0:RW
fe0:RW
pe0:RW
sot0:RW
rxb0:R
0x00
0x00
0x00
0x00
0x00
0x00
0x01FF
rxb0l:R
txs0:W
txs0l:W
ovic1:RW
p1ic0:RW
p1ic1:RW
p1ic2:RW
0xFF
0x80CC
0xCE
0x47
0x47
0x47
0x47
p1ic3:RW
cmic4:RW
csic0:RW
seic0:RW
sric0:RW
stic0:RW
p0ic0:RW
0x47
0x47
0x47
0x47
0x47
0x47
0x47
p0ic1:RW
p0ic2:RW
p0ic3:RW
csic1:RW
csic2:RW
ispr:R
prcmd:W
0x47
0x47
0x47
0x47
0x47
0x00
0x00
intm0:RW
intm1:RW
intm2:RW
tovs:RW
tum1:RW
tmc1:RW
toc1:RW
0x00
0x00
0x00
0x00
0x0000
0x00
0x00
tm1:R
cc10:RW
cc11:RW
cc12:RW
cc13:RW
tmc4:RW
tm4:R
0x0000
0xFFFF
0xFFFF
0xFFFF
0xFFFF
0x00
0x0000
cm4:RW
0x8000
brk>
Example 3.11. The T (or TRACE) Command
brk>trace a
brk>trace
Trace ALL
brk>trace k
Trace events are cleared.
brk>brs 1 a=main
brk>brs 2 a=exit
brk>trace s=brs1 e=brs2
brk>trace
Trace start:
BRS1: A=0x00100082 P=0xXX
Trace end (delay = <none>)
BRS2: A=0x001000B0 P=0xXX
brk>
Green Hills Software
63

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
Example 3.12. The TD (or TDISPLAY) Command
brk>tdisplay i s0 l=20
| FRAME
| TIME
|
ACCESS |
PC
|
OPCODE
|
MNEMONIC
------------------------------------------------------------------------
|
0
|
3 |
| 0x00100000 | e200
| mov
0, r28
|
1
|
14 |
| 0x00100002 | ff800004
| jarl
0x100006, lp
|
2
|
28 |
| 0x00100006 | e81f
| mov
lp, r29
|
3
|
12 |
| 0x00100008 | 4808
| mov
r8, r9
|
4
|
0 |
| 0x0010000A | 4007
| mov
r7, r8
|
5
|
12 |
| 0x0010000C | 3806
| mov
r6, r7
|
6
|
13 |
| 0x0010000E | 0261
| cmp
1, zero
|
7
|
1 |
| 0x00100010 | 5200
| mov
0, r10
|
8
|
0 |
| 0x00100012 | 36200014
| movea
0x14, zero, r6
|
9
|
10 |
| 0x00100016 | ff8027e4
| jarl
0x1027fa, lp
|
10
|
2 |
| 0x001027FC | 0000
| nop
|
11
|
12 |
| 0x001027FE | 007f
| jmp
[lp]
|
12
|
27 |
| 0x0010001A | 0df9
| bnc
0x100038
|
13
|
41 |
| 0x00100038 | 26044000
| addi
0x4000, gp, gp
|
14
|
13 |
| 0x0010003C | 26044000
| addi
0x4000, gp, gp
|
15
|
13 |
| 0x00100040 | 2e054000
| addi
0x4000, tp, tp
|
16
|
13 |
| 0x00100044 | 2e054000
| addi
0x4000, tp, tp
|
17
|
13 |
| 0x00100048 | 0e400010
| movhi
0x10, zero, r1
|
18
|
0 |
| 0x0010004C | 0e013f28
| addi
0x3f28, r1, r1
|
19
|
12 |
| 0x00100050 | 05a2
| be
0x100054
brk>tfilter f=tcoms
brk>td f s0 l=5
| FRAME| TIME |
PC
|
OPCODE
|
MNEMONIC
|
EXT
| STATUS
---------------------------------------------------------------------------------
|
0 |
3 | 0x00100000 | e200
| mov
0, r28
| 0x0000 | 32b
|
1 |
14 | 0x00100002 | ff800004
| jarl
0x100006, lp | 0x0000 | 32b
|
2 |
28 | 0x00100006 | e81f
| mov
lp, r29
| 0x0000 | 32b
|
3 |
12 | 0x00100008 | 4808
| mov
r8, r9
| 0x0000 | 32b
|
4 |
0 | 0x0010000A | 4007
| mov
r7, r8
| 0x0000 | 32b
brk>td i e-5
| FRAME| TIME |
ACCESS
|
PC
| OPCODE
|
MNEMONIC
-----------------------------------------------------------------------------------
|
1160|
1 |
| 0x00101F7E | 381b
| mov
r27, r7
|
1161|
0 |
| 0x00101F80 | 401d
| mov
r29, r8
|
1162|
10 |
| 0x00101F82 | ffbfe100 | jarl
0x100082, lp
|
1163|
41 |
| 0x00100082 | 1a5c
| add
-4, sp
|
1164|
12 | WD
0x00120FD4: 0x00101F86 | 0x00100084 | ff630001 | st.w
lp, 0[sp]
brk>
For an explanation of the codes are used in the Status field of the trace display, see
“Trace Display Status Codes” on page 66.
Example 3.13. The TF (or TFILTER) Command
brk>tfilter i=o
brk>tfilter
Trace Filter:
Instruction mode:
Frame:
Permanent
64
MULTI: Configuring Connections for V850 and RH850 Targets

---

Target Command Descriptions
Time:
Disabled
PC:
Permanent
Opcode:
Enabled
Mnemonic:
Permanent
Frame mode:
Frame:
Permanent
Time:
Enabled
PC:
Enabled
Opcode:
Enabled
Address:
Enabled
Data:
Enabled
Mnemonic:
Enabled
Status:
Enabled
brk>td i s0 l=5
|
ACCESS
|
PC
|
OPCODE
|
MNEMONIC
--------------------------------------------------------------
|
| 0x00100000 | e200
| mov
0, r28
|
| 0x00100002 | ff800004
| jarl
0x100006, lp
|
| 0x00100006 | e81f
| mov
lp, r29
|
| 0x00100008 | 4808
| mov
r8, r9
|
| 0x0010000A | 4007
| mov
r7, r8
brk>tfilter f=ca
brk>td f s0 l=5
| FRAME
|
PC
|
ADDRESS
|
EXT
------------------------------------------------
|
0 | 0x00100000 |
| 0x0000
|
1 | 0x00100002 |
| 0x0000
|
2 | 0x00100006 |
| 0x0000
|
3 | 0x00100008 |
| 0x0000
|
4 | 0x0010000A |
| 0x0000
brk>tf f=m
brk>td f s0 l=5
| FRAME
|
MNEMONIC
|
EXT
-------------------------------------------
|
0 | mov
0, r28
| 0x0000
|
1 | jarl
0x100006, lp
| 0x0000
|
2 | mov
lp, r29
| 0x0000
|
3 | mov
r8, r9
| 0x0000
|
4 | mov
r7, r8
| 0x0000
brk>tf f=ms
brk>td f s0 l=5
| FRAME
|
MNEMONIC
|
EXT
|
STATUS
-------------------------------------------------------
|
0 | mov
0, r28
| 0x0000 | 32b
|
1 | jarl
0x100006, lp
| 0x0000 | 32b
|
2 | mov
lp, r29
| 0x0000 | 32b
|
3 | mov
r8, r9
| 0x0000 | 32b
|
4 | mov
r7, r8
| 0x0000 | 32b
brk>
Example 3.14. The TSEARCH Command
brk>tf f=coadm
brk>tsearch 1100 a=0x120000,0x130000 c=rw
| FRAME
|
PC
|
OPCODE
|
ADDRESS
|
DATA
|
MNEMONIC
Green Hills Software
65

---

Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
-----------------------------------------------------------------------------------
|
1103 |
|
| RD 0x00120F9C
|0x00100462 |
|
1105 | 0x00100462 | e7230001 | RD 0x00120FA0
|0x00120FC8 | ld.w
0[sp], r28
|
1108 |
|
| RD 0x00120FA4
|0x001003AC |
|
1117 | 0x0010065C | ff630005 | WD 0x00120FA4
|0x001003BC | st.w
lp, 4[sp]
|
1118 | 0x00100660 | e7630001 | WD 0x00120FA0
|0x00120FC8 | st.w
r28, 0[sp]
|
1145 | 0x00100176 | ff630005 | WD 0x00120FA4
|0x0010042C | st.w
lp, 4[sp]
|
1146 | 0x0010017A | ef630001 | WD 0x00120FA0
|0x00120FD8 | st.w
r29, 0[sp]
brk>tsearch 1100 a=0x120000,0x130000 c=r
| FRAME
|
PC
|
OPCODE
|
ADDRESS
|
DATA
|
MNEMONIC
-----------------------------------------------------------------------------------
|
1103 |
|
| RD 0x00120F9C
|0x00100462 |
|
1105 | 0x00100462 | e7230001 | RD 0x00120FA0
|0x00120FC8 | ld.w
0[sp], r28
|
1108 |
|
| RD 0x00120FA4
|0x001003AC |
brk>
Trace Display Status Codes
The following codes are used in the Status field of the TD trace display:
16b
Bus access with 16-bit
32b
Bus access with 32-bit
cht
Cache hit
dly
Delay processing
int
Acknowledge interrupt
reti
Branch by reti instruction
sfm
Starting or ending frame of trace
66
MULTI: Configuring Connections for V850 and RH850 Targets

---

Chapter 4
RTE (rteserv2) Connections
Contents
Supported Targets for RTE (rteserv2) Connections . . . . . . . . . . . . . . . . . . . . . . . 68
Installing Your RTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Connecting to a RTE Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Commands for RTE (rteserv2) Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

---

Chapter 4. RTE (rteserv2) Connections
This chapter supplements the general target connection information contained in
Chapter 2, “Setting Up Your Target Hardware” of this book and the documentation
about connecting to your target in the MULTI: Debugging book with specific
information for RTE connections.
Supported Targets for RTE (rteserv2) Connections
RTE stands for Real-Time Evaluator and refers to a group of hardware and software
debugging interfaces available from Midas Labs. There are many different
implementations of RTE.
MULTI supports debugging with an RTE through the Green Hills debug server
rteserv2.
Installing Your RTE
To use MULTI with an RTE, you must first install the RTE hardware (if applicable)
and software provided by Midas Labs. See your RTE documentation for detailed
instructions on installing the RTE.
The Green Hills debug server rteserv2, which supports RTE connections, is installed
automatically when you install MULTI.
Checking Your RTE Connection
After you have installed the RTE according to the documentation that accompanied
it, you should check the connection between the RTE and your host. To check your
connection, use the Check RTE program from within Windows. This RTE program
allows you to:
• Set the parameters for your operating environment (for example, ports, baud,
I/O address, etc.)
• Check the connection between the RTE and the host
• Test RTE functions
68
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using the Green Hills SuperTrace Probe to Collect Real-time Trace Data
The Check RTE program will ask you to make a series of selections appropriate
to your RTE. After you have made these selections, click the confirmation button.
This will start a connection check and function test.
If the Check RTE program terminates normally and does not indicate any errors,
you are ready to configure your MULTI files and then begin debugging with MULTI.
For information about configuring MULTI for your specific debugging environment,
see the documentation about configuring your target hardware in the MULTI:
Debugging book.
If Check RTE does not terminate normally, the following checklist may help you
locate the problem.
Type of
Things to check
connection
Serial
• Serial cable connections to the RTE and the host PC
• RTE settings (for example, baud, port, etc.)
Bus
• I/O address setting (The I/O address must not conflict with another board.)
• Board connection
• RTE dip switch settings (for example, baud, I/O address, etc.)
For more information about Check RTE, RTE settings, and troubleshooting your
connection, see your RTE documentation.
Using the Green Hills SuperTrace Probe to Collect Real-time Trace Data
The following describes connecting the SuperTrace Probe to a Midas RTE Cube
ICE, configuring the SuperTrace Probe, and collecting trace data. For more
information about the SuperTrace Probe, see Green Hills Debug Probes User's
Guide. For more information about connecting your debug server see “Connecting
to a RTE Target” on page 70.
Before connecting a SuperTrace Probe, you must first be able to debug a program
from MULTI with a Midas RTE Cube.
Green Hills Software
69

---

Chapter 4. RTE (rteserv2) Connections
Connecting the SuperTrace Probe to a Midas RTE Cube
The target board must have a trace breakout board on it, or you must acquire a board
separately. This trace breakout board passes the necessary debug signals through
to the RTE Cube while providing an additional Mictor connector into which to plug
the SuperTrace Probe.
The trace collection pod can be plugged directly into most versions of this breakout
board. For breakout boards labeled ADP-NECM-STP (without any subsequent
numbers), Green Hills adapter PATV8-01A must be used between the trace pod
and the ADP-NECM-STP breakout board.
Use a telnet console, a serial console, or gpadmin to set the following settings:
• Adapter must be set to v850e-trace-24.
• Target must be set to v850e_trace.
Note
There is a hyphen in the adapter name and an underscore in the target
name.
For more information about the SuperTrace Probe, see the documentation about
installing your probe in the Getting Started book for your probe
Collecting Trace Data
To collect trace data from the target, you must specify the SuperTrace Probe in your
850eserv2 connection. For more information, see "SuperTrace Probe is connected
via" in “Renesas V850/V850E ICE (850eserv2) Connection Settings” on page 26.
After the connection is made, verify that the target-specific trace options dialog is
configured correctly for your target.
Connecting to a RTE Target
After you have installed and configured your system, you are ready to connect to
your target and begin debugging. To help you connect to your target quickly and
70
MULTI: Configuring Connections for V850 and RH850 Targets

---

Creating a Standard RTE (rteserv2) Connection Method
easily, MULTI allows you to create and save Connection Methods that correspond
to your particular host and target systems and your desired debugging options.
For general instructions on how to create and use Connection Methods, see the
documentation about connecting to your target in the MULTI: Debugging book.
The information in the following sections supplements the instructions provided
there with information that is specific to RTE connections.
Creating a Standard RTE (rteserv2) Connection Method
When creating a new Standard RTE Connection Method, select RTE (rteserv2) as
the connection type in the Create New Connection Method dialog box.
For detailed instructions on creating new Standard Connection Methods, see the
documentation about connecting to your target in the MULTI: Debugging book.
Using the RTE (rteserv2) Connection Editor
In addition to the generic fields that appear on all Connection Editors for Standard
Connection Methods, the RTE (rteserv2) Connection Editor includes a Debug
tab that allows you to set other options. However, you should not enter any other
options on the Debug tab unless directed to do so by Green Hills Technical Support.
Green Hills Software
71

---

Chapter 4. RTE (rteserv2) Connections
Log Connection to File
Controls logging of all communications for rteserv2. Select the radio button for your desired
logging output. Logging is disabled by default.
Use SuperTrace Probe
The Debugger supports collecting trace data from hardware that supports this feature. You can
collect trace data by using a Green Hills SuperTrace Probe in tandem with the rteserv2
connection to the board.
By selecting this option, you can specify the network address of the SuperTrace Probe that
rteserv2 should connect to in order to obtain trace data. This trace data allows the user to use
TimeMachine and other trace facilities of the MULTI Debugger (see the documentation about
analyzing trace data with the TimeMachine tool suite in the MULTI: Debugging book).
For more information about configuring your SuperTrace Probe, see the documentation about
configuring your probe in the Getting Started book for your probe.
Other Options
Allows you to add other, optional arguments directly to the command line. You should only
use this field if directed to do so by Green Hills Technical Support.
72
MULTI: Configuring Connections for V850 and RH850 Targets

---

Commands for RTE (rteserv2) Connections
Commands for RTE (rteserv2) Connections
Unlike most Green Hills debug servers, rteserv2 does not support all of the
commands listed in “Generic Debug Server Commands” on page 90. The commands
available to rteserv2 are listed in the following sections.
General rteserv2 Commands
The commands listed in this section are processed by rteserv2 directly and work
for all of the RTEs tested for this distribution of MULTI (see “Supported Targets
for RTE (rteserv2) Connections” on page 68 for a list of tested RTEs). Each
particular RTE also accepts other commands, which are listed in “Commands for
Specific RTEs” on page 74.
You can enter the commands listed in this section directly into the rteserv2 Target
pane. You can also enter these commands into the MULTI Debugger command
pane using the target command. All of the commands for rteserv2 are
case-insensitive.
bpstat
Sends the eval command to MULTI to display the BP status.
dbgcomm [on | off]
Turns on or off RTE data logging.
debug [on | off]
Turns on or off the logging of debugging information.
info
Sends the eval command to MULTI to display the CPU status.
noload
Disables downloading to the target.
Use this command to avoid duplicate downloading if, for example, an object already exists in
memory.
tracewin
Displays the trace GUI.
Green Hills Software
73

---

Chapter 4. RTE (rteserv2) Connections
Commands for Specific RTEs
In addition to the general commands described in “Commands for RTE (rteserv2)
Connections” on page 73, each particular RTE also accepts other commands, which
are listed below.
RTE-V821-PC
help command
Displays help information.
If a command is specified: Displays help information about the specified command.
If a command is not specified: Displays a list of usable RTE commands and their formats.
inb [address]
Reads (inputs) byte data from the I/O port and places it into address. If no address is specified,
the previous address is used.
inh [address]
Reads (inputs) halfword data from the I/O port and places it into address. If no address is
specified, the previous address is used.
init
Initializes the RTE-V821-PC. This command should rarely be used.
inw [address]
Reads (inputs) word data from the I/O port and places it into address. If no address is specified,
the previous address is used.
outb [[address] data]
Writes (outputs) byte data at address to an I/O register. If address or data are not specified, the
previous address and/or data are used.
outh [[address] data]
Writes (outputs) halfword data at address to an I/O register. If address or data are not specified,
the previous address and/or data are used.
outw [[address] data]
Writes (outputs) word data at address to an I/O register. If address or data are not specified,
the previous address and/or data are used.
74
MULTI: Configuring Connections for V850 and RH850 Targets

---

Commands for Specific RTEs
sfr [registername [=data]]
Displays or sets the internal SFR registers.
If a register is specified, but data is not: Displays data read from the register.
If both the registername and =data arguments are specified: Writes the specified data to the
specified register. The size of the data is determined automatically by the effective size of the
specified register.
If no arguments are specified: lists the register names that may be used with the sfr command.
ver
Displays the version of the current RTE.
RTE-V851-IE
env
Sets the emulation CPU environmental values for the RTE-V851-IE.
help command
Displays help information.
If a command is specified: Displays help information about the specified command.
If a command is not specified: Displays a list of usable RTE commands and their formats.
init
Initializes the RTE-V851-IE. This command should rarely be used.
map
Specifies memory mapping.
nc
Specifies the excluded area for the RTE-V851-IE.
ncd
Deletes the excluded area for the RTE-V851-IE.
reset
Resets.
rrm
References memory within the real-time RAM monitor area.
rrmb
Specifies the real-time RAM monitor base address.
Green Hills Software
75

---

Chapter 4. RTE (rteserv2) Connections
sfr [registername [=data]]
Displays or sets the internal SFR registers.
If a register is specified, but data is not: Displays data read from the register.
If both the registername and =data arguments are specified: Writes the specified data to the
specified register. The size of the data is determined automatically by the effective size of the
specified register.
If no arguments are specified: lists the register names that may be used with the sfr command.
timer
Measures the execution time.
ver
Displays the version of the current RTE.
76
MULTI: Configuring Connections for V850 and RH850 Targets

---

Chapter 5
Multi-core Simulator for V850
and RH850 (simrh850)
Connections
Contents
Installing the Multi-core Simulator for V850 and RH850 (simrh850) . . . . . . . 78
Connecting to the Multi-Core Simulator for V850 and RH850
(simrh850) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Additional Commands for Multi-core Simulator for V850 and RH850
(simrh850) Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Profiling with simrh850 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Simulation Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Unsupported Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Connecting to the Multi-core Simulator for V850 and RH850 (simrh850) as
a Stand-alone Debug Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

---

Chapter 5. Multi-core Simulator for V850 and RH850 (simrh850) Connections
MULTI includes a target simulator called simrh850 that allows you to execute and
debug V850 and RH850 code on your host system. This chapter supplements the
general target connection information contained in Chapter 2, “Setting Up Your
Target Hardware” of this book and the documentation about connecting to your
target in the MULTI: Debugging book with information about how to connect to
and use the simrh850 Simulator.
Installing the Multi-core Simulator for V850 and RH850 (simrh850)
The simrh850 Simulator is installed automatically when you install MULTI. No
other installation steps are necessary.
Connecting to the Multi-Core Simulator for V850 and RH850
(simrh850)
To help you connect to targets (including simulators) quickly and easily, MULTI
allows you to create and save Connection Methods that specify the parameters of
your connection.
For general instructions on how to create and use Connection Methods, see the
documentation about connecting to your target in the MULTI: Debugging book.
The information in the following sections supplements the instructions provided
there with information that is specific to Multi-core Simulator for V850 and RH850
(simrh850) connections.
Creating a Multi-core Simulator for V850 and RH850 (simrh850) Connection
Method
When creating a new Multi-Core Simulator for V850 and RH850 (simrh850)
Connection Method, select Simulator for RH850 (simrh850) as the connection
type in the Create New Connection Method dialog box.
78
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using the Multi-core Simulator for V850 and RH850 (simrh850) Connection Editor
For detailed information about creating new Standard Connection Methods, see the
documentation about Standard Connection Methods in the MULTI: Debugging
book.
Using the Multi-core Simulator for V850 and RH850 (simrh850) Connection
Editor
In addition to the generic fields that appear on all Connection Editors for Standard
Connection Methods, the Multi-core Simulator for V850 and RH850 (simrh850)
Connection Editor includes Connection and Debug tabs that provide settings and
options specific to your simulated target and your host operating system.
Green Hills Software
79

---

Chapter 5. Multi-core Simulator for V850 and RH850 (simrh850) Connections
When the Connection Editor is first displayed after you create a new Connection
Method, the settings and options are set to default values. Settings and options that
are not available on your host operating system may appear dimmed. Some of the
fields may require user input before the Connection Method can be used.
All of the fields on the Connection and Debug tabs of the Multi-core Simulator
for V850 and RH850 (simrh850) Connection Editor are described in detail below.
(See the documentation about the Connection Editor in the MULTI: Configuring
Connections book for a description of the other fields and options, which appear
on all Connection Editors.)
80
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using the Multi-core Simulator for V850 and RH850 (simrh850) Connection Editor
Multi-core Simulator for V850 and RH850 (simrh850) Connection
Settings
Processor
Specifies which target processor to simulate. This field defaults to V850.
ROM mode
Specifies ROM Simulation Mode (as opposed to OS Simulation Mode). For more information
about OS and ROM Simulation Modes, see “Simulation Modes” on page 85.
Unaligned Memory Access Support
Allows misaligned memory accesses on processors that support it.
Number of Cores
Selects the number of V850 and RH850 cores to simulate. Up to 32 cores may be simulated at
one time. The default is 1.
Number of h/w Threads per Core
Selects the number of V850 and RH850 threads to simulate. Up to 8 threads may be simulated
at one time. The default is 1. This option is only available for V850E3/RH850 cores.
Multi-core Simulator for V850 and RH850 (simrh850) Debug
Settings
Warning
Do not change the settings on the Debug tab unless you are instructed to
do so by Green Hills Technical Support.
Green Hills Software
81

---

Chapter 5. Multi-core Simulator for V850 and RH850 (simrh850) Connections
Other Options
Allows you to add other, optional arguments directly to the command line. You should only
use this field if directed to do so by Green Hills Technical Support.
Using Custom Multi-core Simulator for V850 and RH850 (simrh850)
Connection Methods
To connect to your simrh850 Simulator with a Custom Connection Method, type
the command given below, with the appropriate parameters and options, into the
Start a Custom Connection dialog box and click Connect.
simrh850 [-cores=n] [-cpu=cpu] [-fpu=fpu] [-local_mem=start,length | start-end]
[-no_auto_alloc] [-rh850_misalign] [-rh850_simd] [-rh850_fpsimd]
[-rom[_use_entry]] [-shared_mem=start,length | start-end] [-stepcount=n]
[-threads=n] [-trace_core=n] [-trace_thread=n]
where:
• -cores=n — Selects the number of CPU cores to simulate. Up to 32 cores may
be simulated at one time. The default is 1.
• -cpu=cpu — Specifies which target processor to simulate. The default is
rh850g3m. Other acceptable values for cpu are: v850, v850e, v850e1f,
v850e2, v850e2r, v850e2v3, v850e3v5, rh850g3k, rh850g3mh and
rh850g3kh.
• -fpu=fpu — Specifies which FPU coprocessor to simulate. This option is only
meaningful when simulating an RH850 family or V850E3 family processor.
The default is fpu30 which simulates a version 3 FPU. To simulate a version
2 FPU specify fpu20.
• -local_mem=start,length | start-end — Specifies a range of local memory to
allocate for all cores and threads upon startup. This range of memory will be
private for each cores and thread.
• -no_auto_alloc — Disables auto-allocation of simulated memory. By default,
the simulator will automatically allocate memory to match the V850 and RH850
executable being simulated. When in multi-core or multi-threaded mode, all
auto-allocated memory will be shared across all cores and threads. When this
option is specified, only the memory configured with the -shared_mem and
-local_mem options is allocated.
82
MULTI: Configuring Connections for V850 and RH850 Targets

---

Using Custom Multi-core Simulator for V850 and RH850 (simrh850) Connection Methods
• -nofastbps — By default the simulator will simulate software breakpoints
using the software breakpoint instruction. This option will cause it to switch
to a method more similar to a hardware breakpoint. This will significantly slow
down simulation, but is useful for debugging self-modifying software. It is
intended for advanced users only.
• -rh850_misalign — Enables support for misaligned memory accesses in the
simulator. This corresponds to the -misalign_pack option in the compiler.
• -rh850_simd — Enables support for the SIMD coprocessor available with
some RH850 processors. The corresponding -no_rh850_simd option will force
the SIMD coprocessor to be disabled.
• -rh850_fpsimd — Enables support for the FPSIMD coprocessor available
with some RH850 processors. The corresponding -no_rh850_fpsimd option
will force the FPSIMD coprocessor to be disabled.
• -rom — Enables ROM mode on the simulator and sets the simulator to start
from the reset vector. To run the simulator in ROM mode, but start from the
program's entry point, use -rom_use_entry. For more information, see “ROM
Mode” on page 87.
• -shared_mem=start,length | start-end — Specifies a range of shared memory
to allocate for all cores and threads upon startup. This range of memory will
be shared across all cores and threads.
• -stepcount=n — Sets the number of instructions the simulator will simulate
before polling the debugger for activity. The default is 100000 for a single-core,
single-thread simulation. Otherwise the default is 1 to maximize synchronization
between threads and cores. This option should only be used by advanced users
to tweak performance and responsiveness trade-offs of the simulator.
• -threads=n — Selects the number of CPU threads to simulate. Up to 8 threads
may be simulated at one time. The default is 1. This option is only available
for V850E3/RH850 cores.
• -trace_core=n — Selects which core trace data will be collected on. Trace
data may only be collected for a single core at a time. The default is core 0.
• -trace_thread=n — Selects which thread trace data will be collected on. Trace
data may only be collected for a single thread at a time. The default is thread
0.
Green Hills Software
83

---

Chapter 5. Multi-core Simulator for V850 and RH850 (simrh850) Connections
Note
You can also enter the above connection command from the Debugger's
command pane, where it must be preceded by the connect command.
See the documentation about Custom Connection Methods in the MULTI: Debugging
book for more information about Custom Connections.
Additional Commands for Multi-core Simulator for V850 and RH850
(simrh850) Connections
The following commands, in addition to the commands listed in “Generic Debug
Server Commands” on page 90, are available to simrh850.
You can enter all of these commands directly into the simrh850 Target pane. You
can also enter these commands into the MULTI Debugger command pane using
the target command. All of the commands for simrh850 are case-insensitive.
alloc [ local | shared ] addr size
Allocates size bytes of memory starting at address addr in memory.
freq frequency
Sets processor frequency to frequency MHz.
help
Displays all of the commands with their brief descriptions.
memmap
Displays a map of the currently allocated memory for all cores and threads.
snooze interval
Sets the V850E3/RH850 SNOOZE interval to interval cycles.
stepcount count
Sets the number of instructions the simulator will simulate before polling the debugger for
activity. The default is 100000 for a single-core, single-thread simulation. Otherwise the default
is 1 to maximize synchronization between threads and cores. This option should only be used
by advanced users to tweak performance and responsiveness trade-offs of the simulator. Setting
the value to 0 will reset to default values.
84
MULTI: Configuring Connections for V850 and RH850 Targets

---

Profiling with simrh850
threads
Displays the V850E3/RH850 thread scheduling information. For example, the following output
shows that the processor is configured for one CPU, where that CPU has six scheduling slots
(from that CPU's HTSCCTL register's RND field), with the execution order (from that CPU's
HTSCTBLn registers) being Thread 0, Thread 1, Thread 2, Thread 1, Thread 0 and finally Thread
2:
Thread schedule for core 0 (6 scheduling slots used):
0 -> 1 -> 2 -> 1 -> 0 -> 2
Profiling with simrh850
You can use MULTI to profile with the simrh850 simulator. Profiling with a
simulator is often much more accurate than native profiling because profiling
information can be obtained without periodically halting the program and recording
the location of the program counter. The simulator keeps track of which instruction
it is simulating and how many machine clocks have passed. The simulated clock
rate is 50 MHz.
For more information about profiling, see the documentation about recording and
viewing profiling data in the MULTI: Debugging book.
Simulation Modes
The simrh850 simulator has two simulation mode: OS and ROM. These two modes
are described in the following sections. OS Simulation Mode is the default mode.
To enable ROM simulation, select the ROM mode option in the Connection Editor
or pass the -rom or -rom_use_entry option.
The simrh850 simulator is designed to be applicable for user level applications,
but processor features such as caches, memory management unit, and any special
peripherals and registers are generally not implemented.
OS Simulation Mode
In OS simulation mode (which is the default mode), the simulator provides an
environment similar to a user process running under UNIX. The simulator allocates
memory for the text and initialized and uninitialized data of the simulated program,
Green Hills Software
85

---

Chapter 5. Multi-core Simulator for V850 and RH850 (simrh850) Connections
loads it into memory, and starts executing at the entry point specified at link time.
The stack pointer is initialized and any command line arguments listed after the
user program name on the simulator command line are passed to the main program
via the normal argc/argv convention. A limited set of system calls is supported
for I/O purposes. This level of simulation is suitable for debugging user-level
programs, but if your programs need a more accurate simulation of actual CPU
behavior, you should run in ROM mode.
The simulator accepts the following system calls.
access
alarm
brk
close
creat
exit
fstat
getpid
link
lseek
open
read
stat
time
unlink
write
Note
While only these system calls are implemented, many library functions
use a combination of these calls to achieve their goals.
To implement these system calls, the simulator cooperates with the Green Hills
Libraries by setting a breakpoint in the .syscall section. The simulator is then
able to trap any call into this special section and treat it as a system call request by
the library.
In OS simulation mode, only memory that was allocated initially, plus memory
returned by the brk system call, is available. References to other memory addresses
will be trapped by the simulator and cause the program to abort. Similarly, attempts
to use exception-generating instructions also cause the program to abort. If the
simulation must closely reflect actual hardware behavior, consider using ROM
mode.
Including a MEMORY directive in the link map does nothing unless a section is
allocated at the address in question. For example:
MEMORY {
...
memory : ORIGIN = 0x0080f000, LENGTH = 64K ...
}
...
SECTIONS {
86
MULTI: Configuring Connections for V850 and RH850 Targets

---

ROM Mode
...
.section : > memory
...
}*
ROM Mode
ROM Mode simulates only the bare minimum hardware, such as CPU and memory
systems. In ROM mode, you can set the simulator to start at either the reset vector
or at the program's entry point. To cause the simulator to always start execution at
the address of the system reset vector (address 0), as if the CPU were given a hard
reset, and to ignore any program startup address specified at link time, select ROM
mode on the Connection tab of the Connection Editor or include the -rom option
in your Custom Connection Method. To start at the program's entry point instead,
use a Custom Connection Method and pass the -rom_use_entry option.
Other features of ROM mode include:
• Handling of exceptions as in the hardware, with the program counter transferred
to the appropriate address. User code must be supplied to handle the exception
appropriately.
• Prevention of arguments being passed to the running program.
• Requirement that user startup code initialize the stack pointer.
• Support of a limited set of system calls for I/O.
You can use ROM mode for writing and testing exception handlers and even parts
of a real operating system. You should write at least some start-up code in pure
assembly language, since this mode simulates a bare bones processor.
Unsupported Features
The V850 does not support the following hardware features.
• Instruction pipelining
• Exact timing
• ICE mode
• Interrupts
Green Hills Software
87

---

Chapter 5. Multi-core Simulator for V850 and RH850 (simrh850) Connections
Connecting to the Multi-core Simulator for V850 and RH850
(simrh850) as a Stand-alone Debug Server
To connect to the Multi-core Simulator for V850 and RH850 from the command
line, independently of MULTI, enter:
simrh850 [-cpu=cpu] [-rom] image_file [args]...
where:
• -cpu=cpu — Specifies which target processor to simulate. The default is
rh850g3m. Other acceptable values for cpu are: v850, v850e, v850e1f,
v850e2, v850e2r, v850e2v3, v850e3v5, rh850g3k, rh850g3mh and
rh850g3kh.
• -rom — Instructs the simulator to behave more like Green Hills hardware
debug servers and to ignore the program's entry point. See “ROM Mode”
on page 87.
• image_file — Is an ELF style executable file.
• args — Are optional command line arguments which are passed to the program
in OS simulation mode. See “OS Simulation Mode” on page 85.
Connecting to the simulator in this way allows you to simulate your program, but
does not offer the interactive debugging capabilities available through MULTI.
88
MULTI: Configuring Connections for V850 and RH850 Targets

---

Appendix A
Green Hills Debug Server
Command and Scripting
Reference
Contents
Green Hills Debug Server Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
The Green Hills Debug Server Scripting Language . . . . . . . . . . . . . . . . . . . . . . 96

---

Appendix A. Green Hills Debug Server Command and Scripting Reference
This chapter describes generic debug server commands and a full scripting language
that can be used with most Green Hills debug servers.
These commands and the scripting language are used only in legacy .dbs scripts,
and are deprecated.
Green Hills Debug Server Commands
The commands described below are available to most Green Hills debug servers,
but do not apply to simulator or operating system connections.
Most Green Hills debug servers also support additional commands.
Generic Debug Server Commands
Unless otherwise noted, the commands listed in this section are available for all of
the debug servers in this book.
You can enter all of these commands directly into the debug server Target pane.
You can also enter these commands into the MULTI Debugger command pane
using the target command. All of the Green Hills debug server commands are
case-insensitive.
addressof symbol
Returns the address of symbol. This command requires that an image be loaded in the MULTI
Debugger.
amask [mask] [value]
If no arguments are specified, the current settings of the download mask and value are displayed.
The default settings of mask and value are 0xffffffffffffffff and 0, respectively.
If mask and value are specified, amask sets the download mask and value to mask and value.
When the debug server downloads a program, it will bitwise AND mask and bitwise OR value
with the download addresses, as follows:
address = (address & mask) | value
The amask command is useful for shifting download target addresses without relinking a
program. However, the program being downloaded still retains its original relocations and might
not run correctly at its new destination address without further support on the target.
90
MULTI: Configuring Connections for V850 and RH850 Targets

---

Generic Debug Server Commands
close fd
Closes the specified file descriptor, fd.
debug n
Sets the debugging bit flags.
Do not use this command unless directed to do so by Green Hills Technical Support.
delrange addr
Deletes a checked address range starting at addr. See setrange for more information about
checked memory ranges.
delrangeall
Deletes all checked address ranges. See setrange for more information about checked memory
ranges.
echo [ on | off ]
If no argument is specified, the current echo mode is printed.
If on or off is specified, printing of commands executed in a script are enabled or disabled.
fprint fd string
Prints string to the specified file, fd, with script variable expansion.
fprintb fd integer
Prints integer to the specified file, fd, in binary mode.
fread fd identifier
Reads one line of text from the specified file, fd. The line is stored as a variable with the specified
identifier. The number of bytes read is returned. If there is an error, -1 is returned.
freadb fd identifier
Reads an integer from the specified file, fd, in binary mode. The integer is stored as a variable
with the specified identifier. The number of bytes read is returned. If there is an error, -1 is
returned.
getenv envName identifier
Stores the value of the environment variable, envName, in the script variable with the specified
identifier.
halt
Halts execution of the target CPU and forces it into debugging mode.
Green Hills Software
91

---

Appendix A. Green Hills Debug Server Command and Scripting Reference
help [ command | group ]
(See also the device-specific help command listed in “Additional Debug Server Commands”
on page 96.)
If no argument is specified, general help information and instructions for finding more detailed
and specific help is printed.
If a command is specified, detailed help information about the specified command is printed.
If a group is specified, a list of all of the commands in the group with information about the
arguments each command takes is printed. Valid command groups include target, server, and
scripting.
Example 1:
> help server
help [<command> | <group>]
debug <n>
playdead
Example 2:
> help help
help [<command> | <group>]
Prints help information
listrange
Lists all checked ranges. See setrange for more information about checked memory ranges.
listvars
Prints all variable identifiers in no particular order.
Example:
> str1="foo"
> str2="bar"
> i=100
> listvars
i
str1
str2
92
MULTI: Configuring Connections for V850 and RH850 Targets

---

Generic Debug Server Commands
load [all] [text] [data] [bss]
If no argument is specified: Displays the current load settings.
If one or more arguments are specified, load instructs which sections to include in host-to-target
downloads. .text sections contain code, .data sections contain initialized variables, and .bss
sections contain uninitialized data. Setting the all option includes all of these sections in the
download.
You can combine the load command with the noload command.
Green Hills startup code clears all .bss sections so you do not need to download them. In most
cases, the default setting is text data, but the default varies according to your debug server.
Standard Example:
> load all
Download Options: text data bss
Advanced Example:
> load all noload bss
Download Options: text data
m [-dsize] address[=val]
If =val is not specified, the indicated memory address on the target is read.
If =val is specified, val to the specified memory addresson the target is written.
Memory addresses and values must be specified in hexadecimal (with or without a leading 0x).
The optional -d argument can be used to set the access size to byte (-d1), short (-d2), or long
(-d4). The default is -d4.
Examples:
> m 1000
7ca62b78
> m 1000=12345678
> m -d2 1000
1234
nofail command
Executes the specified command and always returns success.
Green Hills Software
93

---

Appendix A. Green Hills Debug Server Command and Scripting Reference
noload [all] [text] [data] [bss]
If no argument is specified, the current noload settings are displayed.
If one or more arguments are specified, noload specifies which sections to exclude from
host-to-target downloads. .text sections contain code, .data sections contain initialized
variables, and .bss sections contain uninitialized data. Setting the all option excludes all of
these sections from the download.
Use the command noload bss to exclude .bss sections from downloads. These sections are
cleared to all zeros by programs compiled with Green Hills tools; therefore, downloading them
to the target is usually unnecessary.
open file
Opens the specified file for writing and returns a file descriptor.
print string
Prints string with script variable expansion.
Example:
> print Test
Test
random max
Generates and returns a pseudo-random number between 0 and max-1.
run [address]
If address is not specified, the processor is run from the current program counter(PC).
If address is specified, it sets the program counter to address and then runs the processor.
Use this command very carefully. It is possible to run a program on the board when MULTI
thinks it is halted, which causes unpredictable results.
A common use for this command is to run a ROM monitor program so that the monitor can set
up the board properly before MULTI downloads a program.
script file
Executes the commands in the specified script file, file, as if they were typed in line by line.
setrange addr length
Sets a checked address range beginning at addr and extending for length bytes.
A checked address range is a range of addresses that are considered inaccessible. Any memory
access, read, or write to a checked address range can fail.
The setrange command is useful for restricting access to target memory that might be sensitive
or volatile.
94
MULTI: Configuring Connections for V850 and RH850 Targets

---

Generic Debug Server Commands
setup file
Specifies a script file, file, to be automatically run immediately prior to every host-to-target
download.
sleep n
Suspends the debug server for n seconds.
status
Prints and returns the current status of the debug server using the following status codes:
0 Running
1 Stopped by breakpoint
2 Single step completed
3 Exception
4 Halted
5 Process exited
6 Process terminated
7 No process
8 (Unassigned)
9 Stopped by hardware breakpoint
10 Failure
11 Process ready to run
12 Host system call in progress
13 Target reset
step
Single steps the target CPU from the current program counter location.
stepint [ nomask | mask ]
Turns interrupts during single stepping on (nomask) or off (mask).
When set, stepint masks all interrupts during a single step. For example, on Power Architecture,
interrupt masking is accomplished by masking the EE bit in the MSR. Stepping over code that
alters the MSR with stepint on will result in unpredictable values in the MSR.
If no argument is specified, this command displays the current value.
undef variable
Removes variable and releases any memory associated with it.
Example:
> x=5
> undef x
> print $x
Error: variable undefined!
Green Hills Software
95

---

Appendix A. Green Hills Debug Server Command and Scripting Reference
Additional Debug Server Commands
The following table indicates where you can find information about additional
commands (if any) available for your particular debugging interface.
Debugging interface
Where to find additional commands for this target
Green Hills Monitor
There are no additional commands for Green Hills Monitor
connections.
Renesas V850/V850E ICE
“Target Commands for Renesas V850/V850E ICE (850eserv2)
Connections” on page 36
RTE Servers
“Commands for Specific RTEs” on page 74
Simulator for V800
“Additional Commands for Multi-core Simulator for V850 and
RH850 (simrh850) Connections” on page 84
The Green Hills Debug Server Scripting Language
In addition to the commands listed in “Generic Debug Server Commands”
on page 90, a full scripting language is available from the monserv command line.
This scripting language is described below.
You can run monserv scripts by:
• Entering scripts one line at a time at the command prompt. When entering a
script line by line, nothing is executed until the top-level enclosing while or if
statement is terminated.
• Storing commands in a script file and then running the file using the script
command.
• Storing commands in a script file and then using the -setup option or setup
command (or the Target Setup Script field in some Connection Editors) to
ensure that the script file is automatically executed immediately prior to every
host-to-target download.
General Notes
When writing monserv scripts, keep the following points in mind:
• There can be no more than one statement per line.
96
MULTI: Configuring Connections for V850 and RH850 Targets

---

Scripting Syntax
• Any line that has the # character as the first non-whitespace character is treated
as a comment.
• Variables do not need to be declared before they are used.
• Variable types are determined automatically. For example, an identifier that is
bound to an integer variable can later be assigned to a string variable.
• Variable and function names are not case-sensitive.
Scripting Syntax
The following sections describe and give examples of some features of the Green
Hills debug server scripting language supported by monserv.
Expressions
Expressions in the Green Hills debug server scripting language are similar to C
language expressions. Unlike C, each operator has its own precedence (10/2*5
evaluates to 1, not 25), and there are no unary operators (such as ~ and unary -).
The following table contains, in order of precedence, the valid operators you can
use in expressions. Note that a string is treated like an integer if it contains a string
representation of an integer.
Operator
Integer Function
String Function
( )
Grouping of operators to ensure
Grouping of operators to ensure desired
desired evaluation
evaluation
*
Multiplication
Invalid
/
Division
Invalid
%
Modulus
Invalid
+
Addition
Concatenation
-
Subtraction
Invalid
<<
Bitwise left shift
Invalid
>>
Bitwise right shift
Invalid
<
Less than
Alphabetic less than
<=
Less than or equal to
Alphabetic less than or equal to
>
Greater than
Alphabetic greater than
Green Hills Software
97

---

Appendix A. Green Hills Debug Server Command and Scripting Reference
Operator
Integer Function
String Function
>=
Greater than or equal to
Alphabetic greater than or equal to
==
Equality test
Equality test
!=
Inequality test
Inequality test
&
Bitwise AND
Invalid
^
Bitwise XOR
Invalid
|
Bitwise OR
Invalid
&&
Logical AND
Invalid
||
Logical OR
Invalid
Assignments
The syntax for an assignment is:
identifier = expression
The expression is evaluated and the result is stored as a variable with the given
identifier. String, integer, and array variables are supported. Identifiers can contain
alphanumeric characters and the underscore (_) character, but cannot begin with a
number, or have the same name as a command.
Arrays
Arrays are indexed lists of variables. Each cell in an array can contain a string, an
integer, or an array. Array indexing begins with the index 0. An array can be created
by assigning an entire array to an identifier or by assigning a string, an integer, or
an array to one cell of an array. To reference a cell, follow the array identified by
the index contained in square brackets. If an array cell contains another array, the
elements in the second array are accessed by appending an additional index in square
brackets. The following example demonstrates the various methods of array access.
endl="\n"
bar[3] = 42
foo = { bar, 7, "hello" }
print $foo[2] world.$endl
if(foo[0][3]==bar[2+1])
98
MULTI: Configuring Connections for V850 and RH850 Targets

---

Scripting Syntax
print Array indexing works.$endl
endif
Arrays are dynamically allocated in a sparse fashion. For example, making an
assignment to foo[0] and then to foo[100] only allocates two array cells, and
no space is used for the undefined array cells 1 through 99. After an array element
has been allocated, it can only be deallocated by using the undef command on the
top-level array identifier.
Conditionals
The following table explains the syntax for conditionals.
Syntax
Effect
if expression
If expression evaluates to zero, nothing happens. Otherwise, the block
of statements between the if and endif lines are executed.
statements
endif
if expression
If expression evaluates to zero, the debug server executes the block
of statements between the else and endif lines. Otherwise, the block
statements
of statements between the if and else lines are executed.
else
statements
endif
if expression1
If expression1 does not evaluate to zero, the debug server executes
the block of statements between the if and elif lines.
statements
If expression1 does evaluate to zero and expression2 does not evaluate
elif expression2
to zero, the debug server executes the block of statements between
statements
the elif and endif lines.
[elif expressionX
If both expression1 and expression2 evaluate to zero, the debug server
continues evaluating each of the subsequent elif expressions (if any)
statements]...
that occur before the endif statement and will execute the block of
endif
statement associated with each elif that does not evaluate to zero.
If none of the elif expressions evaluates to non-zero, the debug server
will not execute anything.
Loops
The following table explains the syntax for loops.
Green Hills Software
99

---

Appendix A. Green Hills Debug Server Command and Scripting Reference
Syntax
Effect
while expression
The statements between the while and endwhile lines are executed
as long as expression does not evaluate to zero.
statements
endwhile
do
The statements between do and while are executed one time, then
continue to execute as long as expression does not evaluate to zero.
statements
dowhile expression
Be careful to avoid infinite loops. If an infinite loop occurs, you must shut down
and restart the debug server.
Variable Expansion
To use script variables as arguments to Green Hills debug server commands, you
must prepend the variable name with one or two $ characters.
• To pass a variable to a command in its default text representation, prepend the
variable name with a single $ character. This passes a decimal string for integer
variables and passes the string itself for string variables. Integers are expanded
as two's complement signed 32-bit integers. An entire array cannot be given
as an argument to a command.
• To pass an integer variable to a command as a hexadecimal string, prepend the
variable name with two $ characters. Use this method with commands such as
m that require arguments in hexadecimal form. The hexadecimal string does
not include a leading 0x.
Variable expansion must be unambiguous. The script parser attempts to use the
longest legal identifier name following the $ character. In the following example,
the user has attempted to print the string bar after the expansion of the variable
foo. The parser interprets this as printing the value of the variable foobar and
reports that the variable is not defined:
>foo="foo"
>print $foobar
Error: variable undefined!
100
MULTI: Configuring Connections for V850 and RH850 Targets

---

Example Scripts
Example Scripts
You can use the following examples of the Green Hills debug server scripting
language as a guide when writing your own scripts.
Note
These example scripts will not work with Renesas V850/V850E ICE or
RTE or connections.
Example A.1. Testing Script File Access in ASCII Mode
For this example, assume that the file test.ascii contains the following text:
This is a test of script file access in ascii mode.
This should print 3 lines of which this is the second.
And this is the third.
The following script commands access the file test.ascii:
file = open test.ascii
filecontents=""
totalchars=0
while(numlinechars=fread file line)
filecontents=filecontents+line
totalchars=totalchars+numlinechars
endwhile
close file
endl="\n"
print Read: $filecontents$endl
print Total of $totalchars characters read.$endl
The output of this example script on a Linux/Solaris host is:
Read: This is a test of script file access in ascii mode.
This should print 3 lines of which this is the second.
And this is the third.
Total of 130 characters read.
Example A.2. Accessing a File
The following script is another example of accessing a file:
Green Hills Software
101

---

Appendix A. Green Hills Debug Server Command and Scripting Reference
i=100
file = open temp.bin
while(i>0)
fprintb file $i
i=i-1
endwhile
close file
file = open temp.bin
sum=0
while(freadb file i)
sum=sum+i
endwhile
close file
endl="\n"
print The numbers between 1 and 100 sum to $sum!$endl
The output of this example script is:
The numbers between 1 and 100 sum to 5050!
Example A.3. Calculating a CRC32 Value
The following script calculates the CRC32 value of the memory range 0x010000
to 0x010100 and prints the result in the Target pane. This script demonstrates the
use of loops, conditional statements, expressions, variables, and other debug server
scripting constructs in a real application.
# Change the following values to specify the memory
# range you want to calculate a CRC32 for.
# Note: locations from memstart to memend-1 are used
# to compute the CRC32 value.
memstart=0x010000
memend=0x010100
# This is the CRC32 polynomial. This is the same as
# is used in ethernet packets.
p=2+4+16+32+128+256+1024+2048+4096+65536+4194304+8388608+67108864
r=0
ptr=memstart
while(ptr<memend)
currbyte=m -d1 $$ptr
currbit=128
while(currbit)
test=r&(1<<31)
r=r<<1
r=r|(currbyte&currbit)
if(test)
r=r^p
endif
102
MULTI: Configuring Connections for V850 and RH850 Targets

---

Example Scripts
currbit=currbit>>1
endwhile
ptr=ptr+1
endwhile
# This loop is for the 32 zeros appended to the
# original memory contents
i=0
while(i<32)
test=r&(1<<31)
r=r<<1
if(test)
r=r^p
endif
i=i+1
endwhile
# Now the resulting 32 bit CRC is in r
# Many of the same ASCII control codes that are used
# in C are supported in debug server scripts.
endl="\n"
print CRC32 = $$r$endl
Green Hills Software
103

---

---

Appendix B
Target-Specific Trace
Options and Triggers
Contents
Renesas V850E IECUBE Target-Specific Options . . . . . . . . . . . . . . . . . . . . . . 106
Renesas V850E2RV3 IECUBE2 Target-Specific Options . . . . . . . . . . . . . . . . 108
Renesas RH850 Target-Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
V850E/V850E2R RTE Target-Specific Options . . . . . . . . . . . . . . . . . . . . . . . . 113
V850 Target-Specific Trace Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

---

Appendix B. Target-Specific Trace Options and Triggers
This section describes the target-specific trace configuration options and triggers
available in the MULTI IDE. For information about generic trace options, see the
MULTI: Debugging book.
Renesas V850E IECUBE Target-Specific Options
Each option in the IECUBE Trace Options window is described in the following
table.
106
MULTI: Configuring Connections for V850 and RH850 Targets

---

Renesas V850E IECUBE Target-Specific Options
Option
Description
Real-Time Trace
Enables real-time trace mode. In this mode, some trace packets may
be lost, but the core executes at the same speed as it would if trace
was disabled. When you disable this option, no trace packets are
lost, but the core may stall occasionally.
Timestamps
Enables timestamps. When timestamps are enabled, the trace
collection device records a timestamp with each packet. Timestamps
are displayed in the Trace List and are used by the MULTI Profile
window, PathAnalyzer, and EventAnalyzer. Timestamps are not
synchronized across cores on multi-core targets.
Use Trigger GUI
Enables the trigger GUI. For simple events, such as executing a
function, the GUI is sufficient. However, the IECUBE also supports
sophisticated event configuration that is not available via the trigger
GUI. If you need access to more advanced features, you can clear
this box and control all events by using debug server commands
such as bra, brs, and trace.
Trace Branch PC
Enables branch program counter (PC) trace packets. This option is
sufficient for fully reconstructing the instruction sequence the target
executed. It is also sufficient for use with TimeMachine. For
information, see the documentation about TimeMachine in the
MULTI: Debugging book.
Trace Instruction PC
Enables instruction program counter (PC) trace packets, which results
in the target outputting a trace packet for each instruction. This can
yield more accurate timing information when timestamps are enabled.
It also increases the probability that the trace buffer overflows in
real-time trace mode.
Trace Data Access PC
Causes the target to output a program counter (PC) trace packet for
every instruction that performs a memory access. This option is
usually unnecessary.
Trace Data Address
Enables data/address trace packets for memory accesses.
and Data
Note
Not all combinations of trace packets are valid. The user interface prevents
you from selecting invalid combinations by dimming options that you
cannot change given the current combination of settings.
Green Hills Software
107

---

Appendix B. Target-Specific Trace Options and Triggers
Renesas V850E2RV3 IECUBE2 Target-Specific Options
Each option in the IE Cube 2 Trace Options window is described in the following
table.
Option
Description
Real-Time Trace
Enables real-time trace mode. In this mode, some trace packets may
be lost, but the core executes at the same speed as it would if trace
was disabled. When you disable this option, no trace packets are
lost, but the core may stall occasionally.
108
MULTI: Configuring Connections for V850 and RH850 Targets

---

Renesas V850E2RV3 IECUBE2 Target-Specific Options
Option
Description
Timestamps
Enables timestamps. When timestamps are enabled, the trace
collection device records a timestamp with each packet. Timestamps
are displayed in the Trace List and are used by the MULTI Profile
window, PathAnalyzer, and EventAnalyzer. Timestamps are not
synchronized across cores on multi-core targets.
Use Trigger GUI
Enables the trigger GUI. For simple events, such as executing a
function, the GUI is sufficient. However, the IECUBE2 also supports
sophisticated event configuration that is not available via the trigger
GUI. If you need access to more advanced features, you can clear
this box and control all events by using debug server commands
such as bra, brs, and trace.
Trace Reads
Enables data read trace packets for memory accesses.
Trace Writes
Enables data write trace packets for memory accesses.
Trace PC
Enables branch program counter (PC) trace packets. This option is
sufficient for fully reconstructing the instruction sequence the target
executed. It is also sufficient for use with TimeMachine. For
information about TimeMachine, see the documentation about
TimeMachine in the MULTI: Debugging book.
Trace DMA Reads
DMA read trace packets.
Trace DMA Writes
Enables DMA write trace packets.
Time resolution
Specifies the time resolution of trace packet timestamps. This field
defaults to 5000 picoseconds when timestamps are enabled.
Buffer Full
Specifies the behavior when the trace buffer fills. You can choose
to overwrite old trace data with new data, stop trace collection, or
halt the process. If you stop trace collection or halt the process, note
that this option can only preserve trace data acquired since the last
time the target was halted (including for breakpoints and system
calls), rather than all of the data acquired since the last time data was
retrieved. When the Long Term Trace extension (QB-V850E2-SP
trace memory extension) is used with IECUBE2, Stop Execution
is not supported.
Trigger Hit
Specifies the behavior when a Delay Trace trigger is hit. It can be
configured to stop trace collection or stop execution.
This option is only available if a Delay Trace trigger has been set
up.
Green Hills Software
109

---

Appendix B. Target-Specific Trace Options and Triggers
Option
Description
Trigger Position
Specifies the desired position of the Delay Trace trigger in the trace
buffer, after trace has stopped. Last means trace will stop very soon
after hitting the trigger (so the trigger will end up being near to the
last thing in the trace buffer). First means trace will continue to be
collected until the trigger is near the beginning of the buffer. Middle
means trace continues to be collected until half of the buffer has
been filled.
This option is only available if a Delay Trace trigger has been set
up.
Note
Not all combinations of trace packets are valid. The user interface prevents
you from selecting invalid combinations by dimming options that you
cannot change given the current combination of settings.
110
MULTI: Configuring Connections for V850 and RH850 Targets

---

Renesas RH850 Target-Specific Options
Renesas RH850 Target-Specific Options
Each option in the RH850 Trace Options window is described in the following
table.
Option
Description
Real-Time Trace
Enables real-time trace mode. In this mode, some trace packets may
be lost, but the core executes at the same speed as it would if trace
was disabled. When you disable this option, no trace packets are
lost, but the core may stall occasionally.
Green Hills Software
111

---

Appendix B. Target-Specific Trace Options and Triggers
Option
Description
Timestamps
Enables timestamps. When timestamps are enabled, the trace
collection device records a timestamp with each packet. Timestamps
are displayed in the Trace List and are used by the MULTI Profile
window, PathAnalyzer, and EventAnalyzer. Timestamps are not
synchronized across cores on multi-core targets.
Use Trigger GUI
Enables the trigger GUI. For simple events, such as executing a
function, the GUI is sufficient. However, the IECUBE2 also supports
sophisticated event configuration that is not available via the trigger
GUI. If you need access to more advanced features, you can clear
this box and control all events by using debug server commands
such as bra, brs, and trace.
Trace Reads
Enables data read trace packets for memory accesses.
Trace Writes
Enables data write trace packets for memory accesses.
Trace PC
Enables branch program counter (PC) trace packets. This option is
sufficient for fully reconstructing the instruction sequence the target
executed. It is also sufficient for use with TimeMachine. For
information about TimeMachine, see the documentation about
TimeMachine in the MULTI: Debugging book.
Trace Software
Causes the target to output a trace packet for each software trace
instruction (DBCP, DBTAG, DBPUSH).
Trace Data Access PC
Causes the target to output a program counter (PC) trace packet for
every instruction that performs a memory access. This option is
usually unnecessary.
Trace DMA Reads
Enables DMA read trace packets.
Trace DMA Writes
Enables DMA write trace packets.
Time resolution
Specifies the time resolution of trace packet timestamps. This field
defaults to 5000 picoseconds when timestamps are enabled.
Buffer Full
Specifies the behavior when the trace buffer fills. You can choose
to overwrite old trace data with new data, stop trace collection, or
halt the process. If you stop trace collection or halt the process, note
that this option can only preserve trace data acquired since the last
time the target was halted, rather than all of the data acquired since
the last time data was retrieved.
112
MULTI: Configuring Connections for V850 and RH850 Targets

---

V850E/V850E2R RTE Target-Specific Options
Option
Description
Trigger Position
Specifies the desired position of the Delay Trace trigger in the trace
buffer, after trace has stopped. Last means trace will stop very soon
after hitting the trigger (so the trigger will end up being near to the
last thing in the trace buffer). First means trace will continue to be
collected until the trigger is near the beginning of the buffer. Middle
means trace continues to be collected until half of the buffer has
been filled.
This option is only available if a Delay Trace trigger has been set
up.
Note
Not all combinations of trace packets are valid. The user interface prevents
you from selecting invalid combinations by dimming options that you
cannot change given the current combination of settings.
V850E/V850E2R RTE Target-Specific Options
Each option in the RTE Trace Options and RTE Trace Options (V850E2R)
windows is described in the table below.
Green Hills Software
113

---

Appendix B. Target-Specific Trace Options and Triggers
Option
Description
Board
Lists boards for which MULTI knows the trace stream format.
Choose your board from the drop-down menu, and the relevant trace
stream format options are selected for you in the RTE Trace Options
window. If your board is not listed, select Custom.
This option is only available in the RTE Trace Options window.
Clock multiplier
Controls the speed at which the target runs the trace clock. Options
are listed as fractions of the CPU clock speed.
Data rate
Controls whether the target outputs trace data on a single clock edge
(SDR) or on both clock edges (DDR).
Number of data pins
Specifies the number of trace data pins that the target uses to output
trace data.
Packet version
Specifies the target's trace packet format version.
This option is only available in the RTE Trace Options window.
Sub-switch on
Controls what kind of trace packets the target outputs when the
sub-switch is on:
• PC — Enables basic program counter (PC) trace packets for
branches and jumps.
• Data Read — Enables data/address trace packets for memory
reads.
• Data Write — Enables data/address trace packets for memory
writes.
Sub-switch off
Controls what kind of trace packets the target outputs when the
sub-switch is off:
• PC — Enables basic program counter (PC) trace packets for
branches and jumps.
• Data Read — Enables data/address trace packets for memory
reads.
• Data Write — Enables data/address trace packets for memory
writes.
DMA read
Enables DMA read trace packets.
This option is only available in the RTE Trace Options (V850E2R)
window.
114
MULTI: Configuring Connections for V850 and RH850 Targets

---

V850E/V850E2R RTE Target-Specific Options
Option
Description
DMA write
Enables DMA write trace packets.
This option is only available in the RTE Trace Options (V850E2R)
window.
Use real-time trace
Enables real-time trace mode. In this mode, some trace packets may
mode
be lost, but the core executes at the same speed as it would if trace
was disabled. When you disable this option, no trace packets are
lost, but the core may stall occasionally.
Use timestamps
Enables timestamps. When timestamps are enabled, the trace
collection device records a timestamp with each packet. Timestamps
are displayed in the Trace List and are used by the MULTI Profile
window, PathAnalyzer, and EventAnalyzer. Timestamps are not
synchronized across cores on multi-core targets.
Use trigger GUI
Enables the trigger GUI. For simple events, such as executing a
function, the GUI is sufficient. However, the Midas ICE also supports
some sophisticated event configuration that does not map well onto
an abstract GUI. If you need access to more advanced features, you
can clear this box and control all events by using debug server
commands such as eve and evt.
Time resolution (ns)
Specifies the time resolution of trace packet timestamps.
This option is only available in the RTE Trace Options (V850E2R)
window.
The amount of data that the SuperTrace Probe can handle at one time is limited.
Due to fast trace clock speeds, some V850E targets may exceed this data limit. The
following two tables list the maximum trace clock speed supported for each
combination of settings.
Green Hills Software
115

---

Appendix B. Target-Specific Trace Options and Triggers
If Use timestamps is cleared (off):
# Data Pins
SDR Max Clock Speed
DDR Max Clock Speed
4
300 MHz
300 MHz
8
300 MHz
300 MHz
16
300 MHz
187 MHz
24
249 MHz
125 MHz
If Use timestamps is selected (on):
# Data Pins
SDR Max Clock Speed
DDR Max Clock Speed
4
266 MHz
266 MHz
8
249 MHz
187 MHz
16
187 MHz
125 MHz
24
249 MHz
125 MHz
V850 Target-Specific Trace Triggers
The following table lists V850-specific trace triggers:
Event
Description
Target Support
Section
Starts trace collection at the hardware level.
V850E RTE
Sub-Switch
When the conditions you set for this event
On
are true, the target turns the section
sub-switch on. By default, the target emits
trace packets when the sub-switch is on.
Section
Stops trace collection at the hardware level.
V850E RTE
Sub-Switch
When the conditions you set for this event
Off
are true, the target turns the section
sub-switch off. By default, the target does
not emit trace packets when the sub-switch
is off.
Qualify Sub
Filters out unwanted trace data at the
V850E RTE
Switch
hardware level. Trace data is only emitted
if this event is active and if trace has been
enabled by the Section Sub-Switch On
event.
116
MULTI: Configuring Connections for V850 and RH850 Targets

---

V850 Target-Specific Trace Triggers
Event
Description
Target Support
Start Trace
Starts trace collection at the hardware level.
V850E IECUBE, V850E2RV3
When the conditions you set for this event
IECUBE2
are true, the core starts emitting trace
packets.
Stop Trace
Stops trace collection at the hardware level.
V850E IECUBE, V850E2RV3
When the conditions you set for this event
IECUBE2
are true, the core stops emitting trace
packets.
Qualify Trace
Filters out unwanted trace data at the
V850E IECUBE, V850E2RV3
hardware level. Trace data is only emitted
IECUBE2
if this event is active and if trace has been
enabled by the Start Trace event.
Delay Trace
Stops trace collection (and optionally stops
V850E2RV3 IECUBE2
execution) after the trigger is hit. The
behavior of this trigger can be configured
with the When Delay Trigger is Hit and
Delay Trigger Position options.
Green Hills Software
117

---

---

Index
B
B command
for 850eserv2, 37, 40
-baud option
for monserv, 13
baud rate, specifying
for Green Hills Monitor, 11, 13
bpstat command
for dbgcomm, 73
for rteserv2, 73
Symbols
BRA command
for 850eserv2, 37, 41
-2m option
example, 62
for 850eserv2, 30
breaks
850eserv2 debug server
setting, 40
additional setup and configuration
BRS command
Windows, 20
for 850eserv2, 37, 42
commands (see commands, 850eserv2)
-bsp option
connecting with, 23
for 850eserv2, 30
connection command syntax, 29
-bss option
Connection Editor, 24
for monserv, 14
Custom Connection Method, 29
.bss sections
examples, 33
legacy debug scripts, 93, 94
error messages, 35
bus event detectors
installing, 20
setting, 41
options (see options, 850eserv2)
Standard Connection Method, 24
C
starting, 23
target system requirements, 20
-cdnw option
troubleshooting, 34, 35
for 850eserv2, 30
Windows definition files, 21
checked address range
850win command
for legacy debug scripts, 91, 94
for 850eserv2, 38
CLOCK command
for 850eserv2, 38, 43
A
close command
for legacy debug scripts, 91
A command
code assembly, 39
for 850eserv2, 36, 39
COMBO breaks
example, 61
displaying status, 43
addressof command
COMBO command
for legacy debug scripts, 90
for 850eserv2, 38, 43
alloc command
commands
for simrh850, 84
850eserv2, 36, 39
amask command
850win, 38
for legacy debug scripts, 90
A, 36, 39
arrays
B, 37, 40
for legacy debug scripts, 98
BRA, 37, 41
assembling code, 39
BRS, 37, 42
assignments
CLOCK, 38, 43
in legacy debug scripts, 98
COMBO, 38, 43
CPU, 38, 44

---

commands (continued)
data and register commands, 36
fprint, 91
emulator configuration, 38
fprintb, 91
event, trigger, and trace setting, 37
fread, 91
execution commands, 37
freadb, 91
HELP, 38, 44
getenv, 91
IEPORT0, 38, 44
halt, 91
IEPORT1, 38, 44
help, 92
LINK, 45
listrange, 92
LOG, 38, 46
listvars, 92
M, 36, 47
load, 93
MAP, 38, 48
m, 93
MODE, 38, 49
nofail, 93
NOHALT, 38, 49
noload, 94
NOLOAD, 38, 49
open, 94
other, 38
print, 94
PIN, 38, 50
random, 94
PINMASK, 38, 50
run, 94
POWER, 38, 50
script, 94
PROFILE, 38, 51
setrange, 94
REG, 36, 51
setup, 95, 96
RMEM, 39, 52
sleep, 95
RRAMBASE, 39, 52
status, 95
RST, 37, 52
step, 95
SA, 37, 53
stepint, 95
SFR, 36, 53
undef, 95
SHOWALL, 37, 53
MULTI Debugger
T, 37, 54
target, 36, 39, 73, 84
TD, 37, 55
rteserv2, 73, 74, 75
TDISPLAY, 37, 55
bpstat, 73
TF, 37, 56
dbgcomm, 73
TFILTER, 37, 56
debug, 73
TIMEBASE, 39, 57
env, 75
TIMER, 39, 57
help, 74, 75
TMODE, 37, 58
inb, 74
trace display, 37
info, 73
TRACE, 37, 54
inh, 74
TRUN, 37, 58
init, 74, 75
TS, 37, 58
inw, 74
TSEARCH, 38, 59
map, 75
TSTOP, 37, 58
nc, 75
U, 36, 60
ncd, 75
VERIFY, 39, 60
nolaod, 73
for the Multi-core Simulator for V850 and RH850
outb, 74
(simrh850), 84
outh, 74
legacy debug scripts, 90
outw, 74
addressof, 90
reset, 75
amask, 90
rrm, 75
close, 91
rrmb, 75
debug, 91
sfr, 75, 76
delrange, 91
timer, 76
delrangeall, 91
ver, 76
120
MULTI: Configuring Connections for V850 and RH850 Targets

---

commands (continued)
simrh850
.data sections
alloc, 84
legacy debug scripts, 93, 94
freq, 84
-dbreak option
help, 84
for monserv, 14
memmap, 84
.dbs setup scripts (see board setup scripts)
snooze, 84
-dck20 option
stepcount, 84
for 850eserv2, 31
threads, 85
debug command
conditionals
for legacy debug scripts, 91
for legacy debug scripts, 99
for rteserv2, 73
connecting MULTI to your target, viii
-debug option
(see also Connection Editor)
for monserv, 14, 15
(see also Connection Methods)
debug server commands (see commands)
list of supported V850 and RH850 targets, viii
hpserv, 84
overview, viii
debug servers
using a Green Hills Monitor, 8
logging connections, 3
Connection Editor
monserv, 8
Green Hills Monitor (monserv), 9, 10, 11, 12
options (see options)
Multi-core Simulator for V850 and RH850 (simrh850)
role of, viii
connection settings, 81
rteserv2, 68
debug settings, 81
debugging interfaces
Renesas V850/V850E ICE (850eserv2), 24
list of supported, viii
RTE (rteserv2), 71
debugging level, specifying
debug settings, 71
for Green Hills Monitor, 14, 15
sections and fields of, 2
definition files
simrh850 Simulator, 79
for Renesas V850/850E ICE connections, 21
Connection Methods
delrange command
Custom
for legacy debug scripts, 91
Green Hills Monitor (monserv), 13, 14, 17
delrangeall command
Renesas V850/V850E ICE (850eserv2), 29
for legacy debug scripts, 91
simrh850 Simulator, 82
-df=device_file option
editing, 2
for 850eserv2, 31
Standard, 2
disassembling object code, 60
Green Hills Monitor (monserv), 9, 10, 11, 12
displaying, 44
Renesas V850/V850E ICE (850eserv2), 24
displaying register values
RTE (rteserv2), 70
changing, 51
V850 and RH850 Multi-core Simulator (simrh850),
displaying, 51
78
displaying settings, 53
conventions
document set, viii, ix
typographical, x
download suppression, 49
CPU
resetting, 52
E
CPU command
-e1jtag option
for 850eserv2, 38, 44
for 850eserv2, 31
-e1lpd option
D
for 850eserv2, 31
-D option
-e1serial option
for 850eserv2, 31
for 850eserv2, 31
data and register commands
-e20jtag option
850eserv2, 36
for 850eserv2, 31
Green Hills Software
121

---

-e20lpd option
-e20lpd option
creating, 9
for 850eserv2, 31
Custom, 13, 14, 17
-e20serial option
editing, 9, 10, 11, 12
for 850eserv2, 31
debugging level, specifying, 14, 15
echo command
halt signal, specifying, 12, 14, 15
for legacy debug scripts, 91
logging host-target communications, 13
emulator configuration commands, 38
options (see options, monserv)
emulator memory configuration, 48
overview, 8
env command
program sections, which to download, 12, 14, 15
for rteserv2, 75
serial port, specifying, 11, 13
-env=env_vars option
for 850eserv2, 31
H
error messages
halt command
850eserv2 connections, 35
for legacy debug scripts, 91
Renesas V850/V850E ICE connections, 35
halt signal, specifying
eval command, 73
for Green Hills Monitor, 12, 14, 15
events
hardware breakpoints, 34
setting with 850eserv2, 37
HELP command
examples
for 850eserv2, 38, 44
Custom Connection Methods
help command
Renesas V850/V850E ICE (850eserv2), 33
for legacy debug scripts, 92
legacy debug scripts, 101
for rteserv2, 74, 75
execution commands, 37
for simrh850, 84
execution event detectors
setting, 42
I
execution time, 76
-I option
expressions
for 850eserv2, 31
legacy debug scripts, 97
-id key option
F
for 850eserv2, 31
-iecube option
fprint command
for 850eserv2, 32
for legacy debug scripts, 91
IEPORT0 command
fprintb command
for 850eserv2, 38, 44
for legacy debug scripts, 91
IEPORT1 command
fread command
for 850eserv2, 38, 44
for legacy debug scripts, 91
inb command
freadb command
for rteserv2, 74
for legacy debug scripts, 91
info command
freq command
for rteserv2, 73
for simrh850, 84
inh command
for rteserv2, 74
G
init command
getenv command
for rteserv2, 74, 75
for legacy debug scripts, 91
initializing the target, 74, 75
Green Hills Monitor, 8
installation
(see also monserv debug server)
Renesas V850/V850E ICE, 20
baud rate, specifying, 11, 13
RTE, 68
connecting MULTI to, 8
V850 and RH850 (simrh850) Multi-core Simulator, 78
Connection Editor, 9, 10, 11, 12
INTEGRITY Real-Time Operating System (RTOS), ix
Connection Methods
interrupts, enabling and disabling, 95
122
MULTI: Configuring Connections for V850 and RH850 Targets

---

inw command
inw command
for rteserv2, 75
for rteserv2, 74
masked processor pins, 50
.mbs setup scripts (see board setup scripts)
L
memmap command
legacy debug scripts
for simrh850, 84
arrays, 98
memory
assignments, 98
changing, 47
.bss sections, 93, 94
displaying, 47
conditionals, 99
memory mapping, 75
.data sections, 93, 94
-minicube option, 32
examples, 101
-minicube2 option
expressions, 97
for 850eserv2, 32
loops, 99
MODE command
running, 96
for 850eserv2, 38, 49
.text sections, 93, 94
monitors, 8
variables
(see also Green Hills Monitor)
declaring, 97
monserv debug server, 8
expansion, 100
(see also Green Hills Monitor)
type, 97
role of, 8
writing, 96
MULTI
LINK command
document set, ix
for 850eserv2, 45
exiting without reset, 49
example, 62
Multi-core Simulator for V850 and RH850 (simrh850)
linking events with a sequencer, 45
commands, 84
Linux targets, ix
simulation modes, 85
listrange command
for legacy debug scripts, 92
N
listvars command
nc command
for legacy debug scripts, 92
for rteserv2, 75
load command
ncd command
for legacy debug scripts, 93
for rteserv2, 75
-loadall option
-nobss option
for monserv, 14
for monserv, 14
LOG command
-nodata option
for 850eserv2, 38, 46
for monserv, 14
logging, 73
nofail command
debug server connections, 3
for legacy debug scripts, 93
logging host-target communications
NOHALT command
for Green Hills Monitor, 13
for 850eserv2, 38, 49
loops
-noiop option
for legacy debug scripts, 99
for 850eserv2, 32
NOLOAD command
M
for 850eserv2, 38, 49
M command
noload command
for 850eserv2, 36, 47
for legacy debug scripts, 94
m command
for rteserv2, 73
for legacy debug scripts, 93, 100
-noload option
MAP command
for monserv, 15
for 850eserv2, 38, 48
-notext option
map command
for monserv, 15
Green Hills Software
123

---

open command
O
P
open command
-p port option
for legacy debug scripts, 94
for 850eserv2, 32
options
PIN command
850eserv2, 30
for 850eserv2, 38, 50
-2m, 30
PINMASK command
-bsp, 30
for 850eserv2, 38, 50
-cdnw, 30
POWER command
-D, 31
for 850eserv2, 38, 50
-dck20, 31
print command
-df=device_file, 31
for legacy debug scripts, 94
-e1jtag, 31
PROFILE command
-e1lpd, 31
for 850eserv2, 38, 51
-e1serial, 31
profiling
-e20jtag, 31
simulator frequency, 85
-e20lpd, 31
profiling support, 51
-e20serial, 31
program sections
-env=env_vars, 31
download, specifying which to
-I, 31
for Green Hills Monitor, 12, 14, 15
-id key, 31
-iecube, 32
R
-minicube2, 32
RAM, 44
-noiop, 32
random command
-p port, 32
for legacy debug scripts, 94
-server, 32
REG command
-stp ip_address, 32
for 850eserv2, 36, 51
-t3v, 32
example, 62
-t5v, 32
Renesas RH850 trace options, 111
-usb, 33
Renesas V850/850E ICE
-X0, 33
target system requirements, 20
monserv
Renesas V850/V850E ICE
-baud, 13
additional setup and configuration
-bss, 14
Windows, 20
-dbreak, 14
commands, 39
-debug, 14, 15
data and register, 36
-loadall, 14
emulator configuration, 38
-nobss, 14
event, trigger, and trace setting, 37
-nodata, 14
execution, 37
-noload, 15
other, 38
-notext, 15
trace display, 37
-sp, 13
connecting to, 23
-zbreak, 15
Connection Editor, 24
OS targets, ix
Custom Connection Method, 29
OSE targets, ix
examples, 33
outb command
error messages, 35
for rteserv2, 74
installing, 20
outh command
options (see options, 850eserv2)
for rteserv2, 74
Standard Connection Method, 24
outw command
troubleshooting, 34, 35
for rteserv2, 74
Renesas V850E IECUBE trace options, 106
124
MULTI: Configuring Connections for V850 and RH850 Targets

---

Renesas V850E2RV3 IECUBE2 trace options
Renesas V850E2RV3 IECUBE2 trace options, 108
(see also board setup scripts)
reset command
serial port, specifying
for rteserv2, 75
for Green Hills Monitor, 11, 13
resetting the CPU, 52
-server option
RMEM command
for 850eserv2, 32
for 850eserv2, 39, 52
setrange command
ROM, 44
for legacy debug scripts, 94
-rom option, 87
setup command
-rom_use_entry option, 87
for legacy debug scripts, 95, 96
RRAMBASE command
-setup option
for 850eserv2, 39, 52
for all debug servers, 96
rrm command
SFR command
for rteserv2, 75
for 850eserv2, 36, 53
rrmb command
example, 63
for rteserv2, 75
sfr command
RST command
for rteserv2, 75, 76
for 850eserv2, 37, 52
SFR values
RTE
displaying, 53
checking, 68
SHOWALL command
commands, 74, 75
for 850eserv2, 37, 53
commands for specific RTEs, 74
simrh850 Multi-core Simulator
connecting to, 70
connecting to, 78
Connection Editor, 71
installing, 78
debug settings, 71
Standard Connection Method, 78
installing, 68
simrh850 Simulator
setting up, 68
Connection Editor, 79
Standard Connection Method, 70
connection settings, 81
troubleshooting, 69
debug settings, 81
RTE (Real-Time Evaluator), 68
Custom Connection Method, 82
RTE-V851-IE, 76
features, 78
rteserv2 debug server, 68
simulated processors, 78
commands (see commands, rteserv2)
simulated processors
connecting with, 70
with V850 and RH850 (simrh850) Multi-core Simulator,
Connection Editor, 71
78
debug settings, 71
simulation modes, 85
installing, 68
simulator
Standard Connection Method, 70
profiling frequency, 85
starting, 70
simulators
run command
connecting to
for legacy debug scripts, 94
V850 and RH850 (simrh850) Multi-core Simulator,
running legacy debug scripts, 96
78
features
S
simrh850, 78
SA command
installing
for 850eserv2, 37, 53
V850 and RH850 (simrh850), 78
script command
supported by MULTI, viii
for legacy debug scripts, 94, 96
sleep command
scripting language
for legacy debug scripts, 95
monserv, 96, 97
snooze command
scripts, 4
for simrh850, 84
-sp option
Green Hills Software
125

---

-sp option (continued)
for monserv, 13
threads command
Standard Connection Methods, 2
for simrh850, 85
status command
ThreadX targets, ix
for legacy debug scripts, 95
TIMEBASE command
step command
for 850eserv2, 39, 57
for legacy debug scripts, 95
TIMER command
stepcount command
for 850eserv2, 39, 57
for simrh850, 84
timer command
stepint command
for rteserv2, 76
for legacy debug scripts, 95
TMODE command
-stp ip_address option
for 850eserv2, 37, 58
for 850eserv2, 32
trace, 73
system requirements (see targets)
Renesas RH850 trace options, 111
Renesas V850E IECUBE trace options, 106
T
Renesas V850E2RV3 IECUBE2 trace options, 108
T command
setting with 850eserv2, 37
for 850eserv2, 37, 54
targets
example, 63
configuring, 106, 108, 111, 113
-t3v option
V850E RTE trace options, 113
for 850eserv2, 32
V850E2R RTE trace options, 113
-t5v option
trace analyzer, 53
for 850eserv2, 32
halting, 58
target command
restarting, 58
for MULTI Debugger, 36, 39, 73, 84
trace buffer
target connections
displaying, 55
Renesas V850/V850E ICE, 23
filtering, 56
RTE, 70
tracing, 59
V850 and RH850 (simrh850) Multi-core Simulator, 78
TRACE command
target system requirements
for 850eserv2, 37, 54
850eserv2 debug server, 20
example, 63
Renesas V850/V850E ICE, 20
trace commands
targets
displaying, 56
Green Hills Monitor, 8
trace data
list of supported, viii
displaying, 55, 58
OS, ix
trace display
TD command
commands, 37
for 850eserv2, 37, 55
status codes, 66
example, 64
tracing, 54
TDISPLAY command
troubleshooting
for 850eserv2, 37, 55
850eserv2 connections, 34, 35
example, 64
Renesas V850/V850E ICE connections, 34, 35
.text sections
TRUN command
legacy debug scripting, 93
for 850eserv2, 37, 58
legacy debug scripts, 94
TS command
TF command
for 850eserv2, 37, 58
for 850eserv2, 37, 56
TSEARCH command
example, 64
for 850eserv2, 38, 59
TFILTER command
TSERCH command
for 850eserv2, 37, 56
for 850eserv2
example, 64
example, 65
TSTOP command
126
MULTI: Configuring Connections for V850 and RH850 Targets

---

TSTOP command (continued)
for 850eserv2, 37, 58
typographical conventions, x
U
U command
for 850eserv2, 36, 60
undef command, 99
for legacy debug scripts, 95
-usb option
for 850eserv2, 33
V
V850 and RH850 (simrh850) Multi-core Simulator
connecting to, 78
features, 78
installing, 78
simulated processors, 78
V850E RTE trace options, 113
V850E2R RTE trace options, 113
ver command, 75
for rteserv2, 76
VERIFY command, 60
for 850eserv2, 39
version, 75, 76
W
Windows definition files, 21
writing legacy debug scripts, 96
X
-X0 option
for 850eserv2, 33
Z
-zbreak option
for monserv, 15
Green Hills Software
127

---

---

Document Outline

• MULTI: Configuring Connections for V850 and RH850 Targets
• Contents
• Preface
  • About This Book
    • Supported Target Connections for V850 and RH850
  • The MULTI Document Set
  • Conventions Used in the MULTI Document Set
• Chapter 1. Using the Connection Editor
  • General Information Settings
  • Target-Specific Tabs
  • The Command Line Viewer
  • Action Buttons
• Chapter 2. Green Hills Monitor (monserv) Connections
  • Supported Features for Green Hills Monitor (monserv) Connections
  • Connecting to Your Target with a Green Hills Monitor
    • Creating a Standard Green Hills Monitor (monserv) Connection Method
    • Using the Green Hills Monitor (monserv) Connection Editor
      • Green Hills Monitor (monserv) Connection Settings
      • Green Hills Monitor (monserv) Advanced Settings
      • Green Hills Monitor (monserv) Debug Settings
    • Using Custom Green Hills Monitor (monserv) Connection Methods
      • Other Options for Custom Green Hills Monitor (monserv) Connection Methods
      • Example Custom Green Hills Monitor (monserv) Connection Methods
• Chapter 3. Renesas V850/V850E ICE (850eserv2) Connections
  • Target System Requirements
  • Installing Your Renesas V850/V850E ICE
  • Additional Windows Setup and Configuration
    • Required Definition File for Network V850/V850E Interfaces
    • Using the Green Hills SuperTrace Probe to Collect Real-time Trace Data
      • Connecting the SuperTrace Probe to an Renesas IE Cube
      • Configuring the SuperTrace Probe
      • Collecting Trace Data
  • Connecting to Your Target with an Renesas V850/V850E ICE
    • Creating a Standard Renesas V850/V850E ICE (850eserv2) Connection Method
    • Using the Renesas V850/V850E ICE (850eserv2) Connection Editor
      • Renesas V850/V850E ICE (850eserv2) Connection Settings
      • Renesas V850/V850E ICE Clock Settings
      • Renesas V850/V850E ICE (850eserv2) Advanced Settings
      • Renesas V850/V850E ICE (850eserv2) Debug Settings
    • Using Custom Renesas V850/V850E ICE (850eserv2) Connection Methods
      • Options for Custom Renesas V850/V850E ICE (850eserv2) Connection Methods
      • Example Custom Renesas V850/V850E ICE (850eserv2) Connection Methods
  • Connecting Through a Remote Server (850eserv2_server)
  • Hardware Breakpoints
  • Troubleshooting
    • General Troubleshooting Checklist
    • Error Messages
  • Target Commands for Renesas V850/V850E ICE (850eserv2) Connections
    • Data and Register Commands
    • Execution Command
    • Event, Trigger, and Trace Setting Commands
    • Trace Display Commands
    • Emulator Configuration Commands
    • Other Commands
    • Target Command Descriptions
      • Additional Examples of 850eserv2 Target Commands
      • Trace Display Status Codes
• Chapter 4. RTE (rteserv2) Connections
  • Supported Targets for RTE (rteserv2) Connections
  • Installing Your RTE
    • Checking Your RTE Connection
    • Using the Green Hills SuperTrace Probe to Collect Real-time Trace Data
    • Connecting the SuperTrace Probe to a Midas RTE Cube
    • Collecting Trace Data
  • Connecting to a RTE Target
    • Creating a Standard RTE (rteserv2) Connection Method
    • Using the RTE (rteserv2) Connection Editor
  • Commands for RTE (rteserv2) Connections
    • General rteserv2 Commands
    • Commands for Specific RTEs
      • RTE-V821-PC
      • RTE-V851-IE
• Chapter 5. Multi-core Simulator for V850 and RH850 (simrh850) Connections
  • Installing the Multi-core Simulator for V850 and RH850 (simrh850)
  • Connecting to the Multi-Core Simulator for V850 and RH850 (simrh850)
    • Creating a Multi-core Simulator for V850 and RH850 (simrh850) Connection Method
    • Using the Multi-core Simulator for V850 and RH850 (simrh850) Connection Editor
      • Multi-core Simulator for V850 and RH850 (simrh850) Connection Settings
      • Multi-core Simulator for V850 and RH850 (simrh850) Debug Settings
    • Using Custom Multi-core Simulator for V850 and RH850 (simrh850) Connection Methods
  • Additional Commands for Multi-core Simulator for V850 and RH850 (simrh850) Connections
  • Profiling with simrh850
  • Simulation Modes
    • OS Simulation Mode
    • ROM Mode
  • Unsupported Features
  • Connecting to the Multi-core Simulator for V850 and RH850 (simrh850) as a Stand-alone Debug Server
• Appendix A. Green Hills Debug Server Command and Scripting Reference
  • Green Hills Debug Server Commands
    • Generic Debug Server Commands
    • Additional Debug Server Commands
  • The Green Hills Debug Server Scripting Language
    • General Notes
    • Scripting Syntax
      • Expressions
      • Assignments
      • Arrays
      • Conditionals
      • Loops
      • Variable Expansion
    • Example Scripts
• Appendix B. Target-Specific Trace Options and Triggers
  • Renesas V850E IECUBE Target-Specific Options
  • Renesas V850E2RV3 IECUBE2 Target-Specific Options
  • Renesas RH850 Target-Specific Options
  • V850E/V850E2R RTE Target-Specific Options
  • V850 Target-Specific Trace Triggers
• Index

---