Analog Devices EZ-KIT User manual

Getting Started with
ADSP-BF548 EZ-KIT Lite®
Revision 1.0, November 2007
Part Number
82-000206-02
Analog Devices, Inc.
One Technology Way
Norwood, Mass. 02062-9106 a

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.

Regulatory Compliance
The ADSP-BF548 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-BF548 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-BF548 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.029
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.

Getting Started with ADSP-BF548 EZ-KIT Lite v
CONTENTS
PREFACE
Purpose of This Manual ................................................................ xiii
Intended Audience ........................................................................ xiii
Manual Contents .......................................................................... xiii
What’s New in This Manual ............................................................ xv
Technical or Customer Support ....................................................... xv
Supported Processors ...................................................................... xvi
Product Information ...................................................................... xvi
MyAnalog.com ........................................................................ xvii
Processor Product Information ................................................. xvii
Related Documents ................................................................ xviii
Online Technical Documentation ............................................. xix
Printed Manuals ....................................................................... xxi
Notation Conventions ................................................................. xxiii
PROGRAMMING ADSP-BF548 EZ-KIT LITE WITH
VISUALDSP++
Installing VisualDSP++ and the EZ-KIT Lite ................................. 1-2
Starting VisualDSP++ and Connecting to the EZ-KIT Lite ............ 1-3
Example 1: Building and Running an Application .......................... 1-6

CONTENTS
vi Getting Started with ADSP-BF548 EZ-KIT Lite
Example 1: Sorts.c File .................................................................. 1-9
USING ADSP-BF548 EZ-KIT LITE TO INVESTIGATE
PERFORMANCE FACTORS
ADSP-BF548 Processor Memory Hierarchy .................................. 2-2
Example 2: Benchmarking the Relative Performance of Memories .. 2-4
Example 3: Using the Blackfin Processor Voltage Regulator ........... 2-8
USING ADSP-BF548 EZ-KIT LITE PERIPHERALS
ADSP-BF548 Processor I/O Peripherals ........................................ 3-2
ADSP-BF548 Peripheral Interfaces on the EZ-KIT Lite ................. 3-4
Using ADSP-BF548 Peripherals on the EZ-KIT Lite ..................... 3-5
Example 4: Overview .................................................................... 3-7
Example 4: Audio.c File ................................................................ 3-8
InitAudio()—Opening the Driver ............................................ 3-8
adi_dev_Control()—Configuring the Driver .......................... 3-11
TerminateAudio() ................................................................. 3-14
PlayBuffer() .......................................................................... 3-14
AD1980Callback() ................................................................ 3-16
Example 4: Running ................................................................... 3-17
USING ADSP-BF548 EZ-KIT LITE AS A MASS STORAGE
DEVICE
ADSP-BF548 Processor USB Interface .......................................... 4-2
Analog Devices USB Software ....................................................... 4-2
Example 5: USB Project ................................................................ 4-3

Getting Started with ADSP-BF548 EZ-KIT Lite vii
CONTENTS
Example 5: Running ..................................................................... 4-6
USING ADSP-BF548 EZ-KIT LITE HARD DISK AND LCD
SCREEN
SSL File System Service ................................................................. 5-2
Sharp LQ043T1DG01 LCD Device Driver ................................... 5-3
Example 6: Displaying a Bitmap File on the EZ-KIT Lite .............. 5-4
Example 6: Project Options ........................................................... 5-4
Example 6: Application Structure .................................................. 5-9
FileSystem.c ............................................................................ 5-9
LCD.c ................................................................................... 5-10
adi_ssl_Init.h ........................................................................ 5-11
Example 6: Running ................................................................... 5-12
USING ADSP-BF548 EZ-KIT LITE KEYPAD AND LED
INDICATOR
Event-Driven Device Drivers ......................................................... 6-2
VDK Device Model ...................................................................... 6-3
VDK Message Passing ................................................................... 6-4
Example 7: Creating a VDK Application ....................................... 6-4
Example 7: Source Files ................................................................. 6-7
CREATING A BOOTABLE APPLICATION
VisualDSP++ Utility Programs ...................................................... 7-2
Executable and Loadable Program Files .......................................... 7-2
Creating a Loadable Program File .................................................. 7-3

