MPLAB XC32 C/C++ Compiler User's Guide - Microchip …

1 MPLAB xc32 C/C++ Compiler User's Guide 2012-2016 Microchip Technology Inc. DS50001686J. 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.

2 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 our products. Attempts to break Microchip 's code protection feature may be a violation of the Digital Millennium Copyright Act. If such acts allow unauthorized access to your software or other copyrighted work, you may have a right to sue for relief under that Act.

3 Information contained in this publication regarding device Trademarks applications and the like is provided only for your convenience The Microchip name and logo, the Microchip logo, AnyRate, and may be superseded by updates. It is your responsibility to dsPIC, FlashFlex, flexPWR, Heldo, JukeBlox, KEELOQ, ensure that your application meets with your specifications. KEELOQ logo, Kleer, LANC heck, LINK MD, MediaLB, MOST, Microchip MAKES NO REPRESENTATIONS OR MOST logo, MPLAB , OptoLyzer, PIC, PICSTART, PIC32 logo, WARRANTIES OF ANY KIND WHETHER EXPRESS OR RightTouch, SpyNIC, SST, SST Logo, SuperFlash and UNI/O. IMPLIED, WRITTEN OR ORAL, STATUTORY OR are registered trademarks of Microchip Technology OTHERWISE, RELATED TO THE INFORMATION, Incorporated in the and other countries.

4 INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR ClockWorks, The Embedded Control Solutions Company, FITNESS FOR PURPOSE. Microchip disclaims all liability ETHERSYNCH, Hyper Speed Control, HyperLight Load, arising from this information and its use. Use of Microchip IntelliMOS, mTouch, Precision Edge, and QUIET-WIRE are devices in life support and/or safety applications is entirely at registered trademarks of Microchip Technology Incorporated the buyer's risk, and the buyer agrees to defend, indemnify and in the hold harmless Microchip from any and all damages, claims, Analog-for-the-Digital Age, Any Capacitor, AnyIn, AnyOut, suits, or expenses resulting from such use.

5 No licenses are BodyCom, chipKIT, chipKIT logo, CodeGuard, dsPICDEM, conveyed, implicitly or otherwise, under any Microchip , Dynamic Average Matching, DAM, ECAN, intellectual property rights unless otherwise stated. EtherGREEN, In-Circuit Serial Programming, ICSP, Inter-Chip Connectivity, JitterBlocker, KleerNet, KleerNet logo, MiWi, motorBench, MPASM, MPF, MPLAB Certified logo, MPLIB, MPLINK, MultiTRAK, NetDetach, Omniscient Code Generation, PICDEM, , PICkit, PICtail, PureSilicon, RightTouch logo, REAL ICE, Ripple Blocker, 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 countries.

6 SQTP is a service mark of Microchip Technology Incorporated in the Microchip received ISO/TS-16949:2009 certification for its worldwide headquarters, design and wafer fabrication facilities in Chandler and Silicon Storage Technology is a registered trademark of Tempe, Arizona; Gresham, Oregon and design centers in California Microchip Technology Inc. in other countries. and India. The Company's quality system processes and procedures are for its PIC MCUs and dsPIC DSCs, KEELOQ code hopping GestIC is a registered trademarks of Microchip Technology devices, Serial EEPROMs, microperipherals, nonvolatile memory and Germany II GmbH & Co. KG, a subsidiary of Microchip analog products.

7 In addition, Microchip 's quality system for the design and manufacture of development systems is ISO 9001:2000 certified. Technology Inc., in other countries. All other trademarks mentioned herein are property of their respective companies. QUALITY MANAGEMENT SYSTEM 2012-2016, Microchip Technology Incorporated, Printed in CERTIFIED BY DNV the , All Rights Reserved. ISBN: 978-1-5224-0679-2. == ISO/TS 16949 ==. DS50001686J-page 2 2012-2016 Microchip Technology Inc. MPLAB xc32 C/C++ Compiler . User's Guide . Table of Contents Preface .. 9. Document Layout .. 9. Conventions Used .. 11. Recommended 12. Chapter 1. Compiler Overview Introduction .. 15. Device Description.

8 15. Compiler Description and Documentation .. 15. Compiler and Other Development Tools .. 17. Chapter 2. Common C Interface Introduction .. 19. Background The Desire for Portable Code .. 19. Using the CCI .. 22. ANSI Standard Refinement .. 23. ANSI Standard Extensions .. 31. Compiler Features .. 46. Chapter 3. How To's Introduction .. 47. Installing and Activating the Compiler .. 47. Invoking the Compiler .. 49. Writing Source Code .. 52. Getting My Application to Do What I Want .. 62. Understanding the Compilation Process .. 66. Fixing Code That Does Not Work .. 73. Chapter 4. xc32 Toolchain and MPLAB X IDE. Introduction .. 75. MPLAB X IDE and Tools Installation.

9 75. MPLAB X IDE Setup .. 76. MPLAB X IDE Projects .. 77. Project Setup .. 79. Project Example .. 90. Chapter 5. Compiler Command Line Driver Introduction .. 93. Invoking the Compiler .. 93. The C Compilation Sequence .. 97. The C++ Compilation Sequence .. 100. 2012-2016 Microchip Technology Inc. DS50001686J-page 3. MPLAB xc32 C/C++ Compiler User's Guide Runtime Files .. 104. Start-Up and Initialization .. 107. Compiler Output .. 109. Compiler Messages .. 111. Driver Option Descriptions .. 111. Chapter 6. ANSI C Standard Issues Introduction .. 135. Divergence from the ANSI C Standard .. 135. Extensions to the ANSI C Standard .. 135. Implementation-Defined Behavior.

10 136. Chapter 7. Device-Related Features Introduction .. 137. Device Support .. 137. Device Header Files .. 137. Stack .. 138. Configuration Bit Access .. 139. ID Locations .. 140. Using SFRs From C Code .. 141. Chapter 8. Supported Data Types and Variables Introduction .. 145. Identifiers .. 145. Data Representation .. 145. Integer Data Types .. 146. Floating-Point Data Types .. 148. Structures and Unions .. 150. Pointer Types .. 152. Complex Data Types .. 154. Constant Types and Formats .. 154. Standard Type Qualifiers .. 157. Compiler -Specific Qualifiers .. 158. Variable Attributes .. 158. Chapter 9. Memory Allocation and Access Introduction .. 163. Address Spaces.