HP 68000 Series User manual

User’s Guide

HP B1466

68000 Series

Debugger/Simulator

Notice

Hewlett-Packard makes no warranty of any kind with regard to this material,

including, but not limited to, the implied warranties of merchantabilityand

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 ofthis material.

Hewlett-Packard assumes no responsibility for the use or reliabilityof its

software on equipment that is not furnished byHewlett-Packard.

This document contains proprietaryinformation, which is protected by

photocopied,reproduced or translated to another language without the prior

written consent of Hewlett-Packard Company. The information contained in

this document issubject to change without notice.

HP-UX 9.* and 10.0 for HP 9000 Series 700 and 800 computers are X/Open

CompanyUNIX 93 branded products.

UNIX® is a registered trademark in the United States and other countries,

licensed exclusivelythrough X/Open CompanyLimited.

Hewlett-Packard Company

P.O . Box 2197

1900 Garden of the Gods Road

Colorado Springs, CO 80901-2197, U.S.A.

RESTRICTED RIGHTS LEGEND Use,duplication, or disclosure bythe U.S.

Government is subject to restrictionsset forth in subparagraph (C) (1) (ii) of

the Rights in Technical Data and Computer Software Clause in DFARS

252.227-7013. Hewlett-Packard Company, 3000 Hanover Street, Palo Alto,

CA 94304 U.S.A.

Rights for non-DOD U.S. Government Departments and Agencies are set

forth in FAR 52.227-19(c)(1,2).

About this edition

Manyproduct updates and fixes do not require manual changes, and manual

correctionsmaybe done without accompanying product changes. Therefore,

do not expect a one-to-one correspondence between product updates and

manual revisions.

Edition dates and the corresponding HP manual part numbers are as follows:

Edition 1 B1466-97003, November 1992

Edition 2 B1466-97004, July 1995

B1466-97003 incorporatesinformation which previouslyappeared in

B1466-92000, B1466-92001, B1466-97000, B1466-97001, B1466-97002,

64360-92003, 64360-97011, 64360-97008, and 64360-97009.

Certification and Warranty

Certification and warrantyinformation can be found at the end ofthismanual

on the pagesbefore the back cover.

iii

Debugging C Programs for

6800x/010/020/3xx Microprocessors

The HP B1466 68000 Series Debugger/Simulator is a debugging tool for

6800x/010/020/3xx microprocessor code. The debugger loads and executes C

programs or assemblylanguage programsusinga simulator on your host

system.

With the Debugger, You Can ...

•Browse and edit C and C+ + source files.

•ViewC and C+ + functions on the stack.

•Monitor variables as the program executes.

•Viewassemblylanguage code with source lines.

•Viewregisters and stack contents.

•Step through programsbyC or C+ + source linesor byassemblylanguage

instructions.

•Stop programs upon the execution of selected instructionsor upon a read

or write ofselected memorylocations.

•Create conditional breakpoints usingmacros.

•Patch C or C+ + code without recompiling.

•Simulate input and output devices using your computer’s keyboard,

display, and file system.

•Tune code byusing the clock cycle count pseudo register to time code

modules during simulation.

•Save and execute command files.

•Log debugger commands and output.

•Examine the inheritance relationships ofC+ + classes.

With the Graphical Interface You Can ...

•Use the debugger under an X WindowSystem that supports OSF/Motif

interfaces.

•Enter debugger commands using pull-down or pop-up menus.

•Set source-level breakpoints using the mouse.

•Create custom action keys for commonlyused debugger commands or

command files.

•Viewsource code,monitored data,registers,stack contents, and backtrace

information in separate windows on the debugger’smain display.

•Access on-line help information.

•Quicklyenter commands using the guided syntaxof the standard interface.

With the Standard Interface You Can ...

•Use the debugger with a terminal or terminal emulator.

•Quicklyenter commands using guided syntax, command recall, and

command editing.

•Viewsource code,monitored data,registers,stack contents, and backtrace

information in separate windows on the debugger’smain display.

•Define your own screensand windows in the debugger’smain display.

•Access on-line help information.

Compatibility with Other Products

The debugger/emulator hasbeen designed to work with HP-UX (version 8.0

or greater), SunOS,or Solaris (see the Installation Notice for version

requirements) and the following Hewlett-Packard language products:

HP B3640, Motorola 68000 FamilyC Cross Compiler, Version 4.00

HP B3641, Motorola 68000 FamilyAssembler, Linker, Librarian,

Version 2.00.

HP B1471, HP 64000-UX Operating Environment Software,Version 6.20.

See the “Loading and Executing Programs” chapter if you are using the

Microteclanguage tools.

In This Book

This book is organized into five parts:

Part 1. Quick Start Guide

An overviewofthe debugger and a short lesson to get you started.

Part 2. User’s Guide

Howto use the debugger to solve your problems.

Part 3. Concept Guide

Conceptual information on CPU simulation and on X resources.

Part 4. Reference

Descriptions of what each debugger command does,details of how the

debugger works, and a list of error messages.

Part 5. Installation

Howto install the debugger software on your computer.

Contents

Part 1 Quick Start Guide

1 Getting Started with the Graphical Interface

The GraphicalInterface at a Glance 5

