ANALOG DEVICES W3.5 Started Guide

W3.5
Getting Started Guide
for 16-Bit Processors
Analog Devices, Inc. One Technology Way Norwood, Mass. 02062-9106
Revision 1.0, October 2003
Part Number
82-000035-05
a
Copyright Information
©1996–2003 Analog Devices, Inc., ALL RIGHTS RESERVED. This document may not be reproduced in any form without prior, express writ­ten consent from Analog Devices, Inc.
Printed in the USA.
Disclaimer
Analog Devices, Inc. reserves the right to change this product without prior notice. Information furnished by Analog Devices is believed to be accurate and reliable. However, no responsibility is assumed by Analog Devices for its use; nor for any infringement of patents or other rights of third parties which may result from its use. No license is granted by impli­cation or otherwise under the patent rights of Analog Devices, Inc.
Trademark and Service Mark Notice
The Analog Devices logo and Blackfin are registered trademarks and VisualDSP++ and the VisualDSP++ logo are trademarks of Analog Devices, Inc.
All other brand and product names are trademarks or service marks of their respective owners.

Contents

PREFACE
Purpose of This Manual ................................................................. vii
Intended Audience ......................................................................... vii
Manual Contents .......................................................................... viii
What’s New in This Manual .......................................................... viii
Technical or Customer Support ....................................................... ix
Supported Processors ....................................................................... ix
Product Information ........................................................................ x
MyAnalog.com ........................................................................... x
DSP Product Information .......................................................... xi
Related Documents .................................................................. xii
Online Technical Documentation ............................................. xii
From VisualDSP++ ............................................................. xiii
From Windows ................................................................... xiii
From the Web ...................................................................... xiv
Printed Manuals ........................................................................ xv
VisualDSP++ Documentation Set .......................................... xv
Hardware Manuals ................................................................ xv
Data Sheets ........................................................................... xv
VisualDSP++ 3.5 Getting Started Guide iii for 16-Bit Processors
CONTENTS
Contacting DSP Publications ................................................... xvi
Notation Conventions .................................................................. xvii
FEATURES AND TOOLS
VisualDSP++ Features .................................................................. 1-1
New Features in Release 3.5 .......................................................... 1-5
Code Development Tools .............................................................. 1-7
BASIC TUTORIAL
Overview ...................................................................................... 2-1
Exercise One: Building and Running a C Program ......................... 2-3
Step 1: Start VisualDSP++ and Open a Project ......................... 2-4
Step 2: Build the dotprodc Project ........................................... 2-7
Step 3: Run the Program ....................................................... 2-10
Step 4: Run dotprodc ............................................................ 2-15
Exercise Two: Modifying a C Program to Call an
Assembly Routine .................................................................... 2-16
Step 1: Create a New Project ................................................. 2-16
Step 2: Add Source Files to dot_product_asm ........................ 2-21
Step 3: Create a Linker Description File for the Project .......... 2-22
Step 4: Modify the Project Source Files .................................. 2-27
Step 5: Use the Expert Linker to modify dot_prod_asm.ldf .... 2-31
Step 6: Rebuild and Run dot_product_asm ............................ 2-34
Exercise Three: Plotting Data ...................................................... 2-36
Step 1: Load the FIR Program ............................................... 2-36
Step 2: Open a Plot Window ................................................. 2-38
iv VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors
CONTENTS
Step 3: Run the FIR Program and View the Data ................... 2-41
Exercise Four: Linear Profiling ..................................................... 2-50
Step 1: Load the FIR Program ................................................ 2-50
Step 2: Open the Profiling Window ....................................... 2-51
Step 3: Collect and Examine the Linear Profile Data ............... 2-53
Exercise Five: Installing and Using a VCSE Component ............... 2-56
Step 1: Start VisualDSP++ and Open the Project .................... 2-56
Step 2: Install the EXAMPLES::CULawc Component on
Your System ........................................................................ 2-58
Step 3: Add the Component to Your Project ........................... 2-61
Step 4: Build and Run the Program ........................................ 2-62
ADVANCED TUTORIAL
Overview ...................................................................................... 3-1
Exercise One: Using Profile-Guided Optimization ......................... 3-2
Step 1: Load the Project ........................................................... 3-4
Step 2: Configure a Data Set .................................................... 3-5
Step 3: Attach an Input Stream ................................................ 3-9
Step 4: Configure Additional Data Sets .................................. 3-13
Step 5: Create PGO Files and Optimize Your Program ........... 3-15
Step 6: Compare Execution Times ......................................... 3-16
Exercise Two: Using Background Telemetry Channel ................... 3-19
Adding BTC to Your DSP Application ................................... 3-20
Running the BTC Assembly Demo ........................................ 3-22
Step 1: Load the Btc_AsmDemo Project ............................ 3-23
VisualDSP++ 3.5 Getting Started Guide v for 16-Bit Processors
CONTENTS
Step 2: Examine the BTC Commands ............................... 3-23
Step 3: Set Up the BTC Memory Window and View Data 3-26
Running the BTC FFT Demo ............................................... 3-34
Step 1: Build the FFT Demo ............................................. 3-34
Step 2: Plot BTC Data ...................................................... 3-35
Step 3: Record and Analyze BTC Data .............................. 3-40
INDEX
vi VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors

