Using the documentation suite | ARM Version 1.6 guide

About RealView Debugger

1.4Using the documentation suite

The RealView Debugger documentation suite consists of five books:

•RealView Debugger v1.6 Essentials Guide

•RealView Debugger v1.6 User Guide

•RealView Debugger v1.6 Target Configuration Guide

•RealView Debugger v1.6 Command Line Reference Guide

•RealView Debugger v1.6 Extensions User Guide.

At the front of each book is a Preface describing how the contents are organized and how information is presented in the chapters. The following description explains how you might use the books:

1.You are recommended to read the chapters in this book, RealView Debugger v1.6 Essentials Guide, to start debugging your images and to learn how to use RealView Debugger quickly. This book describes the minimum needed for the new user.

2.For a comprehensive description of the features available in RealView Debugger, see RealView Debugger v1.6 User Guide. This describes, in detail, how to debug your images, how to work with projects, and how to configure RealView Debugger to customize your working environment. This book also contains examples of debugging software and details shortcuts, and tips, for the developer.

3.RealView Debugger v1.6 Target Configuration Guide describes how to connect to targets, how to amend existing targets that are set up in the base installation, and how to customize your own targets.

4.If you want to use the RealView Debugger Command Line Interface (CLI) to control your debugging tasks, RealView Debugger v1.6 Command Line Reference Guide provides a detailed description of every CLI command and includes examples of their use.

5.If you have the appropriate licenses, you can access RealView Debugger extensions, for example multiprocessor debugging mode and Trace. These features are described in RealView Debugger v1.6 Extensions User Guide.

Refer to ARM FLEXlm License Management Guide for details on the license management system that controls the use of ARM applications.

See the installation notes delivered with your product for details on installing RealView Debugger.

ARM DUI 0181B

Copyright © 2002 ARM Limited. All rights reserved.

1-7

Image 19

ARM Version 1.6 manual Using the documentation suite

Contents

RealView Debugger Essentials Guide RealView Debugger Chapter About RealView Debugger RealView Debugger Essentials Guide Chapter Ending your RealView Debugger Session Preface About this book Using this bookIntended audience Further reading Typographical conventions ARM publications Other publications Contact information for MaxCore from Axys is available at Feedback on RealView Debugger FeedbackFeedback on this book Xii About RealView Debugger Debug target Single connection accessMultiprocessor access RealView Debugger concepts and terminology Multithreaded operation Components of RealView Debugger About the debugging environmentTarget Vehicle Server TVS Debug target interface RealView Connection BrokerPersistence information Debugging mode Using the documentation suite ARM DUI 0181B Features of RealView Debugger Advanced debugging facilities Multi-core debuggingOS awareness Extended Target Visibility ETV 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 Target configuration Connecting to a targetWorking 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 Unattached What is shown in the title bar?Reloading 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 Executable files Backup 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 Select File → Reload Image to Target to reload the image Displaying variablesTooltip 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 Generated makefiles Adding object files to a projectViewing the makefile Build error reporting Finding build errorsBuilding an application ARM DUI 0181B Removing tutorial project files Completing the tutorialRemoving 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 Maintaining the connection Exiting RealView DebuggerClosing down without a connection Closing down with a 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 Watch pane Middle pane rowCall Stack pane Call Stack Formatting pane views Memory paneBottom pane Changing panes Expand/Collapse Pane Pane ContentPane controls Visual controls Color Box Color Box Shows that output is being written to a journal file Other window elementsCursor location field Shows that output is being written to a log file File Finding options on the main menu Find EditView 10 Project menu Tools 12 Debug menu Help Actions toolbar Working with button toolbars Unknown Threads buttonPane Management controls Processor State group Customizing the Actions toolbar Source control button ARM DUI 0181B Floating, docking, and resizing windows and panes Working in the Code windowChanging 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