AUTOSAR_SWS_LINNetworkManagement 中文翻译

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

本翻译覆盖原文档 1-53 页正文。原文为软件规范（SWS），定义 LIN Network Management（LinNm）模块的 API、配置、错误处理。

1 引言与范围

LIN Network Management（LinNm）实现 LIN 网络管理协议，符合 LIN NM 规范（基于 ISO 17987）。提供节点状态监控、睡眠协调、PN（部分网络）等服务。

2 缩略语

LinNm / NM / LIN NM / BusSleep / PrepareBusSleep / Network / RepeatMessage / NAD / PN / PN-C / PN-R

3 相关文档

[1] AUTOSAR SWS Nm
[2] AUTOSAR SWS ComM
[3] AUTOSAR SWS LIN Interface
[4] ISO 17987:2016

4 约束与假设

LinNm 应：

• 符合 LIN NM 规范；
• 支持 NM 状态机（BusSleep/PrepareBusSleep/Network/RepeatMessage）；
• 支持 PN；
• 支持周期性 NM 报文；
• 支持多通道。

5 依赖其他模块

LinNm 依赖：Nm（通用网络管理接口）/ ComM（模式请求）/ LinIf（LIN 接口）。

6 功能规格

6.1 NM 状态机

LinNm 状态机：

• BusSleep：总线睡眠；
• PrepareBusSleep：准备睡眠；
• Network：网络运行；
• RepeatMessage：重复消息（发送唤醒/命令）。

6.2 PN（部分网络）

LinNm 支持 PN 协调器（NmCoordinator）状态：

• PN 学习：节点 PN 索引；
• PN 请求：请求特定 PN；
• PN 释放：释放 PN；
• PN 滤波：丢弃非本节点 PN 报文。

7 API 服务

7.1 初始化 / 关闭

void LinNm_Init(const LinNm_ConfigType* ConfigPtr)：初始化。
void LinNm_DeInit(void)：去初始化。

7.2 网络模式

Std_ReturnType LinNm_NetworkRequest(NetworkHandleType NetworkHandle)：网络请求（启动）。
Std_ReturnType LinNm_NetworkRelease(NetworkHandleType NetworkHandle)：网络释放。
Std_ReturnType LinNm_PassiveStartUp(NetworkHandleType NetworkHandle)：被动启动。
Std_ReturnType LinNm_CheckRemoteSleepIndication(NetworkHandleType NetworkHandle, boolean* NmRemoteSleepIndPtr)：检查远程睡眠指示。

7.3 状态查询

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

7.4 回调

void LinNm_SoAdIfTxConfirmation(PduIdType TxPduId, Std_ReturnType Result)：发送确认。
void LinNm_SoAdIfRxIndication(PduIdType RxPduId, const PduInfoType* PduInfoPtr)：接收指示。
void LinNm_TxTimeoutException(NetworkHandleType NetworkHandle)：发送超时异常。

8 配置

LinNm 配置类：

• LinNmChannelConfig：通道配置（NM 报文 ID、周期）；
• LinNmPnConfig：部分网络配置；
• LinNmConfig：模块配置。

9 错误处理

9.1 开发错误

LINNM_E_UNINIT：模块未初始化。
LINNM_E_PARAM_POINTER：参数指针为空。
LINNM_E_PARAM：参数无效。
LINNM_E_INV_NETWORK_HANDLE：网络句柄无效。

9.2 运行时错误

LINNM_E_BUSY：模块忙。