National Instruments NI LabVIEW User Manual

™

Getting Started with the NI LabVIEW Embedded Module for ADI Blackfin Processors

Version 2.0

The NI LabVIEW Embedded Module for ADI Blackfin Processors is a comprehensive graphical development environment for embedded design. Jointly developed by Analog Devices and National Instruments, this module seamlessly integrates the LabVIEW development environment and Blackfin embedded processors.

This module builds on NI LabVIEW Embedded technology, which facilitates dataflow graphical programming for embedded systems and includes hundreds of analysis and signal processing functions, integrated I/O, and an interactive debugging interface. With the Embedded Module for Blackfin Processors, you can enable cache, optimize linking, and view live front panel updates using JTAG, serial, or TCP/IP, as well as use VisualDSP++ compiler options through LabVIEW. The Embedded Module for Blackfin Processors includes the LabVIEW C Code Generator, which generates C code from the LabVIEW block diagram.

Engineers and scientists can lower development costs, achieve faster development times, and still deliver a high performance embedded processing solution with the Embedded Module for Blackfin Processors.

What’s New in the Embedded Module for Blackfin Processors ............ 2

System Requirements.............................................................................. 3

Installing the Embedded Module for Blackfin Processors...................... 3

Installing the EZ-KIT Lite or Emulator .................................................. 5

Upgrading to the Embedded Module for Blackfin Processors 2.0 ......... 6

Embedded Project Manager............................................................. 6

Upgrading Blackfin VIs and Embedded Projects ............................ 6

Migrating Custom Linker Description Files.................................... 8

Tutorial....................................................................................................9

Creating the LabVIEW Project........................................................9

Creating the Front Panel...................................................................13

Creating the Block Diagram.............................................................14

Configuring the Target and Debugging Options ..............................16

Creating the ADSP-BF537 Build Specification ...............................18

Building, Downloading, and Running a Blackfin Application ........23

Debugging with Breakpoints and Probes .........................................24

Where to Go from Here ...........................................................................26

What’s New in the Embedded Module for Blackfin Processors

Version 2.0 of the Embedded Module for Blackfin Processors includes the following new features:

• LabVIEW projects and the Project Explorer window—Help you

manage and implement the components of a Blackfin application.

• New Blackfin Project Wizard—Facilitates the creation of projects

for new and existing Blackfin VIs.

• VisualDSP++ 4.5 support—Incorporates new features and

enhancements to the VisualDSP++ tool chain.

• New Blackfin Processor support—Allows you to target the

ADSP-BF531, ADSP-BF532, ADSP-BF534, ADSP-BF536, and ADSP-BF538 in addition to the ADSP-BF533 and ADSP-BF537.

• VI profiling—Displays the performance information for VIs and

functions in the Blackfin VIs you create to help you optimize Blackfin applications. Profiling sends execution times for functions and VIs to the host when the application terminates. If a Blackfin VI does not terminate, use the BF Send Profile Data VI to trigger the sending of profile information to the host.

• New device drivers—Provide support for the following:

– Two-wire interface (TWI)—VIs are located on the

Blackfin»Device»TWI palette.

– Micron color VGA sensor—VIs are located on the

Blackfin»Device»MT9V022 Camera palette.

• New VIs and Timed Loop options—Provide more task control and

timing capabilities. The Embedded Module for Blackfin Processors now supports Semaphore VIs and a 1 MHz timing source in Timed Loops.

• Static IP support—Enables a static IP address for the device. In the Build Specifications Properties dialog box, make sure there is not a checkmark in the Use DHCP checkbox on the TCP/IP tab of the Application Information category to enable a static IP address.

Embedded Module for Blackfin Processors 2 ni.com

After you install LabVIEW, refer to the LabVIEW Upgrade Notes, available by selecting Start»All Programs»National Instruments» LabVIEW»LabVIEW Manuals and opening for more information about new features in LabVIEW 8.2. Refer to the

LabVIEW 8.2.1 Readme for Windows, available by selecting Start» All Programs»National Instruments»LabVIEW»Readme and opening

readme.html for information about features and changes in

LabVIEW 8.2.1.

System Requirements

The Embedded Module for Blackfin Processors has the following requirements:

• A desktop computer with Windows Vista/XP/2000

• Analog Devices VisualDSP++ 4.5 (included)

• LabVIEW 8.2.1 with embedded support (included)

• One of the following EZ-KITs:

