W5.0
User’s Guide
Analog Devices, Inc.
One Technology Way
Norwood, Mass. 02062-9106
Revision 3.0, August 2007
Part Number:
82-000420-02
Copyright Information
©2007 Analog Devices, Inc., ALL RIGHTS RESERVED. This document
may not be reproduced in any form without prior, express written 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 implication or otherwise under the patent rights of Analog Devices, Inc.
Trademark and Service Mark Notice
The Analog Devices logo, the CROSSCORE logo, VisualDSP++,
SHARC, TigerSHARC, Blackfin, and EZ-KIT Lite are registered 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 .............................................................. xxiii
Intended Audience ...................................................................... xxiii
Manual Contents ......................................................................... xxiv
What’s New in This Manual .......................................................... xxv
Technical or Customer Support .................................................... xxvi
Supported Processors ................................................................... xxvii
Product Information .................................................................. xxviii
MyAnalog.com ..................................................................... xxviii
Processor Product Information ................................................ xxix
Related Documents ................................................................. xxx
Online Technical Documentation ........................................... xxxi
Accessing Documentation From VisualDSP++ ................... xxxii
Accessing Documentation From Windows ......................... xxxii
Accessing Documentation From the Web .......................... xxxiii
Embedded Processing & DSP Knowledge Base ................. xxxiii
Printed Manuals ................................................................... xxxiii
VisualDSP++ 5.0 User’s Guide -iii
CONTENTS
Hardware Tools Manuals ................................................. xxxiii
Processor Manuals ............................................................ xxxiv
Data Sheets ...................................................................... xxxiv
Notation Conventions ................................................................. xxxv
INTRODUCTION TO VISUALDSP++
VisualDSP++ Features .................................................................. 1-1
Integrated Development and Debugging .................................. 1-2
Code Development Tools ........................................................ 1-2
Source File Editing Features .................................................... 1-3
Project Management Features .................................................. 1-4
Debugging Features ................................................................. 1-5
VDK Features ......................................................................... 1-6
VisualDSP++ 5.0 Features ....................................................... 1-7
Product Updates and Upgrades ................................................... 1-10
VisualDSP++ Product Upgrades ............................................ 1-10
VisualDSP++ Product Updates .............................................. 1-10
Project Development .................................................................. 1-11
Overview of Programming With VisualDSP++ ....................... 1-12
Project Development Stages ................................................... 1-14
Targets .................................................................................. 1-15
Simulation Targets ............................................................ 1-16
EZ-KIT Lite Targets ......................................................... 1-16
Emulator Targets .............................................................. 1-17
Platforms .............................................................................. 1-17
iv VisualDSP++ 5.0 User’s Guide
CONTENTS
Debugging Overview ............................................................. 1-20
VisualDSP++ Kernel .............................................................. 1-22
Program Development Steps .................................................. 1-22
Step 1: Create a Project ..................................................... 1-23
Step 2: Configure Project Options ..................................... 1-23
Step 3: Add and Edit Project Source Files .......................... 1-23
Adding Files to Your Project .......................................... 1-24
Creating Files to Add to Your Project ............................. 1-24
Editing Files .................................................................. 1-24
Managing Project Dependencies .................................... 1-24
Step 4: Specifying Project Build Options ........................... 1-24
Configuration ............................................................... 1-25
Project-Wide File and Tool Options .............................. 1-25
Individual File and Tool Options ................................... 1-26
Step 5: Build a Debug Version of the Project ...................... 1-26
Step 6: Create a Debug Session and Load the Executable .... 1-26
Step 7: Run and Debug the Program ................................. 1-26
Step 8: Build a Release Version of the Project ..................... 1-27
Code Development Tools ............................................................ 1-27
Compiler ............................................................................... 1-28
C++ Run-Time Libraries ........................................................ 1-29
Dinkum Abridged C++ Library ......................................... 1-29
Assembler .............................................................................. 1-30
Linker ................................................................................... 1-31
VisualDSP++ 5.0 User’s Guide v
CONTENTS
Expert Linker ........................................................................ 1-34
Expert Linker Window ..................................................... 1-35
Memory Map Pane Right-Click Menu .............................. 1-36
Stack and Heap Usage ....................................................... 1-38
Archiver ................................................................................ 1-41
Splitter ................................................................................. 1-41
Loader .................................................................................. 1-42
Processor Projects ....................................................................... 1-43
Project Wizard ...................................................................... 1-44
Startup Code .................................................................... 1-45
.LDF File ......................................................................... 1-46
Project Options ..................................................................... 1-47
Project Groups ...................................................................... 1-48
Project Group Files ........................................................... 1-49
Source Code Control (SCC) .................................................. 1-50
Makefiles .............................................................................. 1-51
Rules ................................................................................ 1-52
Output Window ............................................................... 1-53
Example Makefile ............................................................. 1-53
Project Configurations .......................................................... 1-56
Project Build ......................................................................... 1-57
Build Options .................................................................. 1-58
File Building .................................................................... 1-58
Batch Builds ..................................................................... 1-59
vi VisualDSP++ 5.0 User’s Guide
CONTENTS
Pre-Build and Post-Build Options ..................................... 1-59
Command Syntax ......................................................... 1-60
Project Dependencies ........................................................ 1-60
VisualDSP++ Help System .......................................................... 1-61
ENVIRONMENT
Project Window ............................................................................ 2-2
Project View ............................................................................ 2-3
Kernel Tab .............................................................................. 2-4
Project Dependencies .............................................................. 2-4
Project Nodes .......................................................................... 2-6
Project Folders .................................................................... 2-6
Project Files ........................................................................ 2-8
Project Window Icons for Source Code Control (SCC) ........ 2-9
Project Page Right-Click Menus ............................................. 2-10
Project Group Icon Right-Click Menu ............................... 2-10
Project Icon Right-Click Menu .......................................... 2-11
Folder Icon Right-Click Menu .......................................... 2-12
File Icon Right-Click Menu ............................................... 2-12
Project Window Rules ........................................................... 2-13
File Associations .................................................................... 2-14
Automatic File Placement ...................................................... 2-15
File Placement Rules ......................................................... 2-15
Example ........................................................................... 2-16
Editor Windows .......................................................................... 2-16
VisualDSP++ 5.0 User’s Guide vii
CONTENTS
Editor Window Features ........................................................ 2-17
Editor Window Symbols ....................................................... 2-18
Bookmarks ............................................................................ 2-19
Syntax Coloring .................................................................... 2-19
Viewing Modes: Source Mode vs. Mixed Mode ...................... 2-20
Source Mode .................................................................... 2-20
Mixed Mode ..................................................................... 2-20
Editor Tab Mode .................................................................. 2-21
Context-Sensitive Expression Evaluation ................................ 2-23
Viewing an Expression ...................................................... 2-24
Highlighting an Expression ............................................... 2-24
Compiler Annotations ........................................................... 2-24
Right-Click Menu ................................................................. 2-27
Output Window ......................................................................... 2-28
Build Page and Console Page ................................................. 2-29
Code Development Tools Batch Processing Messages ............. 2-31
Message Severity Hierarchy ............................................... 2-31
Syntax of Help for Error Messages ..................................... 2-32
Viewing Error Message Details .......................................... 2-33
Promoting, Demoting, and Suppressing Error Messages ..... 2-35
Example 1: Compiling from the Command Line (Interface) 2-36
Example 2: Promoting Warnings to Errors ..................... 2-36
Example 3: Demoting Messages to Remarks .................. 2-37
Example 4: Suppressing Messages .................................. 2-37
viii VisualDSP++ 5.0 User’s Guide
CONTENTS
Suppressing Compiler Warnings and Remarks ................ 2-37
Log File ................................................................................. 2-38
Output Window Customization ............................................. 2-38
Right-Click Menu ................................................................. 2-39
Script Command Output ....................................................... 2-40
Debugging Windows ................................................................... 2-43
Disassembly Windows ........................................................... 2-45
Other Disassembly Window Features ................................. 2-47
Right-Click Menu ............................................................. 2-48
Disassembly Window Symbols .......................................... 2-49
Expressions Window .............................................................. 2-50
Expressions Permitted in an Expression Window ................ 2-51
Trace Windows ...................................................................... 2-52
Locals Window ...................................................................... 2-54
Statistical/Linear Profiling Window ........................................ 2-55
Window Components ....................................................... 2-55
Left Pane ...................................................................... 2-56
Right Pane .................................................................... 2-56
Status Bar ..................................................................... 2-57
Right-Click Menu ......................................................... 2-57
Window Operations .......................................................... 2-58
Changing the Window View ......................................... 2-59
Displaying a Source File ................................................ 2-59
Displaying Functions in Libraries .................................. 2-59
VisualDSP++ 5.0 User’s Guide ix
CONTENTS
Working With Ranges ................................................... 2-60
Switching Display Modes .............................................. 2-60
Filtering PC Samples With No Debug Information ....... 2-62
Call Stack Window ............................................................... 2-63
Applications Built With Debug Information ..................... 2-64
Applications Built When Debug Information is Not Available 2-64
Memory Windows ................................................................ 2-67
Number Formats in Memory Windows ............................. 2-67
Memory Window Right-Click Menu ................................. 2-69
Expression Tracking in a Memory Window ....................... 2-69
Memory Window Display Customization .......................... 2-72
Background Telemetry Channels (BTCs) ............................... 2-73
BTC Definitions in Your Program ..................................... 2-73
Enabling BTC on ADSP-2126x and ADSP-BF36x Processors 2-74
BTC Priority .................................................................... 2-75
BTC Memory Window ..................................................... 2-75
BTC Memory Window Right-Click Menu ........................ 2-78
Register Windows ................................................................. 2-78
Stack Windows ..................................................................... 2-80
Custom Registers Windows ................................................... 2-81
Custom Board Support ......................................................... 2-82
Custom Board Support Files ............................................. 2-82
Processor Definition Files ................................................. 2-83
Multiprocessor Window ........................................................ 2-83
x VisualDSP++ 5.0 User’s Guide
CONTENTS
Multiprocessor Window Pages ........................................... 2-84
Status Page .................................................................... 2-84
Groups Page .................................................................. 2-85
Operating on Multiprocessor Groups ................................. 2-86
Focus ................................................................................ 2-86
Right-Click Menu ............................................................. 2-87
Pipeline Viewer Window ....................................................... 2-88
Right-Click Menu of Pipeline Viewer Window .................. 2-89
Pipeline Viewer Properties Dialog Box ............................... 2-90
Pipeline Viewer Window Event Icons ................................ 2-91
Pipeline Instruction Event Details ..................................... 2-92
Cache Viewer Window .......................................................... 2-93
Configuration Page ........................................................... 2-96
Detailed View Page ........................................................... 2-97
History Page ..................................................................... 2-98
Performance Page .............................................................. 2-99
Histogram Page ............................................................... 2-100
Address View Page .......................................................... 2-102
VDK Status Window ........................................................... 2-103
VDK State History Window ................................................ 2-105
Thread Status and Event Colors ...................................... 2-106
Window Operations ........................................................ 2-107
Right-Click Menu ........................................................... 2-108
Target Load Window ........................................................... 2-108
VisualDSP++ 5.0 User’s Guide xi
CONTENTS
Plot Windows ..................................................................... 2-109
Plot Window Features ..................................................... 2-110
Status Bar ................................................................... 2-110
Tool Bar ..................................................................... 2-111
Right-Click Menu ...................................................... 2-111
Plot Window Statistics .................................................... 2-112
Plot Configuration ......................................................... 2-114
Plot Window Presentation .............................................. 2-116
Plot Presentation Options ............................................... 2-117
Image Viewer ...................................................................... 2-119
Automation Interface ...................................................... 2-120
Toolbar .......................................................................... 2-120
Status Bar ....................................................................... 2-121
Right-Click Menu .......................................................... 2-121
DEBUGGING
Debug Sessions ............................................................................. 3-1
Debug Session Management .................................................... 3-3
Simulation vs. Emulation ........................................................ 3-3
Breakpoints ........................................................................ 3-3
Watchpoints ....................................................................... 3-4
Multiprocessor (MP) System Debugging .................................. 3-4
Setting Up a Multiprocessor Debug Session ......................... 3-4
Debugging a Multiprocessor System .................................... 3-5
Focus and Pinning .......................................................... 3-6
xii VisualDSP++ 5.0 User’s Guide
CONTENTS
Window Title Bar Information ........................................ 3-6
Additional Focus Indication ............................................ 3-7
Code Analysis Tools ...................................................................... 3-7
Statistical Profiles and Linear Profiles ....................................... 3-8
Simulation: Linear Profiling ................................................ 3-8
Emulation: Statistical Profiling ............................................ 3-8
Traces ...................................................................................... 3-9
Program Execution Operations .................................................... 3-10
Selecting a New Debug Session at Startup .............................. 3-10
Loading the Executable Program ............................................ 3-11
Program Execution Commands .............................................. 3-11
Restarting the Program .......................................................... 3-12
Performing a Restart During Simulation ............................ 3-12
Performing a Restart During Emulation ............................. 3-13
Breakpoints ........................................................................... 3-13
Unconditional and Conditional Breakpoints .......................... 3-14
Automatic Breakpoints .......................................................... 3-14
Watchpoints .......................................................................... 3-15
Hardware Breakpoints ........................................................... 3-16
Latency ............................................................................. 3-16
Restrictions ....................................................................... 3-16
Simulation Tools ......................................................................... 3-16
Interrupts .............................................................................. 3-17
Input/Output Simulation (Data Streams) ............................... 3-17
VisualDSP++ 5.0 User’s Guide xiii
CONTENTS
Plots ........................................................................................... 3-19
Plot Types ............................................................................. 3-20
Line Plots ............................................................................. 3-21
X-Y Plots .............................................................................. 3-21
Constellation Plots ................................................................ 3-22
Eye Diagrams ........................................................................ 3-23
Waterfall Plots ...................................................................... 3-24
Spectrogram Plots ................................................................. 3-26
Flash Programmer ....................................................................... 3-26
Stand-Alone Flash Programmer ............................................. 3-28
Flash Devices ........................................................................ 3-29
Flash Programmer Functions ................................................. 3-29
Flash Driver .......................................................................... 3-30
Flash Programmer Window ................................................... 3-30
Energy-Aware Programming ........................................................ 3-31
Ranking ................................................................................ 3-31
Example ............................................................................... 3-31
REFERENCE INFORMATION
Support Information ..................................................................... A-2
IDDE Command-Line Parameters ................................................ A-7
Extensive Scripting ....................................................................... A-8
File Types ................................................................................... A-12
Parts of the User Interface ........................................................... A-15
Title Bar ............................................................................... A-16
xiv VisualDSP++ 5.0 User’s Guide
CONTENTS
Additional Information in Title Bars ................................. A-17
Title Bar Right-Click Menu ............................................. A-17
Control Menu ...................................................................... A-18
Program Icons .................................................................. A-18
Editor Windows ............................................................... A-18
Debugging Windows ........................................................ A-19
Menu Bar ............................................................................. A-19
Toolbars and User Tools ........................................................ A-19
Built-In Toolbars ............................................................. A-20
Toolbar Customization ..................................................... A-21
User Tools ....................................................................... A-21
Toolbar Buttons ............................................................... A-22
Toolbar Operation ........................................................... A-27
Toolbar Button Appearance .............................................. A-27
Toolbar Shape .................................................................. A-28
Toolbars: Docked vs. Floating .......................................... A-28
Toolbar Rules ................................................................... A-29
Status Bar ............................................................................. A-29
Keyboard Shortcuts .................................................................... A-31
Working With Files .............................................................. A-31
Moving Within a File ........................................................... A-32
Cutting, Copying, Pasting, Moving Text ............................... A-33
Selecting Text Within a File .................................................. A-34
Working With Bookmarks in an Editor Window ................... A-34
VisualDSP++ 5.0 User’s Guide xv
CONTENTS
Building Projects ................................................................... A-35
Using Keyboard Shortcuts for Program Execution .................. A-35
Working With Breakpoints .................................................... A-36
Obtaining VisualDSP++ Help ............................................... A-36
Miscellaneous ....................................................................... A-37
Window Operations ................................................................... A-37
Window Manipulation .......................................................... A-37
Right-Click Menu Options ................................................... A-38
Scroll Bars and Resize Pull-Tab .............................................. A-38
Windows: Docked vs. Floating .............................................. A-39
Docked Windows ............................................................. A-39
Floating Windows ............................................................ A-39
Window Position Rules ......................................................... A-42
Standard Windows Buttons ................................................... A-42
Text Operations .......................................................................... A-44
Regular Expressions vs. Normal Searches ............................... A-44
Specific Special Characters ................................................ A-45
Special Rules for Sequences ............................................... A-46
Repetition and Combination Characters ........................... A-46
Match Rules ..................................................................... A-47
Tagged Expressions in Replace Operations ............................. A-47
Comment Start and Stop Strings ........................................... A-48
Online Documentation ............................................................... A-49
Printing Online Documentation ............................................ A-50
xvi VisualDSP++ 5.0 User’s Guide
CONTENTS
Invoking Online Help .......................................................... A-51
Help Categories .................................................................... A-52
Online Help .............................................................................. A-53
Help Window ...................................................................... A-53
Context-Sensitive Help ......................................................... A-54
Viewing Menu, Toolbar, or Window Help ........................ A-56
Viewing Dialog Box Help ................................................. A-56
Viewing Window Help ..................................................... A-57
Copying Example Code From Help ...................................... A-57
Printing Help ....................................................................... A-57
Bookmarking Frequently Used Help Topics ........................... A-58
Navigating in Online Help ................................................... A-59
Searching Help ..................................................................... A-60
Full-Text Searches ............................................................ A-60
Rules for Full-Text Searches .......................................... A-62
Advanced Search Techniques ............................................ A-62
Wildcard Expressions ................................................... A-63
Boolean Operators ....................................................... A-63
Nested Expressions ....................................................... A-64
Rules for Advanced Searches ......................................... A-65
Glossary ..................................................................................... A-66
SIMULATION OF SHARC PROCESSORS
Anomaly Options ......................................................................... B-1
ADSP-21x6x Processor Anomalies ........................................... B-2
VisualDSP++ 5.0 User’s Guide xvii
CONTENTS
Shadow Write FIFO Anomaly (ADSP-2116x Only) ................. B-2
SIMD Read from Internal Memory With Shadow Write FIFO Hit
Anomaly (ADSP-2116x Only) .............................................. B-3
Event Options .............................................................................. B-4
FP Denorm ............................................................................. B-4
Short Word Anomaly .............................................................. B-4
Access to ADSP-21065L Short-Word Internal Memory 9th Column at
Even Addresses ..................................................................... B-7
Recording a Simulator Anomaly or Event ...................................... B-7
Select Processor ID Options ........................................................ B-10
Simulator Options ...................................................................... B-10
No Boot Mode ...................................................................... B-10
Load Sim Loader Options ........................................................... B-11
SPI Simulation in Slave Mode ..................................................... B-13
SIMULATION OF TIGERSHARC PROCESSORS
ADSP-TS101 Processors ............................................................... C-1
Simulator Timing Analysis Overview ....................................... C-2
Pipeline Stages ........................................................................ C-2
Stalls ....................................................................................... C-3
Stalls Due to IALU Dependency ......................................... C-3
Stalls Due to Compute Block Dependency .......................... C-4
Aborts .................................................................................... C-5
Aborts Due to an Unpredicted Change of Flow ................... C-5
Abort Due to Mispredicted Change of Flow ........................ C-6
xviii VisualDSP++ 5.0 User’s Guide
CONTENTS
Branch Target Buffer Hits .................................................. C-7
Pipeline Viewer and Disassembly Window Operations ............. C-7
Current Program Counter Value ......................................... C-8
Stepping ............................................................................ C-9
Simulator Options ................................................................ C-11
ADSP-TS20x Processors ............................................................. C-12
Simulator Timing Analysis Overview .................................... C-12
Pipeline Stages ...................................................................... C-13
Stalls .................................................................................... C-14
Stalls Due to IALU Dependency ....................................... C-14
Stalls Due to Compute Block Dependency ........................ C-15
Stalls Due to a Cache Miss ............................................... C-15
Aborts .................................................................................. C-15
Aborts Due to an Unpredicted Change of Flow ................. C-16
Abort Due to Mispredicted Change of Flow ...................... C-18
Branch Target Buffer Hits ................................................ C-19
Pipeline Viewer and Disassembly Window Operations ........... C-19
Current Program Counter Value ....................................... C-20
Stepping .......................................................................... C-21
Simulator Options ........................................................... C-22
SIMULATION OF BLACKFIN PROCESSORS
Peripheral Support in Simulators .................................................. D-2
Special Considerations for Peripherals ........................................... D-7
Universal Asynchronous Receiver/Transmitter Peripheral ......... D-7
VisualDSP++ 5.0 User’s Guide xix
CONTENTS
Timer (TMR) Peripheral ........................................................ D-8
Simulator Instruction Timing Analysis for ADSP-BF535 Processors D-9
Stall Reasons .......................................................................... D-9
Kill Reasons ......................................................................... D-10
Pipeline Viewer Window Examples ....................................... D-11
Pipeline Viewer Window Messages ....................................... D-12
Pipeline Viewer Detail View Stall Event Messages ............. D-12
Kills Detected Messages ................................................... D-16
Multicycle Instructions .................................................... D-17
Abbreviations in Pipeline Viewer Messages ............................ D-17
Simulator Instruction Timing Analysis for ADSP-BF531, ADSP-BF532,
ADSP-BF533, and ADSP-BF561 Processors ............................ D-19
Stall Reasons ........................................................................ D-19
Kill Reasons ......................................................................... D-20
Pipeline Viewer Window Examples ....................................... D-20
Multicycle Instructions and Latencies ......................................... D-22
Multicycle Instructions ......................................................... D-22
Push Multiple or Pop Multiple ......................................... D-22
32-Bit Multiply (modulo 232) ......................................... D-23
Call and Jump ................................................................. D-23
Conditional Branch ......................................................... D-23
Return ............................................................................. D-24
Core and System Synchronization .................................... D-24
Linkage ........................................................................... D-25
Interrupts and Emulation ................................................ D-25
xx VisualDSP++ 5.0 User’s Guide
CONTENTS
TESTSET ........................................................................ D-25
Instruction Latencies ............................................................ D-26
Accumulator to Data Register Latencies ............................ D-27
Register Move Latencies ................................................... D-28
Move Conditional and Move CC Latencies ....................... D-30
Loop Setup Latencies ....................................................... D-31
Latencies Due to Instructions Within Hardware Loops ..... D-32
Instruction Alignment Unit Empty Latencies .................... D-33
L1 Data Memory Stalls ......................................................... D-34
Minibank Access Collision ............................................... D-35
SRAM Access (1-Cycle Stall) ........................................ D-35
Cache Access (1-Cycle Stall) ......................................... D-36
Memory-Mapped Register (MMR) Access ........................ D-39
System Minibank Access Collision .................................... D-39
Store Buffer Overflow ...................................................... D-39
Store Buffer Load Collision .............................................. D-40
Load/Store Size Mismatch ............................................ D-40
Store Data Not Ready .................................................. D-41
Instruction Groups ............................................................... D-41
Register Groups .................................................................... D-42
Compiled Simulation ................................................................. D-44
Specifying a Session for Compiled Simulation ....................... D-44
INDEX
VisualDSP++ 5.0 User’s Guide xxi
-xxii VisualDSP++ 5.0 User’s Guide
PREFACE
Thank you for purchasing Analog Devices, Inc. development software for
digital signal processing (DSP) applications.
Purpose of This Manual
The VisualDSP++ 5.0 User’s Guide describes the features, components,
and functions of VisualDSP++. Use this guide as a reference for developing programs for SHARC®, TigerSHARC®, and Blackfin® processors.
This manual does not include detailed procedures for building and debugging projects. For how-to information, refer to VisualDSP++ online Help
and the VisualDSP++ 5.0 Getting Started Guide .
Intended Audience
The primary audience for this manual is a programmer who is familiar
with Analog Devices processors. This manual assumes that the audience
has a working knowledge of the appropriate processor architecture and
instruction set. Programmers who are unfamiliar with Analog Devices
processors can use this manual, but should supplement it with other texts
(such as the appropriate hardware reference and programming reference
manuals) that describe your target architecture.
VisualDSP++ 5.0 User’s Guide xxiii
Manual Contents
Manual Contents
The manual consists of:
• Chapter 1, “Introduction to VisualDSP++”
Describes VisualDSP++ features, license management, project
development, code development tools, and DSP projects
• Chapter 2, “Environment”
Focuses on window features, operations, and customization for the
main window and debugging windows.
• Chapter 3, “Debugging”
Describes debug sessions, code analysis tools, program execution
operations, simulation tools, and utilities.
• Appendix A, “Reference Information”
Describes file types, keyboard shortcuts, command-line parameters,
scripting, toolbar buttons, and text operations; also provides a
glossary and describes online Help features and operations.
• Appendix B, “Simulation of SHARC Processors”
Describes the simulator options available on the Anomalies,
Events , Simulator , Load Sim Loader , and Select Processor ID
submenus under Settings; also explains how to record simulator
anomalies and events, and describes SPI simulation in slave mode.
• Appendix C, “Simulation of TigerSHARC Processors”
Describes simulator instruction timing analysis, pipeline stages, the
Pipeline Viewer, stalls, aborts, the current program counter value,
stepping, and the Select Loader Program command on the Simu-
lator submenu under Settings .
• Appendix D, “Simulation of Blackfin Processors”
Provides an overview of peripheral support for Blackfin simulators
and describes limitations of the simulation software models, simulator instruction timing analysis, and compiled simulation.
xxiv VisualDSP++ 5.0 User’s Guide
Preface
What’s New in This Manual
The VisualDSP++ 5.0 User’s Guide supports all Analog Devices, Inc.
processor families and processors listed in “Supported Processors” on
page -xxvii.
For a list of new VisualDSP++ 5.0 user interface features, refer to
“VisualDSP++ 5.0 Features” on page 1-7. See VisualDSP++ Help for
details.
Also refer to the VisualDSP++ 5.0 Product Release Bulletin for information
on features that are new, updated, or removed. This document provides
release-specific information and should be of particular interest to those
users who are familiar with previous versions of VisualDSP++.
VisualDSP++ 5.0 User’s Guide xxv
Technical or Customer Support
Technical or Customer Support
You can reach Analog Devices, Inc. Customer Support in the following
ways:
• Visit the Embedded Processing and DSP products Web site at
http://www.analog.com/processors/technicalSupport
• E-mail tools questions to
processor.tools.support@analog.com
• E-mail processor questions to
processor.support@analog.com (World wide support)
processor.europe@analog.com (Europe support)
processor.china@analog.com (China support)
• Phone questions to 1-800-ANALOGD
• Contact your Analog Devices, Inc. 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
xxvi VisualDSP++ 5.0 User’s Guide
Preface
Supported Processors
The following is the list of Analog Devices, Inc. processors supported in
VisualDSP++ 5.0.
TigerSHARC (ADSP-TSxxx) Processors
The name “TigerSHARC” refers to a family of floating-point and
fixed-point [8-bit, 16-bit, and 32-bit] processors. VisualDSP++ currently
supports the following TigerSHARC processors:
ADSP-TS101 ADSP-TS201 ADSP-TS202 ADSP-TS203
SHARC (ADSP-21xxx) Processors
The name “SHARC” refers to a family of high-performance, 32-bit,
floating-point processors that can be used in speech, sound, graphics, and
imaging applications. VisualDSP++ currently supports the following
SHARC processors:
ADSP-21020 ADSP-21060 ADSP-21061 ADSP-21062
ADSP-21065L ADSP-21160 ADSP-21161 ADSP-21261
ADSP-21262 ADSP-21266 ADSP-21267 ADSP-21362
ADSP-21363 ADSP-21364 ADSP-21365 ADSP-21366
ADSP-21367 ADSP-21368 ADSP-21369 ADSP-21371
ADSP-21375
Blackfin (ADSP-BFxxx) Processors
The name “Blackfin ” refers to a family of 16-bit, embedded processors.
VisualDSP++ currently supports the following Blackfin processors:
VisualDSP++ 5.0 User’s Guide xxvii
Product Information
ADSP-BF531 ADSP-BF532
ADSP-BF533 ADSP-BF535
ADSP-BF561 ADSP-BF534
ADSP-BF536 ADSP-BF537
ADSP-BF538 ADSP-BF539
ADSP-BF522 ADSP-BF525
ADSP-BF527 ADSP-BF542
ADSP-BF544 ADSP-BF548
ADSP-BF549
Product Information
You can obtain product information from the Analog Devices Web site,
from the product CD-ROM, or from the printed publications (manuals).
Analog Devices is online at www.analog.com . This Web site provides
information 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 Web site that allows
customization of a Web page to display only the latest information on
products you are interested in. You can also choose to receive e-mail
notifications containing updates to the Web pages that meet your interests, including documentation errata against all manuals. MyAnalog.com
provides access to books, application notes, data sheets, code examples,
and more.
xxviii VisualDSP++ 5.0 User’s Guide
Preface
Registration
Visit
www.myanalog.com to sign up. Click Register to use MyAnalog.com.
Registration takes about five minutes and serves as a means to select the
information you want to receive.
If you are already a registered user, just log on. Your user name is your
e-mail address.
Processor Product Information
For information on embedded processors and DSPs, visit our Web site at
www.analog.com/processors, which provides access to technical publica-
tions, 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.
• E-mail questions or requests for information to
processor.support@analog.com (World-wide support)
processor.europe@analog.com (Europe support)
processor.china@analog.com (China support)
• Fax questions or requests for information to
1-781-461-3010 (North America)
+49-89-76903-157 (Europe)
• Access the FTP Web site at
ftp ftp.analog.com or ftp 137.71.25.69
ftp://ftp.analog.com
VisualDSP++ 5.0 User’s Guide xxix
Product Information
Related Documents
For information on product related development software, see these
publications:
• VisualDSP++ 5.0 Product Release Bulletin
• VisualDSP++ 5.0 Getting Started Guide
• VisualDSP++ 5.0 Assembler and Preprocessor Manual
• VisualDSP++ 5.0 C/C++ Compiler Manual for SHARC Processors
• VisualDSP++ 5.0 Run-Time Library Manual for SHARC Processors
• VisualDSP++ 5.0 C/C++ Compiler and Library Manual
for TigerSHARC Processors
• VisualDSP++ 5.0 C/C++ Compiler and Library Manual for Blackfin
Processors
• VisualDSP++ 5.0 Linker and Utilities Manual
• VisualDSP++ 5.0 Loader and Utilities Manual
• VisualDSP++ 5.0 Device Drivers and System Services Manual
for Blackfin Processors
• VisualDSP++ 5.0 Kernel (VDK) User’s Guide
• VisualDSP++ 5.0 Installation Quick Reference Card
• VisualDSP++ 5.0 Licensing Guide
L
xxx VisualDSP++ 5.0 User’s Guide
Throughout this manual and online Help, tools manuals are often
identified by their titles, but without their software version (that is,
the 5.0 is not shown).