Bootloader Generator User's Guide - Microchip Technology

1 2015-2016 Microchip Technology GeneratorUser s GuideDS40001779B-page 2 2015-2016 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 rights unless otherwise 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.

3 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. 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 MANAGEMENT SYSTEM CERTIFIE D BY DNV == ISO/TS 16949 == TrademarksThe Microchip name and logo, the Microchip logo, AnyRate, AVR, AVR logo, AVR Freaks, BeaconThings, BitCloud, CryptoMemory, CryptoRF, dsPIC, FlashFlex, flexPWR, Heldo, JukeBlox, KEELOQ, KEELOQ logo, Kleer, LANC heck, LINK MD, maXStylus, maXTouch, MediaLB, megaAVR, MOST, MOST logo, MPLAB, OptoLyzer, PIC, picoPower, PICSTART, PIC32 logo, Prochip Designer, QTouch, RightTouch, SAM-BA, SpyNIC, SST, SST Logo, SuperFlash, tinyAVR, UNI/O, and XMEGA are registered trademarks of Microchip Technology Incorporated in the and other , The Embedded Control Solutions Company, EtherSynch, Hyper Speed Control, HyperLight Load, IntelliMOS, mTouch, Precision Edge, and Quiet-Wire are registered trademarks of Microchip Technology Incorporated in the Key Suppression, AKS, Analog-for-the-Digital Age, Any Capacitor, AnyIn, AnyOut, BodyCom, chipKIT, chipKIT logo, CodeGuard, CryptoAuthentication, CryptoCompanion.

4 CryptoController, dsPICDEM, , Dynamic Average Matching, DAM, ECAN, EtherGREEN, In-Circuit Serial Programming, ICSP, Inter-Chip Connectivity, JitterBlocker, KleerNet, KleerNet logo, Mindi, MiWi, motorBench, MPASM, MPF, MPLAB Certified logo, MPLIB, MPLINK, MultiTRAK, NetDetach, Omniscient Code Generation, PICDEM, , PICkit, PICtail, PureSilicon, QMatrix, RightTouch logo, REAL ICE, Ripple Blocker, SAM-ICE, Serial Quad I/O, , SQI, SuperSwitcher, SuperSwitcher II, Total Endurance, TSHARC, USBC heck, VariSense, ViewSpan, WiperLock, Wireless DNA, and ZENA are trademarks of Microchip Technology Incorporated in the and other is a service mark of Microchip Technology Incorporated in the Storage Technology is a registered trademark of Microchip Technology Inc. in other is a registered trademark of Microchip Technology Germany II GmbH & Co. KG, a subsidiary of Microchip Technology Inc., in other countries. All other trademarks mentioned herein are property of their respective companies.

5 2015-2016, Microchip Technology Incorporated, All Rights Reserved. ISBN: 978-1-5224-1205-2 Bootloader GENERATORUSER S Guide 2015-2016 Microchip Technology 3 Table of ContentsPreface .. 5 Chapter 1. Bootloader Overview .. Bootloader Requirements .. 9 Chapter 2. Options, Parts and Communication Method .. Verification of Bootload Integrity .. Self Protection .. IO Pin Indicator .. Enable Read Flash .. Enable Read/Write EEData .. Encryption .. 16 Chapter 3. Hex Intel Hex File Format .. PIC16F1 XXX Interpretations .. PIC18 Interpretations .. 20 Chapter 4. MCC Bootloader Generate Bootloader .. 21 Chapter 5. Merge Bootloader with the MPLAB X Project configurations .. End Application Project Configurations .. 27 Chapter 6. Bootloader Host Overall Working Strategy .. Prerequisites .. Detailed Steps .. Menu Bar Options .. Troubleshooting .. External Dependencies .. The Host Application .. 36 Chapter 7. Bootloader Command set.

