4.4.2 xc32-as (32-bit Assembler)

Select a category and set up assembler options. Note that the options specified are for the assembler tool (xc32-as) and are not for the xc32-gcc option. For additional options, see MPLAB® XC32 Assembler, Linker And Utilities User’s Guide documentation. See also 4.4.7 Options Page Features.

Table 4-2. XC32-AS General Options Category
Option	Description	Command Line
Have symbols in production build	Generate debugging information for source-level debugging in MPLAB X.	`--gdwarf-2` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Keep local symbols	Check to keep local symbols, that is, labels beginning with `.L` (upper case only). Uncheck to discard local symbols.	`--keep-locals` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Exclude floating-point library	Exclude support for floating-point operations reducing code size for applications that do not require floating-point support.	`-mno-float`
Generate MIPS16 16-bit code	Changes the assembler's default assembly mode so it will attempt to build for the MIPS16 ISA. You can still override this setting with the `.set isa-mode` directives.	`-mips16` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Generate microMIPS compressed code	Changes the assembler's default assembly mode so it will attempt to build for the microMIPS ISA. You can still override this setting with the `.set isa-mode` directives.	`-mmicromips` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Preprocessor macro definitions	Project-specific preprocessor macro defines passed via the compiler's `–D` option.	`-Dmacro[=defn]` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Assembler symbols	Define symbol `sym` to a given `value`.	`--defsym sym=value` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Preprocessor Include directories	Add a directory to the list of those searched for headers included by the preprocessor. Relative paths are from MPLAB X project directory.	`-I dir` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Assembler Include directories	Add a directory to the list of those searched for files specified in `.include` directives. Relative paths are from MPLAB X project directory. You may add as many directories as necessary to include a variety of paths. The current working directory is always searched first and then `-I` directories in the order in which they were specified (left to right) here.	`-Idir` See the MPLAB ®XC32 Assembler, Linker and Utilities User's Guide.

Table 4-3. XC32-AS Other Options Category
Option	Description	Command Line
Diagnostics level	Select warnings to display in the Output window. Select “Generate warnings” to have the usual warnings issued by the compiler; “Suppress warnings”to have only errors displayed, and "Fatal Warnings" to have the assembler treat warnings as if they were errors.	`--[no-]warn` `--fatal-warnings` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Include source code	Check for a high-level language listing. High-level listings require that the assembly source code is generated by a compiler, a debugging option like `-g` is given to the compiler, and assembly listings (`-al`) are requested. Uncheck for a regular listing.	`-ah` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Expand macros	Check to expand macros in a listing. Uncheck to collapse macros.	`-am` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Include false conditionals	Check to include false conditionals (`.if, .ifdef`) in a listing. Uncheck to omit false conditionals.	`-ac` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Omit forms processing	Check to turn off all forms processing that would be performed by the listing directives `.psize`, `.eject`, `.title` and `.sbttl`. Uncheck to process by listing directives.	`-an` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Include assembly	Check for an assembly listing. This `-a` suboption may be used with other suboptions. Uncheck to exclude an assembly listing.	`-al` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
List symbols	Check for a symbol table listing. Uncheck to exclude the symbol table from the listing.	`-as` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Omit debugging directives	Check to omit debugging directives from a listing. This can make the listing cleaner. Uncheck to included debugging directives.	`-ad` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
List to file	Use this option if you want the assembly listing for any assembly source files in the project. They will have the same basename as the source, with a `.lst` extension.	`-a=file.lst` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide