PICkit 3 Programmer/Debugger User's Guide

1 2009 Microchip Technology 3 Programmer/DebuggerUser s GuideDS51795A-page ii 2009 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 ORWARRANTIES OF ANY KIND WHETHER EXPRESS ORIMPLIED, WRITTEN OR ORAL, STATUTORY OROTHERWISE, RELATED TO THE INFORMATION,INCLUDING BUT NOT LIMITED TO ITS CONDITION,QUALITY, PERFORMANCE, MERCHANTABILITY ORFITNESS FOR PURPOSE. Microchip disclaims all liabilityarising from this information and its use. Use of Microchipdevices in life support and/or safety applications is entirely atthe buyer s risk, and the buyer agrees to defend, indemnify andhold harmless Microchip from any and all damages, claims,suits, or expenses resulting from such use.

2 No licenses areconveyed, implicitly or otherwise, under any Microchipintellectual property Microchip name and logo, the Microchip logo, Accuron, dsPIC, KEELOQ, KEELOQ logo, MPLAB, PIC, PICmicro, PICSTART, rfPIC, SmartShunt and UNI/O are registered trademarks of Microchip Technology Incorporated in the and other , Linear Active Thermistor, MXDEV, MXLAB, SEEVAL, SmartSensor and The embedded Control Solutions Company are registered trademarks of Microchip Technology Incorporated in the Age, Application Maestro, CodeGuard, dsPICDEM, , dsPICworks, dsSPEAK, ECAN, ECONOMONITOR, FanSense, In-Circuit Serial programming , ICSP, ICEPIC, Mindi, MiWi, MPASM, MPLAB Certified logo, MPLIB, MPLINK, mTouch, PICkit , PICDEM, , PICtail, PIC32 logo, PowerCal, PowerInfo, PowerMate, PowerTool, REAL ICE, rfLAB, Select Mode, Total Endurance, WiperLock and ZENA 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.

3 2009, Microchip Technology Incorporated, Printed in the , All Rights Reserved. Printed on recycled 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. 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.

4 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 certification for its worldwide headquarters, design and wafer fabrication facilities in Chandler and Tempe, Arizona; Gresham, Oregon and design centers in California and India. The Company s quality system processes and procedures are for its PIC MCUs and dsPIC DSCs, 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 3 USER S Guide 2009 Microchip Technology iiiTable of ContentsPreface.

5 1 Chapter 1. Introduction .. PICkit 3 Programmer/Debugger Defined .. How the PICkit 3 Programmer/Debugger Helps You .. PICkit 3 Programmer/Debugger Components .. Device and Feature Support .. 13 Chapter 2. Theory of Introduction .. PICkit 3 vs. PICkit 2 .. Debugger to Target Communication .. Communication Connections .. Debugging .. Requirements for Debugging .. programming .. Resources Used by the Debugger .. 22 Chapter 3. Introduction .. Installing the Software .. Connecting the Target .. Setting Up the Target Board .. Setting Up MPLAB IDE .. 25 Chapter 4. General Introduction .. Starting the MPLAB IDE Software .. Creating a Project .. Viewing the Project .. Building the Project .. Setting Configuration Bits .. Setting the Debugger or Programmer .. Debugger/Programmer Limitations .. 29 Chapter 5. PICkit 3 Debug Introduction .. PICkit 3 Debug Express Kit Contents.

6 Installing the Hardware and Software .. 31 PICkit 3 User s GuideDS51795A-page iv 2009 Microchip Technology 6. Troubleshooting First Introduction .. The 5 Questions to Answer First .. Top 10 Reasons Why You Can t Debug .. Other Things to Consider .. 36 Chapter 7. Frequently Asked Questions (FAQs) Introduction .. How Does It Work .. What s Wrong .. 38 Chapter 8. Error Introduction .. Specific Error Messages .. General Corrective Actions .. 44 Chapter 9. Debugger Function Introduction .. Debugging Functions .. Debugging Dialogs/Windows .. programming Functions .. Settings Dialog .. 56 Chapter 10. Hardware Introduction .. Highlights .. Declaration of Conformity .. USB Port/Power .. PICkit 3 Programmer/Debugger .. Standard Communication Hardware .. Target Board Considerations .. 63 Appendix A. PICkit 3 SchematicsAppendix B. Operational AdvisoryGlossary ..71 Index ..91 Worldwide Sales and Service.

