ARM Debugger Version 1.6 Manual do Utilizador

Copyright © 2002 ARM Limited. All rights reserved.ARM DUI 0181BRealView™ DebuggerVersion 1.6Essentials Guide

Preface x Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BContact information for MaxCore from AXYS is available at:http://www.axysdes

RealView Debugger Desktop 6-14 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BDebug Displays the Debug menu shown in Figure 6-12.Fig

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-156.3 Working with button toolbarsThe Code window toolbar

RealView Debugger Desktop 6-16 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BUsed during a multiprocessor debugging session, click t

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-17Find: This field enables you to perform a quick text s

RealView Debugger Desktop 6-18 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BIf you customize a toolbar, this persists to any new Co

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-196.4 Working in the Code windowThis section describes ho

RealView Debugger Desktop 6-20 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BIf you double left-click in a pane entry, for example o

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-216.4.4 Working with tabsYou can access RealView Debugger

RealView Debugger Desktop 6-22 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B6.5 Editor windowRealView Debugger includes a range of

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-236.6 Resource Viewer windowThe Resource Viewer gives acc

Preface ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. xiFeedbackARM Limited welcomes feedback on both RealView Debugger and its doc

RealView Debugger Desktop 6-24 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B6.6.1 File menuThis menu contains:Update List Rereads

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-256.6.3 Resources listThe Resources list box displays all

RealView Debugger Desktop 6-26 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B6.7 Analysis windowRealView Debugger includes Trace, An

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. A-1Appendix A Configuration Files ReferenceThis appendix describes the files set up f

Configuration Files Reference A-2 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BA.1 OverviewRealView Debugger v1.6 creates files con

Configuration Files Reference ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. A-3A.2 Files in the etc directoryWhen you install RealV

Configuration Files Reference A-4 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BDo not edit this file manually.template.spr SPR tem

Configuration Files Reference ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. A-5A.3 Files in the home directoryWhen you install and

Configuration Files Reference A-6 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B*.bcd Board/chip definition files that you might ha

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. Glossary-1GlossaryThe items in this glossary are listed in alphabetical order, with a

Preface xii Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B

Glossary Glossary-2 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BAXYS Oak simulator The AXYS Oak MaxSim simulator provides a high-

Glossary ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. Glossary-3Hardware breakpoint A breakpoint that is implemented using non-int

Glossary Glossary-4 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BRealView Compilation Tools RealView Compilation Tools is a suite o

Glossary ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. Glossary-5Software Interrupt (SWI) An instruction that causes the processor

Glossary Glossary-6 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BTVS See Target Vehicle Server.Watch A watch is a variable or expr

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. Index-1IndexThe items in this index are listed in alphabetical order, with symbols an

IndexIndex-2 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BMain menu 6-11NUM 6-10pane controls 6-8panes 6-5Resource Viewer

IndexARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. Index-3on documentation xion RealView Debugger xiFile EditorFile Editor pane

IndexIndex-4 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181Bbinding 4-11bound 6-4build errors 4-33build tools 4-4, 4-29buildi

IndexARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. Index-5setting watches 4-21using browsers 4-21using the call stack 4-20usi

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 1-1Chapter 1 About RealView DebuggerThis chapter introduces RealView Debugger. It exp

IndexIndex-6 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B

About RealView Debugger 1-2 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B1.1 RealView DebuggerRealView Debugger enables you to debu

About RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 1-3Multithreaded operation RTOS processes can share the memor

About RealView Debugger 1-4 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B1.2 About the debugging environmentRealView Debugger uses

About RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 1-5RealView Connection Broker RealView Connection Broker oper

About RealView Debugger 1-6 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B1.3 Debugging modeThe base installation of RealView Debugg

About RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 1-71.4 Using the documentation suiteThe RealView Debugger doc

ii Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BRealView DebuggerEssentials GuideCopyright © 2002 ARM Limited. All rights reserved

About RealView Debugger 1-8 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 2-1Chapter 2 Features of RealView DebuggerThis chapter describes the features of Real

Features of RealView Debugger 2-2 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B2.1 RealView Debugger v1.6RealView Debugger v1.6 pro

Features of RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 2-3• There is now support for module statics, that is s

Features of RealView Debugger 2-4 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B• viewing disassembly trace• tracing of function cal

Features of RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 2-52.2 Getting more information onlineThe full document

Features of RealView Debugger 2-6 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 3-1Chapter 3 Getting Started with RealView DebuggerThis chapter gives step-by-step in

Getting Started with RealView Debugger 3-2 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B3.1 Starting RealView DebuggerTo start your

Getting Started with RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 3-3Figure 3-1 Code windowThe appearance of the

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. iiiContentsRealView Debugger Essentials GuidePrefaceAbout this book ...

Getting Started with RealView Debugger 3-4 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B3.2 Connecting to a targetThe next stage in

Getting Started with RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 3-5Figure 3-2 Connection Control windowThis wi

Getting Started with RealView Debugger 3-6 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B• panes are updated with debug information,

Getting Started with RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 3-73.3 Working with memoryBefore you load an i

Getting Started with RealView Debugger 3-8 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B3.3.2 Setting top of memory for a sessionIf

Getting Started with RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 3-9Figure 3-4 Changed settings in the Register

Getting Started with RealView Debugger 3-10 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B3.4 Loading an imageWhen you have connecte

Getting Started with RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 3-11Figure 3-5 Code window with an image loade

Getting Started with RealView Debugger 3-12 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B3.4.2 What is shown in the title bar?The C

Getting Started with RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 3-133.4.4 Unloading an imageYou do not have to

Contentsiv Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BChapter 4 Quick-start Tutorial4.1 How to use the tutorial ...

