AUTOSAR_SWS_SOMEIPTransformer 中文翻译

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

本翻译覆盖原文档 1-100 页正文。原文为软件规范（SWS），定义 SOME/IP Transformer 模块的 API、配置、错误处理。R4.4 增强：扩展序列化（Extended Serialization）支持 TLV 编码（Tag/Length/Value）。

1 引言与范围

SOME/IP Transformer 实现 SOME/IP 序列化/反序列化。位于 PduR 与 SOME/IP 应用程序之间。R4.2 起合并了原 SOME/IP TP 模块功能，R4.4 增强 TLV 编码。

2 缩略语

SOME/IP / TP / SD / SoAd / UDP / TCP / TLV / Tag / Length / Value / Alignment / Padding / Endianness / String / Array / Struct / Union

3 相关文档

[1] AUTOSAR ASWS Transformer General
[2] AUTOSAR SWS ServiceDiscovery
[3] AUTOSAR SWS SocketAdaptor
[4] AUTOSAR RS SOME/IP
[5] AUTOSAR PRS SOME/IP

4 约束与假设

SOME/IP Transformer 应：

• 实现 SOME/IP 序列化/反序列化；
• 支持基本类型（Integer/Float/Boolean/Byte/Word/Long/Dword/String）；
• 支持复杂类型（Array/Struct/Union）；
• 支持 TP 分片/重组（合并原 SOME/IP TP 功能）；
• 支持 TLV 编码（R4.4 扩展）；
• 支持字节序配置；
• 支持动态长度 PDU；
• 支持静态/动态配置。

5 依赖其他模块

SOME/IP Transformer 依赖：SoAd（Socket Adapter）/ TcpIp / PduR（PDU 路由）/ Dem（错误上报）。

6 功能规格

6.1 架构

SOME/IP Transformer 位于 SoAd 之上，RTE 之下。提供：

• 应用数据 → SOME/IP 字节流（序列化）；
• SOME/IP 字节流 → 应用数据（反序列化）；
• 大报文 TP 分片/重组。

6.2 SOME/IP 头部

SOME/IP 头部（16 字节）：

• Service ID（2 字节）；
• Method ID（2 字节）；
• Length（4 字节）：自 Length 字段起至报文结束的字节数；
• Client ID（2 字节）；
• Session ID（2 字节）；
• Interface Version（1 字节）；
• Message Type（1 字节）；
• Return Code（1 字节）。

6.3 TLV 编码（R4.4 增强）

R4.4 引入扩展序列化（Extended Serialization），支持 TLV 编码：

• Tag：标识字段；
• Length：字段长度；
• Value：字段值。

用于在结构体/联合中允许可选字段（Tagged union、Optional member）。

7 API 服务

7.1 初始化 / 关闭

void SomeIpTp_Init(const SomeIpTp_ConfigType* ConfigPtr)：初始化（沿用原 SOME/IP TP 命名）。
void SomeIpTp_DeInit(void)：去初始化。

7.2 转换服务

Std_ReturnType SomeIpTp_Transform(Transformer_ChannelType Channel, const void* Buffer, uint32 BufferLength)：SOME/IP 序列化（应用数据 → PDU 字节流）。
Std_ReturnType SomeIpTp_InvTransform(Transformer_ChannelType Channel, const void* Buffer, uint32 BufferLength)：SOME/IP 反序列化（PDU 字节流 → 应用数据）。

7.3 传输

Std_ReturnType SomeIpTp_Transmit(PduIdType TxPduId, const PduInfoType* PduInfoPtr)：请求传输。
Std_ReturnType SomeIpTp_CancelTransmit(PduIdType TxPduId)：取消传输。

7.4 回调

void SomeIpTp_TxConfirmation(PduIdType TxPduId, Std_ReturnType Result)：发送确认。
void SomeIpTp_RxIndication(PduIdType RxPduId, const PduInfoType* PduInfoPtr, boolean CopyDataDone)：接收指示。

7.5 MainFunction

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

8 配置

SOME/IP Transformer 配置类：

• SomeIpTpConnection：连接配置（Client/Server）；
• SomeIpTpChannel：通道配置（关联到 SoAd Socket）；
• SomeIpTpConfig：模块配置；
• SomeIpTransformationProperties：转换属性配置（Byte Order / Alignment / TLV 启用）。

9 错误处理

9.1 开发错误

SOMEIPTP_E_UNINIT：模块未初始化。
SOMEIPTP_E_PARAM_POINTER：参数指针为空。
SOMEIPTP_E_PARAM：参数无效。

9.2 运行时错误

SOMEIPTP_E_TIMEOUT：连接超时。
SOMEIPTP_E_SEQUENCE：序列错误。
SOMEIPTP_E_MALFORMED_MESSAGE：报文格式错误。