AUTOSAR_SWS_NetworkManagementInterface 中文翻译

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

本翻译覆盖原文档 1-66 页正文。原文为软件规范（SWS），定义网络管理接口（Nm）模块的 API、配置、错误处理——作为通用网络管理接口。

1 引言与范围

Nm（Network Management Interface）模块位于 ComM 与具体总线 Nm（CanNm/FrNm/LinNm/UdpNm）之间。提供通用 NM API，聚合多个总线的网络状态。包含 PN 协调器、状态机管理、被动启动等。

2 缩略语

Nm / NM / CAN / FlexRay / LIN / Ethernet / UDP / PN / PN-C / PN-R / CBV / ComM / State / Mode

3 相关文档

[1] AUTOSAR SWS ComM
[2] AUTOSAR SWS CanNm
[3] AUTOSAR SWS FrNm
[4] AUTOSAR SWS LinNm
[5] AUTOSAR SWS UdpNm
[6] AUTOSAR SRS Network Management

4 约束与假设

Nm 应：

• 作为通用 NM 接口；
• 支持多个总线通道（每通道独立网络）；
• 支持 NM 状态机（BusSleep/PrepareBusSleep/Network/RepeatMessage）；
• 支持 PN 协调器；
• 支持运行时配置变化。

5 依赖其他模块

Nm 依赖：ComM（模式请求）/ 具体总线 Nm（CanNm/FrNm/LinNm/UdpNm）/ BswM（模式仲裁）。

6 功能规格

6.1 架构

Nm 位于 ComM 与具体总线 Nm 之间，聚合多个通道的网络状态。PN 协调器状态由 Nm 维护。

7 API 服务

7.1 初始化 / 关闭

void Nm_Init(void)：初始化。
void Nm_DeInit(void)：去初始化。

7.2 网络模式

Std_ReturnType Nm_NetworkRequest(NetworkHandleType NetworkHandle)：网络请求。
Std_ReturnType Nm_NetworkRelease(NetworkHandleType NetworkHandle)：网络释放。
Std_ReturnType Nm_PassiveStartUp(NetworkHandleType NetworkHandle)：被动启动。
Std_ReturnType Nm_CheckRemoteSleepIndication(NetworkHandleType NetworkHandle, boolean* NmRemoteSleepIndPtr)：检查远程睡眠指示。

7.3 状态查询

Std_ReturnType Nm_GetState(NetworkHandleType NetworkHandle, Nm_StateType* NmStatePtr, Nm_ModeType* NmModePtr)：获取 NM 状态与模式。

7.4 PN 协调

Std_ReturnType Nm_ConfirmPnAvailability(NetworkHandleType NetworkHandle)：确认 PN 可用。
Std_ReturnType Nm_DisableCommunication(NetworkHandleType NetworkHandle)：禁用通信。

7.5 回调（来自具体总线 Nm）

void Nm_NetworkMode(NetworkHandleType NetworkHandle)：网络模式指示。
void Nm_PrepareBusSleepMode(NetworkHandleType NetworkHandle)：准备睡眠模式指示。
void Nm_BusSleepMode(NetworkHandleType NetworkHandle)：总线睡眠模式指示。
void Nm_RemoteSleepIndication(NetworkHandleType NetworkHandle)：远程睡眠指示。
void Nm_RemoteSleepCancellation(NetworkHandleType NetworkHandle)：远程睡眠取消指示。
void Nm_MainFunction(NetworkHandleType NetworkHandle)：周期性主函数（来自具体总线 Nm 的实例）。

7.6 MainFunction

void Nm_MainFunction(void)：周期性主函数。

8 配置

Nm 配置类：

• NmChannelConfig：通道配置（关联 ComM NetworkHandle / 具体总线 Nm）；
• NmPnConfig：部分网络配置；
• NmGeneralConfig：全局配置。

9 错误处理

9.1 开发错误

NM_E_UNINIT：模块未初始化。
NM_E_PARAM_POINTER：参数指针为空。
NM_E_PARAM：参数无效。
NM_E_INV_NETWORK_HANDLE：网络句柄无效。

9.2 运行时错误

NM_E_BUSY：模块忙。