Getting Started with RealView Debugger 3-14 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B3.5 Debugging an imageChapter 4 Quick-star

Getting Started with RealView Debugger ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 3-158. To start execution either:• Select Debu

Getting Started with RealView Debugger 3-16 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-1Chapter 4 Quick-start TutorialThis chapter provides a step-by-step tutorial using

Quick-start Tutorial 4-2 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B4.1 How to use the tutorialThe tutorial starts by setting up

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-34.2 Setting up your first projectRealView Debugger enables yo

Quick-start Tutorial 4-4 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B4.2.1 Defining your build toolsRealView Debugger provides sup

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-5Note For details on how to change your build tools see Changi

Quick-start Tutorial 4-6 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B• image name.To define the project:1. Click on the down arrow

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-74.2.4 Viewing the project settingsWhen you close the Create S

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. vPrefaceThis preface introduces the RealView Debugger Essentials Guide. This guide sh

Quick-start Tutorial 4-8 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BTo do this you must change a project setting:1. Select Projec

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-94.2.6 Project base directoryWhen the new project setup is com

Quick-start Tutorial 4-10 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B4.2.8 Project filesThe project you have just created is a si

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-11Executable filesBy default, the executable image created in

Quick-start Tutorial 4-12 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BNote If you have loaded the image created by your project, R

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-134.3 Debugging with RealView DebuggerThis section gives you s

Quick-start Tutorial 4-14 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B4.3.2 Basic debugging tasksIn your debugging session RealVie

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-15The Register pane displays tabs appropriate to the target pr

Quick-start Tutorial 4-16 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BIn this example, the value can also be changed by selecting

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-17An auto-project is a custom, image control, project that hol

Preface vi Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BAbout this bookRealView Debugger provides a powerful tool for debugging and

Quick-start Tutorial 4-18 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BFigure 4-9 Updated memory contentsClick on the Pane menu aga

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-19Displaying variablesTo display the value of a variable from

Quick-start Tutorial 4-20 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BUsing the call stackThe Call Stack pane enables you to follo

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-21Using browsers and listsRealView Debugger provides lists bro

Quick-start Tutorial 4-22 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B6. Right-click to display the Source Variable Name menu, sho

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-23Complex These breakpoints use advanced hardware support on

Quick-start Tutorial 4-24 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B81 }/* Proc_7 */4. Right-click on the line number and select

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-259. Click OK to close the Set Address/Data Break/Tracepoint d

Quick-start Tutorial 4-26 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BYou can remove entries from the Break/Tracepoints pane. High

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-274.4 Working with custom panesIf you are working in single-pr

Preface ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. viiChapter 4 Quick-start Tutorial Read this chapter when you have access to a

Quick-start Tutorial 4-28 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BFigure 4-14 Example Code windowIn Figure 4-14, line numberin

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-294.5 More about projectsThis section gives more detail on how

Quick-start Tutorial 4-30 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B3. Right-click on the Tool_dir entry and select Edit as Dire

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-31Figure 4-16 Configuration Summary windowThis window contains

Quick-start Tutorial 4-32 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BNote Make sure that the Project Properties window is not ope

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-33Do not make any changes to the generated makefiles as these

Quick-start Tutorial 4-34 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B• places a blue pointer at the error• places the flashing te

Quick-start Tutorial ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 4-354.6 Completing the tutorialBecause the tutorial project is s

Quick-start Tutorial 4-36 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 5-1Chapter 5 Ending your RealView Debugger SessionThis chapter describes how to end y

Preface viii Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BARM publicationsThis book is part of the RealView Debugger documentation

Ending your RealView Debugger Session 5-2 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B5.1 Saving the sessionRealView Debugger stor

Ending your RealView Debugger Session ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 5-3For full details on amending your workspace

Ending your RealView Debugger Session 5-4 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B5.1.4 Settings optionsBy default, RealView D

Ending your RealView Debugger Session ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 5-55.2 Disconnecting from a targetYou can disco

Ending your RealView Debugger Session 5-6 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BIf you set disconnect mode from the Connecti

Ending your RealView Debugger Session ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 5-75.3 Exiting RealView DebuggerThis section de

Ending your RealView Debugger Session 5-8 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BTerminating the connectionTo close down and

ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-1Chapter 6 RealView Debugger DesktopThis chapter describes, in detail, the RealView

RealView Debugger Desktop 6-2 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B6.1 About the desktopThis section describes the default

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-3Figure 6-1 Default Code windowThe Code window is your ma

Preface ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. ix• ARM-Thumb® Procedure Call Standard (ATPCS) Specification (SWS ESPC 0002).

RealView Debugger Desktop 6-4 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BFigure 6-2 Title barIn addition to the application icon,

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-56.1.3 Default windows and panesRealView Debugger provide

RealView Debugger Desktop 6-6 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BIf you load an image, or when you are working with sourc

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-7Memory pane Use this pane to:• display the contents of a

RealView Debugger Desktop 6-8 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181B6.1.4 Pane controlsEach configurable pane in the Code wi

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-9Figure 6-3 Actions toolbarFigure 6-4 Editing toolbarTo d

RealView Debugger Desktop 6-10 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BWhen you first start RealView Debugger the Code window

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-116.2 Finding options on the main menuThis section provid

RealView Debugger Desktop 6-12 Copyright © 2002 ARM Limited. All rights reserved. ARM DUI 0181BEdit Displays the Edit menu shown in Figure 6-7. This

RealView Debugger Desktop ARM DUI 0181B Copyright © 2002 ARM Limited. All rights reserved. 6-13Note Custom windows are not available in this release.