5.6.2 xc-dsc-as (DSC 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® XC-DSC Assembler, Linker and Utilities User’s Guide” (DS-50003590). See also, “5.6.6 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 5.6.7 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 5.6.7 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 |