CodeWarrior® Debugger Because of last-minute changes to CodeWarrior, some of the information in this manual may be inaccurate. Please read the Release Notes on the CodeWarrior CD for the latest up-to-date information. Revised: <9/2/03> ©Metrowerks, Inc., 1993, 2003; All Rights Reserved. Documentation stored on the compact disks may be printed by licensee for personal use. Otherwise, no part of this documentation may be reproduced or transmitted in any form by any means, electronic or mechanical, including photocopying, recording, or by any information storage and retrieval system, without permission in writing from Metrowerks, Inc. Metrowerks, the Metrowerks logo, and CodeWarrior are registered trademarks of Metrowerks, Inc. All other trademarks belong to their respective owners. How to Contact Metrowerks: U.S.A. Metrowerks Corporation 9801 Metric Blvd., Suite #100 Austin, TX 78758 - U.S.A. Europe Metrowerks Europe Riehenring 175 - CH-4058 Basel (Switzerland) ASIA/PACIFIC Metrowerks Japan - Shibuya Mitsuba Building 5F - Udagawa-cho 20-11, Shibuya-ku - Tokyo 150-0042 Japan World Wide Web http://www.metrowerks.com Registration Information http://www.metrowerks.com/register mailto:[email protected] Desktop Technical Support http://www.metrowerks.com/support/desktop/ mailto:[email protected] Embedded Technical Support http://www.metrowerks.com/support/embedded/ U.S.A: mailto:[email protected] Europe: mailto:[email protected] Asia/Pac mailto:[email protected] Sales, Marketing, & Licensing mailto:[email protected] Ordering Voice: (800) 377–5416 Fax: (512) 873–4901 Table of Contents Table of Contents 1 Important Notice 17 Copyrights . 17 Trademarks . 17 Warranty . 18 2Overview 19 About This Guide . 19 Highlights . 20 Read the Release Notes . 20 Document Conventions . 20 3 Introduction 23 What Is the Simulator/Debugger? . 23 What Is a Simulator/Debugger Application? . 24 What Is a Simulator/Debugger Execution Framework? . 25 Understanding the Simulator/Debugger Concept . 26 The Simulator/Debugger Execution Framework . 26 Objects and Services. 27 Framework Components . 27 Demo Version Limitations Components . 28 4 Simulator/Debugger User Interface 29 Introduction. 29 Application Programs . 30 Start the Debugger . 30 Start the debugger from the IDE . 30 Starting the Debugger from a Command Line . 31 Simulator/Debugger Main Menu Bar . 33 Simulator/DebuggerSimulator/Debugger Toolbar . 33 Simulator/Debugger Status Bar . 34 Object Info Bar of the Simulator/Debugger Components . 34 Function of the Main Menu Bar . 35 File Menu . 36 Debugger Manual DM–5 Table of Contents View Menu . 39 Run Menu . 42 Target Menu . 45 Simulator Menu . 48 Component Menu . 56 Window Menu . 57 Help Menu . 58 Component Associated Menus . 61 Component Main Menu . 61 Component Popup Menu . 61 Highlights of the User Interface . 62 Smart User Interface: Activating Services with Drag and Drop . 62 To Drag and Drop an Object. 64 Drag and Drop Combinations . 65 Selection Dialog Box . 69 5 Framework Components 71 Component Introduction . 71 CPU component . 71 Window components. 71 Target components . 72 Components Window . 72 General Component . 73 Adc_Dac component. 74 Assembly Component . 80 Command Line Component . 86 Coverage Component . 91 DAC Component . 96 Data Component . 98 Memory Component . 111 IT_Keyboard. 122 Keyboard . 126 LCD Display Component . 130 Monitor components . 137 Push Buttons components. 141 MicroC Component . 144 Module Component . 149 DM–6 Debugger Manual Table of Contents Procedure Component . 151 Profiler Component . 154 Programmable IO_Ports . 159 Recorder Component . 162 Register Component . 166 Seven segments display component . 171 SoftTrace Component . 175 Source Component . 178 Stimulation Component . 192 TestTerm Component . 195 Terminal Component . 201 Wagon Component . 205 Visualization Utilities . 208 Analog Meter Component . 209 Inspector Component . 211 IO LED Component . 220 LED Component . 222 The Phone Component . 224 VisualizationTool . 227 6 Control Points 244 Control points introduction. 244 Breakpoints setting dialog . 246 Breakpoint Symbols . 246 Description of the Dialog . 247 Multiple selections in the dialog . 248 Checking condition in dialog . 248 Saving Breakpoints . 249 Define Breakpoints . 251 Identify all Positions Where a Breakpoint Can Be Defined . 251 Define a Temporary Breakpoint . 252 Define a Permanent Breakpoint . 253 Define a Counting Breakpoint . 253 Define a Conditional Breakpoint . 255 Delete a Breakpoint . 256 Associate a Command with a Breakpoint . 257 Watchpoints setting dialog . 259 Debugger Manual DM–7 Table of Contents Description of the Dialog . 259 Multiple selections in the dialog . 260 Checking condition in the dialog . 261 General Rules for Halting on a Control Point. 261 Define Watchpoints. 262 Defining a Read Watchpoint . 262 Defining a Write Watchpoint . 263 Defining a Read/Write Watchpoint . 264 Defining a Counting Watchpoint . 264 Defining a Conditional Watchpoint . 265 Deleting a Watchpoint . 267 Associate a Command with a Watchpoint . 268 7 Debugger Commands 269 Simulator/Debugger Commands. 269 List of Available Commands . 270 Definitions of Terms Commonly Used in Command Syntaxes . 280 A . 282 ACTIVATE . 283 ADDCHANNEL . 283 ADCPORT . 284 ADDXPR . 284 ATTRIBUTES . 284 AT . 296 AUTOSIZE . 297 BASE . 297 BC . 298 BCKCOLOR. 299 BD. 300 BS . 300 CALL . 303 CD. 303 CF . 304 CLOCK. 307 CLOSE . 307 COPYMEM . 307 CMDFILE. 308 DM–8 Debugger Manual Table of Contents CPORT . 308 CR . 309 CYCLE . 309 DASM . 310 DB. ..