IAR Embedded Workbench® C-SPY® Debugging Guide for the Renesas V850 Microcontroller Family UCSV850-2 COPYRIGHT NOTICE © 2011–2015 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, C-RUN, C-STAT, visualSTATE, Focus on Your Code, IAR KickStart Kit, IAR Experiment!, 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. V850 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 Second edition: October 2015 Part number: UCSV850-2 This guide applies to version 4.x of IAR Embedded Workbench® for the Renesas V850 microcontroller family. The C-SPY® Debugging Guide for V850 replaces all debugging information in the IAR Embedded Workbench IDE User Guide for V850 and the hardware debugger guides for V850. Internal reference: M18, Hom7.2, IJOA. C-SPY® Debugging Guide 2 for V850 AFE1_AFE2-1:1 Brief contents Tables ...................................................................................................................... 19 Preface .................................................................................................................... 21 Part 1. Basic debugging ................................................................ 27 The IAR C-SPY Debugger ........................................................................... 29 Getting started using C-SPY ....................................................................... 39 Executing your application ........................................................................... 69 Variables and expressions ............................................................................ 87 Breakpoints ........................................................................................................ 123 Memory and registers .................................................................................. 149 Part 2. Analyzing your application ................................ 185 Trace ...................................................................................................................... 187 Profiling ................................................................................................................ 217 Code coverage ................................................................................................. 227 Part 3. Advanced debugging ................................................. 231 Interrupts ............................................................................................................ 233 C-SPY macros ................................................................................................. 253 The C-SPY command line utility—cspybat ....................................... 307 Part 4. Additional reference information ............. 321 Debugger options ........................................................................................... 323 Additional information on C-SPY drivers .......................................... 331 3 AFE1_AFE2-1:1 Using the MINICUBE2 emulator ............................................................ 351 Index ..................................................................................................................... 357 4 AFE1_AFE2-1:1 Contents Tables ...................................................................................................................... 19 Preface .................................................................................................................... 21 Who should read this guide ............................................................... 21 Required knowledge .......................................................................... 21 How to use this guide ........................................................................... 21 What this guide contains ..................................................................... 22 Part 1. Basic debugging ..................................................................... 22 Part 2. Analyzing your application .................................................... 22 Part 3. Advanced debugging .............................................................. 23 Part 4. Additional reference information ........................................... 23 Other documentation ........................................................................... 23 User and reference guides .................................................................. 23 The online help system ...................................................................... 24 Web sites ............................................................................................ 24 Document conventions ........................................................................ 25 Typographic conventions ................................................................... 25 Naming conventions .......................................................................... 26 Part 1. Basic debugging ................................................................ 27 The IAR C-SPY Debugger ........................................................................... 29 Introduction to C-SPY .......................................................................... 29 An integrated environment ................................................................. 29 General C-SPY debugger features ..................................................... 30 RTOS awareness ................................................................................ 31 Debugger concepts ................................................................................ 31 C-SPY and target systems .................................................................. 32 The debugger ...................................................................................... 32 The target system ............................................................................... 32 The application ................................................................................... 33 C-SPY debugger systems ................................................................... 33 5 AFE1_AFE2-1:1 The ROM-monitor program ............................................................... 33 Third-party debuggers ........................................................................ 33 C-SPY plugin modules ....................................................................... 33 C-SPY drivers overview ....................................................................... 34 Differences between the C-SPY drivers ........................................... 35 The IAR C-SPY Simulator .................................................................. 35 The C-SPY hardware debugger drivers ........................................ 36 Communication overview .................................................................. 36 Installing the EXEC interface drivers ................................................ 37 Getting started using C-SPY ....................................................................... 39 Setting up C-SPY .................................................................................... 39 Setting up for debugging .................................................................... 39 Executing from reset .......................................................................... 40 Using a setup macro file ..................................................................... 40 Selecting a device description file ..................................................... 41 Loading plugin modules ..................................................................... 41 Starting C-SPY ......................................................................................... 41 Starting a debug session ..................................................................... 42 Loading executable files built outside of the IDE .............................. 42 Starting a debug session with source files missing ............................ 42 Loading multiple images ................................................................... 43 Adapting for target hardware ........................................................... 44 Modifying a device description file ................................................... 44 Initializing target hardware before C-SPY starts ............................... 45 Running example projects .................................................................