RealView® Debugger Essentials Guide

Version 4.0

Table of Contents

About this book
Intended audience
Using this book
Typographical conventions
Further reading
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. RealView Debugger command line options
3.2. Processor support
3.3. Simulator support
3.4. Miscellaneous changes to the GUI
3.5. Changes to CLI commands and predefined macros
3.6. Documentation changes
3.7. Deprecated features
3.8. Obsolete features
A. About Previous Releases
A.1. Changes between RealView Debugger v4.0 and v3.1
A.1.1. Processor support
A.1.2. Simulator support
A.1.3. Miscellaneous changes to the GUI
A.1.4. Documentation changes
A.1.5. Deprecated features
A.1.6. Obsolete features
A.2. Changes between RealView Debugger v3.1 and v3.0
A.2.1. RealView Debugger command line options
A.2.2. Target connection and configuration
A.2.3. CoreSight support
A.2.4. Multiprocessor debugging
A.2.5. Cache debugging
A.2.6. Trace, analysis, and profiling
A.2.7. Simulator support
A.2.8. Changes to the views
A.2.9. Miscellaneous changes to the GUI
A.2.10. Changes to CLI commands and macros
A.2.11. Documentation changes
A.2.12. Deprecated features
A.2.13. Obsolete features
A.3. Changes between RealView Debugger v3.0 and v1.8
A.3.1. TrustZone technology support
A.3.2. Thumb-2EE Support
A.3.3. OS support
A.3.4. Trace, Analysis, and Profiling
A.3.5. RealView Simulator Broker support
A.3.6. Multi-ICE direct connect
A.3.7. Simulator support
A.3.8. Changes to the GUI
A.3.9. Changes to the CLI commands and predefined macros
A.3.10. Updated documentation
A.4. Changes between RealView Debugger v1.8 and v1.7
A.4.1. Updated documentation
A.4.2. Trace, Analysis, and Profiling
A.4.3. Support for gcc built images
A.4.4. Changes to the GUI
A.4.5. Changes to the CLI
A.4.6. RealView ARMulator ISS support
A.4.7. RealMonitor support
A.5. Changes between RealView Debugger v1.7 and v1.6.1
A.5.1. Updated documentation
A.5.2. Advanced debugging facilities
A.5.3. RealView ARMulator ISS
A.5.4. Trace, Analysis, and Profiling
A.5.5. Enhanced RTOS support
A.5.6. New GUI elements

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.

Unrestricted Access is an ARM internal classification.

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.1 for RealView Development Suite v4.0
Copyright © 2002-2009 ARM Limited. All rights reserved.ARM DUI 0181K