PREFACE

Thank you for purchasing VisualDSP++™, the development software for Analog Devices processors.

Purpose of This Manual

The VisualDSP++ 3.5 Getting Started Guide for 16-Bit Processors provides basic and advanced tutorials that highlight many VisualDSP++ features. By completing the step-by-step procedures, you will become familiar with the VisualDSP++ environment and learn how to use these features in your own digital signal processing (DSP) development projects.

Intended Audience

This manual is intended for DSP programmers who are familiar with Analog Devices processors. The manual assumes that the audience has a working knowledge of Analog Devices processor architecture and instruc­tion set.
DSP programmers who are unfamiliar with Analog Devices processors should refer to their processor’s Hardware Reference and Instruction Set Reference, which describe the processor architecture and instruction set. Note that the ADSP-BF533 Blackfin Processor Hardware Reference includes information about the ADSP-BF531 and ADSP-BF532 processors.
VisualDSP++ 3.5 Getting Started Guide vii for 16-Bit Processors

Manual Contents

Manual Contents
This guide contains the following chapters.
Chapter 1, “Features and Tools”
Provides an overview of VisualDSP++ features and code develop­ment tools
Chapter 2, “Basic Tutorial”
Provides step-by-step instructions for creating sessions, and for building and debugging projects by using examples of C/C++ and assembly sources
The tutorial is organized to follow the steps that you take in devel­oping a typical programming project. Before you begin actual programming, you should be familiar with the architecture of your particular processor and the other software development tools.
Chapter 3, “Advanced Tutorial”
Provides step-by-step instructions for using profile-guided optimization (PGO) and background telemetry channel (BTC).

What’s New in This Manual

A new “Advanced Tutorial” chapter has been added to the guide. This chapter covers some of the more advanced VisualDSP++ features and techniques.
viii VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors

Technical or Customer Support

You can reach DSP Tools Support in the following ways.
Visit the DSP Development Tools website at
http://www.analog.com/technology/dsp/developmentTools/index.html
Email questions to
dsptools.support@analog.com
Phone questions to 1-800-ANALOGD
Contact your ADI local sales office or authorized distributor
Send questions by mail to:
Analog Devices, Inc. One Technology Way P.O. Box 9106 Norwood, MA 02062-9106 USA
Preface

Supported Processors

The name “Blackfin” refers to a family of Analog Devices 16-bit, embed­ded processors. VisualDSP++ currently supports the following Blackfin processors.
ADSP-BF531 ADSP-BF532 (formerly ADSP-21532)
ADSP-BF533 ADSP-BF535 (formerly ADSP-21535)
ADSP-BF561 AD6532
VisualDSP++ 3.5 Getting Started Guide ix for 16-Bit Processors

Product Information

