RealView® Debugger Essentials Guide

Version 4.1


Table of Contents

Preface
About this book
Intended audience
Examples
Using this book
Typographical conventions
Further reading
Feedback
Feedback on this product
Feedback on this book
1. About RealView Debugger
1.1. RealView Debugger
1.1.1. RealView Debugger concepts and terminology
1.2. About the debugging environment
1.2.1. Graphical User Interface
1.2.2. Command Line Interface
1.2.3. Supported Debug Interfaces
1.2.4. Persistence information
1.3. Multiprocessor debugging
1.4. Environment variables used by RealView Debugger
1.5. The RealView Debugger documentation suite
2. Getting Started with RealView Debugger
2.1. How to use the tutorial
2.2. Starting the tutorial
2.3. Starting RealView Debugger
2.4. Connecting to a debug target
2.4.1. How to display the Connections window
2.4.2. Elements of the Connect to Target window
2.4.3. Making a connection
2.5. Loading an image ready for debugging
2.5.1. Loading an image directly
2.5.2. Loading multi-image applications to a single debug target
2.6. Setting a simple breakpoint
2.6.1. Procedure
2.7. Running the image
2.7.1. Continuing the tutorial
2.8. Unloading an image
2.8.1. How to explicitly unload an image
2.9. Disconnecting from a target
2.10. Exiting RealView Debugger
2.10.1. Closing down RealView Debugger
2.10.2. Reconnecting to a target
2.11. Cleaning up after the tutorial
2.12. Localizing the RealView Debugger interface
2.12.1. Font recommendations
2.12.2. Procedure summary
2.12.3. Configuring the internationalization settings
2.12.4. Configuring the views
2.13. Saving a debugging session
2.13.1. Workspace
2.13.2. Startup file
2.13.3. History file
3. Changes to RealView Debugger
3.1. Debug target support
3.2. Documentation changes
3.3. Deprecated features
A. About Previous Releases
A.1. Changes between RealView Debugger v4.1 and v4.0 SP1
A.1.1. RealView Debugger command line options
A.1.2. Debug target support
A.1.3. Debug Interface support
A.1.4. GUI changes
A.1.5. Changes to CLI commands
A.1.6. Trace, analysis, and profiling
A.1.7. Documentation changes
A.1.8. Deprecated features
A.2. Changes between RealView Debugger v4.0 SP1 and v4.0
A.2.1. RealView Debugger command line options in RealView Debugger v4.0 SP1
A.2.2. Processor support in RealView Debugger v4.0 SP1
A.2.3. Simulator Support in RealView Debugger v4.0 SP1
A.2.4. Miscellaneous changes to the GUI in RealView Debugger v4.0 SP1
A.2.5. Changes to CLI commands and predefined macros in RealView Debugger v4.0 SP1
A.2.6. Documentation changes in RealView Debugger v4.0 SP1
A.2.7. Deprecated features in RealView Debugger v4.0 SP1
A.2.8. Obsolete features in RealView Debugger v4.0 SP1
A.3. Changes between RealView Debugger v4.0 and v3.1
A.3.1. Processor support in RealView Debugger v4.0
A.3.2. Simulator support in RealView Debugger v4.0
A.3.3. Miscellaneous changes to the GUI in RealView Debugger v4.0
A.3.4. Documentation changes in RealView Debugger v4.0
A.3.5. Deprecated features in RealView Debugger v4.0
A.3.6. Obsolete features in RealView Debugger v4.0
A.4. Changes between RealView Debugger v3.1 and v3.0
A.4.1. Processor support in RealView Debugger v3.1
A.4.2. Simulator support in RealView Debugger v3.1
A.4.3. Command line options in RealView Debugger v3.1
A.4.4. Target connection and configuration in RealView Debugger v3.1
A.4.5. CoreSight support in RealView Debugger v3.1
A.4.6. Multiprocessor debugging in RealView Debugger v3.1
A.4.7. Cache debugging in RealView Debugger v3.1
A.4.8. Trace, analysis, and profiling in RealView Debugger v3.1
A.4.9. Changes to the views in RealView Debugger v3.1
A.4.10. Miscellaneous changes to the GUI in RealView Debugger v3.1
A.4.11. Changes to CLI commands and macros in RealView Debugger v3.1
A.4.12. Documentation changes in RealView Debugger v3.1
A.4.13. Deprecated features in RealView Debugger v3.1
A.4.14. Obsolete features in RealView Debugger v3.1
A.5. Changes between RealView Debugger v3.0 and v1.8
A.5.1. TrustZone technology support in RealView Debugger v3.0
A.5.2. Thumb-2EE Support in RealView Debugger v3.0
A.5.3. OS support in RealView Debugger v3.0
A.5.4. Trace, Analysis, and Profiling in RealView Debugger v3.0
A.5.5. RealView Simulator Broker support in RealView Debugger v3.0
A.5.6. Multi-ICE direct connect in RealView Debugger v3.0
A.5.7. Simulator support in RealView Debugger v3.0
A.5.8. Changes to the GUI in RealView Debugger v3.0
A.5.9. Changes to the CLI commands and predefined macros in RealView Debugger v3.0
A.5.10. Updated documentation in RealView Debugger v3.0
A.6. Changes between RealView Debugger v1.8 and v1.7
A.6.1. Updated documentation in RealView Debugger v1.8
A.6.2. Trace, Analysis, and Profiling in RealView Debugger v1.8
A.6.3. Support for gcc built images in RealView Debugger v1.8
A.6.4. Changes to the GUI in RealView Debugger v1.8
A.6.5. Changes to the CLI in RealView Debugger v1.8
A.6.6. RealView ARMulator ISS support in RealView Debugger v1.8
A.6.7. RealMonitor support in RealView Debugger v1.8
A.7. Changes between RealView Debugger v1.7 and v1.6.1
A.7.1. Updated documentation in RealView Debugger v1.7
A.7.2. Advanced debugging facilities in RealView Debugger v1.7
A.7.3. RealView ARMulator ISS support in RealView Debugger v1.7
A.7.4. Trace, Analysis, and Profiling in RealView Debugger v1.7
A.7.5. Enhanced RTOS support in RealView Debugger v1.7
A.7.6. New GUI elements in RealView Debugger v1.7