7 94 PICkit 3 USER S Guide 2009 Microchip Technology 1 PrefaceINTRODUCTIONThis chapter contains general information that will be useful to know before using PICkit 3 Programmer/Debugger . Items discussed include: Document Layout Conventions Used in this Guide Warranty Registration Recommended Reading The Microchip Web Site Development Systems Customer Change Notification Service Customer SupportNOTICE TO CUSTOMERSAll documentation becomes dated, and this manual is no exception. Microchip tools and documentation are constantly evolving to meet customer needs, so some actual dialogs and/or tool descriptions may differ from those in this document. Please refer to our web site ( ) to obtain the latest documentation are identified with a DS number. This number is located on the bottom of each page, in front of the page number. The numbering convention for the DS number is DSXXXXXA , where XXXXX is the document number and A is the revision level of the the most up-to-date information on development tools, see the MPLAB IDE on-line help.

8 Select the Help menu, and then Topics to open a list of available on-line help 3 User s GuideDS51795A-page 2 2009 Microchip Technology LAYOUTThis document describes how to use the PICkit 2as a development tool to emulate and debug firmware on a target board. The manual layout is as follows: Chapter 1. Overview An overview of the PICkit 3 Programmer/Debugger . Chapter 2. Theory of Operation A simplified description of how the PICkit 3 Programmer/Debugger works. Chapter 3. Installation How to install the PICkit 3 Programmer/Debugger . Chapter 4. General Setup Provides Instructions on how to get started using the PICkit 3 Programmer/Debugger to program supported devices. Chapter 5. PICkit 3 Debug Express Provides basic information on using the PICkit 3 Debug Express. Chapter 6. Troubleshooting First Steps Begins the troubleshooting process by identifying first steps and common reasons for problems with debugging. Chapter 7.

9 Frequently Asked Questions (FAQs) Provides information on solving common problems. Chapter 8. Error Messages Provides specific error messages and general corrective actions. Chapter 9. Debugger Function Summary Summarizes the available debugging functions. Chapter 10. Hardware Specification Details hardware and electrical specifications for the PICkit 3. Appendix A. PICkit 3 Schematics Provides hardware schematic diagrams for the PICkit 3 Programmer/Debugger . Appendix B. Operational Advisory Addresses operational issues to be considered when designing 2009 Microchip Technology 3 CONVENTIONS USED IN THIS GUIDEThe following conventions may appear in this documentation:DOCUMENTATION CONVENTIONSD escriptionRepresentsExamplesArial font:ItalicReferenced booksMPLAB IDE User s GuideEmphasized the only capsA windowthe Output windowA dialogthe Settings dialogA menu selectionselect Enable ProgrammerQuotesA field name in a window or dialog Save project before build Underlined, italic with right angle bracketA menu pathFile>SaveBold charactersA dialog buttonClick OKA tabClick the Power tabText in angle brackets < >A key on the keyboardPress <Enter>, <F1>Courier New font:PlainSample source code#define pathsc.

10 \mcc18\hKeywords_asm, _endasm, staticCommand-line options-Opa+, -Opa-Bit values0, 1 Constants0xFF, A ItalicA variable , where file can be any valid filenameSquare brackets [ ]Optional argumentsmpasmwin [options] file [options]Curly brackets and pipe character: { | }Choice of mutually exclusive arguments; an OR selectionerrorlevel {0|1} repeated textvar_name [, ]Represents code supplied by uservoid main (void){ ..} PICkit 3 User s GuideDS51795A-page 4 2009 Microchip Technology REGISTRATIONP lease complete the enclosed Warranty Registration Card and mail it promptly. Sending in the Warranty Registration Card entitles users to receive new product updates. Interim software releases are available at the Microchip web READINGThis User's Guide describes how to use PICkit 2. Other useful documents are listed below. The following Microchip documents are available and recommended as supplemental reference Demo Board User s Guide (DS41296)Consult this document for instructions on how to use the 44-Pin demo board as a development tool to emulate and debug firmware on a target Pin Count Demo Board User s Guide (DS51556)Consult this document for instructions on how to use Microchip Technology s low pin count device (8-pin, 14-pin and 20-pin).