VisualDSP++ currently supports the following ADSP-21xx processors.
ADSP-2181 ADSP-2191
ADSP-2183 ADSP-2192-12
ADSP-2184/84L/84N ADSP-2195
ADSP-2185/85L/85M/85N ADSP-2196
ADSP-2186/86L/86M/86N ADSP-21990
ADSP-2187L/87N ADSP-21991
ADSP-2188L/88N ADSP-21992
ADSP-2189M/89N
Product Information
You can obtain product information from the Analog Devices website, from the product CD-ROM, or from the printed publications (manuals).
Analog Devices is online at www.analog.com. Our website provides infor­mation about a broad range of products—analog integrated circuits, amplifiers, converters, and digital signal processors.

MyAnalog.com

MyAnalog.com is a free feature of the Analog Devices website that allows
customization of a webpage to display only the latest information on products you are interested in. You can also choose to receive weekly email notification containing updates to the webpages that meet your interests.
MyAnalog.com provides access to books, application notes, data sheets,
code examples, and more.
x VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors
Preface
Registration:
Visit
www.myanalog.com to sign up. Click Register to use MyAnalog.com.
Registration takes about five minutes and serves as means for you to select the information you want to receive.
If you are already a registered user, just log on. Your user name is your email address.

DSP Product Information

For information on digital signal processors, visit our website at
www.analog.com/dsp, which provides access to technical publications, data
sheets, application notes, product overviews, and product announcements.
You may also obtain additional information about Analog Devices and its products in any of the following ways.
Email questions or requests for information to
dsp.support@analog.com
Fax questions or requests for information to
1-781-461-3010 (North America) 089/76 903-557 (Europe)
Access the Digital Signal Processing Division’s FTP website at
ftp ftp.analog.com or ftp 137.71.23.21 ftp://ftp.analog.com
VisualDSP++ 3.5 Getting Started Guide xi for 16-Bit Processors
Product Information

Related Documents

For information on product related development software, see the follow­ing publications.
VisualDSP++ 3.5 User’s Guide for 16-Bit Processors
VisualDSP++ 3.5 C/C++ Compiler and Library Manual for Blackfin Processors
VisualDSP++ 3.5 C Compiler and Library Manual for ADSP-218x Processors
VisualDSP++ 3.5 C/C++ Compiler and Library Manual for ADSP-219x Processors
VisualDSP++ 3.5 Assembler and Preprocessor Manual for Blackfin Processors
VisualDSP++ 3.5 Assembler and Preprocessor Manual for ADSP-21xx Processors
VisualDSP++ 3.5 Linker and Utilities Manual for 16-Bit Processors
VisualDSP++ 3.5 Loader Manual for 16-Bit Processors
VisualDSP++ 3.5 Product Bulletin
VisualDSP++ Kernel (VDK) User’s Guide
VisualDSP++ Component Software Engineering User’s Guide
Quick Installation Reference Card
For hardware information, refer to your processor’s Hardware Reference, Programming Reference, and data sheet.
All documentation is available online. Most documentation is available in printed form.

Online Technical Documentation

