RealView ® DeveloperKit for Philips Getting Started Guide

Version 2.2

Table of Contents

About this book
Intended audience
Using this book
Typographical conventions
Further reading
Feedback on this toolkit
Feedback on this book
1. Introduction
1.1. RealView Developer Kit components
1.1.1. RealView Compilation Tools v2.2
1.1.2. RealView Debugger v1.8
1.1.3. RealView ICE Micro Edition v1.1
1.1.4. RVDK example projects
1.1.5. Names used in the debuggerdocumentation examples
1.2. RealView Developer Kit licensing
1.3. RealView Developer Kit documentation
1.3.1. Getting more information
2. Features of the Compilation Tools, the Debugger, and RealViewICE Micro Edition
2.1. ARM Toolkit Proprietary ELF format
2.2. RealView Compilation Tools v2.2
2.2.1. Components of RVCT
2.3. RealView Debugger v1.8
2.3.1. RealView Debugger concepts and terminology
2.3.2. OS awareness
2.3.3. Extended Target Visibility (ETV)
2.3.4. Project Manager
2.3.5. RealView Debugger downloads
2.3.6. BCD Files
2.3.7. RTOS support
2.4. RealView ICE Micro Edition v1.1
3. RealView Developer Kit Desktop
3.1. Basic elements of the desktop
3.1.1. Splash screen
3.1.2. Code window
3.1.3. Default pane configuration
3.1.4. Debug views and panes
3.1.5. Pane controls
3.1.6. Button toolbars
3.1.7. Color Box
3.1.8. Other window elements
3.2. Finding options on the main menu
3.3. Working with the Code window toolbars
3.3.1. File toolbar
3.3.2. Edit toolbar
3.3.3. Debug toolbar
3.3.4. Image toolbar
3.3.5. Connect toolbar
3.3.6. Build toolbar
3.3.7. Find toolbar
3.3.8. Customizing the toolbars
3.4. Working in the Code window
3.4.1. Floating, docking, and resizing windowsand panes
3.4.2. Changing the focus
3.4.3. In-place editing
3.4.4. Working with tabs
3.4.5. Working with scroll bars
4. Getting Started with RealView Developer Kit
4.1. Using the example projects
4.2. RealView ICE Micro Edition ConnectionSequence
4.3. Starting and Exiting RealView Debugger
4.3.1. Starting RealView Debugger
4.3.2. Exiting RealView Debugger
4.4. Opening an existing RealView Debugger project
4.5. Changing your target board/chip definition
4.5.1. How to change the board/chip definition
4.6. Connecting to your target
4.6.1. Configuring your target connection
4.6.2. Connecting to your target
4.6.3. Setting connect mode
4.7. Loading an image ready for debugging
4.7.1. Loading an image directly
4.7.2. Loading an image associated with a RealView Debugger project
4.7.3. Loading multi-image applications
4.7.4. Working with memory
4.7.5. Reloading an image
4.8. Unloading an image
4.8.1. How to explicitly unload an image
4.9. Running the image
4.10. Basic debugging tasks with RealView Debugger
4.10.1. Displaying line numbers
4.10.2. Setting a simple breakpoint
4.10.3. Setting the top of memory
4.10.4. Configuring Vector Catch
4.10.5. Displaying variables
4.11. Building and rebuilding an image with RealView Debugger
4.12. Help on creating RealView Debugger projects
4.12.1. Types of project
4.12.2. Project properties
4.12.3. Limitations of Standard and Libraryprojects
4.12.4. Making a project anda connection interdependent
4.12.5. Automatic operations performed bya project
4.13. Getting started with the compilationtools
4.13.1. Targeting the sourcelanguage with the compiler
4.13.2. Targeting the ARM orThumb instruction set
4.13.3. Targeting a specific ARM architectureor processor
4.13.4. Targeting specific procedure callstandard variants
4.13.5. Generating debug information
4.13.6. Optimizing your compiled sources
4.13.7. Building an image witha single compiler invocation
4.13.8. Building an image with separate commandinvocations
4.13.9. Specifying the initial entry pointfor an image
4.13.10. Creating object libraries
4.13.11. Converting images to binary files
4.13.12. Creating an image memory map withscatter-loading
4.13.13. Building the RVDK exampleDhrystone project
A. Using the armenv Tool
A.1. About the armenv tool
A.2. Using the armenv tool
A.2.1. armenv command syntax
A.2.2. armenv command-line arguments

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.


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 July2005 RVDK v2.2 for Philips (MCU) release
Copyright © 2005 ARM Limited. All rights reserved. ARM DUI 0308A