RealView® Debugger RTOS Guide

Version 4.1

Table of Contents

About this book
Intended audience
Using this book
Typographical conventions
Further reading
Feedback on this product
Feedback on this book
1. OS Support in RealView Debugger
1.1. About OS support in RealView Debugger
1.1.1. Debugging multithreaded application with RealView Debugger
1.2. Hardware for OS support
1.3. OS debugging features available in RealView Debugger
1.4. Halted System Debug and Running System Debug
1.5. Debug Agent
1.6. OS-aware CLI commands
2. Configuring OS-aware Connections
2.1. Enabling OS support
2.2. Creating a new OS-aware Debug Configuration
2.2.1. Procedure
2.2.2. Configuring a DSTREAM or RealView ICE interface unit
2.3. Customizing an OS-aware Debug Configuration
2.3.1. OS configuration settings
2.3.2. Locating the OS related settings groups
2.3.3. Procedure for configuring RTOS settings
2.3.4. Procedure for configuring the Basic Settings
2.3.5. Procedure for configuring the connect and disconnect settings
2.4. Managing configuration settings
2.4.1. Avoiding conflicts between settings
3. Connecting to a Target and Loading an Image
3.1. Before connecting
3.2. Connecting from the Code window
3.3. Connecting to a running target
3.3.1. Before you start
3.3.2. Procedure for connecting to a running target
3.4. Loading the symbols for an image on a running target
3.5. Loading a multi-image application on an OS-aware connection
3.6. OS Exit Options
3.7. Interrupts when loading an image
3.8. Resetting OS state
4. Associating Threads with Views
4.1. Attaching and unattaching windows
4.2. The current thread
4.2.1. Using CLI commands for examining thread information
4.3. Using the Cycle Threads button
4.3.1. Viewing thread details
4.4. Working with the thread list
4.4.1. The thread list
4.4.2. Identifying the current thread
4.4.3. Captive threads
4.4.4. Attaching windows to threads
5. Working with OS-aware Connections in the Process Control view
5.1. The Process Control view and OS-aware connections
5.2. OS marker in the Process tab
5.2.1. OS marker initial state
5.2.2. OS marker with an OS-aware image loaded
5.2.3. OS marker for a running target with HSD fully operational
5.2.4. OS marker for a running target with RSD fully operational
5.2.5. OS marker status
5.2.6. Context menu
5.3. Examining thread details in the Thread tab
5.3.1. Thread icons
5.3.2. Special threads in the Thread tab
5.4. Changing the current thread and attachment
5.5. Updating the system snapshot
6. Viewing OS Resources
6.1. About viewing OS resources
6.2. Viewing details in the Output view
6.3. Viewing details in a Properties dialog box
6.4. Viewing the active connections
6.5. Updating the Resource Viewer
6.5.1. Toggling automatic updates of the Resource Viewer
6.5.2. Manually updating the selected Resource list in the Resource Viewer
6.5.3. Automatically updating the displayed details for a selected resource
6.6. Performing OS-specific actions on an OS-aware connection
6.7. Interaction of OS resources and RealView Debugger
7. Debugging Your OS Application
7.1. About breakpoints
7.1.1. Using the break trigger group
7.1.2. More on breakpoints
7.2. Setting breakpoints
7.2.1. Procedure for setting a breakpoint in the code view
7.2.2. Breakpoint markers in the code views
7.2.3. Changing the break trigger group
7.3. Using the Create Breakpoint dialog box
7.4. Using the Break/Tracepoints view
7.5. Stepping threads
7.5.1. Stepping in RSD mode
7.5.2. Stepping in HSD mode
7.6. Adding object search paths and mappings
7.6.1. Adding an object search path
7.6.2. Adding an object file mapping
7.7. Manipulating registers and variables
7.8. Updating your debug view
7.9. Synchronization behavior when using OS-awareness in RSD mode
7.9.1. Synchronization behavior when running on an OS-aware connection
7.9.2. Controlling connections running in RSD mode

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 AMarch 2006Release v3.0 for RealView Development Suite v3.0
Revision BMarch 2007Release v3.1 for RealView Development Suite v3.1
Revision CSeptember 2008Release v4.0 for RealView Development Suite v4.0
Revision D27 March 2009Release v4.0 SP1 for RealView Development Suite v4.0
Revision E28 May 2010Release 4.1 for RealView Development Suite v4.1
Revision F30 September 2010Release 4.1 SP1 for RealView Development Suite v4.1 SP1
Copyright © 2006-2010 ARM Limited. All rights reserved.ARM DUI 0323F