Online documentation comprises VisualDSP++ Help system and tools manuals, Dinkum Abridged C++ library and FlexLM network license manager software documentation. You can easily search across the entire VisualDSP++ documentation set for any topic of interest. For easy print­ing, supplementary
xii VisualDSP++ 3.5 Getting Started Guide
.PDF files for the tools manuals are also provided.
for 16-Bit Processors
Preface
A description of each documentation file type is as follows.
File Description
.CHM Help system files and VisualDSP++ tools manuals.
.HTML Dinkum Abridged C++ library and FlexLM network license manager software doc-
umentation. Viewing and printing the net Explorer 4.0 (or higher).
.PDF VisualDSP++ tools manuals in Portable Documentation Format, one .PDF file for
each manual. Viewing and printing the .PDF files require a PDF reader, such as Adobe Acrobat Reader (4.0 or higher).
.HTML files require a browser, such as Inter-
If documentation is not installed on your system as part of the software installation, you can add it from the VisualDSP++ CD-ROM at any time by rerunning the Tools installation.
Access the online documentation from the VisualDSP++ environment, Windows Explorer, or Analog Devices website.
From VisualDSP++
Access VisualDSP++ online Help from the Help menu’s Contents, Search, and Index commands.
Open online Help from context-sensitive user interface items (tool­bar buttons, menu commands, and windows).
From Windows
In addition to any shortcuts you may have constructed, there are many ways to open VisualDSP++ online Help or the supplementary documenta­tion from Windows.
VisualDSP++ 3.5 Getting Started Guide xiii for 16-Bit Processors
Product Information
Help system files (.
CHM files) are located in the Help folder, and .PDF files
are located in the Docs folder of your VisualDSP++ installation. The Docs folder also contains the Dinkum Abridged C++ library and FlexLM net­work license manager software documentation.
Using Windows Explorer
Double-click any file that is part of the VisualDSP++ documenta­tion set.
Double-click the vdsp-help.chm file, which is the master Help sys­tem, to access all the other .CHM files.
Using the Windows Start Button
Access VisualDSP++ online Help by clicking the Start button and choosing Programs, VisualDSP, and VisualDSP++ Documentation.
Access the .PDF files by clicking the Start button and choosing Programs, VisualDSP, Documentation for Printing, and the name of the book.
From the Web
To download the tools manuals, point your browser at:
www.analog.com/technology/dsp/developmentTools/gen_purpose.html
Select a DSP family and book title. Download archive (.ZIP) files, one for each manual. Use any archive management software, such as WinZip, to decompress downloaded files.
xiv VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors
Preface

Printed Manuals

For general questions regarding literature ordering, call the Literature Center at 1-800-ANALOGD (1-800-262-5643) and follow the prompts.
VisualDSP++ Documentation Set
VisualDSP++ manuals may be purchased through Analog Devices Cus­tomer Service at 1-781-329-4700; ask for a Customer Service representative. The manuals can be purchased only as a kit. For additional information, call 1-603-883-2430.
If you do not have an account with Analog Devices, you will be referred to Analog Devices distributors. To get information on our distributors, log onto http://www.analog.com/salesdir/continent.asp.
Hardware Manuals
Hardware reference and instruction set reference manuals can be ordered through the Literature Center or downloaded from the Analog Devices website. The phone number is 1-800-ANALOGD (1-800-262-5643). The manuals can be ordered by a title or by product number located on the back cover of each manual.
Data Sheets
All data sheets can be downloaded from the Analog Devices website. As a general rule, any data sheet with a letter suffix (L, M, N) can be obtained from the Literature Center at 1-800-ANALOGD (1-800-262-5643) or downloaded from the website. Data sheets without the suffix can be downloaded from the website only—no hard copies are available. You can ask for the data sheet by a part name or by product number.
VisualDSP++ 3.5 Getting Started Guide xv for 16-Bit Processors
Product Information
If you want to have a data sheet faxed to you, the phone number for that service is 1-800-446-6212. Follow the prompts and a list of data sheet code numbers will be faxed to you. Call the Literature Center first to find out if requested data sheets are available.

Contacting DSP Publications

Please send your comments and recommendations for improving our manuals and online Help. You can contact us by sending an email to:
dsp.techpubs@analog.com
xvi VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors

Notation Conventions

The following table identifies and describes text conventions used in this manual.
Preface
L
Example Description
Close command (File menu) or OK
{this | that} Alternative required items in syntax descriptions appear within curly
[this | that] Optional items in syntax descriptions appear within brackets and sepa-
[this,…] Optional item lists in syntax descriptions appear within brackets
.SECTION Registers, commands, directives, keywords, code examples, and feature
filename Non-keyword placeholders appear in text with italic style format.
appear throughout this document.
Te x t i n bold style indicates the location of an item within the VisualDSP++ environment’s menu system. For example, the Close command appears on the File menu.
brackets and separated by vertical bars; read the example as
that.
rated by vertical bars; read the example as an optional this or that.
delimited by commas and terminated with an ellipsis; read the example as an optional comma-separated list of
names are in text with letter gothic font.
A note, providing information of special interest or identifying a related topic. In the online version of this book, the word Note appears instead of this symbol.
this or
this.
Additional conventions, which apply only to specific chapters, may
A caution, providing information about critical design or program­ming issues that influence operation of a product. In the online version of this book, the word Caution appears instead of this symbol.
VisualDSP++ 3.5 Getting Started Guide xvii for 16-Bit Processors
Notation Conventions
xviii VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors

