RealView® Development Suite Version 3.0 CodeWarrior® IDE Guide Copyright © 1999-2001, 2005-2006 ARM Limited. All rights reserved. ARM DUI 0065F RealView Development Suite CodeWarrior IDE Guide Copyright © 1999-2001, 2005-2006 ARM Limited. All rights reserved. Release Information The following changes have been made to this book. Change History Date Issue Confidentiality Change October 1999 A Non-Confidential Release 1.0 (ADS) March 2000 B Non-Confidential Release 1.0.1 (ADS) November 2000 C Non-Confidential Release 1.1 (ADS) November 2001 D Non-Confidential Release 1.2 (ADS) May 2005 E Non-Confidential RVDS 2.2 Release March 2006 F Non-Confidential RVDS 3.0 Release Proprietary Notice Words and logos marked with ® or ™ are registered trademarks or trademarks of ARM Limited. Other brands and names mentioned herein may be the trademarks of their respective owners. CodeWarrior® and Metrowerks® are registered trademarks of Metrowerks, Inc. PowerParts™ is a trademark of Metrowerks, Inc. 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. 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. ii Copyright © 1999-2001, 2005-2006 ARM Limited. All rights reserved. ARM DUI 0065F Product Status The information in this document is final, that is for a developed product. Web Address http://www.arm.com ARM DUI 0065F Copyright © 1999-2001, 2005-2006 ARM Limited. All rights reserved. iii iv Copyright © 1999-2001, 2005-2006 ARM Limited. All rights reserved. ARM DUI 0065F Contents RealView Development Suite CodeWarrior IDE Guide Preface About this book .............................................................................................. x Feedback ...................................................................................................... xv Chapter 1 Introduction 1.1 About the CodeWarrior IDE ........................................................................ 1-2 1.2 About the CodeWarrior IDE for RVDS ........................................................ 1-4 Chapter 2 Working with Files 2.1 About working with files .............................................................................. 2-2 2.2 Creating and opening files .......................................................................... 2-3 2.3 Saving files ................................................................................................ 2-12 2.4 Closing files ............................................................................................... 2-16 2.5 Printing files .............................................................................................. 2-18 2.6 Reverting to the most recently saved version of a file ............................... 2-20 2.7 Comparing and merging files and folders ................................................. 2-21 Chapter 3 Working with Projects 3.1 About working with projects ........................................................................ 3-2 3.2 Overview of the project window .................................................................. 3-4 ARM DUI 0065F Copyright © 1999-2001, 2005-2006 ARM Limited. All rights reserved. v 3.3 Working with simple projects .................................................................... 3-11 3.4 Working with project windows .................................................................. 3-18 3.5 Working with project workspaces ............................................................. 3-22 3.6 Working with project stationery ................................................................. 3-24 3.7 Managing files in a project ........................................................................ 3-25 3.8 Configuring the CodeWarrior IDE for complex or multi-user projects ....... 3-38 3.9 Working with multiple build targets and subprojects ................................. 3-40 Chapter 4 Working with the ARM Project Stationery 4.1 About the ARM Project stationery .............................................................. 4-2 4.2 Working with an existing ARM project ........................................................ 4-6 4.3 Using the Thumb ARM interworking stationery ........................................ 4-10 4.4 Creating binary ROM images ................................................................... 4-16 4.5 Creating a project that builds an object library and ROM images ............ 4-17 4.6 Creating a project with a subproject ......................................................... 4-26 4.7 Creating your own project stationery ........................................................ 4-32 4.8 Converting ARM projects to Thumb projects ............................................ 4-35 4.9 Converting Executable Image projects to Library projects ....................... 4-37 4.10 Compiling and linking a project ................................................................. 4-38 4.11 Processing output ..................................................................................... 4-47 4.12 Running batch files with the Batch File Runner ........................................ 4-51 Chapter 5 Working with the ARM Debuggers 5.1 About working with the ARM debuggers .................................................... 5-2 5.2 Generating debug information .................................................................... 5-4 5.3 Running and debugging your code ............................................................. 5-8 5.4 Using the message window ...................................................................... 5-10 Chapter 6 Editing Source Code 6.1 About editing source code .......................................................................... 6-2 6.2 Overview of the editor window .................................................................... 6-3 6.3 Configuring the editor window .................................................................... 6-7 6.4 Editing text ................................................................................................ 6-10 6.5 Navigating text .......................................................................................... 6-19 Chapter 7 Searching and Replacing Text 7.1 About finding and replacing text ................................................................. 7-2 7.2 Finding and replacing text in a single file .................................................... 7-3 7.3 Finding and replacing text in multiple files .................................................. 7-8 7.4 Using grep-style regular expressions ....................................................... 7-17 Chapter 8 Working with the Browser 8.1 About working with the browser .................................................................. 8-2 8.2 Enabling browser data production .............................................................. 8-5 8.3 Using browser views ................................................................................... 8-8 8.4 Using the browser ..................................................................................... 8-21 vi Copyright © 1999-2001, 2005-2006 ARM Limited. All rights reserved. ARM DUI 0065F 8.5 Creating classes and members with browser wizards .............................. 8-30 Chapter 9 Configuring IDE Options 9.1 About configuring the CodeWarrior IDE ...................................................... 9-2 9.2 Overview of the IDE Preferences window ................................................... 9-3 9.3 Choosing general preferences .................................................................... 9-6 9.4 Choosing editor preferences ..................................................................... 9-21 9.5 Setting commands and key bindings ........................................................ 9-37 9.6 Customizing toolbars ................................................................................ 9-48 Chapter 10 Configuring a Build Target 10.1 About configuring a build target ................................................................ 10-2 10.2 Overview of the Target Settings window ................................................... 10-4 10.3 Configuring general build target options ................................................... 10-8 10.4 Using the Equivalent Command Line text box ........................................ 10-35 10.5 Configuring assembler and compiler language settings ......................... 10-37 10.6 Configuring linker settings ....................................................................... 10-66 10.7 Configuring editor settings .....................................................................