Analog Devices EZ-KIT Lite ADSP-BF537 User manual

Getting Started with
ADSP-BF537 EZ-KIT Lite®
Revision 1.2, November 2007
Part Number
82-000865-02
Analog Devices, Inc.
One Technology Way
Norwood, Mass. 02062-9106 a
www.BDTIC.com/ADI

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.
Limited Warranty
The EZ-KIT Lite evaluation system is warranted against defects in materi-
als and workmanship for a period of one year from the date of purchase
from Analog Devices or from an authorized dealer.
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 icon bar and logo, VisualDSP++, the VisualDSP++
logo, Blackfin, the CROSSCORE logo, EZ-KIT Lite, and EZ-Extender
are registered trademarks of Analog Devices, Inc.
All other brand and product names are trademarks or service marks of
their respective owners.
www.BDTIC.com/ADI

Regulatory Compliance
The ADSP-BF537 EZ-KIT Lite is designed to be used solely in a labora-
tory environment. The board is not intended for use as a consumer end
product or as a portion of a consumer end product. The board is an open
system design which does not include a shielded enclosure and therefore
may cause interference to other electrical devices in close proximity. This
board should not be used in or near any medical equipment or RF devices.
The ADSP-BF537 EZ-KIT Lite has been certified to comply with the
essential requirements of the European EMC directive 89/336/EEC
amended by 93/68/EEC and therefore carries the “CE” mark.
The ADSP-BF537 EZ-KIT Lite has been appended to Analog Devices,
Inc. Technical Construction File (TCF) referenced ‘DSPTOOLS1’ dated
December 21, 1997 and was awarded CE Certification by an appointed
European Competent Body as listed below.
Technical Certificate No: Z600ANA1.021
Issued by: Technology International (Europe) Limited
60 Shrivenham Hundred Business Park
Shrivenham, Swindon, SN6 8TY, UK
The EZ-KIT Lite evaluation system contains ESD (electrostatic discharge)
sensitive devices. Electrostatic charges readily accumulate on the human
body and equipment and can discharge without detection. Permanent
damage may occur on devices subjected to high-energy discharges. Proper
ESD precautions are recommended to avoid performance degradation or
loss of functionality. Store unused EZ-KIT Lite boards in the protective
shipping package.
www.BDTIC.com/ADI

www.BDTIC.com/ADI

Getting Started with ADSP-BF537 EZ-KIT Lite v
CONTENTS
PREFACE
Purpose of This Manual ................................................................. xii
Intended Audience ........................................................................ xiii
Manual Contents .......................................................................... xiii
What’s New in This Manual ........................................................... xiv
Technical or Customer Support ...................................................... xiv
Supported Processors ....................................................................... xv
Product Information ....................................................................... xv
MyAnalog.com .......................................................................... xv
Processor Product Information .................................................. xvi
Related Documents .................................................................. xvi
Online Technical Documentation ........................................... xviii
Printed Manuals ....................................................................... xix
Notation Conventions .................................................................... xxi
PROGRAMMING ADSP-BF537 EZ-KIT LITE WITH
VISUALDSP++
Installing VisualDSP++ and ADSP-BF537 EZ-KIT Lite ................. 1-2
Starting VisualDSP++ and Connecting to ADSP-BF537
EZ-KIT Lite .............................................................................. 1-3
www.BDTIC.com/ADI

CONTENTS
vi Getting Started with ADSP-BF537 EZ-KIT Lite
Exercise 1, Part 1: Building and Running the First Program ........... 1-7
Exercise 1, Part 2: Analyzing Performance and Memory Hierarchy
Impact ..................................................................................... 1-11
Exercise 1, Part 3: Working with Blackfin Voltage Regulator ........ 1-17
Listing 1-1. Exercise 1, Part 1 ..................................................... 1-19
Listing 1-2. Exercise 1, Part 2 ..................................................... 1-21
Listing 1-3. Exercise 1, Part 3 ..................................................... 1-25
RUNNING A TCP/IP APPLICATION ON AN ADSP-BF537
EZ-KIT LITE
Part 1: A Primer on TCP/IP, OS Threads and Semaphores, and
Sockets API ............................................................................... 2-2
Part 2: Creating a TCP/IP Application and Connecting to
a DHCP Server .......................................................................... 2-3
Part 3: Communicating with Sockets API ...................................... 2-6
Listing 2-1. Caesar_Cipher_ThreadType::Run() Implementation . 2-10
Listing 2-2. Caesar_Cipher_ThreadType() Implementation ......... 2-11
Listing 2-3. VDK::Thread Implementation ................................. 2-11
Listing 2-4. lwip_sysboot_threadtype_RunFunction()
Implementation ....................................................................... 2-12
CONTROLLING A REAL-TIME APPLICATION VIA
TCP/IP
Part 1: Creating an Audio Pass-Through Application with VDK .... 3-2
Part 2: Controlling Pass-Through Volume via Telnet ..................... 3-7
Part 3: Tuning Application .......................................................... 3-13
Part 4: Running an Application from Flash Memory .................... 3-15
www.BDTIC.com/ADI

