AUTOSAR_SWS_COMBasedTransformer 中文翻译

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

本翻译覆盖原文档 1-59 页正文。原文为软件规范（SWS），定义 ComBasedTransformer 模块的 API、配置、错误处理——基于 COM 的 Transformer。

1 引言与范围

ComBasedTransformer（基于 COM 的 Transformer）是 Transformer 链中的一种，实现 COM 信号 ↔ PDU 字节的转换。它在发送方向将 COM 信号打包成 PDU 字节流；在接收方向将 PDU 字节流解包为 COM 信号。

2 缩略语

ComBasedTransformer / COM / Signal / Signal Group / I-PDU / PduR / Transformer Chain / GenericTransformerInterface

3 相关文档

[1] AUTOSAR ASWS Transformer General
[2] AUTOSAR SWS COM
[3] AUTOSAR SRS Transformer

4 约束与假设

ComBasedTransformer 应：

• 实现通用 Transformer 接口（Transformer_Init / Transform / InvTransform）；
• 作为 COM 模块的扩展；
• 支持静态配置（编译时）。

5 依赖其他模块

ComBasedTransformer 依赖：COM（信号/I-PDU 访问）/ PduR（PDU 路由）/ RTE（数据源）。

6 功能规格

6.1 架构

ComBasedTransformer 与 COM 模块协同工作：COM 负责信号打包（信号→PDU 字节），ComBasedTransformer 提供通用 Transformer 接口以接入 Transformer 链。

7 API 服务

7.1 初始化 / 关闭

void ComBasedTransformer_Init(const ComBasedTransformer_ConfigType* ConfigPtr)：初始化。
void ComBasedTransformer_DeInit(void)：去初始化。

7.2 转换服务

Std_ReturnType ComBasedTransformer_Transform(Transformer_ChannelType Channel, const void* Buffer, uint32 BufferLength)：将应用数据转换为 PDU 字节。
Std_ReturnType ComBasedTransformer_InvTransform(Transformer_ChannelType Channel, const void* Buffer, uint32 BufferLength)：将 PDU 字节转换为应用数据。

7.3 长度查询

uint32 ComBasedTransformer_GetLength(Transformer_ChannelType Channel)：获取转换后 PDU 长度。

8 配置

ComBasedTransformer 配置类：

• ComBasedTransformerChannel：转换通道（关联 COM Signal Group 与 PDU）；
• ComBasedTransformerBuffer：缓冲区配置（Pre-allocated / Dynamic）；
• ComBasedTransformerConfig：模块配置。

9 错误处理

9.1 开发错误

COMBASEDTRANSFORMER_E_UNINIT：模块未初始化。
COMBASEDTRANSFORMER_E_PARAM_POINTER：参数指针为空。
COMBASEDTRANSFORMER_E_PARAM：参数无效。

9.2 运行时错误

COMBASEDTRANSFORMER_E_BUSY：模块忙。
COMBASEDTRANSFORMER_E_BUFFER_OVERFLOW：缓冲区溢出。