National Instruments 320571-01 User Manuals

Table of Contents

• NI-DSP Software Reference Manual for LabVIEW for Windows

  1
• Important Information

  3
• Contents

  5
• About This Manual

  11
  • Assumption of Previous Knowledge

    11
  • Organization of This Manual

    11
  • Conventions Used in This Manual

    12
  • Related Documentation

    14
  • Additional Software

    14
    • NI-DAQ for DOS/Windows/LabWindows

      14
    • Developer Toolkit

      15
  • Compatible Hardware

    15
  • Customer Communication

    15
• Part 1 Getting Started with NI-DSP

  16
  • Product Overview

    16
  • The NI-DSP Software

    16
    • What Your Distribution Diskettes Should Contain

      17
  • Installing NI-DSP for LabVIEW for Windows

    17
  • Board Configuration

    18
    • Installation on an ISA (or AT) Bus Computer

      18
    • Installation on an EISA Bus Computer

      18
• Part 2 Introduction to the NI-DSP Analysis VIs

  19
  • Using the NI-DSP VIs in LabVIEW

    19
  • AT-DSP2200 Software Overview

    19
  • Memory Management and Data Transfer

    20
  • Special Features of the NI-DSP Analysis VIs

    23
    • An Example of Using NI-DSP Analysis VIs

      26
  • Hints for Improving the Execution Speed on the DSP Board

    25
• Part 3 NI-DSP Function Reference

  28
  • Chapter 1 NI-DSP Analysis VI Reference Overview

    28
    • The NI-DSP Analysis VI Overview

      28
    • Analysis VI Organization

      30
    • Accessing the NI-DSP Analysis VIs

      30
    • About the Fast Fourier Transform (FFT)

      31
    • About Filtering

      32
    • About Windowing

      33
  • Chapter 2 NI-DSP Analysis VI Reference

    36
    • Copy Mem(DSP to DSP)

      36
    • Copy Mem(DSP to LV)

      37
    • Copy Mem(LV to DSP)

      38
    • DSP Absolute

      39
    • DSP Add

      40
    • DSP Allocate Memory

      41
    • DSP Blackman Window

      42
    • DSP Blackman Harris Window

      43
    • DSP Butterworth Coefficients

      44
    • DSP Chebyshev Coefficients

      45
    • DSP Clip

      46
    • DSP Complex FFT

      47
    • DSP Convolution

      48
    • DSP Correlation

      49
    • DSP Cross Power

      50
    • DSP Custom

      51
    • DSP Decimate

      52
    • DSP Deconvolution

      53
    • DSP Derivative

      54
    • DSP Divide

      55
    • DSP Elliptic Coefficients

      56
    • DSP Equi-Ripple BandPass

      58
    • DSP Equi-Ripple BandStop

      60
    • DSP Equi-Ripple HighPass

      62
    • DSP Equi-Ripple LowPass

      64
    • DSP Exact Blackman Window

      65
    • DSP Exponential Window

      66
    • DSP FHT

      67
    • DSP Flat Top Window

      68
    • DSP Force Window

      69
    • DSP Free Memory

      69
    • DSP Gaussian White Noise

      70
    • DSP General Cosine Window

      71
    • DSP Hamming Window

      72
    • DSP Handle To Address

      73
    • DSP Hanning Window

      74
    • DSP IIR Filter

      75
    • DSP Impulse Pattern

      77
    • DSP Impulse Train Pattern

      78
    • DSP Index Memory

      79
    • DSP Init Memory

      80
    • DSP Integral

      81
    • DSP Inv Chebyshev Coeff

      82
    • DSP Inverse FFT

      83
    • DSP Inverse FHT

      84
    • DSP Kaiser-Bessel Window

      85
    • DSP Linear Evaluation

      86
    • DSP Load

      86
    • DSP Log

      87
    • DSP Max & Min

      88
    • DSP Median Filter

      89
    • DSP Multiply

      90
    • DSP Parks-McClellan

      91
    • DSP Polar to Rectangular

      95
    • DSP Polynomial Evaluation

      96
    • DSP Power Spectrum

      97
    • DSP Product

      97
    • DSP Pulse Pattern

      98
    • DSP Ramp Pattern

      99
    • DSP Random Pattern

      100
    • DSP Rectangular To Polar

      101
    • DSP ReFFT

      102
    • DSP Reset

      102
    • DSP Reverse

      103
    • DSP Sawtooth Pattern

      104
    • DSP Set

      105
    • DSP Shift

      105
    • DSP Sinc Pattern

      106
    • DSP Sine Pattern

      107
    • DSP Square Pattern

      108
    • DSP Square Root

      109
    • DSP Sort

      110
    • DSP Start

      111
    • DSP Subset

      111
    • DSP Subtract

      112
    • DSP Sum

      112
    • DSP TimeOut

      113
    • DSP Triangle Pattern

      114
    • DSP Triangular Train

      116
    • DSP Triangular Window

      117
    • DSP Uniform White Noise

      118
    • DSP Unwrap Phase

      119
    • DSP Zero Padder

      120
