W5.0 User’s Guide Revision 3.0, August 2007 Part Number: 82-000420-02 Analog Devices, Inc. One Technology Way Norwood, Mass. 02062-9106 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 impli- cation 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 trade- marks 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 .......................................................................