components :: ti :: TMS320xx :: tools :: SPRU018D TMS320C1x C2x C2xx C5x Assembly Language Tools Users Guide 1995

483 Pages·1995·1.4 MB·English

(cid:13)(cid:11)(cid:12)(cid:6)(cid:5)(cid:3)(cid:9)(cid:4)(cid:24)(cid:2)(cid:9)(cid:5)(cid:24)(cid:2)(cid:9)(cid:5)(cid:24)(cid:24)(cid:2)(cid:9)(cid:7)(cid:24)
(cid:8)(cid:22)(cid:22)(cid:16)(cid:19)(cid:15)(cid:18)(cid:25) (cid:10)(cid:14)(cid:20)(cid:17)(cid:23)(cid:14)(cid:17)(cid:16) (cid:13)(cid:21)(cid:21)(cid:18)(cid:22)
User’s Guide
1995 Microprocessor Development Systems
Printed in U.S.A., March 1995 SPRU018D
SDS
(cid:13)(cid:11)(cid:12)(cid:6)(cid:5)(cid:3)(cid:9)(cid:4)(cid:24)(cid:2)(cid:9)(cid:5)(cid:24)(cid:2)(cid:9)(cid:5)(cid:24)(cid:24)(cid:2)(cid:9)(cid:7)(cid:24) 5
User’s
9
Guide 9
(cid:8)(cid:22)(cid:22)(cid:16)(cid:19)(cid:15)(cid:18)(cid:25) (cid:10)(cid:14)(cid:20)(cid:17)(cid:23)(cid:14)(cid:17)(cid:16) (cid:13)(cid:21)(cid:21)(cid:18)(cid:22) 1
TMS320C1x/C2x/C2xx/C5x
Assembly Language Tools
User’s Guide
Printed on Recycled Paper
IMPORTANT NOTICE
Texas Instruments (TI) reserves the right to make changes to its products or to discontinue any
semiconductor product or service without notice, and advises its customers to obtain the latest
version of relevant information to verify, before placing orders, that the information being relied
on is current.
TI warrants performance of its semiconductor products and related software to the specifications
applicable at the time of sale in accordance with TI’s standard warranty. Testing and other quality
control techniques are utilized to the extent TI deems necessary to support this warranty.
Specific testing of all parameters of each device is not necessarily performed, except those
mandated by government requirements.
Certain applications using semiconductor products may involve potential risks of death,
personal injury, or severe property or environmental damage (“Critical Applications”).
TI SEMICONDUCTOR PRODUCTS ARE NOT DESIGNED, INTENDED, AUTHORIZED, OR
WARRANTED TO BE SUITABLE FOR USE IN LIFE-SUPPORT APPLICATIONS, DEVICES
OR SYSTEMS OR OTHER CRITICAL APPLICATIONS.
Inclusion of TI products in such applications is understood to be fully at the risk of the customer.
Use of TI products in such applications requires the written approval of an appropriate TI officer.
Questions concerning potential risk applications should be directed to TI through a local SC
sales offices.
In order to minimize risks associated with the customer’s applications, adequate design and
operating safeguards should be provided by the customer to minimize inherent or procedural
hazards.
TI assumes no liability for applications assistance, customer product design, software
performance, or infringement of patents or services described herein. Nor does TI warrant or
represent that any license, either express or implied, is granted under any patent right, copyright,
mask work right, or other intellectual property right of TI covering or relating to any combination,
machine, or process in which such semiconductor products or services might be or are used.
Copyright  1995, Texas Instruments Incorporated
How to Use This Manual
Preface
Read This First
What Is This Book About?
The TMS320C1x/C2x/C2xx/C5x Assembly Language Tools User’s Guide tells
you how to use these assembly language tools:
(cid:1) Assembler
(cid:1) Archiver
(cid:1) Linker
(cid:1) Absolute lister
(cid:1) Cross-reference lister
(cid:1) Hex conversion utility
Before you can use this book, you should read the TMS320C1x/C2x/ C2xx/
C5x Code Generation Tools Getting Started to install the assembly language
tools.
How to Use This Manual
The goal of this book is to help you learn how to use the Texas Instruments
assembly language tools specifically designed for the TMS320 fixed-point
DSPs. This book is divided into four distinct parts:
(cid:1) Part I: Introductory Information gives you an overview of the assembly
language development tools and also discusses common object file for-
mat (COFF) which helps you to use the TMS320C1x/C2x/C2xx/C5x tools
more efficiently. Read Chapter 2 before using the assembler and linker.
(cid:1) Part II: Assembler Description contains detailed information about
using the assembler. This section explains how to invoke the assembler
and discusses source statement format, valid constants and expressions,
assembler output, and assembler directives. It also summarizes the
TMS320C1x, TMS320C2x, TMS320C2xx, and TMS320C5x instruction
sets alphabetically and describes macro elements.
Read This First iii
How to Use This Manual / Notational Conventions
(cid:1) Part III: Additional Assembly Language Tools describes in detail each
of the tools provided with the assembler to help you create assembly
language source files. For example, Chapter 8 explains how to invoke the
linker, how the linker operates, and how to use linker directives. Chapter
11 explains how to use the hex conversion utility.
(cid:1) Part IV: Reference Material provides supplementary information. This
section contains technical data about the internal format and structure of
COFF object files. It discusses symbolic debugging directives that the
TMS320C2x/C5x C compiler uses. Finally, it includes sample linker
command files, assembler and linker error messages, and a glossary.
Notational Conventions
This document uses the following conventions.
(cid:1) Program listings, program examples, and interactive displays are shown
in a special font. Examples use a bold version of the special font for em-
phasis. Here is a sample program listing:
11 0005 0001 .field 1, 2
12 0005 0003 .field 3, 4
13 0005 0006 .field 6, 3
14 0006 .even
(cid:1) In syntax descriptions, the instruction, command, or directive is in a bold
face font and parameters are in an italics. Portions of a syntax that are in
bold face should be entered as shown; portions of a syntax that are in ital-
ics describe the type of information that should be entered. Syntax that will
be entered on a command line is centered in a bounded box. Syntax that
will be used in a text file is left-justified in an unbounded box. Here is an
example of command line syntax:
dspabs filename
dspabs is a command. The command invokes the absolute lister and has
one parameter, indicated by filename. When you invoke the absolute lis-
ter, you supply the name of the file that the absolute lister uses as input.
(cid:1) Square brackets ( [ and ] ) identify an optional parameter. If you use an
optional parameter, you specify the information within the brackets; you
don’t enter the brackets themselves. Here’s an example of an instruction
that has an optional parameter:
dsphex [–options] filename
iv
Notational Conventions
The dsphex command has two parameters. The first parameter,
–options, is optional. Since options is plural, you may select several
options. The second parameter, filename, is required.
Square brackets are also used as part of the pathname specification for
VMS pathnames; in this case, the brackets are actually part of the path-
name (they are not optional).
(cid:1) In assembler syntax statements, column one is reserved for the first char-
acter of a label or symbol. If the label or symbol is optional, it is usually
not shown. If it is a required parameter, then it will be shown starting
against the left margin of the shaded box, as in the example below. No
instruction, command, directive, or parameter, other than a symbol or
label, should begin in column one.
symbol .usect ”section name”, size in bytes
The symbol is required for the .usect directive and must begin in column
one. The section name must be enclosed in quotes, and the section size in
bytes must be separated from the section name by a comma.
(cid:1) Some directives can have a varying number of parameters. For example,
the .byte directive can have up to 100 parameters. The syntax for this di-
rective is:
.byte value1 [, ... , valuen]
Note that .byte does not
begin in column one.
This syntax shows that .byte must have at least one value parameter, but
you have the option of supplying additional value parameters, separated
by commas.
(cid:1) Braces ( { and } ) indicate a list. The symbol | (read as or) separates items
within the list. Here’s an example of a list:
{ * | *+ | *– }
This provides three choices: *, *+, or *–.
Unless the list is enclosed in square brackets, you must choose one item
from the list.
Read This First v
Related Documentation From Texas Instruments
Related Documentation From Texas Instruments
The following books describe the TMS320C1x, ’C2x, ’C2xx, and ’C5x devices
and related support tools. To obtain a copy of any of these TI documents, call
the Texas Instruments Literature Response Center at (800) 477–8924. When
ordering, please identify the book by its title and literature number.
TMS320C1x User’s Guide (literature number SPRU013) discusses the
hardware aspects of the ’C1x generation of CMOS fixed-point digital
signal processors. It describes pin assignments, architecture, instruction
set, and software and hardware applications. This book also features a
section with analog interface peripherals and applications for the ’C1x
DSPs, and includes a consolidated data sheet with electrical
specifications and package information for all ’C1x devices.
TMS320C2x User’s Guide (literature number SPRU014) discusses the hard-
ware aspects of the ’C2x fixed-point digital signal processors. It de-
scribes pin assignments, architecture, instruction set, and software and
hardware applications. It also includes electrical specifications and pack-
age mechanical data for all ’C2x devices. The book features a section
with a ’C1x-to-’C2x DSP system migration.
TMS320C2xx User’s Guide (literature number SPRU127) discusses the
hardware aspects of the ’C2xx fixed-point digital signal processors. It de-
scribes pin assignments, architecture, instruction set, and software and
hardware applications. It also includes electrical specifications and pack-
age mechanical data for all ’C2xx devices. The book features a section
comparing instructions from ’C2x to ’C2xx.
TMS320C5x User’s Guide (literature number SPRU056) describes the
TMS320C5x 16-bit, fixed-point, general-purpose digital signal proces-
sors. Covered are its architecture, internal register structure, instruction
set, pipeline, specifications, DMA, and I/O ports. Software applications
are covered in a dedicated chapter.
TMS320C2x/C2xx/C5x Optimizing C Compiler User’s Guide (literature
number SPRU024) describes the ’C2x/’C2xx/C5x C compiler. This C
compiler accepts ANSI standard C source code and produces TMS320
assembly language source code for the ’C2x, ’C2xx, and ’C5x genera-
tions of devices.
TMS320 Family Development Support Reference Guide (literature number
SPRU011) describes the ’320 family of digital signal processors and
covers the various products that support this product line. This includes
code-generation tools (compilers, assemblers, linkers, etc.) and system
integration and debug tools (simulators, emulators, evaluation modules,
etc.). Also covered are available documentation, seminars, the universi-
ty program, and factory repair and exchange.
vi
Related Documentation From Texas Instruments
TMS320 Third-Party Support Reference Guide (literature number
SPRU052) alphabetically lists over 100 third parties that provided vari-
ous products that serve the family of ’320 digital signal processors. A
myriad of products and applications are offered—software and hardware
development tools, speech recognition, image processing, noise cancel-
lation, modems, etc.
Digital Signal Processing Applications with the TMS320 Family, Volumes
1, 2, and 3 (literature numbers SPRA012, SPRA016, SPRA017)
Volumes 1 and 2 cover applications using the ’C10 and ’C20 families of
fixed-point processors. Volume 3 documents applications using both
fixed-point processors as well as the ’C30 floating-point processor.
TMS320C2x C Source Debugger User’s Guide (literature number
SPRU070) tells how to invoke the debugger with the TMS320C2x
simulator version of the C source debugger interface. This book dis-
cusses various aspects of the debugger interface, including window
management, command entry, code execution, data management,
and breakpoints, and includes a tutorial that introduces basic debug-
ger functionality.
TMS320C5x C Source Debugger User’s Guide (literature number
SPRU055) tells you how to invoke the ’C5x emulator, EVM, and simulator
versions of the C source debugger interface. This book discusses
various aspects of the debugger interface, including window
management, command entry, code execution, data management, and
breakpoints, and includes a tutorial that introduces basic debugger
functionality.
Read This First vii