CONTENTS
viii Getting Started with ADSP-BF548 EZ-KIT Lite
Writing a Loader File to Flash Memory ......................................... 7-5
Booting From Burst Flash Memory ............................................... 7-8
Example 8: Loading ...................................................................... 7-9
Epilogue ..................................................................................... 7-10
INDEX

Getting Started with ADSP-BF548 EZ-KIT Lite ix
PREFACE
Thank you for purchasing the ADSP-BF548 EZ-KIT Lite®, Analog
Devices, Inc. evaluation system for ADSP-BF548 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-BF548 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-BF548 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-BF548 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-BF548 processor and
the evaluation board peripherals. Analog Devices JTAG emulators offer

x Getting Started with ADSP-BF548 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-BF548 EZ-KIT Lite provides example programs to demon-
strate the capabilities of the evaluation board.
LThe ADSP-BF548 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, the linker restricts a user’s program to 60 KB of
memory for code space with no restrictions for data space
The board features:
• Analog Devices ADSP-BF548 Blackfin processor
DCore performance up to 600 MHz
DExternal bus performance up to 133 MHz
D400-pin mini-BGA package
D25 MHz crystal
• Double data rate (DDR) synchronous dynamic random access
memory (SDRAM)
DMicron MT46V32M16 – 64 MB (8M x 16-bits x 4 banks)
• Burst flash memory
DIntel PC28F128K3C115 – 32 MB (16M x 16-bits)
• NAND flash memory
DST Micro NAND02 – 2 Gb

Getting Started with ADSP-BF548 EZ-KIT Lite xi
Preface
• SPI flash memory
DST Micro M25P16 – 16 Mb
• Advanced technology attachment packet interface (ATAPI)
DToshiba 2.5” MK4032GAX – 40 GB HDD
• Analog audio interface
DAnalog Devices AD1980 SoundMAX codec
D6 DAC channels for 5.1 surround
D1 input stereo MIC jack
D1 input stereo LINE IN jack
D1 output stereo LINE OUT/HEAD PHONE OUT jack
D1 output stereo SURROUND jack
D1 output center and LFE jack
• TFT LCD display with touchscreen
DSharp LQ043T1DG01 – 480 x 272, 4.3” touchscreen LCD
DAnalog Devices AD7877 – touchscreen controller
• Ethernet interface
DSMSC LAN9218 device
D10-BaseT and 100-BaseTX Ethernet controller
DIntegrated PHY and MAC
DHP Auto-MDIX
•Keypad
DACT components– 4 x 4 keypad assembly

xii Getting Started with ADSP-BF548 EZ-KIT Lite
• Thumbwheel
DCTS Corp rotary encoder
• 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: all ADSP-BF548 processor signals
• Other features
DJTAG ICE 14-pin header
DUSB OTG connector
DHOST interface connector
DBlackfin power measurement jumpers
DPPI1 IDC connector
DSPORT2 and SPORT3 IDC connectors
DTWI, SPI, timers, UART3 IDC connectors
For information about the hardware components of the EZ-KIT Lite,
refer to the ADSP-BF548 EZ-KIT Lite Evaluation System Manual.

Getting Started with ADSP-BF548 EZ-KIT Lite xiii
Preface
Purpose of This Manual
The Getting Started with ADSP-BF548 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-BF548 EZ-KIT Lite Evaluation System Manual, which describes the
evaluation system’s components in greater detail.
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:
• Chapter 1, “Programming ADSP-BF548 EZ-KIT Lite with Visu-
alDSP++” on page 1-1
Provides instructions for connecting the EZ-KIT Lite to Visu-
alDSP++ running on your PC. The established connection allows
you to download the example program (along with your own) to

