Motorola dsp assembler Reference Manual

List of Figures
xii
DSP ASSEMBLER REFERENCE MANUAL
MOTOROLA
E-23
 Function Symbol Auxiliary Entry  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  E-24
E-24
 Array Symbol Auxiliary Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  E-25
E-25
 End of Block or Function Auxiliary Entry  . . . . . . . . . . . . . . . . . . . . . . . . .  E-25
E-26
 Beginning of Block or Function Auxiliary Entry  . . . . . . . . . . . . . . . . . . . .  E-26
E-27
 Structure, Union, or Enumeration Name Auxiliary Entry  . . . . . . . . . . . . .  E-27
E-28
 CORE_ADDR Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  E-28
E-29
 Memory Mapping Enumerations  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  E-29
E-30
 Motorola DSP COFF Byte Ordering  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  E-30

---

MOTOROLA
DSP ASSEMBLER REFERENCE MANUAL
1-1
Chapter 1
MOTOROLA DSP ASSEMBLER
1.1
  INTRODUCTION
The Motorola DSP Assemblers are programs that process assembly language source
statements written for Motorola’s family of digital signal processors.  The Assembler trans-
lates these source statements into object programs compatible with other  Motorola DSP
software and hardware products.
1.2
  ASSEMBLY LANGUAGE
The assembly language provides mnemonic operation codes for all machine instructions
in the digital signal processor instruction set.  In addition, the assembly language contains
mnemonic directives which specify auxiliary actions to be performed by the Assembler.
These directives are not always translated into machine language.  The assembly lan-
guage enables the programmer to define and use macro instructions which replace a sin-
gle statement with a predefined sequence of statements found in the macro definition.
Conditional assembly also is supported.
1.3
  INSTALLING THE ASSEMBLER
The Assembler is distributed on various media and in different formats depending on the
host environment. See Appendix G, Host-dependent Information, for details on installing
and operating the Assembler on your particular machine.
1.4
  RUNNING THE ASSEMBLER
The general format of the command line to invoke the Assembler is:
DSPASM  [options]   
where:
DSPASM
The name of the Motorola DSP Assembler program appropriate for the tar-
get processor (see Appendix F, Device-dependent Information). For exam-

---

Motorola DSP Assembler
Running The Assembler
1-2
DSP ASSEMBLER REFERENCE MANUAL
MOTOROLA
ple, for the Motorola DSP56000 processor the name of the Assembler
executable is ASM56000.
[options]
Any of the following command line options. These can be in any order, but
must precede the list of source filenames. Some options can be given more
than once; the individual descriptions indicate which options may be speci-
fied multiple times. Option letters can be in either upper or lower case. 
Command options that are used regularly may be placed in the environment
variable  DSPASMOPT. If the variable is found in the environment the As-
sembler adds the associated text to the existing command line prior to pro-
cessing any options. See your host documentation for instructions on how
to define environment variables.
Option arguments may immediately follow the option letter or may be sepa-
rated from the option letter by blanks or tabs.   However, an ambiguity arises
if an option takes an optional argument. Consider the following command
line:
ASM56000  -B  MAIN  IO
In this example it is not clear whether the file MAIN is a source file or is
meant to be an argument to the -B option.   If the ambiguity is not resolved
the Assembler will assume that MAIN is a source file and attempt to open it
for reading.  This may not be what the programmer intended. 
There are several ways to avoid this ambiguity.  If  MAIN is supposed to be
an argument to the -B option it can be placed immediately after the option
letter:
ASM56000  -BMAIN  IO
If there are other options on the command line besides those that take op-
tional arguments the other options can be placed between the ambiguous
option and the list of source file names:
ASM56000  -B  MAIN   -V   IO
An alternative is to use two successive hyphens to indicate the end of the
option list:
ASM56000  -B  -- MAIN  IO
In this latter case the Assembler interprets MAIN as a source file name and
uses the default naming conventions for the -B option.

---

Motorola DSP Assembler
Assembler Options
MOTOROLA
DSP ASSEMBLER REFERENCE MANUAL
1-3
1.5
  ASSEMBLER OPTIONS
-A
Indicates that the Assembler should run in absolute mode, generating an
absolute object file when the -B command line option is given. By default the
Assembler produces a relocatable object file that is subsequently pro-
cessed by the Motorola DSP linker. See Chapter 4, Software Project Man-
agement, for more information on Assembler modes.
-B[]
This option specifies that an object file is to be created for Assembler output.
can be any legal operating system filename, including an optional
pathname.  A hyphen also may be used as an argument to indicate that the
object file should be sent to the standard output.
The type of object file produced depends on the Assembler operation mode.
If the -A option is supplied on the command line, the Assembler operates in
absolute mode and generates an absolute object (.CLD) file.  If there is no
-A option on the command line, the Assembler operates in relative mode
and creates a relocatable object (.CLN) file.
If a pathname is not specified, the file will be created in the current directory.
If no filename is specified, the Assembler will use the basename (filename
without extension) of the first filename encountered in the source input file
list and append the appropriate file type (.CLN or .CLD) to the basename. If
the -B option is not specified, then the Assembler will not generate an object
file. The -B option should be specified only once. If the file named in the
-B option already exists, it will be overwritten.
Example: ASM56000  -Bfilter  main.asm  fft.asm  fio.asm
In this example, the files MAIN.ASM, FFT.ASM, and FIO.ASM are
assembled together to produce the relocatable object file
FILTER.CLN.
-D
This is equivalent to a source statement of the form:
DEFINE     
  must be preceded by a blank and should be enclosed in single
quotes if it contains any embedded blanks. Note that if single quotes are
used they must be passed to the Assembler intact, e.g. some host com-
mand interpreters will strip single quotes from around arguments. The

---