1 FEATURES AND TOOLS

This chapter contains the following topics.
“VisualDSP++ Features” on page 1-1
“New Features in Release 3.5” on page 1-5
“Code Development Tools” on page 1-7

VisualDSP++ Features

VisualDSP++ provides the following features.
Extensive editing capabilities. Create and modify source files by using multiple language syntax highlighting, drag-and-drop, book­marks, and other standard editing operations. View files generated by the code development tools.
Flexible project management. Specify a project definition that identifies the files, dependencies, and tools that you will use to build projects. Create this project definition once or modify it to meet changing development needs.
VisualDSP++ 3.5 Getting Started Guide 1-1 for 16-Bit Processors
VisualDSP++ Features
Easy access to code development tools. Analog Devices provides these code development tools: C/C++ compiler, assembler, linker, splitter, and loader. Specify options for these tools by using dialog boxes instead of complicated command line scripts. Options that control how the tools process inputs and generate outputs have a one-to-one correspondence to command line switches. Define options for a single file or for an entire project. Define these options once or modify them as necessary.
Flexible project build options. Control builds at the file or project level. VisualDSP++ enables you to build files or projects selectively, update project dependencies, or incrementally build only the files that have changed since the previous build. View the status of your project build in progress. If the build reports an error, double-click on the file name in the error message to open that source file. Then correct the error, rebuild the file or project, and start a debug session.
VisualDSP++ Kernel (VDK) Support. Add VDK support to a project to structure and scale application development. The Kernel tab page of the Project window enables you to manipulate events, event bits, priorities, semaphores, and thread types.
Flexible workspace management. Create up to ten workspaces and quickly switch between them. Assigning a different project to each workspace enables you to build and debug multiple projects in a single session.
Easy movement between debug and build activities. You start the debug session and move freely between editing, build, and debug activities.
1-2 VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors
Features and Tools
Figure 1-1 shows the Integrated Development and Debugging
Environment.

Figure 1-1. The VisualDSP++ IDDE

VisualDSP++ 3.5 Getting Started Guide 1-3 for 16-Bit Processors
VisualDSP++ Features
VisualDSP++ reduces your debugging time by providing these key features.
Easy-to-use debugging activities. Debug with one common, easy-to-use interface for all processor simulators and emulators, or hardware evaluation and development boards. Switch easily between these targets.
Multiple language support. Debug programs written in C, C++, or assembly, and view your program in machine code. For programs written in C/C++, you can view the source in C/C++ or mixed C/C++ and assembly, and display the values of local variables or evaluate expressions (global and local) based on the current context.
Effective debug control. Set breakpoints on symbols and addresses and then step through the program’s execution to find problems in coding logic. Set watchpoints (conditional breakpoints) on regis­ters, stacks, and memory locations to identify when they are accessed.
Tools for improving performance. Use the trace, profile, and lin­ear and statistical profiles to identify bottlenecks in your DSP application and to identify program optimization needs. Use plot­ting to view data arrays graphically. Generate interrupts, outputs, and inputs to simulate real-world application conditions.
1-4 VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors
Features and Tools

New Features in Release 3.5

