CSI DSP Software Library

Introduction

This user manual describes the CSI DSP software library, a suite of common signal processing functions for use on CK80x processor based devices.

The library is divided into a number of functions each covering a specific category:

• Basic math functions
• Fast math functions
• Complex math functions
• Filters
• Matrix functions
• Transforms
• Motor control functions
• Statistical functions
• Support functions
• Interpolation functions

The library has separate functions for operating on 8-bit integers, 16-bit integers, 32-bit integer and 32-bit floating-point values.

Using the Library

The library installer contains prebuilt versions of the libraries in the Lib folder.

• libcsky_ck803slf_math.a (Little endian and Floating Point Unit on CK803S)
• libcsky_ck803sbf_math.a (Big endian and Floating Point Unit on CK803S)
• libcsky_ck803sl_math.a (Little endian on CK803S)
• libcsky_ck803sb_math.a (Big endian on CK803S)
• libcsky_ck802l_math.a (Little endian on CK802)
• libcsky_ck802b_math.a (Big endian on CK802)
• libcsky_ck801l_math.a (Little endian on CK801)
• libcsky_ck801b_math.a (Big endian on CK801)

The library functions are declared in the public file csky_math.h which is placed in the Include folder. Simply include this file and link the appropriate library in the application and begin calling the library functions. The Library supports single public header file csky_math.h for CK803S/CK802/CK801 with little endian and big endian. Same header file will be used for floating point unit(FPU) variants.

Define the appropriate pre processor MACRO CSKY_MATH_CK803S or CSKY_MATH_CK802 or CSKY_MATH_CK801 depending on the target processor in the application.

Examples

The library ships with a number of examples which demonstrate how to use the library functions.

Toolchain Support

The library is being tested in GCC toolchains and updates on this activity will be made available shortly.

Pre-processor Macros

Each library project have differant pre-processor macros.

• UNALIGNED_SUPPORT_DISABLE: Define macro UNALIGNED_SUPPORT_DISABLE, If the silicon does not support unaligned memory access
• CSKY_MATH_BIG_ENDIAN: Define macro CSKY_MATH_BIG_ENDIAN to build the library for big endian targets. By default library builds for little endian targets.
• CSKY_MATH_MATRIX_CHECK: Define macro CSKY_MATH_MATRIX_CHECK for checking on the input and output sizes of matrices
• CSKY_MATH_ROUNDING: Define macro CSKY_MATH_ROUNDING for rounding on support functions
• CSKY_MATH_CK80x: Define macro CSKY_MATH_CK803S for building the library on CK803S target, CSKY_MATH_CK802 for building library on CK802 target and CSKY_MATH_CK801 for building library on CK801 target
• CSKY_SUP_LARGE_TABLE: Define macro CSKY_SUP_LARGE_TABLE for transform functions to support large input signal.

---

CSI-DSP in CSI

The following files relevant to CSI-DSP are present in the CSI directories:

File/Folder	Content
CSI/Documentation/DSP	This documentation
CSI/DSP_Lib/Examples	Example projects demonstrating the usage of the library functions
CSI/DSP_Lib/Source	Source files for rebuilding the library
CSI/DSP_Lib/Project	Scripts for rebuilding the library
CSI/DSP_Lib/Include	Include headers for rebuilding the library
CSI/Lib/	Prebuilt DSP library