AUTOSAR_SWS_SAEJ1939NetworkManagement 中文翻译

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

本翻译覆盖原文档 1-53 页正文。原文为软件规范（SWS），定义 SAE J1939 Network Management（J1939Nm）模块的 API、配置、错误处理。R4.2.2 起支持无地址声明网络与可靠传输确认（Reliable TxConfirmation）。

1 引言与范围

J1939Nm 模块实现 SAE J1939-81 网络管理协议。提供地址声明（Address Claimed）、命令地址（Commanded Address）、地址竞争处理、网关地址协调（R4.3）等服务。

2 缩略语

J1939Nm / NM / Address Claimed / Commanded Address / NAME / Priority / PGN 0xEE00 / PGN 0xFED8 / CAN / Reliable TxConfirmation / BswM

3 相关文档

[1] AUTOSAR SWS ComM
[2] AUTOSAR SWS Nm
[3] AUTOSAR SWS CAN Interface
[4] AUTOSAR SWS CAN State Manager
[5] SAE J1939-81 / SAE J1939-31

4 约束与假设

J1939Nm 应：

• 实现地址声明机制（Address Claimed）；
• 支持命令地址（Commanded Address）；
• 处理地址竞争（基于 NAME 优先级）；
• 支持无地址声明网络（R4.2.2 新增）；
• 支持 Reliable TxConfirmation（R4.3 起替代超时机制）。

5 依赖其他模块

J1939Nm 依赖：CanIf（CAN 接口）/ ComM（模式请求）/ Nm（通用 NM）/ Dem（错误上报）/ BswM（模式仲裁）。

6 功能规格

6.1 架构

J1939Nm 位于 CanIf 之上，Nm 之下，专门处理 J1939 地址管理。

6.2 地址声明

J1939Nm 启动时通过 Address Claimed 报文（PGN 0xEE00）声明自己的 8 字节 NAME 与 1 字节源地址。NAME 包含：

• Arbitrary Address Capable（22 bit）；
• Industry Group（3 bit）；
• Vehicle System Instance（4 bit）；
• Vehicle System（7 bit）；
• Reserved（1 bit）；
• Function（8 bit）；
• Function Instance（5 bit）；
• ECU Instance（3 bit）；
• Manufacturer Code（11 bit）；
• Identity Number（21 bit）。

NAME 数值越小，优先级越高。

6.3 状态机

J1939Nm 状态机：

• J1939NM_STATE_OFFLINE：离线（未声明地址）；
• J1939NM_STATE_NORMAL：正常（已声明地址）；
• J1939NM_STATE_WAIT_ADDRESS_CLAIM：等待地址声明响应；
• J1939NM_STATE_ADDRESS_CLAIMING：声明中（与更高优先级竞争）；
• J1939NM_STATE_CANNOT_CLAIM_ADDRESS：无法声明地址（使用了别人占用的地址）。

7 API 服务

7.1 初始化 / 关闭

void J1939Nm_Init(const J1939Nm_ConfigType* ConfigPtr)：初始化。
void J1939Nm_DeInit(void)：去初始化。

7.2 网络模式

Std_ReturnType J1939Nm_NetworkRequest(NetworkHandleType NetworkHandle)：网络请求。
Std_ReturnType J1939Nm_NetworkRelease(NetworkHandleType NetworkHandle)：网络释放。
Std_ReturnType J1939Nm_PassiveStartUp(NetworkHandleType NetworkHandle)：被动启动。

7.3 状态查询

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

7.4 回调（来自 CanIf）

void J1939Nm_TxConfirmation(PduIdType TxPduId, Std_ReturnType Result)：发送确认。
void J1939Nm_RxIndication(PduIdType RxPduId, const PduInfoType* PduInfoPtr)：接收指示。

7.5 Reliable TxConfirmation

R4.3 起 J1939Nm 引入可靠传输确认（SetEventStatus 替代 ReportErrorStatus）。

8 配置

J1939Nm 配置类：

• J1939NmChannel：通道配置（源地址、NAME）；
• J1939NmNode：节点配置（地址、ECU 类型）；
• J1939NmConfig：模块配置。

9 错误处理

9.1 开发错误

J1939NM_E_UNINIT：模块未初始化。
J1939NM_E_PARAM_POINTER：参数指针为空。
J1939NM_E_PARAM：参数无效。

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

J1939NM_E_ADDRESS_LOST：地址丢失（被优先级更高节点占用）。
J1939NM_E_CANNOT_CLAIM_ADDRESS：无法声明地址。