User`s manual

Assemblers
Motorola Selecting Tools 1-3
This option to link explicitly is obviously a good choice under several different conditions:
if your project consists of many, large C source files; if those files are compiled
with option -c, then changes to one file will simply require recompilation of that
file and relinking to the others; you can save the time required to recompile the
unchanged files;
if your project consists of a mixture of C source and assembly code;
if your project needs to link to existing libraries or other object-code modules.
1.2 Assemblers
Each Motorola digital signal processor recognizes a set of machine instructions. A Suite56
assembler translates mnemonic operation codes (recognizable by humans) into machine
instructions recognized by a Motorola digital signal processor. An assembler also accepts
mnemonic directives indicating how it should behave. Suite56 assemblers, for example,
accept
include directives, allowing you to put include files into applications based on
assembly code.
Suite56 assemblers understand algebraic expressions as arguments to directives and as
immediate operands in certain instructions. Suite56 assemblers also accept user-defined
macros, even nested macros, converting them into appropriate sequences of machine
instructions. Suite56 assemblers support conditional assembly, and they provide a suite of
transcendental functions (such as sine, cosine, natural logarithm) widely used in digital
signal processing. These features are documented in the Motorola DSP Assembler
Reference Manual. Figure 1-3 on page 1-4 illustrates some of the features of these Suite56
assemblers.
An assembler can produce various kinds of output:
a relocatable object file (option
-b)
a listing of the source program (option
-l)
an object file with symbolic information from the source file (option
-g)
verbose reports about its progress (option
-v)
a report about loadtime and runtime memory use (option
-mu)
an absolutely located object file or executable object file (option
-a) or relocatable
overlays (default)