HP 64793 Series User manual

HP 64793
H8/338/329 Emulator
Softkey Interface
User’s Guide
HP Part No. 64793-97002
Printed in U.S.A.
October 1992
Edition 1

Notice Hewlett-Packard makes no warranty of any kind with regard to
this material, including, but not limited to, the implied warranties
of merchantability and fitness for a particular purpose.
Hewlett-Packard shall not be liable for errors contained herein or for
incidental or consequential damages in connection with the furnishing,
performance, or use of this material.
Hewlett-Packard assumes no responsibility for the use or reliability of
its software on equipment that is not furnished by Hewlett-Packard.
Copyright 1992, Hewlett-Packard Company.
This document contains proprietary information, which is protected by
copyright. All rights are reserved. No part of this document may be
photocopied, reproduced or translated to another language without the
prior written consent of Hewlett-Packard Company. The information
contained in this document is subject to change without notice.
UNIX is a registered trademark of AT&T.
Torx is a registered trademark of Camcar Division of Textron, Inc.
Hewlett-Packard Company
Colorado Springs Division
8245 North Union Boulevard
Colorado Springs, CO 80920, U.S.A.

Printing History New editions are complete revisions of the manual. The date on the
title page changes only when a new edition is published.
A software code may be printed before the date; this indicates the
version level of the software product at the time the manual was issued.
Many product updates and fixes do not require manual changes, and
manual corrections may be done without accompanying product
changes. Therefore, do not expect a one-to-one correspondence
between product updates and manual revisions.
Edition 1 64793-97002, October 1992

Using This Manual
This manual introduces you to the following emulators as used with the
Softkey Interface.
HP 64793A H8/338 emulator
HP 64793B H8/329 emulator
Throughout this documentation, the following names are used to
denote the microprocessors listed in the following table of supported
microprocessors.
Model Supported Microprocesorts Reffered to as
HP 64793A (H8/338 emulator) HD6473388CP
HD6433388CP
HD6413388CP
HD6473378CP
HD6433378CP
HD6413378CP
HD6433368CP
H8/338
H8/338
H8/338
H8/337
H8/337
H8/337
H8/336
HP 64793B (H8/329 emulator) HD6473298P
HD6473298C
HD6433298P
HD6413298P
HD6433288P
HD6473278P
HD6473278C
HD6433278P
HD6413278P
HD6433268P
H8/329
H8/329
H8/329
H8/329
H8/328
H8/327
H8/327
H8/327
H8/327
H8/326
For the most part, the H8/329 and H8/338 emulators all operate the
same way. Differences between the emulators are described where they
exist. Both the H8/329 and H8/338 emulators will be referred to as the
"H8/338 emulator". In the specific instances where H8/329 emulator

differs from H8/338 emulator, it will be described as the "H8/329
emulator".
This manual:
Shows you how to use emulation commands by executing
them on a sample program and describing their results.
Shows you how to use the emulator in-circuit (connected to a
target system).
Shows you how to configure the emulator for your
development needs. Topics include: restricting the emulator
to real-time execution, selecting a target system clock source.
This manual does not:
Show you how to use every Softkey Interface command and
option; the Softkey Interface is described in the Softkey
Interface Reference.

Organization
Chapter 1 Introduction. This chapter lists the H8/338 emulator features and
describes how they can help you in developing new hardware and
software.
Chapter 2 Getting Started. This chapter shows you how to use emulation
commands by executing them on a sample program. This chapter
describes the sample program and how to: load programs into the
emulator, map memory, display and modify memory, display registers,
step through programs, run programs, set software breakpoints, search
memory for data, and use the analyzer.
Chapter 3 In-Circuit Emulation. This chapter shows you how to plug the
emulator into a target system, and how to use the "in-circuit" emulation
features.
Chapter 4 Configuring the Emulator. You can configure the emulator to adapt
it to your specific development needs. This chapter describes the
options available when configuring the emulator and how to save and
restore particular configurations.
Chapter 5 Using the Emulator. This chapter describes emulation topics which
are not covered in the "Getting Started" chapter.

