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

More documents

Recommendations

Info

16-Bit C Compiler User’s Guide section......................................................... 24, 68 secure ............................................................... 24 shadow...................................................... 25, 101 unused .............................................................. 25 user_init ............................................................ 25 weak.................................................................. 26 Attribute, Variable..................................................... 12 address ............................................................. 12 aligned .............................................................. 13 boot ................................................................... 13 deprecated ........................................................ 13 far................................................................ 14, 67 fillupper ............................................................. 14 mode ................................................................. 14 near............................................................. 14, 67 noload ............................................................... 15 packed .............................................................. 15 persistent .......................................................... 15 reverse .............................................................. 15 section............................................................... 16 secure ............................................................... 16 sfr ...................................................................... 16 space ................................................................ 17 transparent_union ............................................. 18 unordered.......................................................... 18 unused .............................................................. 18 weak.................................................................. 18 auto_psv Space ....................................................... 35 Automatic Variable ........................................41, 43, 70 -aux-info ................................................................... 38 B -B........................................................................ 56, 59 Binary Radix............................................................. 32 Bit Fields ...................................................38, 134, 209 Bit fields.................................................................. 115 Bit Reversed and Modulo Addressing...................... 76 boot Attribute...................................................... 13, 21 Built-In Functions __builtin_add................................................... 142 __builtin_addab............................................... 142 __builtin_btg.................................................... 143 __builtin_clr..................................................... 143 __builtin_clr_prefect........................................ 144 __builtin_divf ................................................... 145 __builtin_divmodsd ......................................... 145 __builtin_divmodud ......................................... 146 __builtin_divsd ................................................ 146 __builtin_divud ................................................ 146 __builtin_dmaoffset......................................... 147 __builtin_ed..................................................... 147 __builtin_edac................................................. 148 __builtin_fbcl ................................................... 148 __builtin_lac .................................................... 149 __builtin_mac.................................................. 150 __builtin_modsd.............................................. 150 __builtin_modud.............................................. 151 __builtin_movsac ............................................ 151 __builtin_mpy.................................................. 152 __builtin_mpyn................................................ 153 __builtin_msc .................................................. 154 __builtin_mulss ............................................... 154 __builtin_mulsu ............................................... 155 __builtin_mulus ............................................... 155 __builtin_muluu ............................................... 155 __builtin_nop................................................... 156 __builtin_psvoffset .......................................... 156 __builtin_psvpage ........................................... 156 __builtin_readsfr.............................................. 157 __builtin_return_address................................. 157 __builtin_sac ................................................... 157 __builtin_sacr .................................................. 158 __builtin_sftac ................................................. 158 __builtin_subab ............................................... 159 __builtin_tbloffset ............................................ 159 __builtin_tblpage ............................................. 159 __builtin_tblrdh................................................ 160 __builtin_tblrdl ................................................. 160 __builtin_tblwth ............................................... 161 __builtin_tblwtl................................................. 161 __builtin_write_NVM ....................................... 161 __builtin_write_OSCCONH............................. 162 __builtin_write_OSCCONL ............................. 162 __builtin_write_RTCWEN ............................... 162 C -C.............................................................................. 52 -c ........................................................................ 37, 55 C Dialect Control Options......................................... 38 -ansi .................................................................. 38 -aux-info ............................................................ 38 -ffreestanding .................................................... 38 -fno-asm ............................................................ 38 -fno-builtin ......................................................... 38 -fno-signed-bitfields........................................... 38 -fno-unsigned-bitfields....................................... 38 -fsigned-bitfields ................................................ 38 -fsigned-char ..................................................... 38 -funsigned-bitfields ............................................ 38 -funsigned-char ................................................. 38 -fwritable-strings........................................ 38, 208 -traditional ......................................................... 26 C Heap Usage.......................................................... 72 C Stack Usage ......................................................... 70 C, Mixing with Assembly ........................................ 119 C30_VERSION......................................................... 60 Calling Conventions ............................................... 207 Case Ranges............................................................ 31 Cast .............................................................. 41, 43, 44 char ............................................. 14, 38, 39, 73, 75, 79 Characters.............................................................. 131 Code Generation Conventions Options.................... 56 -fargument-alias ................................................ 56 -fargument-noalias ............................................ 56 -fargument-noalias-global ................................. 56 -fcall-saved........................................................ 57 -fcall-used.......................................................... 57 -ffixed ................................................................ 57 -finstrument-functions........................................ 57 -fno-ident ........................................................... 57 -fno-short-double............................................... 58 -fno-verbose-asm .............................................. 58 DS51284H-page 230 © 2008 Microchip Technology Inc.
-fpack-struct ...................................................... 58 -fpcc-struct-return ............................................. 58 -fshort-enums.................................................... 58 -fverbose-asm................................................... 58 -fvolatile ............................................................ 58 -fvolatile-global.................................................. 58 -fvolatile-static................................................... 58 Code Size, Reduce .......................................35, 46, 47 Coding ISR’s .......................................................... 101 COFF ...................................................... 8, 61, 92, 208 Command Line Options ........................................... 33 Command-Line Compiler ......................................... 33 Command-Line Options ........................................... 34 Command-Line Simulator .......................................8, 9 Comments...........................................................39, 52 Common Subexpression Elimination ...... 22, 48, 49, 50 Common Subexpressions........................................ 50 Compiler..................................................................... 8 Command-Line ................................................. 33 Driver ............................................. 8, 9, 33, 56, 61 Overview............................................................. 7 Compiler-Managed Resources .............................. 207 Compiling Multiple Files ........................................... 61 Complex Data Types ....................................................... 29 Floating Types .................................................. 29 Integer Types.................................................... 29 Numbers ........................................................... 29 complex.................................................................... 29 Conditional Expression ............................................ 31 Conditionals with Omitted Operands........................ 31 Configuration Bits Setup .......................................... 95 const Attribute .......................................................... 22 Constants Binary................................................................ 32 Predefined .................................................60, 211 String .............................................................. 205 CORCON ......................................................64, 91, 92 Customer Notification Service.................................... 6 Customer Support...................................................... 6 D -D ........................................................................52, 54 Data Formats ......................................................... 204 Data Memory Allocation........................................... 95 Data Memory Space .....................................35, 36, 72 Data Memory Space, Near....................................... 14 Data Representation ................................................ 79 Data Type ...........................................................14, 79 Complex............................................................ 29 Floating Point.................................................... 80 Integer............................................................... 79 Pointers............................................................. 80 -dD ........................................................................... 52 Debugging Information............................................. 46 Debugging Options .................................................. 46 -g....................................................................... 46 -Q...................................................................... 46 -save-temps ...................................................... 46 Declarators............................................................. 134 Defining Global Register Variables .......................... 27 Index deprecated Attribute......................................13, 22, 44 Development Tools .................................................... 8 Device Support Files ................................................ 91 Diagnostics............................................................. 163 Differences Between 16-Bit Device C and ANSI C .. 11 Differences Between Compilers............................. 203 Directories .....................................................52, 53, 54 Directory Search Options ......................................... 56 -B ................................................................ 56, 59 -specs= ............................................................. 56 -dM ........................................................................... 52 -dN ........................................................................... 52 Documentation Conventions ........................................................ 3 Layout ................................................................. 2 double ............................................. 58, 73, 75, 80, 204 Double-Word Integers .............................................. 29 dsPIC DSC C Compiler.............................................. 7 dsPIC DSC-Specific Options.................................... 35 dsPIC-Specific Options -mconst-in-code ................................................ 35 -mconst-in-data ................................................. 35 -mcpu ................................................................ 35 -merrata ............................................................ 35 -mlarge-code..................................................... 35 -mlarge-data...................................................... 35 -mno-isr-warn.................................................... 36 -mno-pa............................................................. 35 -momf=.............................................................. 36 -mpa.................................................................. 35 -mpa=................................................................ 35 -msmall-code .................................................... 36 -msmall-data ..................................................... 36 -msmall-scalar................................................... 36 -msmart-io......................................................... 36 -mtext=.............................................................. 36 DWARF .................................................................... 36 E -E....................................................... 37, 52, 53, 54, 55 EEDATA............................................................. 95, 96 EEPROM, data......................................................... 95 ELF....................................................................... 8, 36 Enabling/Disabling Interrupts ................................. 113 endian ...................................................................... 79 Enumerations ......................................................... 134 Environment ........................................................... 130 Environment Variables ............................................. 59 PIC30_C_INCLUDE_PATH .............................. 59 PIC30_COMPILER_PATH................................ 59 PIC30_EXEC_PREFIX ..................................... 59 PIC30_LIBRARY_ PATH .................................. 59 PIC30_OMF ...................................................... 59 TMPDIR ............................................................ 59 errno....................................................................... 138 Error Control Options -pedantic-errors................................................. 39 -Werror.............................................................. 44 -Werror-implicit-function-declaration ................. 39 Errors ..................................................................... 163 Escape Sequences ................................................ 131 © 2008 Microchip Technology Inc. DS51284H-page 231
Page 1 and 2:
MPLAB ® C COMPILER FOR PIC24 MCUs
Page 3 and 4:
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:
Page 19 and 20:
Differences Between 16-Bit Device C
Page 21 and 22:
Page 23 and 24:
Page 25 and 26:
Page 27 and 28:
Page 29 and 30:
Page 31 and 32:
Page 33 and 34:
Page 35 and 36:
Page 37 and 38:
Page 39 and 40:
Page 41 and 42:
Using the Compiler on the Command L
Page 43 and 44:
Page 45 and 46:
Page 47 and 48:
Page 49 and 50:
Page 51 and 52:
Page 53 and 54:
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:
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:
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: MPLAB ® C COMPILER FOR PIC24 MCUs
Page 211 and 212: MPLAB C Compiler for PIC18 MCUs vs.
Page 217 and 218: E.1 INTRODUCTION E.2 HIGHLIGHTS MPL
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 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: Symbols __builtin_add..............
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

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?