MPLAB C Compiler for PIC24 MCUs and dsPIC DSCs ... - Microchip

More documents

Recommendations

Info

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. 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. Information contained in this publication regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer’s risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights. Trademarks The Microchip name and logo, the Microchip logo, Accuron, dsPIC, KEELOQ, KEELOQ logo, MPLAB, PIC, PICmicro, PICSTART, PRO MATE, rfPIC and SmartShunt are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. FilterLab, Linear Active Thermistor, MXDEV, MXLAB, SEEVAL, SmartSensor and The Embedded Control Solutions Company are registered trademarks of Microchip Technology Incorporated in the U.S.A. Analog-for-the-Digital Age, Application Maestro, CodeGuard, dsPICDEM, dsPICDEM.net, dsPICworks, dsSPEAK, ECAN, ECONOMONITOR, FanSense, In-Circuit Serial Programming, ICSP, ICEPIC, Mindi, MiWi, MPASM, MPLAB Certified logo, MPLIB, MPLINK, mTouch, PICkit, PICDEM, PICDEM.net, PICtail, PIC32 logo, PowerCal, PowerInfo, PowerMate, PowerTool, REAL ICE, rfLAB, Select Mode, Total Endurance, UNI/O, WiperLock and ZENA are trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. SQTP is a service mark of Microchip Technology Incorporated in the U.S.A. All other trademarks mentioned herein are property of their respective companies. © 2008, Microchip Technology Incorporated, Printed in the U.S.A., All Rights Reserved. Printed on recycled paper. Microchip 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 certified. DS51284H-page ii © 2008 Microchip Technology Inc.
MPLAB ® C COMPILER FOR PIC24 MCUs AND dsPIC ® DSCs USER’S GUIDE Table of Contents Preface ........................................................................................................................... 1 Chapter 1. Compiler Overview 1.1 Introduction ..................................................................................................... 7 1.2 Highlights ........................................................................................................ 7 1.3 Compiler Description and Documentation ...................................................... 7 1.4 Compiler and Other Development Tools ........................................................ 8 1.5 Compiler Feature Set ..................................................................................... 9 Chapter 2. Differences Between 16-Bit Device C and ANSI C 2.1 Introduction ................................................................................................... 11 2.2 Highlights ...................................................................................................... 11 2.3 Keyword Differences .................................................................................... 11 2.4 Statement Differences .................................................................................. 30 2.5 Expression Differences ................................................................................ 32 Chapter 3. Using the Compiler on the Command Line 3.1 Introduction ................................................................................................... 33 3.2 Highlights ...................................................................................................... 33 3.3 Overview ...................................................................................................... 33 3.4 File Naming Conventions ............................................................................. 34 3.5 Options ......................................................................................................... 34 3.6 Environment Variables ................................................................................. 59 3.7 Predefined Macro Names ............................................................................. 60 3.8 Compiling a Single File on the Command Line ............................................ 60 3.9 Compiling Multiple Files on the Command Line ........................................... 61 3.10 Notable Symbols ........................................................................................ 62 Chapter 4. Run Time Environment 4.1 Introduction ................................................................................................... 63 4.2 Highlights ...................................................................................................... 63 4.3 Address Spaces ........................................................................................... 63 4.4 Startup and Initialization ............................................................................... 64 4.5 Memory Spaces ........................................................................................... 65 4.6 Memory Models ............................................................................................ 66 4.7 Locating Code and Data ............................................................................... 68 4.8 Software Stack ............................................................................................. 69 4.9 The C Stack Usage ...................................................................................... 70 4.10 The C Heap Usage ..................................................................................... 72 4.11 Function Call Conventions ......................................................................... 73 4.12 Register Conventions ................................................................................. 75 © 2008 Microchip Technology Inc. DS51284H-page iii
Page 1: MPLAB ® C COMPILER FOR PIC24 MCUs
Page 5 and 6: Table of Contents A.5 Identifiers .
Page 7 and 8: INTRODUCTION MPLAB ® C COMPILER FO
Page 9 and 10: CONVENTIONS USED IN THIS GUIDE The
Page 11 and 12: THE MICROCHIP WEB SITE Preface C Re
Page 13 and 14: 1.1 INTRODUCTION 1.2 HIGHLIGHTS MPL
Page 15 and 16: 1.5 COMPILER FEATURE SET Compiler O
Page 17 and 18: MPLAB ® C COMPILER FOR PIC24 MCUs
Page 19 and 20: Differences Between 16-Bit Device C
Page 39 and 40: MPLAB ® C COMPILER FOR PIC24 MCUs
Page 41 and 42: Using the Compiler on the Command L
Page 53 and 54:
Using the Compiler on the Command L
Page 55 and 56:
Page 57 and 58:
Page 59 and 60:
Page 61 and 62:
Page 63 and 64:
Page 65 and 66:
3.6 ENVIRONMENT VARIABLES Using the
Page 67 and 68:
Page 69 and 70:
4.1 INTRODUCTION 4.2 HIGHLIGHTS 4.3
Page 71 and 72:
4.5 MEMORY SPACES Run Time Environm
Page 73 and 74:
Run Time Environment 1. It is possi
Page 75 and 76:
4.8 SOFTWARE STACK Run Time Environ
Page 77 and 78:
FIGURE 4-2: CALL OR RCALL Stack gro
Page 79 and 80:
4.11 FUNCTION CALL CONVENTIONS Run
Page 81 and 82:
Run Time Environment The compiler a
Page 83 and 84:
4.14.2 String Literals as Arguments
Page 85 and 86:
5.1 INTRODUCTION 5.2 HIGHLIGHTS MPL
Page 87 and 88:
6.1 INTRODUCTION MPLAB ® C COMPILE
Page 89 and 90:
6.3 PMP POINTERS Additional C Point
Page 91 and 92:
6.4 EXTERNAL POINTERS 6.3.3 Define
Page 93 and 94:
ead_external16 Additional C Pointer
Page 95 and 96:
Additional C Pointer Types } else {
Page 97 and 98:
Page 99 and 100:
7.5 USING SFRS Device Support Files
Page 101 and 102:
7.6 USING MACROS Device Support Fil
Page 103 and 104:
EXAMPLE 7-2: EEDATA ACCESS VIA PSV
Page 105 and 106:
Page 107 and 108:
Interrupts When using the interrupt
Page 109 and 110:
8.4.1 dsPIC30F DSCs (Non-SMPS) Inte
Page 111 and 112:
8.4.3 PIC24F MCUs Interrupt Vectors
Page 113 and 114:
Interrupts TABLE 8-3: INTERRUPT VEC
Page 115 and 116:
Interrupts TABLE 8-4: INTERRUPT VEC
Page 117 and 118:
85 _Interrupt85 _AltInterrupt85 Res
Page 119 and 120:
8.8 ENABLING/DISABLING INTERRUPTS I
Page 121 and 122:
Interrupts 2. Unsafe: read bar inte
Page 123 and 124:
LATGbits.LATG2 = 0; /* No problem l
Page 125 and 126:
MPLAB ® C COMPILER FOR PIC24 MCUs
Page 127 and 128:
Mixing Assembly Language and C Modu
Page 129 and 130:
Page 131 and 132:
Page 133 and 134:
Page 135 and 136:
Page 137 and 138:
A.5 IDENTIFIERS A.6 CHARACTERS Impl
Page 139 and 140:
Implementation-Defined Behavior The
Page 141 and 142:
A.15 PREPROCESSING DIRECTIVES Imple
Page 143 and 144:
A.17 SIGNALS A.18 STREAMS AND FILES
Page 145 and 146:
A.24 GETENV A.25 SYSTEM A.26 STRERR
Page 147 and 148:
B.1 INTRODUCTION MPLAB ® C COMPILE
Page 149 and 150:
__builtin_btg Built-in Functions De
Page 151 and 152:
__builtin_clr_prefetch Argument: xp
Page 153 and 154:
__builtin_dmaoffset Built-in Functi
Page 155 and 156:
__builtin_fbcl Built-in Functions A
Page 157 and 158:
__builtin_modsd Argument: dividend
Page 159 and 160:
__builtin_mpy Error Messages An err
Page 161 and 162:
__builtin_mulss Built-in Functions
Page 163 and 164:
__builtin_psvoffset Built-in Functi
Page 165 and 166:
__builtin_subab Built-in Functions
Page 167 and 168:
__builtin_tblwth Built-in Functions
Page 169 and 170:
C.1 INTRODUCTION C.2 ERRORS MPLAB
Page 171 and 172:
Diagnostics ambiguous abbreviation
Page 173 and 174:
Diagnostics cast specifies function
Page 175 and 176:
F Diagnostics ‘identifier’ fail
Page 177 and 178:
Diagnostics initializer for static
Page 179 and 180:
Diagnostics invalid use of undefine
Page 181 and 182:
N Diagnostics negative width in bit
Page 183 and 184:
R Diagnostics redeclaration of ‘i
Page 185 and 186:
Diagnostics symbol ‘symbol’ not
Page 187 and 188:
Diagnostics void expression between
Page 189 and 190:
Diagnostics anonymous union declare
Page 191 and 192:
Diagnostics comparison between sign
Page 193 and 194:
duplicate ‘const’ The ‘const
Page 195 and 196:
Diagnostics function might be possi
Page 197 and 198:
Diagnostics ‘identifier’ is nar
Page 199 and 200:
Diagnostics library function ‘ide
Page 201 and 202:
P Diagnostics parameter has incompl
Page 203 and 204:
Diagnostics shift count >= width of
Page 205 and 206:
Diagnostics too many arguments for
Page 207 and 208:
V Diagnostics __VA_ARGS__ can only
Page 209 and 210:
Page 211 and 212:
MPLAB C Compiler for PIC18 MCUs vs.
Page 213 and 214:
Page 215 and 216:
Page 217 and 218:
E.1 INTRODUCTION E.2 HIGHLIGHTS MPL
Page 219 and 220:
Page 221 and 222:
G.1 PREAMBLE MPLAB ® C COMPILER FO
Page 223 and 224:
G.3 VERBATIM COPYING G.4 COPYING IN
Page 225 and 226:
GNU Free Documentation License incl
Page 227 and 228:
Page 229 and 230:
Glossary File Registers On-chip dat
Page 231 and 232:
Glossary Machine Language A set of
Page 233 and 234:
Glossary Stack, Software Memory use
Page 235 and 236:
Symbols __builtin_add..............
Page 237 and 238:
-fpack-struct .....................
Page 239 and 240:
-idirafter.........................
Page 241 and 242:
Peephole Optimization..............
Page 243 and 244:
-Wsequence-point...................
show all

MPLAB C Compiler for PIC24 MCUs and dsPIC DSCs ... - Microchip

Create successful ePaper yourself

Delete template?

Save as template?