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

Using the Compiler on the Command Line
• c:\Program Files\Microchip\MPLAB C30\lib - Library directory: this
directory is where the libraries and precompiled object files reside.
• c:\Program Files\Microchip\MPLAB C30\support\dsPIC30F\gld -
Linker script directory: this directory is where device-specific linker script files may
be found.
• c:\Program Files\Microchip\MPLAB C30\bin - Executables directory:
this directory is where the compiler programs are located. Your PATH environment
variable should include this directory.
The following is a simple C program that adds two numbers.
Create the following program with any text editor and save it as ex1.c.
#include
int main(void);
unsigned int Add(unsigned int a, unsigned int b);
unsigned int x, y, z;
int
main(void)
{
x = 2;
y = 5;
z = Add(x,y);
return 0;
}
unsigned int
Add(unsigned int a, unsigned int b)
{
return(a+b);
}
The first line of the program includes the header file p30f2010.h, which provides
definitions for all special function registers on that part. For more information on header
files, see Chapter 7. “Device Support Files”.
Compile the program by typing the following at a DOS prompt:
C:\> pic30-gcc -o ex1.o ex1.c
The command-line option -o ex1.o names the output COFF executable file (if the -o
option is not specified, then the output file is named a.exe). The COFF executable file
may be loaded into the MPLAB IDE.
If a hex file is required, for example to load into a device programmer, then use the
following command:
C:\> pic30-bin2hex ex1.o
This creates an Intel hex file named ex1.hex.
3.9 COMPILING MULTIPLE FILES ON THE COMMAND LINE
Move the Add() function into a file called add.c to demonstrate the use of multiple
files in an application. That is:
File 1
/* ex1.c */
#include
int main(void);
unsigned int Add(unsigned int a, unsigned int b);
unsigned int x, y, z;
int main(void)
{
x = 2;
y = 5;
© 2008 Microchip Technology Inc. DS51284H-page 61