# filter **Repository Path**: MagicBude/filter ## Basic Information - **Project Name**: filter - **Description**: 数字滤波算法库 - 提供常用高效滤波算法,专为传感器数据处理和信号平滑设计 - **Primary Language**: C - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 5 - **Forks**: 2 - **Created**: 2025-08-22 - **Last Updated**: 2026-11-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # STM32 数字滤波算法库 提供14类数字滤波算法和1个数组处理工具,适用于 STM32 等支持 C99 的工程。 核心实现不访问芯片外设,不分配动态内存,窗口和历史状态由调用方管理。 ## 快速接入 将 `FILTER/filter.c` 加入工程,并把 `FILTER` 目录加入编译器包含路径,然后包含 `filter.h`。 头文件仅依赖标准 ``;使用芯片或 HAL/LL 声明的调用方,应自行包含对应 SDK 头文件。 完整的初始化、缓冲区与调用约定见[接入指南](docs/integration.md)。 在仓库根目录使用 PowerShell 7 运行主机回归和示例: ```powershell .\scripts\verify.ps1 -Compiler C:\msys64\mingw64\bin\gcc.exe ``` 如果 `gcc` 已加入 `PATH`,可省略 `-Compiler` 参数。 脚本使用真实算法源码运行测试和[最小示例](examples/filter_demo.c),验证说明见[主机验证指南](docs/testing.md)。 当前仓库没有完整 STM32 工程,主机检查不能替代目标工程构建和上板验证。 ## 文件组织 ```text FILTER/ 算法头文件、实现和逐项说明 docs/ 接入及验证指南 tests/ 直接调用真实算法的主机回归 examples/ 可编译运行的最小使用示例 scripts/ 主机验证入口 ``` 核心实现位于 `FILTER/filter.c` 和 `FILTER/filter.h`,按基础、滑动窗口、高级滤波和工具函数四个分组组织。 测试、示例和验证脚本独立于嵌入式工程,接入固件时只需加入实际使用的算法源码。 ## 算法分类 - **基础滤波算法:** 限幅、中值、算术平均 - **滑动窗口滤波算法:** 去极值平均、滑动平均、限幅滑动平均、加权递推平均 - **高级滤波算法:** 一阶低通、计数消抖、限幅消抖、卡尔曼、EWMA、双边、自适应 - **工具函数:** 数组限幅 原理、接口和逐项示例见[算法参考](FILTER/README.md)。 选型时结合实际采样数据、允许延迟、状态内存和目标端计时验证效果。