Summary of the content on the page No. 1
™
NI-DSP
Software Reference Manual
®
for LabVIEW for Windows
Digital Signal Processing Software for the PC
December 1993 Edition
Part Number 320571-01
© Copyright 1993 National Instruments Corporation.
All Rights Reserved.
Summary of the content on the page No. 2
National Instruments Corporate Headquarters 6504 Bridge Point Parkway Austin, TX 78730-5039 (512) 794-0100 Technical support fax: (800) 328-2203 (512) 794-5678 Branch Offices: Australia (03) 879 9422, Austria (0662) 435986, Belgium 02/757.00.20, Canada (Ontario) (519) 622-9310, Canada (Québec) (514) 694-8521, Denmark 45 76 26 00, Finland (90) 527 2321, France (1) 48 14 24 24, Germany 089/741 31 30, Italy 02/48301892, Japan (03) 3788-1921, Netherlands 03480-33466, Norway 32-848400, Spain (91) 640
Summary of the content on the page No. 3
Limited Warranty The media on which you receive National Instruments software are warranted not to fail to execute programming instructions, due to defects in materials and workmanship, for a period of 90 days from date of shipment, as evidenced by receipts or other documentation. National Instruments will, at its option, repair or replace software media that do not execute programming instructions if National Instruments receives notice of such defects during the warranty period. National Ins
Summary of the content on the page No. 4
Warning Regarding Medical and Clinical Use of National Instruments Products National Instruments products are not designed with components and testing intended to ensure a level of reliability suitable for use in treatment and diagnosis of humans. Applications of National Instruments products involving medical or clinical treatment can create a potential for accidental injury caused by product failure, or by errors on the part of the user or application designer. Any use or application of Nati
Summary of the content on the page No. 5
Contents About This Manual xi .................................................................................................................... Assumption of Previous Knowledge xi ........................................................................................................ Organization of This Manual xi ............................................
Summary of the content on the page No. 6
Contents DSP Absolute ............................................................................................................................................2-4 DSP Add ................................................................................................................................................... 2-5 DSP Allocate Memory 2-6 .............................................................................................................................. DSP Blackman Window 2-7
Summary of the content on the page No. 7
Contents DSP ReFFT ............................................................................................................................................... 2-66 DSP Reset ................................................................................................................................................. 2-66 DSP Reverse ............................................................................................................................................. 2-67 DSP Sawtooth
Summary of the content on the page No. 8
Contents Chapter 4 ..................................................................................................................................4-1 Using the DMA VIs DSP DMA Copy(DSP to LV) 4-3 ................................................................................................................... DSP DMA Copy(LV to DSP) 4-4 ................................................................................................................... Appendix A Error Codes .................
Summary of the content on the page No. 9
Contents Figures Part 1 Figure 1-1. Development Paths with the NI-DSP Software 1-1 ............................................................................. Part 2 Figure 1-1. Communication between the PC and the DSP Board 1-1 .................................................................... Figure 1-2. DSP Handle Cluster 1-3 ....................................................................................................................... Figure 1-3. The Hexadecimal Encoding of a Typ
Summary of the content on the page No. 10
Contents Tables Part 1 Table 1-1. Subdirectories Created by SETUP 1-2 ................................................................................................. Part 3 Table 1-1. The NI-DSP Analysis VI Groups 1-1 .................................................................................................. Part 4 Table 2-1. Files Required to Build the Custom DSP Library Example 2-7 .......................................................... Appendix A Table A-1. NI-DSP Analysis Library
Summary of the content on the page No. 11
About This Manual The NI-DSP Software Reference Manual for LabVIEW for Windows explains how to use the NI-DSP software package for the LabVIEW for Windows environment. The NI-DSP software package contains the NI-DSP Analysis VIs, which are high-level digital signal processing (DSP) VIs that call the functions that execute on the AT-DSP2200 plug-in board for IBM AT bus and compatible compute
Summary of the content on the page No. 12
About This Manual - Chapter 3, DSP Board Function Overview, contains an overview of the prototypes of the C-callable NI-DSP Analysis functions on the DSP board that you can use in your custom programs. - Chapter 4, Using the DMA VIs, describes two special VIs that transfer data between the host computer and the DSP board without interfering with the DSP board. • Appendix A, Error Codes, contains a list of the error codes returned by the NI-DSP Analysis VIs and the corresponding error messages. •
Summary of the content on the page No. 13
About This Manual LabVIEW Data Types Each VI description includes a data type picture for each control and indicator, as illustrated in the following table: Control Indicator Data Type Boolean String Signed 16-bit integer Array of signed 16-bit integers Signed 32-bit integer Array of signed 32-bit integers 32-bit floating-point number; by default, floating-point numbers are double precision Array of 32-bit floating-point numbers Path DSP Handle Cluster Array of DSP Handle Clusters Error Cluster
Summary of the content on the page No. 14
About This Manual Related Documentation The following documentation available from National Instruments contains information that you may find helpful as you read this manual. • AT-DSP2200 User Manual, part number 320435-01 • LabVIEW Data Acquisition VI Reference Manual, part number 320536-01 • LabVIEW Getting Started Manual for Windows, part number 320533-01 • LabVIEW User Manual, part number 320534-01 • LabVIEW Utility VI Reference Manual, part number 320543-01 • NI-DAQ Function Reference Manu
Summary of the content on the page No. 15
About This Manual Developer Toolkit The Developer Toolkit, an optional software package that you can purchase separately from National Instruments, is required for building custom libraries with the NI-DSP Interface Utilities. The Developer Toolkit contains an AT&T C compiler, assembler, linker, and documentation. With these tools, you can program AT Series DSP boards directly, using theboard flexibility to custom tailor the DSP Library. The C compiler optimizes WE DSP32C code and generates a
Summary of the content on the page No. 16
Part 1 Getting Started with NI-DSP This part contains a brief product overview, information about the NI-DSP for LabVIEW for Windows package, and the procedure for installing the software. Product Overview The NI-DSP software package comes with a set of LabVIEW VIs that invoke the digital signal processing (DSP) board-resident high-performance functions that efficiently process large blocks
Summary of the content on the page No. 17
Getting Started with NI-DSP Part 1 What Your Distribution Diskettes Should Contain The NI-DSP software package contains the NI-DSP for LabVIEW for Windows Disks (for licensed LabVIEW for Windows users). If your kit is missing any of these components, contact National Instruments. Installing NI-DSP for LabVIEW for Windows Note: NI-DSP for LabVIEW for Windows is intended for use with the standard LabVIEW for Windows software. You must install LabVIEW for Windows before installing NI-DSP. You mus
Summary of the content on the page No. 18
Part 1 Getting Started with NI-DSP NIDSP is the name you specify during setup. The SETUP program prompts you for information including the drive letter and directory in which you have installed the standard LabVIEW package. The program also verifies that your hard disk has enough space to hold the NI-DSP for LabVIEW for Windows files. If you choose Custom Installation, SETUP installs only the files you specify. Board Configuration There are several board configuration parameters that must be es
Summary of the content on the page No. 19
Part 2 Introduction to the NI-DSP Analysis VIs This part describes how to use the NI-DSP Analysis VIs in your LabVIEW applications. This part also describes how to manage memory on the DSP board from your LabVIEW application, and how to transfer data between your LabVIEW application and the NI-DSP functions on the board. This part contains general guidelines for developing NI-DSP applicati
Summary of the content on the page No. 20
Introduction to the NI-DSP Analysis VIs Part 2 The AT-DSP2200 can process large amounts of data, separately and distinctly from the host PC processor. The board consists not only of a signal processing chip, but also memory where data that the board processes must reside. The AT-DSP2200 does not have access to memory locations on the host PC. Therefore, you must download all data from your application programs to DSP board memory before processing it. The Interface Library, DSP.DLL, and the C
