AUTOSAR_EXP_MacroEncapsulationofInterpolationCalls 中文翻译

文档编号：457　|　状态：Final　|　发布于：AUTOSAR CP Release 4.4.0
所属标准：AUTOSAR Classic Platform　|　文档责任方：AUTOSAR

本翻译覆盖原文档 1-32 页正文（约 720 KB）。
原文为解释性文档（EXP），介绍 AUTOSAR 库（特别是 IFL/MFL/IFX/MFX）插值/数学函数调用的宏封装机制——通过宏在编译期包装函数调用以减少运行时开销。

1 引言

AUTOSAR 标准库（IFL/MFL/IFX/MFX）函数在编译期可通过宏封装（Macro Encapsulation）包装函数调用。宏封装的核心目标：

• 减少运行时开销（避免函数调用）；
• 编译期优化（内联函数体）；
• 类型安全的内联（编译期类型检查）。

2 宏封装机制

2.1 基本机制

AUTOSAR 库函数的函数体可通过宏展开为内联调用：

// 宏封装前（函数调用）
result = Mfl_Sin_f32(angle);

// 宏封装后（编译期内联）
result = MFL_SIN_F32(angle);  // 宏展开为内联代码

2.2 宏命名规则

宏命名遵循 大写 + 类型后缀 规则：

• 原函数 Mfl_Sin_f32 → 宏 MFL_SIN_F32；
• 原函数 Mfx_Add_s8s8_s16 → 宏 MFX_ADD_S8S8_S16；
• 原函数 Ifl_IpoCur_f32 → 宏 IFL_IPOCUR_F32。

2.3 编译配置

宏封装在编译期通过预处理器宏启用：

// 在 BSW 或 SWC 编译配置中定义
#define AUTOSAR_LIBRARY_USE_MACROS  1
#include <Mfl.h>

3 使用示例

// 浮点正弦（普通调用）
result = Mfl_Sin_f32(angle);

// 宏封装版本（编译期内联）
result = MFL_SIN_F32(angle);

// 定点加法（带饱和）
result = Mfx_Add_s8s8_s16(a, b);

// 宏封装版本
result = MFX_ADD_S8S8_S16(a, b);

4 性能对比

宏封装在性能敏感场景（ECU 频繁调用）中可显著降低开销。

5 参考文献

• AUTOSAR_SRS_Libraries
• AUTOSAR_SWS_IFLLibrary / MFLLibrary / IFXLibrary / MFXLibrary