6 The Host Application .. Additional commands .. 41 Worldwide Sales and Service .. 45 Bootloader Generator user s GuideDS40001779B-page 4 2015-2016 Microchip Technology : Bootloader GENERATORUSER S Guide 2015-2016 Microchip Technology 5 PrefaceINTRODUCTIONThis chapter contains general information that will be useful to know before using the Bootloader Generator . Items discussed in this chapter include: Document Layout Conventions Used in this Guide Warranty Registration Recommended Reading The Microchip Website Development Systems Customer Change Notification Service Customer Support Revision HistoryDOCUMENT LAYOUTThis document describes how to use the Bootloader Generator software library through MCC to produce code for application integration, along with use of MPLAB X and the Unified Bootloader Application. The document is organized as follows: Chapter 1. Overview Chapter 2. Options, Parts and Pieces Chapter 3. Hex File Chapter 4.

7 MCC Bootloader Generator Chapter 5. Merge Bootloader with the Application Chapter 6. Bootloader Host Application Chapter 7. Bootloader Protocol NOTICE 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 website ( ) 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 online help. Select the Help menu, and then Topics to open a list of available online help Generator user s GuideDS40001779B-page 6 2015-2016 Microchip Technology USED IN THIS GUIDEThis manual uses the following documentation conventions:DOCUMENTATION CONVENTIONSD escriptionRepresentsExamplesArial font:Italic charactersReferenced 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 text with right angle bracketA menu pathFile>SaveBold charactersA dialog buttonClick OKA tabClick the Power tabN RnnnnA number in verilog format, where N is the total number of digits, R is the radix and n is a b0010, 2 hF1 Text in angle brackets < >A key on the keyboardPress <Enter>, <F1>Courier New font:Plain Courier NewSample source code#define pathsc.

8 \mcc18\hKeywords_asm, _endasm, staticCommand-line options-Opa+, -Opa-Bit values0, 1 Constants0xFF, A Italic Courier NewA variable , where file can be any valid filenameSquare brackets [ ]Optional argumentsmcc18 [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){ ..}Preface 2015-2016 Microchip Technology 7 WARRANTY 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 READINGThis user s Guide describes how to use Bootloader Generator MCC software library, and Unified Bootloader host application. Other useful documents are listed below. The following Microchip documents are available and recommended as supplemental ref-erence Notes for MPLAB ICD 3 In-Circuit DebuggerFor the latest information on using Bootloader Generator , read the Readme for Bootloader file (an HTML file) in the Readmes subdirectory of the MPLAB IDE installation directory.

9 The release notes (Readme) contains update information and known issues that may not be included in this user s Microchip WEBSITEM icrochip provides online support via our website at This website is used as a means to make files and information easily available to customers. Acces-sible by using your favorite Internet browser, the website contains the following infor-mation: Product Support Data sheets and errata, application notes and sample programs, design resources, user s guides and hardware support documents, latest software releases and archived software General Technical Support Frequently Asked Questions (FAQs), technical support requests, online discussion groups, Microchip consultant program member listing Business of Microchip Product selector and ordering guides, latest Microchip press releases, listing of seminars and events, listings of Microchip sales offices, distributors and factory representativesDEVELOPMENT SYSTEMS CUSTOMER CHANGE NOTIFICATION SERVICEM icrochip s customer notification service helps keep customers current on Microchip products.

10 Subscribers will receive e-mail notification whenever there are changes, updates, revisions or errata related to a specified product family or development tool of register, access the Microchip website at , click on Customer Change Notification and follow the registration Development Systems product group categories are: Compilers The latest information on Microchip C compilers, assemblers, linkers and other language tools. These include all MPLAB C compilers; all MPLAB assemblers (including MPASM assembler); all MPLAB linkers (including MPLINK object linker); and all MPLAB librarians (including MPLIB object librarian). Emulators The latest information on Microchip in-circuit includes the MPLAB REAL ICE and MPLAB ICE 2000 in-circuit emulators. In-Circuit Debuggers The latest information on the Microchip in-circuit debuggers. This includes MPLAB ICD 3 in-circuit debuggers and PICkit 3 debug Generator user s GuideDS40001779B-page 8 2015-2016 Microchip Technology Inc.