IDE Project Management and Building Guide for the Renesas RL78 Microcontroller Family UIDERL78_I-6 COPYRIGHT NOTICE © 2015–2019 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. Renesas is a registered trademark of Renesas Electronics Corporation. RL78 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 Sixth edition: November 2019 Part number: UIDERL78_I-6 This guide applies to version 4.x of IAR Embedded Workbench® for the Renesas RL78 microcontroller family. Internal reference: BB5, Mym8.4, tut2017.1, IJOA. IDE Project Management and Building Guide 2 for RL78 AFE1_AFE2-1:1 Brief contents Tables ..................................................................................................................... 13 Preface .................................................................................................................... 15 Part 1. Project management and building ............ 21 The development environment ................................................................ 23 Project management ....................................................................................... 87 Building projects ............................................................................................. 107 Editing ................................................................................................................... 123 Part 2. Reference information ........................................... 167 Product files ...................................................................................................... 169 Menu reference ............................................................................................... 177 General options .............................................................................................. 197 Compiler options ........................................................................................... 207 Assembler options ......................................................................................... 223 Output converter options ......................................................................... 231 Custom build options ................................................................................... 233 Build actions options .................................................................................... 235 Linker options .................................................................................................. 237 Library builder options ................................................................................ 253 Glossary ............................................................................................................... 255 Index ..................................................................................................................... 271 3 AFE1_AFE2-1:1 IDE Project Management and Building Guide 4 for RL78 AFE1_AFE2-1:1 Contents 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 Using and customizing the IDE ........................................................ 25 Running the IDE ............................................................................... 26 Working with example projects ......................................................... 26 Organizing windows on the screen .................................................... 28 Specifying tool options ...................................................................... 28 Adding a button to a toolbar .............................................................. 29 Removing a button from a toolbar ..................................................... 30 5 AFE1_AFE2-1:1 Showing/hiding toolbar buttons ......................................................... 30 Recognizing filename extensions ....................................................... 31 Getting started using external analyzers ............................................ 31 Invoking external tools from the Tools menu .................................... 34 Adding command line commands to the Tools menu ........................ 35 Using an external editor ..................................................................... 35 Reference information on the IDE .................................................. 37 IAR Embedded Workbench IDE window ......................................... 39 Customize dialog box ......................................................................... 44 Button Appearance dialog box ........................................................... 47 Tool Output window .......................................................................... 48 Common Fonts options ...................................................................... 49 Key Bindings options ......................................................................... 50 Language options ............................................................................... 52 Editor options ..................................................................................... 53 Configure Auto Indent dialog box ..................................................... 56 External Editor options ...................................................................... 57 Editor Setup Files options .................................................................. 59 Editor Colors and Fonts options ......................................................... 60 Messages options ............................................................................... 61 Project options .................................................................................... 62 External Analyzers options ................................................................ 64 External Analyzer dialog box ............................................................ 66 Source Code Control options (deprecated) ........................................ 68 Debugger options ............................................................................... 69 Stack options ...................................................................................... 71 Terminal I/O options .......................................................................... 73 Configure Tools dialog box ............................................................... 75 Configure Viewers dialog