简述

这份手册描述的是 CSI DSP软件库, 是一套用于CK80X设备的通用信号处理函数。

库内的各个函数可以分类为:

• 基本数学函数
• 快速数学函数
• 复数函数
• 滤波函数
• 矩阵函数
• 变换函数
• 电机控制函数
• 统计函数
• 辅助函数
• 插值函数

库内的大多数函数都有Q7，Q15，Q31和单精度浮点四种版本。

如何使用库

Lib 目录内提供了一些预编译的版本，分别是：

• libcsky_ck803slf_math.a (CK803S 小端和硬件浮点)
• libcsky_ck803sbf_math.a (CK803S 大端和硬件浮点)
• libcsky_ck803sl_math.a (CK803S 小端)
• libcsky_ck803sb_math.a (CK803S 大端)
• libcsky_ck802l_math.a (CK802 小端)
• libcsky_ck802b_math.a (CK802 大端)
• libcsky_ck801l_math.a (CK801 小端)
• libcsky_ck801b_math.a (CK801 大端)

函数库的函数声明在头文件 csky_math.h 中， csky_math.h 源码放在 Include 目录中。

在应用程序中包括 csky_math.h 头文件，就可以直接调用DSP库函数；链接的时候指定应用对应的库版本，就可以将库函数链接进应用程序。 不管是 CK803S/CK802/CK801 的大端还是小端，是否有硬件浮点支持（FPU），对应的都是同一个头文件 csky_math.h 。

当然，根据使用的不同处理器，需要在包含 csky_math.h 之前，需要先定义相应的预处理宏 CSKY_MATH_CK803S 或者 CSKY_MATH_CK802 或者 CSKY_MATH_CK801 。

示例

函数库里面带了一些示例演示如何使用库函数。

工具链支持

函数库已经使用GCC工具链测试。

预处理宏

函数库定义了一些不同的预处理宏来表示各种特性，若是应用了默认选择的预编译库不能满足需求，则自行选择后重新编译。

• UNALIGNED_SUPPORT_DISABLE : 表示芯片是否支持未对齐内存访问。默认不支持未对齐访问。
• CSKY_MATH_BIG_ENDIAN : 选择编译大端或者小端版本的库。
• CSKY_MATH_MATRIX_CHECK : 指定是否检查输入输出矩阵的大小。默认不检查矩阵的大小。
• CSKY_MATH_ROUNDING : 指定是否使能舍入。默认不使能舍入。
• CSKY_MATH_CK80x : 定义宏 CSKY_MATH_CK803S 则编译 CK803S 库, 定义宏CSKY_MATH_CK802 则编译 CK802 库，定义 CSKY_MATH_CK801 则编译CK801。
• CSKY_SUP_LARGE_TABLE : 指定变换函数是否支持较大数组。为了削减代码大小，默认不定义CSKY_SUP_LARGE_TABLE。

工程中的CSI-DSP目录

下表罗列了 CSI-DSP 相关的目录：