Getting Started with ADSP-BF537 EZ-KIT Lite vii
CONTENTS
Listing 3-1. Caesar_Cipher_ThreadType::Run() New
Implementation ....................................................................... 3-19
What’s Next? ............................................................................... 3-21
CREATING A TCP/IP APPLICATION
TCP/IP Framework ...................................................................... A-1
TCP/IP Communications ....................................................... A-2
VisualDSP++ Kernel (VDK) Overview ......................................... A-3
BSD Socket API ..................................................................... A-3
1. Create Sockets ................................................................ A-4
2. Host Waits for Client ..................................................... A-4
3. Client Connects with Host ............................................. A-4
4. Host Acknowledges Client .............................................. A-5
5. Inter-Process Communications ....................................... A-5
6. Close Connection .......................................................... A-5
INDEX
www.BDTIC.com/ADI

CONTENTS
viii Getting Started with ADSP-BF537 EZ-KIT Lite
www.BDTIC.com/ADI

Getting Started with ADSP-BF537 EZ-KIT Lite ix
PREFACE
Thank you for purchasing the ADSP-BF537 EZ-KIT Lite®, Analog
Devices, Inc. evaluation system for ADSP-BF537 Blackfin®processors.
Blackfin processors are embedded processors that support a Media
Instruction Set Computing (MISC) architecture. This architecture is the
natural merging of RISC, media functions, and digital signal processing
(DSP) characteristics towards delivering signal processing performance in
a microprocessor-like environment.
The evaluation board is designed to be used in conjunction with the Visu-
alDSP++®development environment to test the capabilities of
ADSP-BF537 Blackfin processors. The VisualDSP++ development envi-
ronment gives you the ability to perform advanced application code
development and debug, such as:
• Create, compile, assemble, and link application programs written
in C++, C, and ADSP-BF537 assembly
• Load, run, step, halt, and set breakpoints in application programs
• Read and write data and program memory
• Read and write core and peripheral registers
• Plot memory
Access to the ADSP-BF537 processor from a personal computer (PC) is
achieved through a USB port or an optional JTAG emulator. The USB
interface provides unrestricted access to the ADSP-BF537 processor and
the evaluation board peripherals. Analog Devices JTAG emulators offer
www.BDTIC.com/ADI

x Getting Started with ADSP-BF537 EZ-KIT Lite
faster communication between the host PC and target hardware. Analog
Devices carries a wide range of in-circuit emulation products. To learn
more about Analog Devices emulators and processor development tools,
go to http://www.analog.com/dsp/tools/.
The ADSP-BF537 EZ-KIT Lite provides example programs to demon-
strate the capabilities of the evaluation board.
LThe ADSP-BF537 EZ-KIT Lite installation is part of the Visu-
alDSP++ installation. The EZ-KIT Lite is a licensed product that
offers an evaluation (temporary) license. Once the evaluation
license expires, VisualDSP++ restricts simulator and emulator con-
nections and limits the size of a user program to 20 KB of internal
memory.
The board features:
• Analog Devices ADSP-BF537 Blackfin processor
DCore performance up to 600 MHz
DExternal bus performance to 133 MHz
D182-pin mini-BGA package
D25 MHz crystal
• Synchronous dynamic random access memory (SDRAM)
DMT48LC32M8 – 64 MB (8M x 8-bits x 4 banks) x 2 chips
• Flash memory
D4 MB (2M x 16-bits)
• Analog audio interface
DAD1871 96 kHz analog-to-digital codec (ADC)
DAD1854 96 kHz digital-to-audio codec (DAC)
www.BDTIC.com/ADI

Getting Started with ADSP-BF537 EZ-KIT Lite xi
Preface
D1 input stereo jack
D1 output stereo jack
• Ethernet interface
D10-BaseT (10 Mbits/sec) and 100-BaseT (100 Mbits/sec)
Ethernet Media Access Controller (MAC)
DSMSC LAN83C185 device
• Controller Area Network (CAN) interface
DPhilips TJA1041 high-speed CAN transceiver
• National Instruments Educational Laboratory Virtual Instrumen-
tation Suite (ELVIS) interface
DLabVIEW™-based virtual instruments
DMultifunction data acquisition device
DBench-top workstation and prototype board
• Universal asynchronous receiver/transmitter (UART)
DADM3202 RS-232 line driver/receiver
DDB9 female connector
•LEDs
D10 LEDs: 1 power (green), 1 board reset (red), 1 USB (red),
6 general-purpose (amber), and 1 USB monitor (amber)
• Push buttons
D5 push buttons: 1 reset, 4 programmable flags with
debounce logic
• Expansion interface
DAll processor signals
www.BDTIC.com/ADI

