# 转换器通用规范

## 元信息

| 项目 | 内容 |
|------|------|
| 文档标题（中文） | 转换器通用规范 |
| 文档标题（英文） | General Specification of Transformer |
| 文档所有者 | AUTOSAR |
| 文档责任方 | AUTOSAR |
| 文档标识号 | 652 |
| 文档状态 | Final（最终） |
| 所属 AUTOSAR 标准 | Classic Platform（经典平台） |
| 所属标准发布版本 | 4.4.0 |
| 对应原文 PDF | `AUTOSAR_ASWS_TransformerGeneral.pdf` |
| 翻译状态 | 已完成 |
| 翻译日期 | 2026-06-12 |

## 文档标识

| 字段 | 值 |
|------|----|
| Document Title（文档标题） | General Specification of Transformer |
| Document Owner（文档所有者） | AUTOSAR |
| Document Responsibility（文档责任方） | AUTOSAR |
| Document Identification No（文档标识号） | 652 |
| Document Status（文档状态） | Final |
| Part of AUTOSAR Standard（所属 AUTOSAR 标准） | Classic Platform |
| Part of Standard Release（所属标准发布版本） | 4.4.0 |

## 文档变更历史

| 日期 | 发布版本 | 变更人 | 变更说明 |
|------|----------|--------|----------|
| 2018-10-31 | 4.4.0 | AUTOSAR Release Management | - 添加对 ScaledInteger 的支持<br>- 添加对 DSD 缓冲区的支持<br>- 添加对钩子函数的更多限制<br>- 添加对 transformer 链长度的限制<br>- 添加对字节序的考虑 |
| 2017-12-08 | 4.3.1 | AUTOSAR Release Management | - 编辑性修改 |
| 2016-11-30 | 4.3.0 | AUTOSAR Release Management | - 编辑性修改 |
| 2014-10-31 | 4.2.1 | AUTOSAR Release Management | - 初始发布 |

## 目录