Release 3.5 includes the following new features and enhancements.
New processor support. The ADSP-BF561 processor is supported
by this software version. Refer to the ADSP-BF561 Blackfin Hard- ware Reference and chip data sheet for details.
Multiple project support. VisualDSP++ provides the ability to switch among multiple open projects in the same IDDE session. The Project window displays active projects.
Data streaming and logging. VisualDSP++ now offers the ability to stream and log data from a target DSP without halting the DSP. The IDDE takes advantage of this capability in plot windows. If the target supports background telemetry channel (BTC), the plot window is updated while the target is running.
License management in the IDDE. License management (installa­tion and validation) has been integrated into the VisualDSP++ IDDE. Installing a FlexLM license server is still handled by the separate instal­lation application.
Profile-guided optimization (PGO) in the IDDE. VisualDSP++ includes facilities to run common PGO scenarios simply and also pro­vides a mechanism for advanced applications that require more control over the profiling process via scripting. The techniques relies on setting up and executing data sets to produce an optimized application.
VisualDSP++ 3.5 Getting Started Guide 1-5 for 16-Bit Processors
New Features in Release 3.5
Integrated Source Code Control (SCC). VisualDSP++ uses the Microsoft Common Source Code Control (MCSCC) interface to pro­vide a connection from the IDDE to SCC applications (such as Visual SourceSafe, PVCS Version Manager, and ClearCase) installed on your machine. You can now conveniently access commonly-used SCC fea­tures from VisualDSP++ without leaving the IDDE. Advanced and application-specific SCC features not available from the IDDE must be run directly from the SCC applications.
Automation aware scripting engine. VisualDSP++ includes a script­ing engine that uses the Microsoft ActiveX script host framework. The engine enables you to use multiple scripting languages (such as VBScript, JavaScript, and so on) to access the VisualDSP++ Automa­tion API.
You can interact with the IDDE by using a single command or a script file similar to the Tcl scripting functionality, which was available in previous versions of VisualDSP++.
Profiling code with Expert Linker. You can use Expert Linker to profile object sections in a program. When the program halts, Expert Linker graphically displays how much time was spent in each object section. You can use this display to locate code “hotspots” and then move that code to faster, internal memory.
Address bar in Disassembly and Memory windows. When enabled, an address bar is displayed in Disassembly windows and memory win­dows. You can use the address bar to navigate by address, symbol, or expression. The address bar maintains a most recently used history of visited locations.
Menus with Icons. Icons now appear beside menu commands that have corresponding toolbar buttons.
1-6 VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors

Code Development Tools

Code development tools for 16-bit processors include:
C/C++ compiler
Runtime library with over 100 math, DSP, and C runtime library routines
•Assembler
•Linker
Splitter
•Loader
Simulator
Features and Tools
Emulator (must be purchased separately from VisualDSP++)
These tools enable you to develop applications that take full advantage of your processor’s architecture.
The VisualDSP++ linker supports multiprocessing, shared memory, and memory overlays.
VisualDSP++ 3.5 Getting Started Guide 1-7 for 16-Bit Processors
Code Development Tools
The code development tools provide the following key features.
Easy-to-program C, C++, and assembly languages. Program in C/C++, assembly, or mix C/C++ and assembly in one source. The assembly language is based on an algebraic syntax that is easy to learn, program, and debug.
Flexible system definition. Define multiple types of executables for a single type of processor in one Linker Description File ( Specify input files, including objects, libraries, shared memory files, overlay files, and executables.
Support for overlays, multiprocessors, and shared memory exe- cutables. The linker places code and resolves symbols in multiprocessor memory space for use by multiprocessor systems. The loader enables you to configure multiprocessors with less code and faster boot time. Create host, link port, and PROM boot images.
.LDF).
Software and hardware tool kits include context-sensitive Help and manu­als in PDF format.
For details about assembly syntax, refer to the VisualDSP++ 3.5 Assembler and Preprocessor Manual for your target processor.
1-8 VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors

2 BASIC TUTORIAL

This chapter contains the following topics.
“Overview” on page 2-1
“Exercise One: Building and Running a C Program” on page 2-3
“Exercise Two: Modifying a C Program to Call an Assembly Rou-
tine” on page 2-16
“Exercise Three: Plotting Data” on page 2-36
“Exercise Four: Linear Profiling” on page 2-50
“Exercise Five: Installing and Using a VCSE Component” on
page 2-56

