MPLAB IDE User's Guide - Microchip Technology

1 2005 Microchip Technology IDEUSER S GUIDEDS51519A-page ii 2005 Microchip Technology contained in this publication regarding deviceapplications and the like is provided only for your convenienceand may be superseded by updates. It is your responsibility toensure that your application meets with your MAKES NO REPRESENTATIONS OR WAR-RANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED,WRITTEN OR ORAL, STATUTORY OR OTHERWISE,RELATED TO THE INFORMATION, INCLUDING BUT NOTLIMITED TO ITS CONDITION, QUALITY, PERFORMANCE,MERCHANTABILITY OR FITNESS FOR disclaims all liability arising from this information andits use. Use of Microchip s products as critical components inlife support systems is not authorized except with expresswritten approval by Microchip . No licenses are conveyed,implicitly or otherwise, under any Microchip intellectual Microchip name and logo, the Microchip logo, Accuron, dsPIC, KEELOQ, microID, MPLAB , PIC, PICmicro, PICSTART, PRO MATE, PowerSmart, rfPIC, and SmartShunt are registered trademarks of Microchip Technology Incorporated in the and other , FilterLab, Migratable Memory, MXDEV, MXLAB, PICMASTER, SEEVAL, SmartSensor and The Embedded Control Solutions Company are registered trademarks of Microchip Technology Incorporated in the Age, Application Maestro, dsPICDEM, , dsPICworks, ECAN, ECONOMONITOR, FanSense, FlexROM, fuzzyLAB, In-Circuit Serial Programming, ICSP, ICEPIC, MPASM, MPLIB, MPLINK, MPSIM, PICkit, PICDEM, , PICLAB, PICtail, PowerCal, PowerInfo, PowerMate, PowerTool, rfLAB, rfPICDEM, Select Mode, Smart Serial.

2 SmartTel and Total Endurance are trademarks of Microchip Technology Incorporated in the and other is a service mark of Microchip Technology Incorporated in the other trademarks mentioned herein are property of their respective companies. 2005, Microchip Technology Incorporated, Printed in the , All Rights Reserved. Printed on recycled paper. 11/12/04 Note the following details of the code protection feature on Microchip devices: Microchip products meet the specification contained in their particular Microchip Data Sheet. Microchip believes that its family of products is one of the most secure families 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 knowledge, require using the Microchip products in a manner outside the operating specifications contained in Microchip s Data Sheets.

3 Most likely, the person doing so is 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 ourproducts. Attempts to break Microchip s code protection feature may be a violation of the Digital Millennium Copyright Act. If such actsallow unauthorized access to your software or other copyrighted work, you may have a right to sue for relief under that received ISO/TS-16949:2002 quality system certification for its worldwide headquarters, design and wafer fabrication facilities in Chandler and Tempe, Arizona and Mountain View, California in October 2003.

4 The Company s quality system processes and procedures are for its PICmicro 8-bit MCUs, KEELOQ code hopping devices, Serial EEPROMs, microperipherals, nonvolatile memory and analog products. In addition, Microchip s quality system for the design and manufacture of development systems is ISO 9001:2000 IDEUSER S Guide 2005 Microchip Technology iiiTable of ContentsPreface .. 1 Part 1 MPLAB IDEC hapter 1. What is MPLAB IDE? An Overview of Embedded Systems .. The Development Cycle .. Project Manager .. Language Tools .. Target Debugging .. Device Programming .. Components of MPLAB IDE .. MPLAB IDE Documentation .. MPLAB IDE On-line Help .. MPLAB IDE Updates and Version Numbering .. 22 Chapter 2. Getting Started with MPLAB IDE: A Basic Introduction .. MPLAB IDE Features and Installation .. Tutorial Overview .. Selecting the Device.

5 Creating the Project .. Setting Up Language Tools .. Naming the Project .. Adding Files to the Project .. Building the Project .. Creating Code .. Building the Project Again .. Testing Code with the Simulator .. Tutorial Summary .. 45 Chapter 3. Walk-Through and Introduction .. Selecting a Device .. Setting Up Configuration Bits .. Creating Source Code with the Editor .. Creating a New Project .. Using the Project Wizard .. Setting Up the Language Toolsuite .. 50 MPLAB IDE user s GuideDS51519A-page iv 2005 Microchip Technology Naming and Locating the Project .. Adding Files .. Completing the Project .. Viewing the Project Window .. Setting Build Options .. Building The Project .. Choosing a Debugger .. Running Your Code .. Viewing Debug Windows .. Using Watch Windows .. Using Breakpoints .. Choosing a Programmer.

