AUTOSAR_SWS_WirelessEthernetTransceiverDriver 中文翻译

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

本翻译覆盖原文档 1-50 页正文。原文为软件规范（SWS），定义 Wireless Ethernet Transceiver Driver 模块的 API、配置、错误处理。

1 引言与范围

Wireless Ethernet Transceiver Driver（WEthTrcv）位于 MCAL 层，控制无线 RF 收发器（Wi-Fi/Bluetooth/Cellular 射频模块）。提供 RF 状态、信号强度、频段切换、连接管理等服务。

2 缩略语

WEthTrcv / RF / Wi-Fi / Bluetooth / Cellular / 2.4 GHz / 5 GHz / LTE / 5G / RSSI / dBm / Antenna / Diversity

3 相关文档

[1] AUTOSAR SWS Wireless Ethernet Driver
[2] AUTOSAR SWS Ethernet Transceiver Driver
[3] AUTOSAR SWS Ethernet Interface
[4] AUTOSAR SRS Ethernet

4 约束与假设

WEthTrcv 应：

• 作为 MCAL 模块（与硬件强耦合）；
• 由 WEth Driver 调用；
• 支持多 RF 频段切换；
• 支持天线分集。

5 依赖其他模块

WEthTrcv 依赖：Dem（错误上报）/ WEth Driver / Port（引脚复用）。

6 功能规格

6.1 架构

WEthTrcv 位于 MCAL 层，对下控制 RF 模块，对上为 WEth Driver 提供抽象。

7 API 服务

7.1 初始化 / 关闭

void WEthTrcv_Init(const WEthTrcv_ConfigType* ConfigPtr)：初始化。
void WEthTrcv_DeInit(void)：去初始化。

7.2 模式控制

Std_ReturnType WEthTrcv_SetTransceiverMode(uint8 TrcvIdx, WEthTrcv_ModeType Mode)：设置模式（NORMAL/STANDBY/SLEEP）。
Std_ReturnType WEthTrcv_GetTransceiverMode(uint8 TrcvIdx, WEthTrcv_ModeType* ModePtr)：获取模式。

7.3 频段 / 信道

Std_ReturnType WEthTrcv_SetChannel(uint8 TrcvIdx, WEthTrcv_ChannelType Channel)：设置 RF 信道。
Std_ReturnType WEthTrcv_GetChannel(uint8 TrcvIdx, WEthTrcv_ChannelType* ChannelPtr)：获取信道。

7.4 链路状态 / 信号

Std_ReturnType WEthTrcv_GetLinkState(uint8 TrcvIdx, WEthTrcv_LinkStateType* LinkStatePtr)：获取链路状态（ACTIVE/INACTIVE）。
Std_ReturnType WEthTrcv_GetSignalQuality(uint8 TrcvIdx, int8* RssiPtr)：获取信号质量（RSSI，dBm）。

7.5 唤醒

Std_ReturnType WEthTrcv_GetBusWuReason(uint8 TrcvIdx, WEthTrcv_WakeupReasonType* ReasonPtr)：获取唤醒原因。
Std_ReturnType WEthTrcv_SetTransceiverWakeupMode(uint8 TrcvIdx, WEthTrcv_WakeupModeType Mode)：设置唤醒模式。

8 配置

WEthTrcv 配置类：

• WEthTrcvChannel：通道配置（频段、信道范围）；
• WEthTrcvDemEventParameterRefs：Dem 事件引用；
• WEthTrcvGeneral：全局配置（天线配置）。

9 错误处理

9.1 开发错误

WETHTRCV_E_UNINIT：模块未初始化。
WETHTRCV_E_PARAM_POINTER：参数指针为空。
WETHTRCV_E_PARAM：参数无效。

9.2 运行时错误

WETHTRCV_E_BUSY：模块忙。