RealView ® Debugger RTOSGuide

Version 3.1

Table of Contents

About this book
Intended audience
Using this book
Typographical conventions
Further reading
Feedback on RealView Debugger
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.3.1. See also
1.4. Halted System Debug and Running SystemDebug
1.4.1. See also
1.5. Debug Agent
1.6. OS-aware CLI commands
1.6.1. See also
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 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_configsettings
2.3.4. Procedure for configuring the ARM_configsettings
2.3.5. Procedure for configuring the connectand 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 runningtarget
3.4. Loading the symbols for an image ona running target
3.4.1. Procedure
3.5. Loading a multi-image applicationon an OS-aware connection
3.5.1. Procedure
3.6. OS Exit Options
3.6.1. See also
3.7. Interrupts when loading an image
3.8. Resetting OS state
4. Associating Threads with Views
4.1. Attaching and unattaching windows
4.1.1. See also
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 threadlist
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
4.4.5. Using the thread ListSelection dialog box
5. Working with OS-aware Connections in the Process Controlpane
5.1. The Process Control pane and OS-awareconnections
5.1.1. See also
5.2. OS marker in the Process tab
5.2.1. OS marker initial state
5.2.2. OS marker with an OS-awareimage loaded
5.2.3. OS marker for a running target withHSD fully operational
5.2.4. OS marker for a running target withRSD fully operational
5.2.5. OS marker status
5.2.6. Context menu
5.3. Examining thread details in the Threadtab
5.3.1. Thread icons
5.3.2. Special threads in the Thread tab
5.4. Changing the current thread and attachment
5.4.1. See also
5.5. Updating the system snapshot
6. Viewing OS Resources
6.1. About viewing OS resources
6.2. Viewing details in the Output pane
6.3. Viewing details in a Properties dialogbox
6.4. Viewing the active connections
6.4.1. See also
6.5. Updating the Resource Viewer pane
6.5.1. Toggling automatic updates of theResource Viewer pane
6.5.2. Manually updating the selected Resourcelist in the Resource Viewer pane
6.5.3. Automatically updating the displayeddetails for a selected resource
6.6. Performing OS-specific actions onan OS-aware connection
6.6.1. See also
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 dialogbox
7.3.1. See also
7.4. Using the Break/Tracepoints pane
7.4.1. See also
7.5. Stepping threads
7.5.1. Stepping in RSD mode
7.5.2. Stepping in HSD mode
7.6. Adding object searchpaths 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.7.1. See also
7.8. Updating your debug view
7.8.1. See also
7.9. Synchronization behavior when usingOS-awareness in RSD mode
7.9.1. Synchronization behavior when runningon an OS-aware connection
7.9.2. Controlling connections running inRSD mode

List of Figures

1.1. RealView Debugger and OS components
2.1. Connect to Target window
2.2. New Debug Configuration in the Connectto Target window
2.3. RTOS_config group in the ConnectionProperties window
2.4. ARM_config group in the ConnectionProperties window
2.5. Default group in the Connection Propertieswindow
3.1. Connect to Target window
3.2. RTOS Exit Options List Selectiondialog box
4.1. Example thread list
4.2. Example thread list in an attachedwindow
4.3. Thread List Selection dialog box
5.1. OS marker initial state (OS plug-innot loaded)
5.2. OS marker initial state (OS plug-inloaded)
5.3. OS marker with loaded image (OS plug-inloaded)
5.4. OS marker in the Process Controlpane (HSD)
5.5. OS marker in the Process Controlpane (RSD)
5.6. Thread tab in the Process Controlpane
6.1. Resource Viewer pane
6.2. Resource Viewer pane showing thethread list
6.3. Thread details in the Output pane
6.4. Resource Viewer pane
6.5. Resource Viewer pane showing thethread list
6.6. Thread details in the Propertiesdialog box
6.7. Active connection in the ResourceViewer pane
6.8. Resource Viewer pane
6.9. Select resource in the Resource Viewerpane
6.10. Resource Viewer pane (RSD)
6.11. Resources list in the Resource Viewerpane
6.12. Action argument prompt
7.1. OS Breakpoint Class selector
7.2. OS (RSD) breakpoints in the Break/Tracepointspane
7.3. OS (HSD) breakpoints in the Break/Tracepointspane
7.4. Debug toolbar
7.5. Stepping and stopping threads
7.6. Source Search and Mappings dialogbox
7.7. Object Search Path tab
7.8. Object Search Path tab
7.9. Object Mapping tab
7.10. New Mapping dialog box

Proprietary Notice

Words and logos marked with ® or ™ are registered trademarks or trademarksowned by ARM Limited. Other brands and names mentioned herein maybe the trademarks of their respective owners.

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

The product described in this document is subject to continuousdevelopments and improvements. All particulars of the product andits use contained in this document are given by ARM in good faith.However, all warranties implied or expressed, including but notlimited to implied warranties of merchantability, or fitness forpurpose, are excluded.

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

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


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

Product Status

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

Revision History
Revision A March2006 Release v3.0 for RVDS v3.0
Revision B March2007 Release v3.1 for RVDS v3.1
Copyright © 2006, 2007 ARM Limited. All rights reserved. ARM DUI 0323B