AUTOSAR_SWS_EthernetStateManager 中文翻译

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

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

1 引言与范围

Ethernet State Manager（EthSm）协调 Ethernet 通信通道状态机。对下调用 EthIf / TcpIp 模式控制；对上响应 ComM 的网络模式请求。状态机包括：OFFLINE / WAIT_TRCV / WAIT_ONLINE / ONLINE / WAIT_OFFLINE / ONHOLD / START_SLEEP / SLEEP / WAIT_WAKEUP 等。

2 缩略语

EthSm / EthIf / TcpIp / ComM / Nm / BswM / OFFLINE / ONLINE / SLEEP / Wakeup

3 相关文档

[1] AUTOSAR SWS ComM
[2] AUTOSAR SWS Ethernet Interface
[3] AUTOSAR SWS TcpIp
[4] AUTOSAR SRS Ethernet

4 约束与假设

EthSm 应：

• 实现 Ethernet 通道状态机；
• 由 ComM 触发模式请求；
• 对下控制 EthIf/TcpIp 模式；
• 支持 Partial Networking（PN）；
• 支持多通道（每通道独立状态机）。

5 依赖其他模块

EthSm 依赖：ComM（模式请求）/ EthIf（接口模式）/ TcpIp（协议模式）/ BswM（模式仲裁）/ Nm（PN 协调）。

6 功能规格

6.1 状态机

EthSm 状态机：

• OFFLINE：Eth 关闭；
• WAIT_TRCV：等待收发器就绪；
• WAIT_ONLINE：等待网络上线；
• ONLINE：网络已上线；
• WAIT_OFFLINE：等待网络下线；
• ONHOLD：暂留（等待 BswM 决策）；
• START_SLEEP：开始睡眠；
• SLEEP：睡眠；
• WAIT_WAKEUP：等待唤醒。

7 API 服务

7.1 初始化 / 关闭

void EthSm_Init(const EthSm_ConfigType* CfgPtr)：初始化。
void EthSm_DeInit(void)：去初始化。

7.2 模式请求（来自 ComM）

Std_ReturnType EthSm_RequestComMode(NetworkHandleType NetworkHandle, ComM_ModeType ComMode)：请求通信模式（COMM_NO_COMMUNICATION / COMM_SILENT_COMMUNICATION / COMM_FULL_COMMUNICATION）。

7.3 模式获取

Std_ReturnType EthSm_GetCurrentComMode(NetworkHandleType NetworkHandle, ComM_ModeType* ComModePtr)：获取当前通信模式。

7.4 回调（来自 EthIf / TcpIp）

void EthSm_TcpIpModeIndication(EthIf_SwitchPortGroupIdxType PortGroupIdx, TcpIp_StateType State)：TcpIp 状态指示（TCPIP_STATE_ONLINE / TCPIP_STATE_OFFLINE / TCPIP_STATE_STARTUP / TCPIP_STATE_SHUTDOWN）。
void EthSm_EthIfPortLinkStateChg(EthIf_SwitchPortIdxType PortIdx, EthIf_LinkStateType LinkState)：端口链路状态变化。

7.5 MainFunction

void EthSm_MainFunction(void)：周期性主函数，处理状态机转换。

8 配置

EthSm 配置类：

• EthSmChannel：通道配置（关联 ComM NetworkHandle / EthIf 控制器 / TcpIp）；
• EthSmPn：部分网络配置；
• EthSmConfig：模块配置。

9 错误处理

9.1 开发错误

ETHSM_E_UNINIT：模块未初始化。
ETHSM_E_PARAM_POINTER：参数指针为空。
ETHSM_E_PARAM：参数无效。
ETHSM_E_INV_NETWORK_HANDLE：网络句柄无效。

9.2 运行时错误

ETHSM_E_BUSY：模块忙。
ETHSM_E_INVALID_STATE：无效状态转换。