• Part 4 NI-DSP Interface Utilities

  121
• Chapter 1 Introduction to the NI-DSP Interface Utilities

  121
  • Overview of the NI-DSP Interface Utilities

    121
  • Installing the NI-DSP Interface Utilities

    122
  • Using the NI-DSP Interface Utilities

    122
• Chapter 2 Getting Started with the NI-DSP Interface Utilities

  123
  • Creating Your Custom NI-DSP Library

    123
    • 1. Create Your Source Code of C Functions

      123
      • GMaxMin.c Example:

        123
      • Guidelines for the Custom Functions

        124
      • DSP Board Memory Management

        126
    • 2. Compile and/or Assemble Source Code

      127
    • 3. Add Your Object Filenames to a Linker File (ifile)

      127
    • 4. Add Your New Function Names to a Library Function List File

      127
      • Customizing the DSP Library by Deleting Functions

        128
    • 5. Run the Build Dispatch Application to Generate an Assembly Dispatch File

      129
    • 6. Compile, Assemble, and Link Your Custom Library

      130
  • Creating Your LabVIEW Interface

    131
    • 1. Bundle All of the Input Parameters to Arrays

      131
    • 2. Call the Custom VI

      133
  • Executing the Custom Function from LabVIEW

    135
• Chapter 3 DSP Board Function Overview

  136
  • Data Acquisition Functions

    138
• Chapter 4 Using the DMA VIs

  139
  • DSP DMA Copy(DSP to LV)

    141
  • DSP DMA Copy(LV to DSP)

    142
• Appendix A Error Codes

  143
• Appendix B Customer Communication

  147
• Glossary

  151
• Index

  152
• Figures

  9
  • Figure 1-1. Development Paths with the NI-DSP Software

    16
  • Figure 1-1. Communication between the PC and the DSP Board

    19
  • Figure 1-2. DSP Handle Cluster

    21
  • Figure 1-3. The Hexadecimal Encoding of a Typical DSP Handle

    21
  • Figure 1-4. Front Panel–An Example of How to Allocate a DSP Handle Cluster

    22
  • Figure 1-5. Block Diagram–An Example of How to Allocate a DSP Handle Cluster

    22
  • Figure 1-6. DSP Add VI

    23
  • Figure 1-7. The error in/error out Cluster

    23
  • Figure 1-8. An Example That Does Not Use error in/error out

    24
  • Figure 1-9. An Example of Using the error in/error out Cluster for Sequential VI Execution

    25
  • Figure 1-10. Front Panel–An Example of Using NI-DSP Analysis VIs

    26
  • Figure 1-11. Block Diagram–An Example of Using NI-DSP Analysis VIs

    26
  • Figure 1-1. Choosing DSP2200 from the Functions Menu

    31
  • Figure 1-2. Spectral Leakage Demonstrated Using Convolution

    34
  • Figure 1-1. NI-DSP for DOS Directory Structure

    121
  • Figure 1-2. Interface Layers to Onboard Functions

    122
  • Figure 2-1. Linker File NIDSPLNK

    127
  • Figure 2-2. Library Function List File NIDSP.fnc

    127
  • Figure 2-3. Typical Section of NIDSP.fnc

    128
  • Figure 2-4. Signals Group Section in dspfncs.h

    129
  • Figure 2-5. Signals Group Section in dispatch.s

    129
  • Figure 2-6. How to Bundle Parameters in LabVIEW to Call gmaxmin.c

    132
  • Figure 2-7. How to Connect to Custom VI to Call gmaxmin.c

    133
  • Figure 2-8. Block Diagram–How to Index the Output Arrays of the Custom VI

    134
  • Figure 2-9. Block Diagram–Using the Custom VI to Call gmaxmin.c on the

    134
  • Figure 2-10. Front Panel–Using the Custom VI to Call gmaxmin.c on the

    135
• Tables

  10
  • Table 1-1. Subdirectories Created by SETUP

    17
  • Table 1-1. The NI-DSP Analysis VI Groups

    28
  • Table 2-1. Files Required to Build the Custom DSP Library Example

    130
  • Table A-1. NI-DSP Analysis Library Error Codes

    143