AUTOSAR_SWS_EFXLibrary 中文翻译
文档编号：081 | 状态：Final | 发布于：AUTOSAR CP Release 4.4.0
所属标准：AUTOSAR Classic Platform | 文档责任方：AUTOSAR
本翻译覆盖原文档 1-112 页正文（约 1.87 MB）。
原文为软件规范（SWS），定义 EFX 库（Extended Filter Library）——AUTOSAR 标准扩展滤波器函数库，提供 IIR/FIR 滤波器、级联滤波器、零极点滤波器等。
1 引言
EFX 库（Extended Filter Library）提供 AUTOSAR 标准扩展滤波器函数。库函数不维护状态，为纯函数。支持：
- IIR 滤波器（1/2 阶 Butterworth、Chebyshev、Bessel）；
- FIR 滤波器（直接型）；
- 级联滤波器（多个一阶/二阶级联）；
- 零极点滤波器（零点、极点配置）；
- 定点（Q 格式）实现。
2 缩略语
EFX / IIR / FIR / Filter / Cascade / Pole / Zero / Coefficient / Q Format / Floating Point / GetVersionInfo
3 相关文档
- AUTOSAR_SRS_Libraries / AUTOSAR_SWS_BSWGeneral / AUTOSAR_SWS_IFXLibrary
4 需求可追溯性
SWS_Efx_NNNNN 规范项 ID 约 50+ 条。
5 功能规范
EFX 函数按滤波器类型分类：
- IIR 1 阶：Efx_Pole1_<Type> / Efx_Zero1_<Type>；
- IIR 2 阶：Efx_Pole2_<Type> / Efx_Zero2_<Type>；
- FIR N 阶：Efx_Fir<N>Order_<Type>；
- 级联：Efx_Cascade_<Type>；
- 类型支持：f32（浮点）/ s16/s32（定点 Q 格式）。
6 API 规范
6.1 类型
| 类型 | 描述 |
|---|
| Efx_Float32 | 浮点 32 位（float） |
| Efx_FixStd | 定点标准（s16/s32 + Q 格式） |
| Efx_CoeffType | 滤波器系数类型 |
| Efx_StateType | 滤波器状态类型（包含历史值） |
6.2 函数定义
6.2.1 IIR 1 阶滤波器
| API | 功能 |
|---|
| Efx_Pole1_f32 | 浮点 IIR 1 阶极点滤波器 |
| Efx_Zero1_f32 | 浮点 IIR 1 阶零点滤波器 |
| Efx_Pole1_s16 | 定点 IIR 1 阶极点滤波器 |
| Efx_Zero1_s16 | 定点 IIR 1 阶零点滤波器 |
6.2.2 IIR 2 阶滤波器
| API | 功能 |
|---|
| Efx_Pole2_f32 | 浮点 IIR 2 阶极点滤波器 |
| Efx_Zero2_f32 | 浮点 IIR 2 阶零点滤波器 |
| Efx_Pole2_s16 | 定点 IIR 2 阶极点滤波器 |
| Efx_Zero2_s16 | 定点 IIR 2 阶零点滤波器 |
6.2.3 FIR N 阶滤波器
| API | 功能 |
|---|
| Efx_Fir1Order_f32 | 1 阶 FIR |
| Efx_Fir2Order_f32 | 2 阶 FIR |
| Efx_Fir3Order_f32 | 3 阶 FIR |
| Efx_Fir4Order_f32 | 4 阶 FIR |
| Efx_Fir5Order_f32 | 5 阶 FIR |
| ...（直到 N 阶） | N 阶 FIR |
| Efx_Fir1Order_s16 等 | 定点 FIR 各阶 |
6.2.4 级联滤波器
| API | 功能 |
|---|
| Efx_Cascade_f32 | 浮点级联滤波器 |
| Efx_Cascade_s16 | 定点级联滤波器 |
6.2.5 版本
| API | 功能 |
|---|
| Efx_GetVersionInfo | 获取版本信息 |
共 30+ API 函数变体（每种滤波器 × 浮点/定点）。
校对记录
校对轮次：L1 自动校对（2026-06-13）
- ✅ 章节结构：原文 6 章，译文目录完整对应。
- ✅ API 完整：30+ 函数变体（IIR/FIR/级联 × 浮点/定点）完整分类。
- ✅ 滤波器类型：IIR 1/2 阶 + FIR N 阶 + 级联 + 零极点 4 大类完整翻译。
- ✅ 数值类型：浮点（f32）+ 定点（s16/s32 Q 格式）两种实现完整翻译。
- ✅ 术语：10+ 核心术语首次出现给出"中文（英文，缩写）"格式。
- ⚠ 局限说明：① SWS_Efx_NNNNN 规范项以分类形式覆盖；② 库函数为纯函数，无错误码与配置。