Purpose of This Manual
xii Getting Started with ADSP-BF537 EZ-KIT Lite
• Other features
DJTAG ICE 14-pin header
The EZ-KIT Lite board has flash memory with a total of 4 MB. The flash
memory can be used to store user-specific boot code, allowing the board
to run as a stand-alone unit. The board also has 64 MB of SDRAM, which
can be used by the user at runtime.
SPORT0 interfaces with the audio circuit, facilitating development of audio
signal processing applications. SPORT0 also connects to an off-board con-
nector for communication with other serial devices.
The UART of the processor connects to an RS-232 line driver and a DB9
female connector, providing an interface to a PC or other serial device.
Additionally, the EZ-KIT Lite board provides access to all of the proces-
sor’s peripheral ports. Access is provided in the form of a three-connector
expansion interface.
For information about the hardware components of the EZ-KIT Lite,
refer to the ADSP-BF537 EZ-KIT Lite Evaluation System Manual.
Purpose of This Manual
The Getting Started with ADSP-BF537 EZ-KIT Lite familiarizes users with
the hardware capabilities of the evaluation system and demonstrates how
to access these capabilities in the VisualDSP++ environment.
EZ-KIT Lite users should use this manual in conjunction with the
ADSP-BF537 EZ-KIT Lite Evaluation System Manual, which describes the
evaluation system’s components in greater detail.
www.BDTIC.com/ADI

Getting Started with ADSP-BF537 EZ-KIT Lite xiii
Preface
Intended Audience
The primary audience of this manual is a programmer with experience in
desktop and/or embedded programming, but with little or no experience
with the Blackfin architecture and/or VisualDSP++. A working knowledge
of the C and C++ programming languages will be extremely helpful in
understanding the examples and source code blocks referenced in this
manual.
Manual Contents
The manual consists of:
• Exercise 1, “Programming ADSP-BF537 EZ-KIT Lite with Visu-
alDSP++” on page 1-1
Provides instructions for connecting the EZ-KIT Lite to a PC and
writing a C program to perform two sorting algorithms.
• Exercise 2, “Running a TCP/IP application on an ADSP-BF537
EZ-KIT Lite” on page 2-1
Provides instructions for creating a TCP/IP application using the
open source LwIP stack and VisualDSP++ Kernel.
• Exercise 3, “Controlling a real-time application via TCP/IP” on
page 3-1
Provides instructions for creating a complex application with audio
pass-through VDK threads that operate concurrently and indepen-
dently with the TCP/IP stack’s operations.
• Appendix A, “Creating a TCP/IP Application” on page A-1
Familiarizes the user with the concepts utilized in the creation of a
TCP/IP application.
www.BDTIC.com/ADI

