IAR Embedded Workbench® C-SPY® Debugging Guide for the Renesas RL78 Microcontroller Family UCSRL78-3 COPYRIGHT NOTICE © 2011–2013 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, The Code to Success, IAR KickStart Kit, I-jet, 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 Electronic 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 Third edition: January 2013 Part number: UCSRL78-3 This guide applies to version 1.x of IAR Embedded Workbench® for the Renesas RL78 microcontroller family. Internal reference: M12, Too6.5, ISUD. C-SPY® Debugging Guide 2 for RL78 AFE1_AFE2-1:1 Brief contents Tables ...................................................................................................................... 17 Preface .................................................................................................................... 19 The IAR C-SPY Debugger ........................................................................... 25 Getting started using C-SPY ....................................................................... 35 Executing your application ........................................................................... 57 Variables and expressions ............................................................................ 77 Breakpoints ........................................................................................................ 111 Memory and registers .................................................................................. 137 Trace ...................................................................................................................... 169 Profiling ................................................................................................................ 199 Code coverage ................................................................................................. 207 Interrupts ............................................................................................................ 211 C-SPY macros ................................................................................................. 231 The C-SPY Command Line Utility—cspybat ................................... 275 Debugger options ........................................................................................... 289 Additional information on C-SPY drivers .......................................... 295 OCD emulators reserved resources ................................................... 321 Index ..................................................................................................................... 325 3 AFE1_AFE2-1:1 4 AFE1_AFE2-1:1 Contents Tables ...................................................................................................................... 17 Preface .................................................................................................................... 19 Who should read this guide ............................................................... 19 Required knowledge .......................................................................... 19 What this guide contains ..................................................................... 19 Other documentation ........................................................................... 20 User and reference guides .................................................................. 20 The online help system ...................................................................... 21 Web sites ............................................................................................ 21 Document conventions ........................................................................ 22 Typographic conventions ................................................................... 22 Naming conventions .......................................................................... 23 The IAR C-SPY Debugger ........................................................................... 25 Introduction to C-SPY .......................................................................... 25 An integrated environment ................................................................. 25 General C-SPY debugger features ..................................................... 26 RTOS awareness ................................................................................ 27 Debugger concepts ................................................................................ 28 C-SPY and target systems .................................................................. 28 The debugger ...................................................................................... 28 The target system ............................................................................... 29 The application ................................................................................... 29 C-SPY debugger systems ................................................................... 29 The ROM-monitor program ............................................................... 29 Third-party debuggers ........................................................................ 29 C-SPY plugin modules ....................................................................... 30 C-SPY drivers overview ....................................................................... 30 Differences between the C-SPY drivers ........................................... 30 The IAR C-SPY Simulator .................................................................. 31 Simulator features .............................................................................. 31 5 AFE1_AFE2-1:1 The C-SPY Hardware debugger drivers ....................................... 32 Features .............................................................................................. 32 IECUBE Communication overview ................................................... 33 Communication overview for E1, E20, and TK ................................ 34 Getting started using C-SPY ....................................................................... 35 Setting up C-SPY .................................................................................... 35 Setting up for debugging .................................................................... 35 Executing from reset .......................................................................... 36 Using a setup macro file ..................................................................... 36 Selecting a device description file ..................................................... 36 Loading plugin modules ..................................................................... 37 Starting C-SPY ......................................................................................... 37 Starting a debug session ..................................................................... 37 Loading executable files built outside of the IDE .............................. 38 Starting a debug session with source files missing ............................ 38 Loading multiple images ................................................................... 39 Hardware configuration when starting for the first time ................... 40 Adapting for target hardware ........................................................... 40 Modifying a device description file ................................................... 40 Initializing target hardware before C-SPY starts ............................... 41 Running example projects .................................................................. 42 Running an example project .............................................................. 42 Reference information on starting C-SPY ................................... 43 C-SPY Debugger main window ......................................................... 43 Images window .................................................................................. 48 Get Alternative File dialog box .......................................................... 50 Hardware Setup .................................................................................. 51 Executing your application ........................................................................... 57 Introduction to application execution ........................................... 57 Briefly about application execution ..................................................