2.2 Assembler Usage

The MPLAB® XC32 Assembler translates assembly source files into relocatable object files. These object files can then be put into an archive (MPLAB XC32 Object Archiver/Librarian) or linked with other relocatable object files and archives to create an executable file (MPLAB XC32 Object Linker). See the “MPLAB® XC32 C Compiler User’s Guide for PIC32A MCU” (DS-50003831) for an overview of the tools process flow.

Typically the command-line driver, xc32-gcc, is used to invoke the assembler as it can be passed assembler source files as input; however, the options for the assembler are supplied here for instances where the assembler is being called directly, or when options need to be set in the assembler tab assembler category of the Project Properties window.

The assembler command line may contain options and file names. For details on command line option syntax, see Command-Line Syntax.

Note that the assembler will not produce any messages unless there are errors or warnings – there are no “assembly completed” messages. For more on messages, see Assembler Errors/Warnings/Messages.