
ADDS-210xx-TOOLS
REV. B
–3–
SOFT WARE T OOLS
Assembler
T he Assembler reads ADSP-21000 Family assembly language
source files and generates a relocatable object file. It includes
a preprocessor that lets you use the C preprocessor directives
#define
,
#include
,
#if
,
#ifdef
, and
#else
in assembly code.
Assembler directives define code modules, data buffers, data
variables, and memory mapped I/O ports. Both the assembler
and C preprocessor have directives to define macros.
Programming in assembly language is eased by the highly read-
able algebraic syntax of the ADSP-21000 Family instruction set.
An add instruction, for example, is written in the same manner
as the actual equation: T he algebraic statement r = x + y is
coded in assembly language as (f0 = f1 + f2).
Linker
T he Linker processes separately assembled object and library
files to create a single executable program. It assigns memory
locations to code and data according to user defined architecture
files—text files that describe the memory configuration of the
target system. T he Linker generates symbols (variable names
and program labels) in the processed files that are used by the
simulator and emulator to perform symbolic debugging.
Assembly Library/Librarian
T he Assembly Library contains standard arithmetic and DSP
routines accessible to your programs. You can create libraries of
your own functions using the Librarian tool.
Simulator
T he Simulator, a software model of the DSP, provides instruction-
level simulation of program execution. It models system
memory and I/O according to the contents of the system
architecture file, and displays hardware registers and memory
in separate data windows (see Figure 1). T he standard
Windows Graphical User Interface (GUI) provides additional
reconfigurable windows that display and let you alter register
and memory contents, making a powerful debugging
environment. T he Simulator also reads symbols to perform
symbolic debugging. A separate Simulator is provided for
ADSP-2106x class DSPs and for ADSP-21020 class DSPs.
Features of the ADSP-21000 Family Simulators:
Display of all registers, caches, and stacks
Integration with CBUG C Source-Level Debugger
Single step execution
Interrupt simulation
Plotting memory
Break points and break conditions
Simulation of program and data memory.
G21K ANSI C COMPILE R
K nown for its efficiency and reliability, the GNU-based
Optimizing G21K C Compiler supports in-line assembly code,
using the
asm
( ) construct, and generates COFF (Common
Object Format Files), an industry standard file format for
object, library, and executable files.
Figure 1. ADSP-21000 Family Simulator and Emulator User Interface