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

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