ARM DUI 0181B | ARM Version 1.6 guide

Quick-start Tutorial

Note

If you have loaded the image created by your project, RealView Debugger gives you the option to unload the image. Unload the image associated with the project to avoid the creation of an auto-project (see Working with images on page 4-16 for more details).

The Code window title bar shows that the project is no longer open.

Any files displayed in the File Editor pane remain after the parent project closes. To close the file shown on the top tab, either:

•select File → Close from the Code window main menu

•right-click on the file tab and select Close from the context menu.

If any file has been edited, you are warned and given the option to save the file before it closes. A backup copy of the previous version is saved by default, unless you have changed this in your workspace.

If you have several files displayed in the File Editor pane, the next tab is brought to the top and you can then close this one in the same way.

In the next part of the tutorial you use the debugging features of RealView Debugger to load an executable image and monitor execution. It is not necessary to exit RealView Debugger at this stage.

4-12

Copyright © 2002 ARM Limited. All rights reserved.

ARM DUI 0181B

Image 54

ARM Version 1.6 manual ARM DUI 0181B

Contents

RealView Debugger RealView Debugger Essentials Guide RealView Debugger Essentials Guide Chapter About RealView Debugger Chapter Ending your RealView Debugger Session Preface Using this book About this bookIntended audience Typographical conventions Further reading 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 RealView Debugger concepts and terminology Single connection accessMultiprocessor access 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 Extended Target Visibility ETV Multi-core debuggingOS awareness Advanced debugging facilities Trace, Analysis, and Profiling Project manager RealView Debugger downloads 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 Making a connection Connection Control window Setting connect mode RDI connection details Setting top of memory and stack values Working with memory Setting top of memory for a session Setting top of memory for 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 Debugging an image Getting started Code views Viewing target status ARM DUI 0181B Quick-start Tutorial How to use the tutorial Setting up your first project Build-Tool Properties for a Typical installation Defining your build tools Creating a new project Defining a Standard Project Create Standard Project dialog box Viewing the project settings Setting up compiler options Customizing your project Project base directory Building the application Project files Project Directory/filename Description Contains Backup files Executable filesClosing the project ARM DUI 0181B Debugging with RealView Debugger Displaying register contents Basic debugging tasks Changing register contents Process control Process Control pane Displaying memory contents Updated memory contents Displaying variables Select File → Reload Image to Target to reload the imageTooltip evaluation Using the call stack 11 Local variables in the Call Stack pane Using browsers and lists Setting watches Using breakpoints Breakpoint types Actions and qualifiers Unconditional Select When Expression True... from the menu 12 Set Address/Data Break/Tracepoint dialog box Managing breakpoints 13 Break/Tracepoints pane ARM DUI 0181B Working with custom panes Customizing your debug views Hiding panes 14 Example Code window More about projects Changing build tools Viewing build settings Adding files to your project Adding source files to a 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 Saving the session Workspace Startup file History file Settings options Disconnecting from a target Setting disconnect mode ARM DUI 0181B Closing down with a connection Exiting RealView DebuggerClosing down without a connection Maintaining the connection Reconnecting to a target Terminating the connection RealView Debugger Desktop About the desktop Splash screen Default Code window Title bar Title bar Default windows and panes File Editor pane Call Stack Middle pane rowCall Stack pane Watch pane Changing panes Memory paneBottom pane Formatting pane views Visual controls Pane ContentPane controls Expand/Collapse Pane Color Box Color Box Shows that output is being written to a log file Other window elementsCursor location field Shows that output is being written to a journal file Finding options on the main menu File Edit FindView Tools 10 Project menu Help 12 Debug menu Working with button toolbars Actions toolbar Processor State group Threads buttonPane Management controls Unknown Source control button Customizing the Actions toolbar ARM DUI 0181B Working in the Code window Floating, docking, and resizing windows and panesChanging the focus In-place editing Working with tabs Editor window 15 Editor Window Resource Viewer window 16 Resource Viewer window File menu Help menu Resources list Details area Analysis window 17 Analysis window Configuration Files Reference Overview Files in the etc directory SPR template used by RealView Debugger Files in the home directory These files are referenced by the .rbe files Means that the installation files are not changed ARM-Thumb Procedure Call Standard Glossary 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 Index Caps See also Glossary Mscclock RDI Index-5 Index-6