Proprietary Notice

Words and logos marked with ® or ™ are registered trademarks or trademarks of ARM Limited in the EU and other countries, except as otherwise stated below in this proprietary notice. Other brands and names mentioned herein may be the trademarks of their respective owners.

Neither the whole nor any part of the information contained in, or the product described in, this document may be adapted or reproduced in any material form except with the prior written permission of the copyright holder.

The product described in this document is subject to continuous developments and improvements. All particulars of the product and its use contained in this document are given by ARM in good faith. However, all warranties implied or expressed, including but not limited to implied warranties of merchantability, or fitness for purpose, are excluded.

This document is intended only to assist the reader in the use of the product. ARM Limited shall not be liable for any loss or damage arising from the use of any information in this document, or any error or omission in such information, or any incorrect use of the product.

Where the term ARM is used it means “ARM or any of its subsidiaries as appropriate”.

Confidentiality Status

This document is Non-Confidential. The right to use, copy and disclose this document may be subject to license restrictions in accordance with the terms of the agreement entered into by ARM and the party that ARM delivered this document to.

Product Status

The information in this document is final, that is for a developed product.

Revision History
Revision AApril 2002Release v1.5
Revision BSeptember 2002Release v1.6
Revision CFebruary 2003Release v1.6.1
Revision DSeptember 2003Release v1.6.1 for RealView Developer Suite v2.0
Revision EJanuary 2004Release v1.7 for RealView Developer Suite v2.1
Revision FDecember 2004Release v1.8 for RealView Developer Suite v2.2
Revision GMay 2005Release v1.8 SP1 for RealView Developer Suite v2.2 SP1
Revision HMarch 2006Release v3.0 for RealView Development Suite v3.0
Revision IMarch 2007Release v3.1 for RealView Development Suite v3.1
Revision JSeptember 2008Release v4.0 for RealView Development Suite v4.0
Revision K27 March 2009Release v4.0 SP1 for RealView Development Suite v4.0
Revision L28 May 2010Release 4.1 for RealView Development Suite v4.1
Revision M30 September 2010Release 4.1 SP1 for RealView Development Suite v4.1 SP1
Copyright © 2002-2010 ARM Limited. All rights reserved.ARM DUI 0181M
Non-ConfidentialID102410