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

MPLAB ® C COMPILER FOR
PIC24 MCUs AND dsPIC ® DSCs
USER’S GUIDE
Chapter 3. Using the Compiler on the Command Line
3.1 INTRODUCTION
3.2 HIGHLIGHTS
3.3 OVERVIEW
This chapter discusses using the MPLAB C Compiler for PIC24 MCUs and dsPIC ®
DSCs (formerly MPLAB C30) on the command line. For information on using the compiler
with MPLAB IDE, please refer to the “16-bit Language Tools Getting Started”
(DS70094).
Items discussed in this chapter are:
• Overview
• File Naming Conventions
• Options
• Environment Variables
• Predefined Macro Names
• Compiling a Single File on the Command Line
• Compiling Multiple Files on the Command Line
• Notable Symbols
The compilation driver program (pic30-gcc) compiles, assembles and links C and
assembly language modules and library archives. Most of the compiler command-line
options are common to all implementations of the GCC toolset. A few are specific to
the compiler.
The basic form of the compiler command line is:
pic30-gcc [options] files
Note: This executable name applies for all 16-bit compilers, i.e., MPLAB C Compiler
for PIC24 MCUs and dsPIC ® DSCs, MPLAB C Compiler for dsPIC ®
DSCs, and MPLAB C Compiler for PIC24 MCUs.
The available options are described in Section 3.5 “Options”.
Note: Command line options and file name extensions are case-sensitive.
For example, to compile, assemble and link the C source file hello.c, creating the
absolute executable hello.exe.
pic30-gcc -o hello.exe hello.c
© 2008 Microchip Technology Inc. DS51284H-page 33