6 Programming Your Part .. Using Microchip Help .. 59 Chapter 4. Projects and Introduction .. Using the Project Wizard .. Creating/Updating any Project .. Setting Up a Project Structure Relative Paths .. Project Folders and Files .. Using A Version-Control System (VCS) .. Setting Up/Changing a Project .. Using a Single Project and Workspace .. Using Multiple Projects in a Single Workspace .. Building an Application without a Project .. 73 Chapter 5. Integrated Introduction .. Language Toolsuites .. Microchip Language Tools .. Third Party Language Tools .. Editors .. Simulators .. In-Circuit Emulators .. In-Circuit Debuggers .. Programmers .. Third Party Tools .. 82 Chapter 6. MPLAB IDE Introduction .. Common Problems/FAQ .. Error Messages .. Limitations .. 85 Table of Contents 2005 Microchip Technology vPart 2 MPLAB IDE ReferenceChapter 7.

7 MPLAB IDE Introduction .. MPLAB IDE Menu Bar .. MPLAB IDE Toolbars .. MPLAB IDE Status Bar .. 99 Chapter 8. MPLAB IDE Introduction .. Changing Window Data and Properties .. Code Display Window Symbols .. Project Window .. Output Window .. Disassembly Listing Window .. Hardware Stack Window .. Program Memory Window .. File Registers Window .. EEPROM Window .. LCD Pixel Window .. Watch Window .. Special Function Registers Window .. Trace Memory Window .. Configuration Bits Window .. File (Editor) Window .. 126 Chapter 9. MPLAB IDE Introduction .. About MPLAB IDE Dialog .. Add Watch Dialog .. Breakpoints Dialog .. Build Options Dialog .. Export Hex File Dialog .. External Memory Setting Dialog .. File Management Dialog .. Fill Memory/Registers Dialog .. Find In Project Files Dialog .. Find and Replace Dialogs.

8 Help Topics Dialog .. Import Dialog .. New Project Dialog .. Project-Display Preferences Dialog .. Project Wizard Dialogs .. Properties Dialog .. Save Project As Dialog .. 138 MPLAB IDE user s GuideDS51519A-page vi 2005 Microchip Technology Select Device Dialog .. Select Language Toolsuite Dialog .. Set Language Tool Location Dialog .. Settings Dialog .. Table Setup Dialog .. user ID Memory Dialog .. Version-Control Dialog .. Watch Dialog .. 145 Chapter 10. MPLAB IDE Operational Introduction .. Command-Line Options .. Files Used by MPLAB IDE .. Saved Information .. 148 Part 3 MPLAB EditorChapter 11. Using the Introduction .. Configuring the Editor .. Working with Files .. Working with Text .. Working with Debug Features .. Keyboard Features .. Editor Troubleshooting .. 164 Part 4 MPLAB SIMC hapter 12.

9 Simulator Introduction .. Simulator Features .. Simulator Model PICmicro MCUs .. Simulator Model dsPIC DSCs .. Simulator Execution .. 178 Chapter 13. Getting Started with MPLAB Introduction .. Using the Stopwatch .. Using Stimulus .. Using Simulator Trace .. Using External Memory .. 182 Chapter 14. Using Introduction .. SCL Generator Dialog .. Stimulus Controller Dialog .. Stimulus Input Interaction .. 195 Table of Contents 2005 Microchip Technology viiChapter 15. Using Stimulus PIC17 Introduction .. Using Pin Stimulus .. Using File Stimulus .. 200 Chapter 16. Simulator Introduction .. Common Problems/FAQ .. Limitations .. 206 Chapter 17. Simulator Introduction .. Debugging Functions .. Settings Dialog .. Settings Dialog PIC17 Devices .. 210 Glossary .. 213 Index .. 227 Worldwide Sales and Service.

10 232 MPLAB IDE user s GuideDS51519A-page viii 2005 Microchip Technology : 2005 Microchip Technology Inc. DS51519A-page 1 MPLAB IDEUSER S GUIDEP refaceINTRODUCTIONThis chapter contains general information that will be useful to know before using MPLAB IDE. Items discussed in this chapter include: Document Layout Conventions Used in this Guide Recommended Reading The Microchip Web Site Development Systems Customer Change Notification Service Customer SupportDOCUMENT LAYOUTThis document describes how to use MPLAB IDE to develop your firmware. The manual layout is as follows:Part 1 - MPLAB IDE Chapter 1: What is MPLAB IDE? Describes MPLAB IDE and how it can help develop an application. Chapter 2: Getting Started with MPLAB IDE: A Basic Tutorial How to install MPLAB IDE software and how to use the software to develop an example application. Chapter 3: Walk-Through and Tutorial Walks through the necessary steps to develop an application using MPLAB IDE.