Manual Contents
xiv Getting Started with ADSP-BF548 EZ-KIT Lite
the board and control the program execution. You will build and
run the first example project using the VisualDSP++ debug and
data display tools.
• Chapter 2, “Using ADSP-BF548 EZ-KIT Lite to Investigate Per-
formance Factors” on page 2-1
Explores the memory hierarchy of the EZ-KIT Lite and measures
the ramifications of memory placement decisions. Demonstrates
the Blackfin processor core’s built-in voltage regulator and its abil-
ity to throttle the processor’s power consumption and clock rate at
run-time. The system services library (SSL), your API to the Black-
fin processor, also is introduced in this chapter.
• Chapter 3, “Using ADSP-BF548 EZ-KIT Lite Peripherals” on
page 3-1
Explores the peripheral interfaces and devices available on the
EZ-KIT Lite. Introduces the device driver software supplied with
VisualDSP++. You will use one of the supplied device drivers to
play an audio clip through the AD1980 audio codec on the
EZ-KIT Lite.
• Chapter 4,“Using ADSP-BF548 EZ-KIT Lite As A Mass Storage
Device” on page 4-1
Examines the USB and hard disk functionality. You will connect
the EZ-KIT Lite to your PC and have Windows use it as a remov-
able mass storage device.
• Chapter 5, “Using ADSP-BF548 EZ-KIT Lite Hard Disk and
LCD Screen” on page 5-1
Introduces the LCD panel driver of the SSL. You will copy a bit-
map file to the EZ-KIT Lite hard disk and display the file on the
LCD panel.

Getting Started with ADSP-BF548 EZ-KIT Lite xv
Preface
• Chapter 6, “Using ADSP-BF548 EZ-KIT Lite Keypad and LED
Indicator” on page 6-1
Explores the keypad interface of the EZ-KIT Lite and introduces
the VisualDSP++ real-time kernel (VDK). You will use the LEDs
to communicate the application status.
• Chapter 7, “Creating A Bootable Application” on page 7-1
Finally, you will construct an application, drawing from the previ-
ous chapters in the manual. A working bitmap photo viewer
application will be created, including hard drive access, USB con-
nectivity, push button navigation, and audio sample triggering.
The application will be burned to the on-board flash devices. This
will allow the application to run while not connected to
VisualDSP++.
What’s New in This Manual
This is the first revision of the Getting Started with ADSP-BF548 EZ-KIT
Lite.
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]

Supported Processors
xvi Getting Started with ADSP-BF548 EZ-KIT Lite
• 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
Supported Processors
The ADSP-BF548 EZ-KIT Lite evaluation system supports Analog
Devices ADSP-BF548 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.

Getting Started with ADSP-BF548 EZ-KIT Lite xvii
Preface
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.
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.

Product Information
xviii Getting Started with ADSP-BF548 EZ-KIT Lite
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-BF542/BF544/BF548/BF549 Embedded
Processor Data Sheet
General functional description, pinout, and
timing
ADSP-BF548 Blackfin Processor Hardware Ref-
erence
Description of internal processor architecture
and all register functions
Table 2. Related VisualDSP++ Publications
Title Description
ADSP-BF548 EZ-KIT Lite Evaluation System
Manual
Description of the ADSP-BF548 EZ-KIT Lite
hardware and software components
VisualDSP++ User’s Guide Description of VisualDSP++ features and usage
VisualDSP++ Assembler and Preprocessor Man-
ual
Description of the assembler function and
commands

Getting Started with ADSP-BF548 EZ-KIT Lite xix
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/.
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.
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
Table 2. Related VisualDSP++ Publications (Cont’d)
Title Description

Product Information
xx Getting Started with ADSP-BF548 EZ-KIT Lite
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-BF548 EZ-KIT Lite Help, which is part of the Visu-
alDSP++ Help system, use the Contents or Search tab of the Help
window.
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.
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).