Conventions Example commands throughout the manual use the following
conventions:
bold Commands, options, and parts of command syntax.
bold italic Commands, options, and parts of command syntax
which may be entered by pressing softkeys.
normal User specified parts of a command.
$Represents the HP-UX prompt. Commands which
follow the "$" are entered at the HP-UX prompt.
<RETURN> The carriage return key.

Contents
1 Introduction to the H8/338 Emulator
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Purpose of the H8/338 Emulator . . . . . . . . . . . . . . . . . . . 1-1
Features of the H8/338 Emulator . . . . . . . . . . . . . . . . . . . 1-3
Supported Microprocessors . . . . . . . . . . . . . . . . . . . . 1-3
Clock Speeds . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Emulation Memory . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Register Display and Modification . . . . . . . . . . . . . . . 1-4
Single-Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Reset Support . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Real-Time Execution . . . . . . . . . . . . . . . . . . . . . . . 1-5
Limitations, Restrictions . . . . . . . . . . . . . . . . . . . . . . . 1-6
Foreground Monitor . . . . . . . . . . . . . . . . . . . . . . . . 1-6
Monitor Break at Sleep/Standby Mode . . . . . . . . . . . . . . 1-6
Store Condition and Trace . . . . . . . . . . . . . . . . . . . . 1-6
Step Command and Interrupts . . . . . . . . . . . . . . . . . . 1-6
RAM Enable Bit . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
Software Performance Measurement . . . . . . . . . . . . . . . 1-6
2 Getting Started
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
A Look at the Sample Program . . . . . . . . . . . . . . . . . . 2-2
Sample Program Assembly . . . . . . . . . . . . . . . . . . . . 2-6
Linking the Sample Program . . . . . . . . . . . . . . . . . . . 2-6
Generate HP Absolute file . . . . . . . . . . . . . . . . . . . . 2-6
Entering the Softkey Interface . . . . . . . . . . . . . . . . . . . . 2-7
From the "pmon" User Interface . . . . . . . . . . . . . . . . . 2-7
From the HP-UX Shell . . . . . . . . . . . . . . . . . . . . . . 2-8
Using the Default Configuration . . . . . . . . . . . . . . . . . 2-9
On-Line Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Contens - 1

Softkey Driven Help . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Pod Command Help . . . . . . . . . . . . . . . . . . . . . . . 2-10
Loading Absolute Files . . . . . . . . . . . . . . . . . . . . . . . 2-11
Displaying Symbols . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Displaying Memory in Mnemonic Format . . . . . . . . . . . . . 2-13
Displaying Memory with Symbols . . . . . . . . . . . . . . . . . 2-14
Running the Program . . . . . . . . . . . . . . . . . . . . . . . . 2-15
From Transfer Address . . . . . . . . . . . . . . . . . . . . . 2-15
From Reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15
Displaying Memory Repetitively . . . . . . . . . . . . . . . . . . 2-16
Modifying Memory . . . . . . . . . . . . . . . . . . . . . . . . . 2-16
Breaking into the Monitor . . . . . . . . . . . . . . . . . . . . . 2-17
Using Software Breakpoints . . . . . . . . . . . . . . . . . . . . 2-17
Enabling/Disabling Software Breakpoints . . . . . . . . . . . 2-18
Setting a Software Breakpoint . . . . . . . . . . . . . . . . . 2-18
Clearing a Software Breakpoint . . . . . . . . . . . . . . . . . 2-20
Stepping Through the Program . . . . . . . . . . . . . . . . . . . 2-20
Displaying Registers . . . . . . . . . . . . . . . . . . . . . . . . 2-21
Using the Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . 2-22
Specifying a Simple Trigger . . . . . . . . . . . . . . . . . . 2-22
Displaying the Trace . . . . . . . . . . . . . . . . . . . . . . 2-23
Displaying Trace with Time Count Absolute . . . . . . . . . . 2-24
Changing the Trace Depth . . . . . . . . . . . . . . . . . . . 2-25
H8/338 Analysis Status Qualifiers . . . . . . . . . . . . . . . 2-26
Trace Analysis Considerations . . . . . . . . . . . . . . . . . . . 2-27
How to Specify Trigger Condition . . . . . . . . . . . . . . . 2-27
Store Condition and Trace . . . . . . . . . . . . . . . . . . . 2-28
Triggering the Analyzer by Data . . . . . . . . . . . . . . . . 2-30
For a Complete Description . . . . . . . . . . . . . . . . . . . 2-31
Exiting the Softkey Interface . . . . . . . . . . . . . . . . . . . . 2-31
End Release System . . . . . . . . . . . . . . . . . . . . . . . 2-31
Ending to Continue Later . . . . . . . . . . . . . . . . . . . . 2-31
Ending Locked from All Windows . . . . . . . . . . . . . . . 2-31
Selecting the Measurement System Display or
Another Module . . . . . . . . . . . . . . . . . . . . . . . . . 2-32
3 Using the H8/338 Emulator In-Circuit
Installing the Target System Probe . . . . . . . . . . . . . . . . . . 3-2
Pin Guard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
2 - Contents

