6.6.2 xc16-as (16-bit Assembler)
A subset of command-line options may be specified in MPLAB X IDE. Select a category and then set up assembler options. For additional options, see the MPLAB® XC16 Assembler, Linker and Utilities User’s Guide (DS50002106). See also, “Options Page Features.”
| Option | Description | Command Line |
|---|---|---|
| Define ASM macros (.S only) | Add assembler macros. | -Dmacro |
| Assembler symbols | Define symbol 'sym' to a given 'value'. | --defsym sym=value |
| ASM include dirs | Add a directory to the list of directories
the assembler searches for files specified in .include
directives.For more information, see Additional Search Paths and Directories | -I“dir” |
| Preprocessor include dirs | Add a directory to the list of directories
the compiler preprocessor searches for files specified in
.include directives.For more information, see Additional Search Paths and Directories | -I“dir” |
| Allow call optimization | Check to turn relaxation on. Uncheck to turn relaxation off. | --relax
|
| Keep local symbols | Check to keep local symbols, i.e., labels
beginning with .L (upper case only).Uncheck to discard local symbols. | --keep-locals (-L) |
| Diagnostics level | Select warnings to display in the Output window. | |
| - Generate warnings | --warn | |
| - Suppress warnings | --no-warn | |
| - Fatal warnings | --fatal-warnings | |
| Additional driver options | Enter any additional driver options not existing in the GUI. The string you introduce here will be emitted as-is in the driver invocation command. |
| Option | Description | Command Line |
|---|---|---|
| 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 |
| Include macros expansions | Check to expand macros in a listing. Uncheck to collapse macros. | -am |
| Omit false conditionals | Check to omit false conditionals
(.if, .ifdef) in a listing.Uncheck to include false conditionals. | -ac |
| 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 |
| Include assembly | Check for an assembly listing. This
-a suboption may be used with other suboptions.Uncheck to exclude an assembly listing. | -al |
| Include symbols | Check for a symbol table listing. Uncheck to exclude the symbol table from the listing. | -as |
| Omit debugging directives | Check to omit debugging directives from a
listing. This can make the listing cleaner. Uncheck to included debugging directives. | -ad |
| Include section information | Check to display information on each of the
code and data sections. This information contains details on the size of each
of the sections and then a total usage of program and data memory. Uncheck to not display this information. | -ai |
| List to file | Check to send listing information to a
file. Uncheck to send listing information to the Output window. | -a=asmfilename.lst |