IAR Embedded Workbench® IDE User Guide for Advanced RISC Machines Ltd’s ARM® Cores UARM-14 COPYRIGHT NOTICE Copyright © 1999–2008 IAR Systems AB. No part of this document may be reproduced without the prior written consent of IAR Systems AB. The software described in this document is furnished under a license and may only be used or copied in accordance with the terms of such a license. DISCLAIMER The information in this document is subject to change without notice and does not represent a commitment on any part of IAR Systems. While the information contained herein is assumed to be accurate, IAR Systems assumes no responsibility for any errors or omissions. In no event shall IAR Systems, its employees, its contractors, or the authors of this document be liable for special, direct, indirect, or consequential damage, losses, costs, charges, claims, demands, claim for lost profits, fees, or expenses of any nature or kind. TRADEMARKS IAR Systems, IAR Embedded Workbench, C-SPY, visualSTATE, From Idea To Target, IAR KickStart Kit, IAR PowerPac, IAR YellowSuite, IAR Advanced Development Kit, IAR, and the IAR Systems logotype are trademarks or registered trademarks owned by IAR Systems AB. J-Link is a trademark licensed to IAR Systems AB. Microsoft and Windows are registered trademarks of Microsoft Corporation. ARM and Thumb are registered trademarks of Advanced RISC Machines Ltd. EmbeddedICE is a trademark of Advanced RISC Machines Ltd. OCDemon is a trademark of Macraigor Systems LLC. μC/OS-II is a trademark of Micriμm, Inc. CMX-RTX is a trademark of CMX Systems, Inc. ThreadX is a trademark of Express Logic. RTXC is a trademark of Quadros Systems. Fusion is a trademark of Unicoi Systems. Adobe and Acrobat Reader are registered trademarks of Adobe Systems Incorporated. CodeWright is a registered trademark of Starbase Corporation. All other product names are trademarks or registered trademarks of their respective owners. EDITION NOTICE Fourteenth edition: June 2008 Part number: UARM-14 This guide describes version 5.2x of the IAR Embedded Workbench® IDE for Advanced RISC Machines Ltd’s ARM core family. Internal reference: 5.3.0. ISUD. UARM-14 Brief contents Tables .................................................................................................................... xxv Figures ................................................................................................................. xxix Preface .............................................................................................................. xxxvii Part 1. Product overview ............................................................. 1 Product introduction ........................................................................................ 3 Installed files ........................................................................................................ 19 Part 2. Tutorials .................................................................................... 27 Creating an application project ................................................................. 29 Debugging using the IAR C-SPY® Debugger ..................................... 41 Mixing C and assembler modules ............................................................ 51 Using C++ ............................................................................................................ 55 Simulating an interrupt .................................................................................. 59 Creating and using libraries ......................................................................... 69 Part 3. Project management and building ............ 73 The development environment ................................................................. 75 Managing projects ............................................................................................. 81 Building ................................................................................................................... 91 Editing ..................................................................................................................... 99 Part 4. Debugging .............................................................................. 109 The IAR C-SPY® Debugger ..................................................................... 111 iii UARM-14 Executing your application ......................................................................... 121 Working with variables and expressions ............................................ 127 Using breakpoints ........................................................................................... 135 Monitoring memory and registers ........................................................ 143 Using the C-SPY® macro system .......................................................... 149 Analyzing your application ......................................................................... 157 Part 5. The C-SPY® Simulator ......................................... 163 Simulator-specific debugging ..................................................................... 165 Simulating interrupts ..................................................................................... 185 Part 6. C-SPY hardware debugger systems ...... 197 Introduction to C-SPY® hardware debugger systems ............... 199 Hardware-specific debugging .................................................................... 213 Using flash loaders ......................................................................................... 255 Part 7. Reference information ........................................... 261 IAR Embedded Workbench® IDE reference ................................... 263 C-SPY® reference .......................................................................................... 343 General options .............................................................................................. 379 Compiler options ........................................................................................... 387 Assembler options ......................................................................................... 401 Converter options ......................................................................................... 409 Custom build options ................................................................................... 411 Build actions options .................................................................................... 413 IAR Embedded Workbench® IDE iv User Guide UARM-14 Brief contents Linker options .................................................................................................. 415 Library builder options ................................................................................ 427 Debugger options ........................................................................................... 429 The C-SPY Command Line Utility—cspybat ................................... 433 C-SPY® macros reference ........................................................................ 459 Index ..................................................................................................................... 493 v UARM-14 IAR Embedded Workbench® IDE vi User Guide UARM-14 Contents Tables .................................................................................................................... xxv Figures ................................................................................................................. xxix Preface .............................................................................................................. xxxvii Who should read this guide .........................................................xxxvii How to use this guide .....................................................................xxxvii What this guide contains ..............................................................xxxviii Other documentation ...........................................................................xli Document conventions .......................................................................xlii Typographic conventions ..................................................................xlii Naming conventions ........................................................................xliii Part 1. Product overview ............................................................. 1 Product introduction ........................................................................................ 3 The IAR Embedded Workbench IDE .............................................. 3 An extensible and modular environment ............................................. 3 Features ................................................................................................ 4 Documentation ..................................................................................... 5 IAR C-SPY Debugger .............................................................................. 5 General C-SPY debugger features ....................................................... 6 C-SPY plugin modules ......................................................................... 8 RTOS awareness .................................................................................. 9 Documentation ..................................................................................... 9 IAR C-SPY Debugger systems ............................................................ 9 IAR C-SPY Simulator ........................................................................ 10