Motorola dsp assembler Reference Manual

Table of Contents
vi
DSP ASSEMBLER REFERENCE MANUAL
MOTOROLA
Chapter 7
STRUCTURED CONTROL STATEMENTS
7.1
INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
7.2
STRUCTURED CONTROL DIRECTIVES  . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
7.3
SYNTAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
7.3.1
.BREAK Statement  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-2
7.3.2
.CONTINUE Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-3
7.3.3
.FOR Statement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-4
7.3.4
.IF Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-5
7.3.5
.LOOP Statement  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-6
7.3.6
.REPEAT Statement  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-7
7.3.7
.WHILE Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-7
7.4
SIMPLE AND COMPOUND EXPRESSIONS   . . . . . . . . . . . . . . . . . . . . . . . 7-8
7.4.1
Simple Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-8
7.4.1.1
Condition Code Expressions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8
7.4.1.2
Operand Comparison Expressions  . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
7.4.2
Compound Expressions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-10
7.5
STATEMENT FORMATTING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10
7.5.1
Expression Formatting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-10
7.5.2
.FOR/.LOOP Formatting  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-11
7.5.3
Assembly Listing Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7-11
7.6
EFFECTS ON THE PROGRAMMER’S ENVIRONMENT  . . . . . . . . . . . . . 7-11
Appendix A
ASCII CHARACTER CODES
Appendix B
DIRECTIVE SUMMARY
B.1
ASSEMBLY CONTROL  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  B-1
B.2
SYMBOL DEFINITION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  B-2
B.3
DATA DEFINITION/STORAGE ALLOCATION. . . . . . . . . . . . . . . . . . . . . .  B-2
B.4
LISTING CONTROL AND OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  B-2
B.5
OBJECT FILE CONTROL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  B-3
B.6
MACROS AND CONDITIONAL ASSEMBLY . . . . . . . . . . . . . . . . . . . . . . .  B-3
B.7
STRUCTURED PROGRAMMING  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  B-3

---

Table of Contents
MOTOROLA
DSP ASSEMBLER REFERENCE MANUAL
vii
Appendix C
ASSEMBLER MESSAGES
C.1
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   C-1
C.2
COMMAND LINE ERRORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   C-2
C.3
WARNINGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   C-4
C.4
ERRORS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   C-13
C.5
FATAL ERRORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   C-44
Appendix D
ASSEMBLER LISTING FILE FORMAT
D.1
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   D-1
D.2
LISTING FILE COMMENTARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   D-1
D.3
CROSS-REFERENCE FORMAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   D-3
D.4
MEMORY UTILIZATION REPORT FORMAT  . . . . . . . . . . . . . . . . . . . . . .   D-3
D.5
ASSEMBLER LISTING FORMAT  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   D-5
Appendix E
MOTOROLA DSP OBJECT FILE FORMAT (COFF)
E.1
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-1
E.2
OBJECT FILE STRUCTURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-1
E.3
OBJECT FILE COMPONENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-3
E.3.1
File Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-3
E.3.2
Optional Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-4
E.3.3
Sections  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-6
E.3.3.1
Section Headers  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-7
E.3.3.2
Relocation Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-9
E.3.3.3
Line Numbers  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-10
E.3.4
Symbol Table  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-11
E.3.4.1
Symbol Name  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-13
E.3.4.2
Symbol Value  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-13
E.3.4.3
Section Number. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-14
E.3.4.4
Symbol Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-14
E.3.4.5
Symbol Storage Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-16
E.3.4.6
Auxiliary Entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   E-20
E.3.4.6.1
Filenames  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-21
E.3.4.6.2
Sections   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-21
E.3.4.6.3
Tag Names  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-23

---