Freescale Semiconductor, Inc.
SC_Assem.book Page 133 Thursday, September 23, 2004 10:44 AM
Assembler Directives
Descriptions
Parameter
<comment>
User-specified note or comment.
Example
NOTE”This is a note”
OPT Set Assembler Options
Specifies options that control formats, reporting, and other aspects of assembler operation.
OPT option[,option...] [; comment]
Parameters
option
Any assembler control option: valid either with the OPT directive or with the -o command line option. Table X lists these options.
comment
Optional comment string.
Remarks
Commas without spaces must separate multiple options. You may not use a label with this directive.
The same options can be arguments for this directive or for the -o command line option: OPT MU in a source line has the same effect as -o in the command line.
Table 5.3 lists available options, by type. The table shows the options in capital letters, but the options are not case sensitive. Many options have logical opposites that begin with NO; table explanations include these opposites.
SC100 Assembler User Guide
For More Information: www.freescale.com
133
Freescale Semiconductor, Inc.
SC_Assem.book Page 134 Thursday, September 23, 2004 10:44 AM
Assembler Directives
Descriptions
Table 5.3 OPT Options
Type
Listing Format
Control
Option
FC
Output file format
Reporting
FF
FM
PP
RC
COFF
ELF
REL
RELA
CEX
Control Action
Folds trailing comments under the source line, aligning them with the opcode field; aligns lines that start with the ; character with the label field.
NOFC option: Does not fold trailing comments. Default setting; reset setting at end of pass one.
Uses form feeds for page ejects in the source listing.
NOFF option: Uses multiple line feeds for page ejects. Default setting; reset setting at end of pass one.
Formats messages: aligns text, breaks at word boundaries.
NOFM option: Does not format messages. Default setting; reset setting at end of pass one.
Pretty prints: aligns values in consistent columns, without regard to source-file formatting. Default setting; reset setting at end of pass one.
NOPP option: Does not pretty print; preserves source-line formatting, but expands tabs to spaces and concatenates continuation lines.
Uses relative comment spacing: lets comment starting column float, according to presence/absence of other field values.
NORC option: Does not use relative spacing. Default setting; reset setting at end of pass one.
Specifies a COFF binary output file.
Specifies an ELF binary output file.
Specifies a .rel relocation type.
Specifies a .rela relocation type.
Prints DC expansions.
NOCEX option: Does not print DC expansions. Default setting; reset setting at end of pass one.
134 SC100 Assembler User Guide
For More Information: www.freescale.com
Freescale Semiconductor, Inc.
SC_Assem.book Page 135 Thursday, September 23, 2004 10:44 AM
Assembler Directives
Descriptions
Table 5.3 OPT Options ( continued)
Type Option
CL
Control Action
Prints conditional assembly directives. Default setting; reset setting at end of pass one.
DXL
HDR
IL
MC
MD
MEX
MU
NL
NOCL option: Does not print conditional assembly directives.
Expands DEFINE directive strings in the source listing. Default setting; reset setting at end of pass one.
NODXL option: Does not expand DEFINE directive strings.
Generates listing header along with titles and subtitles. Default setting; reset setting at end of pass one.
NOHDR option: Does not generate listing header; turns off titles and subtitles.
Inhibits (blocks) a source listing.
Prints macro calls. Default setting; reset setting at end of pass one.
NOMC option: Does not print macro calls.
Prints macro definitions. Default setting; reset setting at end of pass one.
NOMD option: Does not print macro definitions.
Prints macro expansions.
NOMEX option: Does not print macro expansions. Default setting; reset setting at end of pass one.
Includes a memory utilization report in the source listing. This option must appear before any code or data generation.
Prints nesting levels in listing: conditional assembly and section nesting.
WEX
NONL option: Does not print nesting levels. Default setting; reset setting at end of pass one.
Counts warnings as error messages. Warnings block creation of an object file, unless -osvo is in the command line.
SC100 Assembler User Guide 135
For More Information: www.freescale.com
Freescale Semiconductor, Inc.
SC_Assem.book Page 136 Thursday, September 23, 2004 10:44 AM
Assembler Directives
Descriptions
Table 5.3 OPT Options ( continued)
Type
Message
Control
Option
U
AE
Control Action
Prints unassembled lines of conditional-assembly code.
NOU option: Does not print unassembled, conditional-assembly lines. Default setting; reset setting at end of pass one.
Checks address expressions: validates arithmetic operations.
Default setting; reset setting at end of pass one.
MSW
UR
NOAE option: Do not check address expressions.
Issues a memory space warning if incompatibilities exist. Default setting; reset setting at end of pass one.
NOMSW option: Suppresses memory space incompatibility warnings.
Warns about each unresolved reference at assembly time; valid only in relocatable mode.
Symbol
Assembler
Operation
W
DEX
IC
SO
AEC
BE
NOUR option: Does not warn about unresolved references.
Prints all warnings. Default setting; reset setting at end of pass one.
NOW option: Does not print warnings.
Expands DEFINE symbols in quoted strings. To expand individual symbols, use double-quoted strings.
NODEX option: Does not expand DEFINE symbols in quoted strings.
Default setting; reset setting at end of pass one.
Ignores case for symbols, section names, and macro names; must appear before any definitions of symbols, sections, and macros.
Writes symbol information to the object file.
Permits standard C-language escape characters in DC directives; changes DC directive default setting.
NOAEC option: do not allow C escape characters. Default setting.
Generates output for a big-endian target. (The default setting is littleendian.)
136 SC100 Assembler User Guide
For More Information: www.freescale.com
Freescale Semiconductor, Inc.
SC_Assem.book Page 137 Thursday, September 23, 2004 10:44 AM
Assembler Directives
Descriptions
Table 5.3 OPT Options ( continued)
Type Option
CC
Control Action
Enables cycle counts, clears the total cycle count. The output listing shows cycle counts for each instruction, as if there were a full instruction fetch pipeline and no wait states.
CK
CM
CONTCK
CS
DLD
GL
INTR
LDB
LE
NOCC option: Disables cycle counts, does not clear the total cycle count. Default setting; reset setting at end of pass one.
Enables checksumming for instructions and data values; clears cumulative checksum.
NOCK option: Disables checksumming. Default setting; reset setting at end of pass one.
Preserves comment lines of macro definitions; does not preserve comment lines that begin with ;; characters.
NOCM option: Does not preserve comment lines of macro definitions.
Re-enables checksumming for instructions and data values; does not clear cumulative checksum.
Classifies carry-update instructions as irrelevant, letting the assembler re-order instructions of a packet for minimum length.
Does not restrict DO-loop directives; suppresses error messages regarding directives in DO loops that do not make sense.
NODLD option: Restricts DO-loop directives. Default setting; reset setting at end of pass one.
Makes all symbols global; must appear in the source file before any explicit section definitions.
Checks interrupt locations; lets the assembler screen interrupt vector locations of memory for inappropriate DSP instructions. Default setting; reset setting for absolute mode.
NOINTER option: Does not check interrupt locations. Reset setting for relative mode.
Enables source listing debug: using the source listing instead of the assembly language file as the debug source file. Valid only if the command line includes the -l option.
Enables little-endian mode. Default setting.
SC100 Assembler User Guide 137
For More Information: www.freescale.com
Freescale Semiconductor, Inc.
SC_Assem.book Page 138 Thursday, September 23, 2004 10:44 AM
Assembler Directives
Descriptions
Table 5.3 OPT Options ( continued)
Type Option
LPA
Control Action
Enables hardware loop alignment for subsequent loops of the file; aligns loop addresses on a fetch set boundary, preventing additional pipeline stall cycles. The assembler implements this alignment automatically by padding execution sets with NOPs. However, this padding does not take place in hardware loops that do not use
LOOPSTART notation.
MB
MI
NONMCHK
NOOVLDB
G
OVLDBG
PS
SC110
SC120
SC1200
SC140
SC140E
NOLPA option: Disables hardware loop alignment. Default setting.
Specifies the big memory model: move instruction addresses use the
{a32} format instead of the default {a16} format.
Expands scanning for macro include files to all MACLIB directories; overrides directory restrictions of INCLUDE directive, MACLIB directive, and -i command-line option.
NOMI option: Does not expand scanning. Default setting; reset setting at end of pass one.
Blocks checking for reserved symbol name violations.
For files containing an overlay section, renames debug sections
.debug_info<overlay_scn>. (In this format, multiple overlay sections in the same module corrupt the debug information.)
Default setting. Assembler generates overlay-section debug information using local addresses instead of run addresses. This mode permits debugging of modules that contain multiple overlay sections.
Packs strings for the DC directive; packs individual string bytes into consecutive target words.
NOPS option: Does not pack strings; stores one string byte per word.
Sets target architecture for the SC110 DSP core (one MAC unit).
Sets target architecture for the SC120 DSP core (two MAC units).
Sets target architecture for the SC1200 DSP core (two MAC units)/
Sets target architecture for the SC140 DSP core (four MAC units.
Default setting.
Sets target architecture for the SC140E DSP core (four MAC units.)
138 SC100 Assembler User Guide
For More Information: www.freescale.com