What’s New in This Manual
xiv Getting Started with ADSP-BF537 EZ-KIT Lite
What’s New in This Manual
The Getting Started with ADSP-BF537 EZ-KIT Lite has been updated for
the current release of VisualDSP++.
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
[e-mail]
• E-mail processor questions to
[email protected]m (World wide support)
[email protected] (Europe support)
[email protected] (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
www.BDTIC.com/ADI

Getting Started with ADSP-BF537 EZ-KIT Lite xv
Preface
Supported Processors
The ADSP-BF537 EZ-KIT Lite evaluation system supports Analog
Devices ADSP-BF537 Blackfin processors.
Product Information
You can obtain product information from the Analog Devices Web site,
from the product CD-ROM, or from printed publications (manuals).
Analog Devices is online at www.analog.com. Our Web site 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 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 weekly
e-mail notifications containing updates to the Web pages that meet your
interests, including documentation errata against all manuals. You can
also choose to receive weekly e-mail notifications containing updates to
the Web pages that meet your interests. MyAnalog.com provides access to
books, application notes, data sheets, code examples, and more.
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
e-mail address.
www.BDTIC.com/ADI

Product Information
xvi Getting Started with ADSP-BF537 EZ-KIT Lite
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
[email protected]m (World wide support)
[email protected] (Europe support)
[email protected] (China support)
• Fax questions or requests for information to
1-781-461-3010 (North America)
[phone] (Europe)
Related Documents
For information on product related development software and hardware,
see these publications:
Table 1. Related Processor Publications
Title Description
ADSP-BF536/ADSP-BF537 Embedded Proces-
sor Data Sheet
General functional description, pinout, and
timing.
ADSP-BF537 Blackfin Processor Hardware Ref-
erence
Description of internal processor architecture
and all register functions.
www.BDTIC.com/ADI

Getting Started with ADSP-BF537 EZ-KIT Lite xvii
Preface
LIf you plan to use the EZ-KIT Lite board in conjunction with a
JTAG emulator, also refer to the documentation that accompanies
the emulator.
All documentation is available online. Most documentation is available in
printed form.
Visit the Technical Library Web site to access all processor and tools man-
uals and data sheets:
http://www.analog.com/processors/technicalSupport/technicalLi-
brary/.
Table 2. Related VisualDSP++ Publications
Title Description
ADSP-BF537 EZ-KIT Lite Evaluation System
Manual
Description of the ADSP-BF537 EZ-KIT Lite
hardware and software components.
VisualDSP++ Assembler and Preprocessor Man-
ual
Description of the assembler function and
commands.
VisualDSP++ C/C++ Complier and Library
Manual for Blackfin Processors
Description of the complier function and com-
mands for Blackfin processors.
VisualDSP++ Linker and Utilities Manual Description of the linker function and com-
mands.
VisualDSP++ Loader and Utilities Manual Description of the loader/splitter function and
commands.
VisualDSP++ Device Drivers and System Services
Manual for Blackfin Processors
Description of the device drivers’ and system
services’ functions and commands
www.BDTIC.com/ADI

Product Information
xviii Getting Started with ADSP-BF537 EZ-KIT Lite
Online Technical Documentation
Online documentation comprises the VisualDSP++ Help system, software
tools manuals, hardware tools manuals, processor manuals, the Dinkum
Abridged C++ library, and Flexible License Manager (FlexLM) network
license manager software documentation. You can easily search across the
entire VisualDSP++ documentation set for any topic of interest. For easy
printing, supplementary .pdf files of most manuals are also provided.
Each documentation file type is described as follows.
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 running the Tools installation. Access the online documentation from
the VisualDSP++ environment, Windows®Explorer, or the Analog
Devices Web site.
Accessing Documentation From VisualDSP++
To view VisualDSP++ Help, click on the Help menu item or go to the
Windows task bar and navigate to the VisualDSP++ documentation via
the Start menu.
To view ADSP-BF537 EZ-KIT Lite Help, which is part of the Visu-
alDSP++ Help system, use the Contents or Search tab of the Help
window.
File Description
.chm Help system files and manuals in Help format
.htm or
.html
Dinkum Abridged C++ library and FlexLM network license manager software doc-
umentation. Viewing and printing the .html files requires a browser, such as
Internet Explorer 6.0 (or higher).
.pdf VisualDSP++ and processor manuals in Portable Documentation Format (PDF).
Viewing and printing the .pdf files requires a PDF reader, such as Adobe Acrobat
Reader (4.0 or higher).
www.BDTIC.com/ADI

Getting Started with ADSP-BF537 EZ-KIT Lite xix
Preface
Accessing Documentation 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.
Help system files (.chm) are located in the Help folder, and .pdf files are
located in the Docs folder of your VisualDSP++ installation CD-ROM.
The Docs folder also contains the Dinkum Abridged C++ library and the
FlexLM network license manager software documentation.
Your software installation kit includes online Help as part of the Windows
interface. These help files provide information about VisualDSP++ and
the ADSP-BF537 EZ-KIT Lite evaluation system.
Accessing Documentation From Web
Download manuals at the following Web site:
http://www.analog.com/processors/technicalSupport/technicalLi-
brary/.
Select a processor family and book title. Download archive (.zip) files,
one for each manual. Use any archive management software, such as Win-
Zip, to decompress downloaded files.
Printed Manuals
For general questions regarding literature ordering, call the Literature
Center at 1-800-ANALOGD (1-800-262-5643) and follow the prompts.
Hardware Tools Manuals
To purchase EZ-KIT Lite and in-circuit emulator (ICE) manuals, call
1-603-883-2430. The manuals may be ordered by title or by product
number located on the back cover of each manual.
www.BDTIC.com/ADI

Product Information
xx Getting Started with ADSP-BF537 EZ-KIT Lite
Processor Manuals
Hardware reference and instruction set reference manuals may be ordered
through the Literature Center at 1-800-ANALOGD (1-800-262-5643),
or downloaded from the Analog Devices Web site. Manuals may be
ordered by title or by product number located on the back cover of each
manual.
Data Sheets
All data sheets (preliminary and production) may be downloaded from the
Analog Devices Web site. Only production (final) data sheets (Rev. 0, A,
B, C, and so on) can be obtained from the Literature Center at
1-800-ANALOGD (1-800-262-5643); they also can be downloaded from
the Web site.
To have a data sheet faxed to you, call the Analog Devices Faxback System
at 1-800-446-6212. Follow the prompts and a list of data sheet code
numbers will be faxed to you. If the data sheet you want is not listed,
check for it on the Web site.
www.BDTIC.com/ADI