Other publications | ARM Version 1.6 guide

Preface

•ARM-Thumb®Procedure Call Standard (ATPCS) Specification (SWS ESPC 0002).

Refer to the following documentation for information relating to the ARM debug interfaces suitable for use with RealView Debugger:

•ARM Agilent Debug Interface v1.0 User Guide (ARM DUI 0158)

•Multi-ICE version 2.2.2 User Guide (ARM DUI 0048).

Refer to the following documentation for information relating to specific ARM Limited processors:

•ARM7TDMI (Rev 4) Technical Reference Manual (ARM DDI 0210)

•ARM7EJ-S (Rev 1) Technical Reference Manual (ARM DDI 0214)

•ARM9TDMI (Rev 3) Technical Reference Manual (ARM DDI 0180)

•ARM920T (Rev 1) Technical Reference Manual (ARM DDI 0151)

•ARM922T (Rev 0) Technical Reference Manual (ARM DDI 0184)

•ARM9EJ-S (Rev 1) Technical Reference Manual (ARM DDI 0222)

•ARM926EJ-S (Rev 0) Technical Reference Manual (ARM DDI 0198)

•ARM940T (Rev 2) Technical Reference Manual (ARM DDI 0144)

•ARM946E-S (Rev 1) Technical Reference Manual (ARM DDI 0201)

•ARM966E-S (Rev 2) Technical Reference Manual (ARM DDI 0213)

•ARM1020E Technical Reference Manual (ARM DDI 0177)

•ARM1022E Technical Reference Manual (ARM DDI 0237).

Refer to the following documentation for details on the FLEXlm® license management system, supplied by GLOBEtrotter Inc., that controls the use of ARM applications:

•ARM FLEXlm License Management Guide (ARM DUI 0209).

Other publications

For a comprehensive introduction to ARM architecture see:

Steve Furber, ARM system-on-chip architecture (2nd edition, 2000). Addison Wesley, ISBN 0-201-67519-6.

For the definitive guide to the C programming language, on which the RealView Debugger macro and expression language is based, see:

Brian W. Kernighan, Dennis M. Ritchie, The C Programming Language (2nd edition, 1989). Prentice-Hall, ISBN 0-13-110362-8.

For more information about Oak and TeakLite processors from the DSP Group see:

http://www.dspg.com.

ARM DUI 0181B

Copyright © 2002 ARM Limited. All rights reserved.

ix

Image 9

ARM Version 1.6 manual Other publications

Contents

RealView Debugger Essentials Guide RealView Debugger Chapter About RealView Debugger RealView Debugger Essentials Guide Chapter Ending your RealView Debugger Session Preface Using this book About this bookIntended audience Further reading Typographical conventions ARM publications Other publications Contact information for MaxCore from Axys is available at Feedback Feedback on RealView DebuggerFeedback on this book Xii About RealView Debugger Multiprocessor access Single connection accessRealView Debugger concepts and terminology Debug target Multithreaded operation About the debugging environment Components of RealView DebuggerTarget Vehicle Server TVS RealView Connection Broker Debug target interfacePersistence information Debugging mode Using the documentation suite ARM DUI 0181B Features of RealView Debugger OS awareness Multi-core debuggingExtended Target Visibility ETV Advanced debugging facilities Trace, Analysis, and Profiling RealView Debugger downloads Project manager Getting more information online ARM DUI 0181B Getting Started with RealView Debugger Starting RealView Debugger Starting RealView DebuggerCode window Code window Connecting to a target Target configurationWorking with connections Connection Control window Making a connection RDI connection details Setting connect mode Working with memory Setting top of memory and stack values Setting top of memory for session Setting top of memory for a session Changed settings in the Register pane Loading an image Loading an image Code window with an image loaded What is shown in the title bar? UnattachedReloading an image Unloading an image Getting started Debugging an image Viewing target status Code views ARM DUI 0181B Quick-start Tutorial How to use the tutorial Setting up your first project Defining your build tools Build-Tool Properties for a Typical installation Defining a Standard Project Creating a new project Create Standard Project dialog box Setting up compiler options Viewing the project settings Customizing your project Building the application Project base directory Project Directory/filename Description Contains Project files Backup files Executable filesClosing the project ARM DUI 0181B Debugging with RealView Debugger Basic debugging tasks Displaying register contents Changing register contents Process Control pane Process control Displaying memory contents Updated memory contents Displaying variables Select File → Reload Image to Target to reload the imageTooltip evaluation 11 Local variables in the Call Stack pane Using the call stack Setting watches Using browsers and lists Breakpoint types Using breakpoints Unconditional Actions and qualifiers 12 Set Address/Data Break/Tracepoint dialog box Select When Expression True... from the menu 13 Break/Tracepoints pane Managing breakpoints ARM DUI 0181B Customizing your debug views Working with custom panes 14 Example Code window Hiding panes Changing build tools More about projects Viewing build settings Adding source files to a project Adding files to your project Adding object files to a project Generated makefilesViewing the makefile Finding build errors Build error reportingBuilding an application ARM DUI 0181B Completing the tutorial Removing tutorial project filesRemoving the tutorial project ARM DUI 0181B Ending your RealView Debugger Session Workspace Saving the session History file Startup file Settings options Setting disconnect mode Disconnecting from a target ARM DUI 0181B Closing down without a connection Exiting RealView DebuggerClosing down with a connection Maintaining the connection Terminating the connection Reconnecting to a target RealView Debugger Desktop Splash screen About the desktop Title bar Default Code window Title bar File Editor pane Default windows and panes Call Stack pane Middle pane rowCall Stack Watch pane Bottom pane Memory paneChanging panes Formatting pane views Pane controls Pane ContentVisual controls Expand/Collapse Pane Color Box Color Box Cursor location field Other window elementsShows that output is being written to a log file Shows that output is being written to a journal file File Finding options on the main menu Edit FindView 10 Project menu Tools 12 Debug menu Help Actions toolbar Working with button toolbars Pane Management controls Threads buttonProcessor State group Unknown Customizing the Actions toolbar Source control button ARM DUI 0181B Working in the Code window Floating, docking, and resizing windows and panesChanging the focus In-place editing Working with tabs 15 Editor Window Editor window 16 Resource Viewer window Resource Viewer window Help menu File menu Details area Resources list 17 Analysis window Analysis window Configuration Files Reference Overview Files in the etc directory SPR template used by RealView Debugger These files are referenced by the .rbe files Files in the home directory Means that the installation files are not changed Glossary ARM-Thumb Procedure Call Standard See Pop-up menu See Joint Test Action Group Real Time Operating System Used by the ARM standard C library to handle semihosting See Target Vehicle Server Caps Index See also Glossary Mscclock RDI Index-5 Index-6