AUTOSAR_SWS_FlexRayDriver 中文翻译

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

本翻译覆盖原文档 1-78 页正文。原文为软件规范（SWS），定义 FlexRay Driver（Fr）模块的 API、配置、错误处理——位于 MCAL 层，控制 FlexRay CC。

1 引言与范围

FlexRay Driver（Fr）位于 MCAL 层，初始化并控制 FlexRay CC（Communication Controller）。支持 10 Mbps 双通道通信、TDMA + FTDMA 时分多址。符合 FlexRay 协议规范 v3.0.1。

2 缩略语

Fr / FlexRay / CC / TDMA / FTDMA / POC / Key Slot / POC State / Cycle / Slot / MTG / Channel A/B / Wakeup / Cold Start / Sync / Startup

3 相关文档

[1] AUTOSAR SWS FlexRay Interface
[2] AUTOSAR SWS FlexRay Transceiver Driver
[3] AUTOSAR SRS FlexRay
[4] FlexRay Protocol Specification v3.0.1

4 约束与假设

Fr 应：

• 作为 MCAL 模块（与硬件强耦合）；
• 由 FrIf 调用；
• 支持冷启动节点 / 非冷启动节点；
• 支持 POC 状态机；
• 支持双通道（A+B）配置；
• 支持多 CC 实例。

5 依赖其他模块

Fr 依赖：Dem（错误上报）/ MCU（时钟配置）/ Port（引脚复用）/ FrTrcv（收发器）/ StbM（时间同步）。

6 功能规格

6.1 架构

Fr Driver 位于 MCAL 层，对下控制 CC 寄存器，对上为 FrIf 提供抽象。

6.2 POC 状态机

Fr 管理 CC 的 POC（Protocol Operation Control）状态机：

• DEFAULT_CONFIG / CONFIG / READY / WAKEUP / STARTUP / NORMAL_ACTIVE / NORMAL_PASSIVE / HALT / SLEEP；
• 包含 CHI（Controller Host Interface）命令接口。

7 API 服务

7.1 初始化 / 关闭

void Fr_Init(const Fr_ConfigType* ConfigPtr)：初始化 Fr 驱动。
void Fr_DeInit(void)：去初始化。

7.2 控制器模式

Std_ReturnType Fr_SetControllerMode(uint8 Fr_CtrlIdx, Fr_ControllerStateType Fr_CtrlMode)：设置控制器状态。
Std_ReturnType Fr_GetControllerMode(uint8 Fr_CtrlIdx, Fr_ControllerStateType* Fr_CtrlModePtr)：获取状态。

7.3 帧传输 / 接收

Std_ReturnType Fr_Transmit(uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, const PduInfoType* Fr_PduInfoPtr)：发送 LPdu（Frame）。
Std_ReturnType Fr_Receive(uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, const PduInfoType* Fr_PduInfoPtr, const uint16* Fr_LPduStatusPtr)：接收。

7.4 状态查询

Std_ReturnType Fr_GetStatus(uint8 Fr_CtrlIdx, Fr_StatusType* Fr_StatusPtr)：获取 Fr 状态。
Std_ReturnType Fr_GetNmState(uint8 Fr_CtrlIdx, Fr_NmStateType* Fr_NmStatePtr)：获取网络管理状态（CCMSM 状态）。

7.5 触发传输

Std_ReturnType Fr_TriggerTransmit(uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, PduInfoType* Fr_PduInfoPtr)：触发传输。

7.6 CCMSM 抽象

CCMSM（Clock Correction / Sync / Media Access state machine）状态查询。

8 配置

Fr 配置类：

• FrController：CC 配置（Key Slot、Slot ID、Payload Length、Microtick）；
• FrChannel：通道配置（A/B）；
• FrDemEventParameterRefs：Dem 事件引用；
• FrGeneral：全局配置（波特率、宏周期）；
• FrConfigSet：多配置集。

9 错误处理

9.1 开发错误

FR_E_UNINIT：模块未初始化。
FR_E_PARAM_POINTER：参数指针为空。
FR_E_PARAM：参数无效。
FR_E_INV_CTRL_IDX：控制器索引无效。

9.2 运行时错误

FR_E_BUSY：模块忙。

9.3 扩展生产错误（上报 DEM）

FR_E_TIMEOUT：通信超时。
FR_E_FATAL_ERROR：CC 严重错误。