AUTOSAR_SWS_UDPNetworkManagement 中文翻译

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

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

1 引言与范围

UDP Network Management（UdpNm）实现基于 UDP 的网络管理。符合 AUTOSAR NM 规范，支持 Partial Networking（PN）、协调器同步、跨 ECU 唤醒、IPv6 等。

2 缩略语

UdpNm / UDP / NM / IPv4 / IPv6 / Multicast / Unicast / BusSleep / PrepareBusSleep / Network / RepeatMessage / CBV / PN / SoAd / TcpIp

3 相关文档

[1] AUTOSAR SWS Nm
[2] AUTOSAR SWS ComM
[3] AUTOSAR SWS Socket Adaptor
[4] AUTOSAR SWS TcpIp
[5] AUTOSAR SRS Network Management

4 约束与假设

UdpNm 应：

• 基于 UDP 协议传输 NM 报文；
• 符合 AUTOSAR NM 规范；
• 支持 Partial Networking；
• 支持 IPv4/IPv6；
• 支持多播 / 单播 NM 报文；
• 支持多通道。

5 依赖其他模块

UdpNm 依赖：Nm（通用 NM 接口）/ ComM（模式请求）/ SoAd / TcpIp（UDP）/ Dem（错误上报）。

6 功能规格

6.1 NM 状态机

UdpNm 状态机与 CanNm 类似：

• BusSleep：总线睡眠；
• PrepareBusSleep：准备睡眠；
• Network：网络运行；
• RepeatMessage：重复消息。

6.2 Partial Networking

UdpNm 支持 PN：

• 学习（节点 PN 索引 PRI/CRI）；
• 请求（PN 协调器）；
• 释放；
• 滤波。

7 API 服务

7.1 初始化 / 关闭

void UdpNm_Init(const UdpNm_ConfigType* ConfigPtr)：初始化。
void UdpNm_DeInit(void)：去初始化。

7.2 网络模式

Std_ReturnType UdpNm_NetworkRequest(NetworkHandleType NetworkHandle)：网络请求。
Std_ReturnType UdpNm_NetworkRelease(NetworkHandleType NetworkHandle)：网络释放。
Std_ReturnType UdpNm_PassiveStartUp(NetworkHandleType NetworkHandle)：被动启动。
Std_ReturnType UdpNm_CheckRemoteSleepIndication(NetworkHandleType NetworkHandle, boolean* NmRemoteSleepIndPtr)：检查远程睡眠指示。

7.3 状态查询

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

7.4 协调器

Std_ReturnType UdpNm_RequestBusSynchronization(NetworkHandleType NetworkHandle)：请求总线同步。

7.5 回调（来自 SoAd）

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

7.6 MainFunction

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

8 配置

UdpNm 配置类：

• UdpNmChannelConfig：通道配置（UDP 端口、TTL、多播地址）；
• UdpNmPnConfig：部分网络配置；
• UdpNmGlobalConfig：全局配置。

9 错误处理

9.1 开发错误

UDPNM_E_UNINIT：模块未初始化。
UDPNM_E_PARAM_POINTER：参数指针为空。
UDPNM_E_PARAM：参数无效。

9.2 运行时错误

UDPNM_E_BUSY：模块忙。