IDE Project Management and Building Guide for Arm Limited’s Arm® Cores UIDEARM-15 COPYRIGHT NOTICE © 1999–2021 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, Embedded Trust, C-Trust, IAR Connect, C-SPY, C-RUN, C-STAT, IAR Visual State, IAR KickStart Kit, I-jet, I-jet Trace, I-scope, IAR Academy, IAR, and the logotype of IAR Systems are trademarks or registered trademarks owned by IAR Systems AB. Microsoft and Windows are registered trademarks of Microsoft Corporation. Arm, Cortex, Thumb, and TrustZone are registered trademarks of Arm Limited. EmbeddedICE is a trademark of Arm Limited. uC/OS-II and uC/OS-III are trademarks of Micrium, 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. Renesas Synergy is a trademark of Renesas Electronics Corporation. Adobe and Acrobat Reader are registered trademarks of Adobe Systems Incorporated. All other product names are trademarks or registered trademarks of their respective owners. EDITION NOTICE Fifteenth edition: February 2021 Part number: UIDEARM-15 This guide applies to version 9.10.x of IAR Embedded Workbench® for Arm. Internal reference: BB8, FF9.0, IJOA. IDE Project Management and Building Guide 2 for Arm AFE1_AFE2-1:1 Brief contents Brief contents ....................................................................................................... 3 Tables ..................................................................................................................... 13 Preface .................................................................................................................... 15 Part 1. Project management and building ............ 21 The development environment ................................................................ 23 Project management ....................................................................................... 91 Building projects ............................................................................................. 115 Editing ................................................................................................................... 133 Part 2. Reference information ........................................... 177 Product files ...................................................................................................... 179 Menu reference ............................................................................................... 187 General options .............................................................................................. 209 Compiler options ........................................................................................... 221 Assembler options ......................................................................................... 237 Output converter options ......................................................................... 245 Custom build options ................................................................................... 247 Build actions options .................................................................................... 249 Linker options .................................................................................................. 251 Library builder options ................................................................................ 267 Glossary ............................................................................................................... 269 Index ..................................................................................................................... 285 3 AFE1_AFE2-1:1 IDE Project Management and Building Guide 4 for Arm AFE1_AFE2-1:1 Contents Brief contents ....................................................................................................... 3 Tables ..................................................................................................................... 13 Preface .................................................................................................................... 15 Who should read this guide ............................................................... 15 Required knowledge .......................................................................... 15 How to use this guide ........................................................................... 15 What this guide contains ..................................................................... 16 Part 1. Project management and building .......................................... 16 Part 2. Reference information ............................................................ 16 Other documentation ........................................................................... 17 User and reference guides .................................................................. 17 The online help system ...................................................................... 18 Web sites ............................................................................................ 18 Document conventions ........................................................................ 18 Typographic conventions ................................................................... 19 Naming conventions .......................................................................... 20 Part 1. Project management and building ............ 21 The development environment ................................................................ 23 Introduction to the IAR Embedded Workbench IDE ............ 23 Briefly about the IDE and the build toolchain ................................... 23 Tools for analyzing and checking your application ........................... 24 An extensible and modular environment ........................................... 24 The layout of the windows on the screen ........................................... 25 Execution modes .................................................................................... 25 Using and customizing the IDE ........................................................ 26 Running the IDE ............................................................................... 26 Working with example projects ......................................................... 27 Organizing windows on the screen .................................................... 32 5 AFE1_AFE2-1:1 Specifying tool options ...................................................................... 33 Adding a button to a toolbar .............................................................. 33 Removing a button from a toolbar ..................................................... 34 Showing/hiding toolbar buttons ......................................................... 35 Recognizing filename extensions ....................................................... 36 Getting started using external analyzers ............................................ 36 Invoking external tools from the Tools menu .................................... 38 Adding command line commands to the Tools menu ........................ 39 Using an external editor ..................................................................... 39 Reference information on the IDE .................................................. 41 IAR Embedded Workbench IDE window ......................................... 43 Customize dialog box ......................................................................... 48 Button Appearance dialog box ........................................................... 50 Tool Output window .......................................................................... 51 Common Fonts options ...................................................................... 52 Key Bindings options ......................................................................... 53 Language options ............................................................................... 55 Editor options ..................................................................................... 56 Configure Auto Indent dialog box ..................................................... 59 External Editor options ...................................................................... 60 Editor Setup Files options .................................................................. 62 Editor Colors and Fonts options ......................................................... 63 Messages options ............................................................................... 64 Project options .................................................................................... 65 External Analyzers options ................................................................ 67 External Analyzer dialog box ...........................................................