Pin Protector(H8/329 Only) . . . . . . . . . . . . . . . . . . . 3-3
Installing the Target System Probe . . . . . . . . . . . . . . . . 3-3
Pin State in Background . . . . . . . . . . . . . . . . . . . . . . . 3-5
Target System Interface (H8/338) . . . . . . . . . . . . . . . . . . 3-6
Target System Interface (H8/329) . . . . . . . . . . . . . . . . . . 3-8
In-Circuit Configuration Options . . . . . . . . . . . . . . . . . . 3-10
Running the Emulator from Target Reset . . . . . . . . . . . . . 3-10
4 Configuring the Emulator
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
General Emulator Configuration . . . . . . . . . . . . . . . . . . . 4-3
Micro-processor clock source? . . . . . . . . . . . . . . . . . . 4-3
Enter monitor after configuration? . . . . . . . . . . . . . . . . 4-3
Restrict to real-time runs? . . . . . . . . . . . . . . . . . . . . . 4-4
Memory Configuration . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Mapping memory . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Emulator Pod Configuration . . . . . . . . . . . . . . . . . . . . . 4-7
Processor type? . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
Processor operation mode? . . . . . . . . . . . . . . . . . . . . 4-8
Enable /NMI input from the target system? . . . . . . . . . . . . 4-9
Enable /RES input from the target system? . . . . . . . . . . . . 4-9
Reset value for stack pointer? . . . . . . . . . . . . . . . . . . . 4-9
Debug/Trace Configuration . . . . . . . . . . . . . . . . . . . . 4-10
Break processor on write to ROM? . . . . . . . . . . . . . . . 4-10
Trace background or foreground operation? . . . . . . . . . . 4-10
Simulated I/O Configuration . . . . . . . . . . . . . . . . . . . . 4-11
Interactive Measurement Configuration . . . . . . . . . . . . . . 4-11
External Analyzer Configuration . . . . . . . . . . . . . . . . . . 4-11
Saving a Configuration . . . . . . . . . . . . . . . . . . . . . . . 4-12
Loading a Configuration . . . . . . . . . . . . . . . . . . . . . . 4-12
5 Using the Emulator
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Features Available via Pod Commands . . . . . . . . . . . . . . . 5-2
Using a Command File . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Debugging C Programs . . . . . . . . . . . . . . . . . . . . . . . . 5-4
Displaying Memory with C Sources . . . . . . . . . . . . . . . 5-4
Displaying Trace with C Sources . . . . . . . . . . . . . . . . . 5-4
Stepping C Sources . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Limitations, Restrictions . . . . . . . . . . . . . . . . . . . . . . . 5-5
Foreground Monitor . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Contens - 3