MPLAB X IDE User’s Guide - Microchip Technology

1 2011 Microchip Technology X IDEUser s GuideDS52027A-page 2 2011 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.

2 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. No licenses areconveyed, implicitly or otherwise, under any Microchipintellectual property Microchip name and logo, the Microchip logo, dsPIC, KEELOQ, KEELOQ logo, MPLAB , PIC, PICmicro, PICSTART, PIC32 logo, rfPIC and UNI/O are registered trademarks of Microchip Technology Incorporated in the and other , Hampshire, HI-TECH C, Linear Active Thermistor, MXDEV, MXLAB, SEEVAL and The Embedded Control Solutions Company are registered trademarks of Microchip Technology Incorporated in the Age, Application Maestro, chipKIT, chipKIT logo, CodeGuard, dsPICDEM, , dsPICworks, dsSPEAK, ECAN, ECONOMONITOR.

3 FanSense, HI-TIDE, In-Circuit Serial Programming, ICSP, Mindi, MiWi, MPASM, MPLAB Certified logo, MPLIB, MPLINK, mTouch, Omniscient Code Generation, PICC, PICC-18, PICDEM, , PICkit, PICtail, REAL ICE, rfLAB, Select Mode, Total Endurance, TSHARC, UniWinDriver, 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. 2011, Microchip Technology Incorporated, Printed in the , All Rights Reserved. Printed on recycled : 978-1-61341-883-3 Note the following details of the code protection feature on Microchip devices: Microchip products meet the specification contained in their particular Microchip Data Sheet.

4 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.

5 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:2009 certification for its worldwide headquarters, design and wafer fabrication facilities in Chandler and Tempe, Arizona; Gresham, Oregon and design centers in California and India.

6 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 X IDEUSER S Guide 2011 Microchip Technology Inc. DS52027A-page 3 Table of ContentsPreface ..7 Chapter 1. What is MPLAB X IDE? An Overview of Embedded Systems .. The Development Cycle .. Project Manager .. Language Tools .. Target Debugging .. Device Programming .. Components of MPLAB X IDE .. MPLAB X IDE Online Help.

7 Other MPLAB X IDE Documentation .. Web Site .. MPLAB X IDE Updates .. 25 Chapter 2. Before You Install JRE and MPLAB X IDE .. Install the USB Device Drivers (For Hardware Tools) .. Connect to a Target (For Hardware Tools) .. Install the Language Tools .. Launch the IDE .. Launch Multiple Instances of the IDE .. 34 Chapter 3. Tutorial Equipment .. Installation and Setup .. Create a New Project .. View Changes to the Desktop .. View or Make Changes to Project Properties .. Set Options for Debugger, Programmer or Language Tools .. Set Language Tool Locations .. Add An Existing File to the Project.

8 46 MPLAB X IDE user s GuideDS52027A-page 4 2011 Microchip Technology Editor Usage .. Configuration Bits .. Build a Project .. Run Code .. Debug Run Code .. Control Program Execution with Breakpoints .. Step Through Code .. Watch Symbol Values Change .. View Device Memory (including Configuration Bits) .. Program a Device ..55 Chapter 4. Basic Working with MPLAB X IDE Projects .. Create a New Project .. View Changes to the Desktop .. View or Make Changes to Project Properties .. Set Options for Debugger, Programmer or Language Tools .. Set Language Tool Locations .. Set Other Tool Options.

9 Create a New Project File .. Add Existing Files to a Project .. Editor Usage .. Add Library and Other Files to a Project .. Set File Properties .. Set Build Properties .. Build a Project .. Run Code .. Debug Run Code .. Control Program Execution with Breakpoints .. Step Through Code .. Watch Symbol and Variable Values Change .. View/Change Device Memory (including Configuration Bits) .. View The Call Stack .. Program a Device ..85 Table of Contents 2011 Microchip Technology Inc. DS52027A-page 5 Chapter 5. Additional Performing Additional Tasks .. Import MPLAB Legacy Project .. Prebuilt Projects.

10 Library Projects .. Modify or Create Code Templates .. Switch Hardware or Language Tools .. Use the Stopwatch .. View the Disassembly Window .. View The Call Graph .. View the Dashboard Display .. Improve Your Code .. Control Source Code .. Collaborate on Code Development and Error Tracking .. Add Plug-In Tools .. 100 Chapter 6. Advanced Multiple Projects .. Multiple Configurations .. NetBeans Editor .. C Code Refactoring .. 109 Chapter 7. USB Driver Installation Issues .. Cross-Platform Issues .. MPLAB X IDE Issues .. NetBeans Platform Issues .. Errors .. Forums.