– EZ-KIT Lite for Analog Devices ADSP-BF537 Blackfin

Processor (included)

– EZ-KIT Lite for Analog Devices ADSP-BF533 (not included)

– EZ-KIT Lite for Analog Devices ADSP-BF538 (not included)

LV_Upgrade_Notes.pdf,

Refer to the National Instruments Web site at the info code information about LabVIEW development system requirements.

relnote82 to access the LabVIEW Release Notes for more

ni.com/info and enter

Installing the Embedded Module for Blackfin Processors

If you have LabVIEW 8.2 installed, you can install LabVIEW 8.2.1 without first uninstalling LabVIEW 8.2. If you do not have LabVIEW 8.2 installed, you can install LabVIEW 8.2.1 without first installing LabVIEW 8.2.

Note Because LabVIEW installs 8.2.1 over 8.2, you cannot have both LabVIEW 8.2 and

8.2.1 installed simultaneously.

Complete the following steps to install the Embedded Module for Blackfin Processors.

1. Log in as an administrator or as a user with administrator privileges.

2. Insert the Analog Devices VisualDSP++ 4.5 installation CD and follow the instructions on the screen to install VisualDSP++ 4.5.

Tip If the installer does not automatically begin, double-click VisualDSP++4.5.exe on

the CD to begin installation.

3. After you finish installing VisualDSP++, select Start»All Programs» Analog Devices»VisualDSP++ 4.5»Maintain this installation.

4. Select Apply a downloaded Update and click the Next button in the VisualDSP++ 4.5 - Setup wizard.

5. Open the

.vdu file on the Analog Devices VisualDSP++ 4.5

installation CD, click the Next button, and follow the rest of the instructions to install the VisualDSP++ update.

6. Insert the LabVIEW 8.2.1 with Embedded Support CD and select to install the software.

Note LabVIEW 8.2.1 with embedded support is a special edition of LabVIEW 8.2.1.

7. Follow the activation instructions that appear on the screen.

You also can use the NI License Manager, available by selecting Start»All Programs»National Instruments»NI License Manager, to activate National Instruments products. Refer to the National

Instruments License Manager Help, available by selecting Help» Contents in the NI License Manager, for more information about

activating NI products.

8. Restart the computer when the installer prompts you and log on as an administrator or as a user with administrator privileges.

9. Insert the LabVIEW Embedded Module for Blackfin Processors 2.0 installation CD and follow the instructions on the screen.

Tip If the installer does not automatically begin, double-click setup.exe on the CD to

begin installation.

10. Follow the activation instructions that appear on the screen.

Embedded Module for Blackfin Processors 4 ni.com

Installing the EZ-KIT Lite or Emulator

Caution Be careful when removing the board from the package and handling the board to

avoid the discharge of static electricity, which might damage some components.

The EZ-KIT Lite or USB-based ICE board is designed to run as a stand-alone unit. You do not have to open the computer case.

Note You must install VisualDSP++ before you can install the Blackfin target. Refer to

the Installing the Embedded Module for Blackfin Processors section for information about installing VisualDSP++.

Complete the following steps to install the EZ-KIT Lite or USB-based ICE.

1. Plug the power supply for the board into a surge-protected outlet. Connect the USB assembly for the board to the USB port on the host computer using the provided USB cable.

Figure 1 shows the location of the A/C adaptor and USB port on the Blackfin target. Refer to the ADSP-BF537 EZ-KIT Lite Evaluation System Manual in the EZ-KIT box for more detailed information about the ADSP-BF537 EZ-KIT Lite hardware.

A/C Adaptor

USB to Host PC

Figure 1. Locating the A/C Adaptor and USB Port on the Blackfin Target

ANALOG DEVICES

On the board, the power LED illuminates, and you might see other visible activity, such as blinking LEDs. The connection activates the Windows Found New Hardware Wizard.

2. Follow the instructions on the screen to install the software automatically. A Windows message notifies you when the new device is ready for use and the hardware installation is complete.

3. Verify that the USB monitor LED is lit. The LED is in close proximity to the USB connector. The lit LED signifies that the board is communicating properly with the host computer and is ready to run. Refer to the ADSP-BF537 EZ-KIT Lite Evaluation System Manual in the EZ-KIT box for more detailed information about the USB monitor LED.

4. For a USB-based ICE, attach the JTAG cable to the emulation target. Refer to the emulator documentation for more information about USB-based ICE.

