MPLAB® IDE SIMULATOR, EDITOR USER’S GUIDE 2002 Microchip Technology Inc. DS51025E Note the following details of the code protection feature on PICmicro® MCUs. • The PICmicro family meets the specifications contained in the Microchip Data Sheet. • Microchip believes that its family of PICmicro microcontrollers is one of the most secure products of its kind on the market today, when used in the intended manner and under normal conditions. • There are dishonest and possibly illegal methods used to breach the code protection feature. All of these methods, to our knowl- edge, require using the PICmicro microcontroller in a manner outside the operating specifications contained in the data sheet. The person doing so may be engaged in theft of intellectual property. • Microchip is willing to work with the customer who is concerned about the integrity of their code. • Neither Microchip nor any other semiconductor manufacturer can guarantee the security of their code. Code protection does not mean that we are guaranteeing the product as “unbreakable”. • Code protection is constantly evolving. We at Microchip are committed to continuously improving the code protection features of our product. If you have any further questions about this matter, please contact the local sales office nearest to you. Information contained in this publication regarding device Trademarks applications and the like is intended through suggestion only and may be superseded by updates. It is your responsibility to The Microchip name and logo, the Microchip logo, KEELOQ, ensure that your application meets with your specifications. MPLAB, PIC, PICmicro, PICSTART and PRO MATE are No representation or warranty is given and no liability is registered trademarks of Microchip Technology Incorporated assumed by Microchip Technology Incorporated with respect in the U.S.A. and other countries. to the accuracy or use of such information, or infringement of FilterLab, microID, MXDEV, MXLAB, PICMASTER, SEEVAL patents or other intellectual property rights arising from such and The Embedded Control Solutions Company are use or otherwise. Use of Microchip’s products as critical com- registered trademarks of Microchip Technology Incorporated ponents in life support systems is not authorized except with in the U.S.A. express written approval by Microchip. No licenses are con- veyed, implicitly or otherwise, under any intellectual property dsPIC, dsPICDEM.net, ECONOMONITOR, FanSense, rights. FlexROM, fuzzyLAB, In-Circuit Serial Programming, ICSP, ICEPIC, microPort, Migratable Memory, MPASM, MPLIB, MPLINK, MPSIM, PICC, PICDEM, PICDEM.net, rfPIC, Select Mode and Total Endurance are trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. Serialized Quick Turn Programming (SQTP) is a service mark of Microchip Technology Incorporated in the U.S.A. All other trademarks mentioned herein are property of their respective companies. © 2002, Microchip Technology Incorporated. Printed in the U.S.A., All Rights Reserved. Printed on recycled paper. Microchip received QS-9000 quality system certification for its worldwide headquarters, design and wafer fabrication facilities in Chandler and Tempe, Arizona in July 1999 and Mountain View, California in March 2002. The Company’s quality system processes and procedures are QS-9000 compliant for its PICmicro® 8-bit MCUs, KEELOQ® code hopping devices, Serial EEPROMs, microperipherals, non-volatile memory and analog products. In addition, Microchip’s quality system for the design and manufacture of development systems is ISO 9001 certified. DS51025E - page ii 2002 Microchip Technology Inc. 12 ® MPLAB IDE USER’S GUIDE Table of Contents Preface Introduction ................................................................................................ 1 Highlights ................................................................................................... 1 About This Guide ....................................................................................... 1 Warranty Registration ................................................................................ 3 Recommended Reading ............................................................................ 4 The Microchip Internet Web Site ............................................................... 5 Development Systems Customer Notification Service .............................. 6 Customer Support ..................................................................................... 8 2001 Microchip Technology Inc. DS51025E-page iii MPLAB® IDE User’s Guide Part 1 - Getting Started with MPLAB IDE Chapter 1. MPLAB IDE Preview 1.1 Introduction .....................................................................................9 1.2 Highlights ........................................................................................9 1.3 What is MPLAB IDE ........................................................................9 1.4 How MPLAB IDE Helps You ...........................................................9 1.5 MPLAB IDE – An Integrated Development Environment (IDE) .....10 1.6 MPLAB IDE Development Tools ...................................................11 Chapter 2. MPLAB IDE Installation 2.1 Introduction ...................................................................................13 2.2 Highlights ......................................................................................13 2.3 Host Computer System Requirements ..........................................13 2.4 Obtaining the Program Files .........................................................13 2.5 Installing MPLAB IDE ....................................................................14 2.6 Uninstalling MPLAB IDE ...............................................................16 Chapter 3. Getting Started with MPLAB IDE – A Tutorial 3.1 Introduction ...................................................................................17 3.2 Highlights ......................................................................................17 3.3 Setting up the Development Mode ................................................18 3.4 Creating a Simple New Project .....................................................19 3.5 Creating a Simple New Source File ..............................................25 3.6 Entering Source Code ...................................................................26 3.7 Assembling the Source File ..........................................................27 3.8 Running Your Program .................................................................28 3.9 Opening Other Windows for Debugging .......................................29 3.10 Using a Watch Window .................................................................29 3.11 Setting a Break Point ....................................................................32 3.12 Summary .......................................................................................32 DS51025E-page iv 2001 Microchip Technology Inc. Table of Contents Chapter 4. Projects Tutorial 4.1 Introduction ................................................................................... 35 4.2 Highlights ...................................................................................... 35 4.3 Overview of Projects ..................................................................... 35 4.4 Making a Project with One MPASM™ Assembler Source File ...... 38 4.5 Compiling a Single MPASM Assembler Source File Without Creating a Project ............................................................ 45 4.6 Making a Project with Multiple MPASM Assembler Source Files using MPLINK™ Linker 49 4.7 Making a Project with Other Tools ................................................ 58 Part 2 - Using MPLAB IDE Chapter 1. MPLAB Editor 1.1 Introduction ................................................................................... 59 1.2 Highlights ...................................................................................... 59 1.3 What is the MPLAB Editor ............................................................ 59 1.4 How MPLAB Editor Helps You ..................................................... 60 1.5 MPLAB Editor Features ................................................................ 60 1.6 MPLAB Editor Functions ............................................................... 61 Chapter 2. Debugging and MPLAB SIM Simulator 2.1 Introduction ................................................................................... 65 2.2 Highlights ...................................................................................... 65 2.3 MPLAB IDE Debugging Functions ................................................ 65 2.4 Real-Time Program Execution ...................................................... 66 2.5 MPLAB SIM Simulator Environment ............................................. 67 2.6 Simulator Considerations .............................................................. 68 2.7 Break and Trace Points ................................................................ 69 2.8 Conditional Break Dialog .............................................................. 75 2.9 Stimulus Functions ....................................................................... 76 2001 Microchip Technology Inc. DS51025E-page v MPLAB® IDE User’s Guide 2.10 12-Bit Core Device Simulator Issues ............................................86 2.11 14-Bit Core Device Simulator Issues ............................................88 2.12 16-Bit Core Device