Release Note

2022.1

The below features have been added to the library in this release.

  • DDS / Mixer

The DDS/ Mixer library element now has extended type support. It now supports cfloat and cint32 for TT_DATA when configured as a mixer. When configured as a DDS, cfloat is now supported for TT_DATA. Additionally, the DDS/Mixer now supports Super Sample Rate operation for higher throughput.

  • FFT/iFFT

FFT point size support has been extended to 65536. Performance has been improved approximately 10% for cases using PARALLEL_POWER>1 which were previously supported.

  • FIR Filters

All FIR library elements now support streaming interfaces as well as window interfaces. The single rate asymmetric FIR variant now support Super Sample Rate operation for higher throughput. The FIR resampler library element has been added which performs fractional decimation. This supersedes the existing FIR interpolate fractional library unit. All FIR variants now support a larger maximum value for FIR_LEN, up to 8k depending on variant, data/coefficient type and API choice.

2021.2

The below features have been added to the library in this release.

  • DDS / Mixer - new library element
Function Namespace and class name
DDS / Mixer xf::dsp::aie::mixer::dds_mixer

This component may be configured to one of three modes. The first mode is a DDS only. The second mode is a single channel mixer. The third mode is a symmetrical mixer, taking two input channels and mixing each with the DDS output and the conjugate of DDS output respectively, combining the result to one output channel. DDS/Mixer supports window input/output interface, as well as streaming interface.

  • FIR Filters

Single rate FIRs now support streaming interfaces as well as to window interfaces.

  • FFT/iFFT

FFT now supports streaming interfaces as well as to window interfaces. In addition, FFT now offers improved performance and greater point size support with parallelization.

2021.1

The AI Engine DSP Library contains common parameterizable DSP functions used in many advanced signal processing applications. All functions currently support window interfaces with streaming interface support planned for future releases.

Note

Namespace aliasing can be utilized to shorten instantiations: namespace dsplib = xf::dsp::aie;

  • FIR Filters

The DSPLib contains several variants of Finite Impulse Response (FIR) filters.

Function Namespace and class name
Single rate, asymmetrical dsplib::fir::sr_asym::fir_sr_asym_graph
Single rate, symmetrical dsplib::fir::sr_sym::fir_sr_sym_graph
Interpolation asymmetrical dsplib::fir::interpolate_asym::fir_interpolate_asym_graph
Decimation, halfband dsplib::fir::decimate_hb::fir_decimate_hb_graph
Interpolation, halfband dsplib::fir::interpolate_hb::fir_interpolate_hb_graph
Decimation, asymmetric dsplib::fir::decimate_asym::fir_decimate_asym_graph
Interpolation, fractional, asymmetric dsplib::fir::interpolate_fract_asym:: fir_interpolate_fract_asym_graph
Decimation, symmetric dsplib::fir::decimate_sym::fir_decimate_sym_graph

All FIR filters can be configured for various types of data and coefficients. These types can be int16, int32, or float and also real or complex. Both FIR length and cascade length can also be configured for all FIR variants.

  • FFT/iFFT

The DSPLib contains one FFT/iFFT solution. This is a single channel, single kernel decimation in time, (DIT), implementation with configurable point size, complex data types, cascade length and FFT/iFFT function.

Function Namespace and class name
Single Channel FFT/iFFT dsplib::fft::fft_ifft_dit_1ch_graph
  • Matrix Multiply (GeMM)

The DSPLib contains one Matrix Multiply/GEMM (GEneral Matrix Multiply) solution. This supports the Matrix Multiplication of 2 Matrices A and B with configurable input data types resulting in a derived output data type.

Function Namespace and class name
Matrix Mult / GeMM dsplib::blas::matrix_mult::matrix_mult_graph
  • Widget Utilities

These widgets support converting between window and streams on the input to the DSPLib function and between streams to windows on the output of the DSPLib function where desired and additional widget for converting between real and complex data-types.

Function Namespace and class name
Stream to Window / Window to Stream dsplib::widget::api_cast::widget_api_cast_graph
Real to Complex / Complex to Real dsplib:widget::real2complex::widget_real2complex_graph
  • AIE DSP in Model Composer

DSP Library functions are supported in Vitis Model Composer, enabling users to easily plug these functions into the Matlab/Simulink environment to ease AI Engine DSP Library evaluation and overall AI Engine ADF graph development.

2020.2

Revised the APIs to fully support Vitis HLS.

2020.1

The 1.0 release introduces L1 HLS primitives for Discrete Fourier Transform for 1-D and 2-D input data.