Overview

The Basic Tutorial demonstrates key features and capabilities of the VisualDSP++ Integrated Development and Debugging Environment (IDDE). The exercises use sample programs written in C, C++, and assembly for Blackfin processors.
You can use different Blackfin processors with only minor changes to the Linker Description Files (.LDFs) included with each project. VisualDSP++ includes basic Linker Description Files for each processor type in the
folder
Program Files\Analog Devices\VisualDSP 3.5 16-Bit\Blackfin\ldf
VisualDSP++ 3.5 Getting Started Guide 2-1 for 16-Bit Processors
. For Blackfin processors, the folder’s default installation path is:
ldf
Overview
The source files for these exercises are installed during the VisualDSP++ software installation.
The tutorial contains five exercises:
•In Exercise One, you will start up VisualDSP++, build a project containing C source code, and profile the performance of a C function.
•In Exercise Two, you will create a new project, create a Linker Description File to link with the assembly routine, rebuild the project, and profile the performance of the assembly language routine.
•In Exercise Three, you will plot the various waveforms produced by a Finite Impulse Response (FIR) algorithm.
•In Exercise Four, you will use linear profiling to examine the effi- ciency of the FIR algorithm used in Exercise Three. Using the collected linear profile data, you will pinpoint the most time-con­suming areas of the algorithm, which are likely to require hand tuning in the assembly language.
•In Exercise Five, you will install a VCSE component on your sys- tem and add the component to the project. Then you will build and run the program with the component.
The ADSP-BF53x Family Simulator and ADSP-BF535 processor are used for all exercises.
Tip: Become familiar with the VisualDSP++ toolbar buttons, shown in
Figure 2-1 on page 2-3. They are shortcuts for menu commands such as
Open a file and Run a program. Toolbar buttons and menu commands that are not available for tasks that you want to perform are disabled and displayed in gray.
2-2 VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors

Figure 2-1. VisualDSP++ Toolbar Buttons

Basic Tutorial
L
VisualDSP++ is a licensed software product. To run the software, you must have a valid license installed on your system. If you try to run VisualDSP++ and a license is not installed, a message window opens to let you add a license. For details about license manage­ment, see the VisualDSP++ 3.5 User’s Guide for 16-Bit Processors or the VisualDSP++ online Help.

Exercise One: Building and Running a C Program

In this exercise, you will:
Start up the VisualDSP++ environment
Open and build an existing project
Examine windows and dialog boxes
Run the program
The sources for this exercise are in the installation path is:
dot_product_c folder. The default
Program Files\Analog Devices\VisualDSP 3.5 16-Bit\Blackfin\
Examples\Tutorial\dot_product_c
VisualDSP++ 3.5 Getting Started Guide 2-3 for 16-Bit Processors
Exercise One: Building and Running a C Program

Step 1: Start VisualDSP++ and Open a Project

To start VisualDSP++ and open a project:
1. Click the Windows Start button and select Programs, Analog
Devices, VisualDSP++ 3.5 for 16-bit Processor, and VisualDSP++ Environment.
If you are running VisualDSP++ for the first time, the New Session dialog box (Figure 2-6 on page 2-11) opens to enable you to set up a session.
a. Select the values shown in Table 2-1.
Table 2-1. Session Specification
Box Value
Debug Target ADSP-BF53x Family Simulator
Platform ADSP-BF535 Simulator
Session Name ADSP-BF535 ADSP-BF535 Simulator
Processor
ADSP-BF535
b. Click OK. The VisualDSP++ main window appears.
If you have already run VisualDSP++ and the Reload last project at
startup option is selected on the Project page under Settings and Preferences, VisualDSP++ opens the last project that you worked
on. To close this project, choose Close from the Project menu, and then click No when prompted to save the project. Since you have made no changes to the project, you do not have to save it.
2. From the Project menu, choose Open.
VisualDSP++ displays the Open Project dialog box.
2-4 VisualDSP++ 3.5 Getting Started Guide
for 16-Bit Processors
Loading...
+ 108 hidden pages