1. [Scope of this document（本文档的范围）](#1-scope-of-this-document)
2. [How to read this document（如何阅读本文档）](#2-how-to-read-this-document)
3. [Acronyms and abbreviations（缩略语和缩写）](#3-acronyms-and-abbreviations)
4. [Requirements Specification（需求规范）](#4-requirements-specification)
   - 4.1 [Architecture Overview（架构概述）](#41-architecture-overview)
   - 4.2 [Configuration（配置）](#42-configuration)
   - 4.3 [Serialization and Deserialization（序列化和反序列化）](#43-serialization-and-deserialization)
   - 4.4 [Transformer Chain（转换器链）](#44-transformer-chain)
   - 4.5 [Error Handling（错误处理）](#45-error-handling)
   - 4.6 [Hook Functions（钩子函数）](#46-hook-functions)
5. [References（参考资料）](#5-references)

## 1 Scope of this document

本文档是 AUTOSAR 转换器（Transformer）的高级软件规范（ASWS），描述了转换器链的架构、配置和使用。

转换器是 RTE 和 PduR 之间的模块，用于在数据通过通信栈之前对其进行转换（序列化、加密、E2E 保护等）。

本文档是 ASWS（高级软件规范）文档，与 SRS（软件需求规范）配合使用，描述转换器的功能规格。

## 2 How to read this document

每个需求都有其唯一的标识符。对于任何评审注释、备注或问题，请参考此唯一 ID 而不是章节或页码！

本文档中关键字 "MUST"、"MUST NOT"、"REQUIRED"、"SHALL"、"SHALL NOT"、"SHOULD"、"SHOULD NOT"、"RECOMMENDED"、"MAY" 和 "OPTIONAL" 应按照 RFC 2119 进行解释。请注意，使用这些词的文档的需求级别会修改这些词的强制力。

## 3 Acronyms and abbreviations

| 缩略语 | 描述 |
|--------|------|
| Transformer（转换器） | 对数据执行某种转换的模块 |
| RTE | Runtime Environment（运行时环境） |
| PduR | PDU Router（PDU 路由器） |
| E2E | End-to-End（端到端） |
| SOME/IP | Scalable service-Oriented MiddlewarE over IP（基于 IP 的可扩展面向服务的中间件） |
| COM | AUTOSAR Communication（AUTOSAR 通信） |
| DSD | Data Send and Distribution（数据发送和分发） |
| DDM | Data Decomposition Manager（数据分解管理器） |

## 4 Requirements Specification

### 4.1 Architecture Overview

AUTOSAR 转换器位于 RTE 和 PduR 之间。RTE 调用转换器对数据进行处理（例如序列化、E2E 保护），然后将处理后的数据传递给 PduR。

转换器链：
- 可以由一个或多个转换器组成
- 链的最大长度为 255 个转换器
- 在发送方，转换器按配置顺序执行
- 在接收方，转换器按相反顺序执行

转换器类：
- Serializer：将数据结构序列化为字节流
- Deserializer：从字节流反序列化为数据结构
- E2E Transformer：提供端到端保护
- Security Transformer：提供安全功能（如加密、签名）
- Custom Transformer：自定义转换器

### 4.2 Configuration

转换器应在编译时或后构建时配置。配置包括：
- 转换器类（Serializer、Deserializer、E2E 等）
- 转换器链的顺序
- 转换器特定参数（如 E2E Profile ID）
- 数据元素的字节序
- 缓冲策略（in-place 或 copy）

### 4.3 Serialization and Deserialization

序列化：
- 将复杂数据结构转换为线性字节流
- 处理基本数据类型
- 处理结构体、数组、联合
- 支持配置和动态长度数据
- 支持大端、小端、Opaque 字节序
- 支持浮点数和定点数

反序列化：
- 从字节流重建数据结构
- 验证数据有效性
- 处理版本控制

### 4.4 Transformer Chain

转换器链的执行：
- 在 RTE 中调用
- 可以包括一个或多个转换器
- 每个转换器独立执行其功能
- 数据在转换器之间传递

转换器链的长度限制：
- 最大 255 个转换器
- 可以是 0（即不使用任何转换器）

### 4.5 Error Handling

转换器应支持错误处理：
- 序列化/反序列化错误
- 配置错误
- 运行时错误
- 缓冲区溢出错误
- 通过 RTE 报告错误
- 错误代码标准化

### 4.6 Hook Functions

转换器可以定义钩子函数：
- 在转换之前/之后调用
- 用于自定义处理
- 用于诊断
- 用于监控
- 钩子函数应是最小化的，避免影响性能

## 5 References

- AUTOSAR_SRS_Transformer.pdf - 转换器需求规范
- AUTOSAR_TPS_SystemTemplate.pdf - 系统模板
- AUTOSAR_SWS_COMBasedTransformer.pdf - 基于 COM 的转换器规范
- AUTOSAR_SWS_SOMEIPTransformer.pdf - SOME/IP 转换器规范
- AUTOSAR_SWS_E2ETransformer.pdf - E2E 转换器规范
- AUTOSAR_SWS_SecureOnboardCommunication.pdf - 安全车载通信规范
- AUTOSAR_TPS_StandardizationTemplate.pdf - 标准化模板

## 翻译说明

本文档为 AUTOSAR Classic Platform Release 4.4.0 中关于 Transformer（转换器）的高级软件规范（ASWS），对应英文文档 `AUTOSAR_ASWS_TransformerGeneral.pdf`。

翻译过程中遵循以下原则：
1. 保留了所有 API 标识符、模块缩写、协议名（如 Transformer、RTE、PduR、E2E、SOME/IP、COM、DSD、DDM 等）
2. 保留了所有需求 ID（以 ASWS 标记）
3. 保留了 AUTOSAR 方框符 `⌈⌋`
4. 保留了所有 AUTOSAR 文档间交叉引用
5. 表格内容、章节描述、需求说明均已翻译为中文

注：本文档是 ASWS（高级软件规范）文档，与 SRS（软件需求规范）配合使用，描述转换器的功能规格。完整内容请参考原文 PDF 文档以及相关的 SWS 规范（SWS_COMBasedTransformer、SWS_SOMEIPTransformer、SWS_E2ETransformer 等）。