Pointer and cursor shapes 5

The Debugger Window 6

Graphical Interface Conventions 8

Mouse Buttons 9

Platform Differences 10

The Quick Start Tutorial 11

The Demonstration Program 11

To prepare to run the debugger 12

To start the debugger 13

To activate displayarea windows 14

To run until main() 15

To scroll the Code window 16

To displaya function 17

To run until a line 18

To edit the program 19

To displayinit_system() again 20

To set a breakpoint 20

To run until the breakpoint 21

To patch code usinga macro 22

To delete a single breakpoint 23

To delete all breakpoints 24

To step through a program 25

To run until a stack level 25

To step over functions 26

To step out ofa function 26

To displaythe value of a variable 26

To change the value of a variable 27

vii

To recall an entrybuffer value 28

To displaythe addressof a variable 29

To break on an access to a variable 30

To use the command line 31

To use a C printf command 31

To turn the command line off 32

To see on-line help 33

To end the debugging session 34

Part 2 User’s Guide

2 Entering Debugger Commands

Starting the Debugger 41

Using Menus, the EntryBuffer, and Action Keys 42

To choose a pull-down menu item using the mouse (method 1) 42

To choose a pull-down menu item using the mouse (method 2) 43

To choose a pull-down menu item using the keyboard 44

To choose pop-up menu items 45

To use pop-up menu shortcuts 46

To place values into the entrybuffer using the keyboard 46

To copy-and-paste to the entrybuffer 46

To recall entrybuffer values 48

To edit the entrybuffer 49

To use the entrybuffer 49

To copy-and-paste from the entrybuffer to the command line entryarea 49

To use the action keys 50

To use dialog boxes 51

To access help information 55

Usingthe Command Line with the Mouse 56

To turn the command line on or off 57

To enter a command 58

To edit the command line usingthe command line pushbuttons 59

To edit the command line usingthe command line pop-up menu 60

Contents

viii

To recall commands 60

To get help about the command line 61

To find commands which duplicate a menu selection 61

Usingthe Command Line with the Keyboard 62

To enter debugger commands from the keyboard 62

To edit the command line 64

To recall commands using the command line recall feature 64

To displaythe help window 65

Viewing Debugger Status 67

Debugger Status 67

Indicator Characters 68

CPU Simulated 68

Current Module 68

Last Breakpoint 68

To displayinformation about the debugger version 69

Solving problems with the interface 70

Ifpop-up menusdon’t pop up 70

3 Loading and Executing Programs

Compiling Programs for the Debugger 72

Writing programs for simulation 72

68020 Module Support —CALLM and RTM 72

Using a Hewlett-Packard C Cross Compiler 73

Using Microtec Language Tools 75

Loading Programs and Symbols 78

To specifythe location of C source files 78

To load programs 79

To load program code only 80

To load symbols only 81

To load additional programs 82

To turn demand loading of symbols on or off 83

Stepping Through and Running Programs 84

To step through programs 84

Contents

To step over functions 85

To run from the current program counter (PC) address 86

To run from a start address 86

To run until a stop (break) address 87

To count simulated clock cycles 88

To add simulated wait states 89

Using Breakpoints 90

To set a memoryaccess breakpoint 90

To set an instruction breakpoint 91

To set a breakpoint for a C+ + object instance 92

To set a breakpoint for overloaded C+ + functions 93

To set a breakpoint for C+ + functions in a class 93

To clear selected breakpoints 94

To clear all breakpoints 95

To displaybreakpoint information 96

To halt program execution on return to a stack level 99

UsingSimulated Interrupts 100

To define simulated interrupts 100

To remove simulated interrupts 101

RestartingPrograms 102

To reset the processor 102

To reset the program counter to the startingaddress 102

To reset program variables 103

Savingand Loadingthe CPU State 104

To save the current CPU state 104

MappingMemory 105

To prevent accessto memorylocations 105

To prevent writingto memorylocations 105

To allowaccess to memorylocations 106

To displaycurrent memorymap assignments 106

Accessing Input Ports 108

To set or alter input port status 108

To delete an input port 109

Contents

This manual suits for next models

Table of contents

Other HP Computer Accessories manuals

Popular Computer Accessories manuals by other brands

Motorola

Motorola ATRIX user guide

Cherry

Cherry B.UNLIMITED 3.0 user manual

Logitech

Logitech IO2 user manual

ARM

ARM DSTREAM-ST Getting started guide

Bartec

Bartec TC 7 Series user guide

Philips

Philips SPC3540 Specifications

Logitech

Logitech mk220 user manual

SilverStone

SilverStone LC02 manual

Flexispot

Flexispot ML2B installation guide

Hamlet

Hamlet UNIVERSAL COVER 101 KBT2 user manual

Adam Equipment

Adam Equipment RS-485 manual 

Vivo

Vivo MOUNT-KB05-4DW instruction manual

Kvaser

Kvaser Memorator Professional user guide

DRC

DRC D-Imaging user manual

Sven

Sven Base 305 сombo instructions

Hama

Hama 108310 Operating instruction

SpeechWare

SpeechWare FlexyMike FMK03 user manual

Sony

Sony Vaio VGP-FL10 operating instructions