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

16-Bit C Compiler User’s Guide
3.7 PREDEFINED MACRO NAMES
The compiler predefines several macros which can be tested by conditional directives
in source code.
The following preprocessing symbols are defined by the compiler being used.
Compiler Symbol Defined with -ansi command-line option?
16-Bit Compiler C30 No
__C30 Yes
__C30__ Yes
ELF-specific C30ELF No
__C30ELF Yes
__C30ELF__ Yes
COFF-specific C30COFF No
__C30COFF Yes
__C30COFF__ Yes
The following symbols define the target family.
Symbol Defined with -ansi command-line option?
__dsPIC30F__ Yes
__dsPIC33F__ Yes
__PIC24F__ Yes
__PIC24H__ Yes
In addition, the compiler defines a symbol based on the target device set with -mcpu=.
For example, -mcpu=30F6014, which defines the symbol __dsPIC30F6014__.
The compiler will define the constant __C30_VERSION__, giving a numeric value to
the version identifier. This can be used to take advantage of new compiler features
while still remaining backward compatible with older versions.
The value is based upon the major and minor version numbers of the current release.
For example, release version 2.00 will have a __C30_VERSION__ definition of 200.
This macro can be used, in conjunction with standard preprocessor comparison statements,
to conditionally include/exclude various code constructs.
The current definition of __C30_VERSION__ can be discovered by adding
--version to the command line, or by inspecting the README.html file that came
with the release.
Constants that have been deprecated may be found in Appendix E. “Deprecated
Features”.
3.8 COMPILING A SINGLE FILE ON THE COMMAND LINE
This section demonstrates how to compile and link a single file. For the purpose of this
discussion, it is assumed the compiler is installed on your c: drive in the standard
directory location. Therefore, the following will apply:
• c:\Program Files\Microchip\MPLAB C30\include - Include directory for
ANSI C header file. This directory is where the compiler stores the standard C
library system header files. The PIC30_C_INCLUDE_PATH environment variable
can point to that directory. (From the DOS command prompt, type set to check
this.)
• c:\Program Files\Microchip\MPLAB C30\support\dsPIC30F\h -
Include directory for dsPIC® DSC device-specific header files. This directory is
where the compiler stores the dsPIC DSC device-specific header files.
DS51284H-page 60 © 2008 Microchip Technology Inc.