随着嵌入式系统对实时信号处理需求的增长，LuatOS通过集成fft核心库，为开发者提供了强大的数学运算支持。该模块封装了快速傅里叶变换算法，可在低功耗MCU上实现高效的频谱分析。本文将系统介绍fft API的功能特性、调用方式及其在实际项目中的应用价值。
一、概述
fft 模块提供高性能的快速傅里叶变换（FFT）和逆快速傅里叶变换（IFFT）功能，支持 float32 和 q15 定点两种内核，适用于信号处理、频谱分析等场景。
二、核心示例
1、核心示例是指：使用本库文件提供的核心 API，开发的基础业务逻辑的演示代码；
2、核心示例的作用是：帮助开发者快速理解如何使用本库，所以核心示例的逻辑都比较简单；
三、常量详解
核心库常量，顾名思义是由 LuatOS 内核固件中定义的、不可重新赋值或修改的固定值，在脚本代码中不需要声明，可直接调用；
每个常量对应的常量取值仅做日志打印时查询使用，不要将这个常量取值用做具体的业务逻辑判断，因为LuatOS内核固件可能会变更每个常量对应的常量取值；
如果用做具体的业务逻辑判断，一旦常量取值发生改变，业务逻辑就会出错；
fft 模块没有常量。
四、函数详解
fft.generate_twiddles(N)
功能
生成 float32 旋转因子表。
参数
N
返回值
local Wc, Ws = fft.generate_twiddles(N)
Wc
Ws
示例
fft.generate_twiddles_q15_to_zbuff(N, Wc_zb, Ws_zb)
功能
生成 q15 定点旋转因子到 zbuff（零浮点）。
参数
N
Wc_zb
Ws_zb
返回值
无返回值
示例
fft.run(real, imag, N, Wc, Ws[, opts])
功能
原地 FFT 计算。
参数
real
imag
N
Wc
Ws
opts
返回值
无返回值
示例
fft.ifft(real, imag, N, Wc, Ws[, opts])
功能
原地 IFFT 计算。
注意事项
就地修改 real/imag，并在 f32 路径下包含 1/N 归一化
参数
real
imag
N
Wc
Ws
opts
返回值
无返回值
示例
fft.fft_integral(real, imag, n, df)
功能
频域积分（1/(jω)）。
参数
real
imag
n
df
返回值
无返回值
示例
五、模组支持说明
支持 LuatOS 开发的所有模组都支持 fft 核心库。
今天的内容就分享到这里了~