Upgrading to the Embedded Module for Blackfin Processors 2.0

This section describes upgrade and compatibility issues for the Embedded Module for Blackfin Processors 2.0.

Embedded Project Manager

The Embedded Module for Blackfin Processors no longer supports the Embedded Project Manager. Use the Project Explorer window instead. Refer to the Creating the LabVIEW Project section for information about using the Project Explorer window. Refer to the Upgrading Blackfin VIs and Embedded Projects section for information about converting embedded project (

.lep) files.

Upgrading Blackfin VIs and Embedded Projects

If you created Blackfin VIs using the Embedded Module for Blackfin Processors 1.0, you must create projects and update the VIs for use with LabVIEW 8.2.1 and the Embedded Module for Blackfin Processors 2.0.

Caution National Instruments recommends you back up your files before you

begin updating your Blackfin VIs for use with the Embedded Module for Blackfin Processors 2.0. The Embedded Module for Blackfin Processors 1.0 cannot open VIs you save in version 2.0.

The Embedded Module for Blackfin Processors includes a utility to help you convert LabVIEW 7.1 embedded project (

Embedded Module for Blackfin Processors 6 ni.com

.lep) files to

LabVIEW 8.2.1 project (.lvproj) files. Complete the following steps to update embedded project files for use with LabVIEW 8.2.1 and the Embedded Module for Blackfin Processors 2.0.

1. Launch LabVIEW 8.2.1.

2. Select File»Open in the Getting Started window and navigate to the

labview\Targets\ADI\Embedded\vdk\utils\Blackfin LEP

Converter\

3. Select

directory.

Blackfin_LEP_Converter.vi and click the OK button to

run the Blackfin LEP converter utility.

4. Complete the following steps to add the LEP file you want to import to

the LabVIEW Embedded Project (*.lep) Files list.

a. Click the Add button below the LabVIEW Embedded Project

(*.lep) Files list. The Select an Embedded Project to Add dialog box appears.

b. Navigate to the location of the LEP file you want to import.

c. Click the Add button. LabVIEW adds the LEP file and all the VIs

associated with the LEP file to the Blackfin LEP converter utility. You can see only the LEP file in the LabVIEW Embedded Project (*.lep) Files list.

5. Click the Continue button. LabVIEW prompts you to specify the

location and name of the new project.

6. The Import Status dialog box appears. When LabVIEW finishes importing the 1.0 files, the Project Explorer window appears with the Blackfin target and VIs.

7. Complete the following steps to verify the target configuration and build specifications.

a. Right-click the Blackfin target in the Project Explorer window

and select Configure Target from the shortcut menu.

b. Verify the settings in the VisualDSP++ Target Configuration

dialog box and click the OK button. Refer to the Configuring the

Target and Debugging Options section for information about

configuring the Blackfin target.

c. Right-click the build specification under the Blackfin target in

the Project Explorer window and select Properties from the shortcut menu to open the Build Specifications Properties dialog box.

d. Verify the settings in the Application Information and Source

Files categories and click the OK button. Refer to the Creating the

ADSP-BF537 Build Specification section for information about

editing a build specification.

8. Select File»Save in the Project Explorer window to save the project.

LabVIEW saves a copy of all the VIs for the project in the same folder as the

.lvproj file.

Refer to the Building, Downloading, and Running a Blackfin Application section for information about building a Blackfin VI into a Blackfin application and running the application on the target.

Migrating Custom Linker Description Files

If you used the Embedded Module for Blackfin Processors 1.0 to move to custom hardware, you modified the Linker Description File (LDF) to match the hardware layout of the custom hardware memory layout. The .

ldf file defines the system to the VisualDSP++ linker and specifies how

the linker creates executable code.

You must rewrite custom . for Blackfin Processors 2.0 because the format of .

ldf files to use them with the Embedded Module

ldf files changed from

VisualDSP++ 4.0 to VisualDSP++ 4.5.

Refer to the Moving to Custom Hardware topic in the LabVIEW Help, available by selecting Help»Search the LabVIEW Help in LabVIEW, for information about modifying .

Tip When searching for a specific topic in the LabVIEW Help from the Search tab, place

ldf files for a custom target.

a checkmark in the Search titles only checkbox and enter the topic title in the Type in t he word(s) to search for textbox. This option limits the number of topics that the LabVIEW

Help finds so you can locate the topic more quickly.

Embedded Module for Blackfin Processors 8 ni.com

+ 18 hidden pages