PicC 9.50 dsPIC Manual.pdf

DSPICC Command-line DriverDSPICC Compiler Options2.4.11 -Ofile: Specify Output FileThis option allows the name of the output file(s) to be specified. If no -O option is given, the outputfile(s) will be named after the first source or object file on the command line. The files controlled areany produced by the linker or applications run subsequent to that, e.g. CROMWELL. So for instancethe HEX file, map file and SYM file are all controlled by the -O option.The -O option can also change the directory in which the output file is located by include therequired path before the filename, e.g. -Oc:\project\output\first.hex. This will then alsospecify the output directory for any files produced by the linker or subsequently run applications.2.4.12 -P: Preprocess Assembly FilesThe -P option causes the assembler files to be preprocessed before they are assembled thus allowingthe use of preprocessor directives, such as #include, with assembler code. By default, assemblerfiles are not preprocessed.2.4.13 -Q: Quiet ModeThis option places the compiler in a quiet mode which suppresses the HI-TECH Software copyrightnotice from being displayed.2.4.14 -S: Compile to Assembler CodeThe -S option stops compilation after generating an assembler source file. An assembler file will begenerated for each C source file passed on the command line. The command:DSPICC --CHIP=30F6014 -S test.cwill produce an assembler file called test.as which contains the code generated from test.c.This option is particularly useful for checking function calling conventions and signature valueswhen attempting to write external assembly language routines. The file produced by this optiondiffers to that produced by the --ASMLIST option in that it does not contain op-codes or addressesand it may be used as a source file and subsequently passed to the assembler to be assembled.2.4.15 -Umacro: Undefine a MacroThe -U option, the inverse of the -D option, is used to undefine predefined macros. This option takesthe form -Umacro. The option, -Udraft, for example, is equivalent to:#undefdraftplaced at the top of each module compiled using this option.11