7.0 KiB
转换器通用规范
元信息
| 项目 | 内容 |
|---|---|
| 文档标题（中文） | 转换器通用规范 |
| 文档标题（英文） | 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 的支持 - 添加对 DSD 缓冲区的支持 - 添加对钩子函数的更多限制 - 添加对 transformer 链长度的限制 - 添加对字节序的考虑 |
| 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 | - 初始发布 |
目录
- Scope of this document（本文档的范围）
- How to read this document（如何阅读本文档）
- Acronyms and abbreviations（缩略语和缩写）
- Requirements Specification（需求规范）
- 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。
翻译过程中遵循以下原则：
- 保留了所有 API 标识符、模块缩写、协议名（如 Transformer、RTE、PduR、E2E、SOME/IP、COM、DSD、DDM 等）
- 保留了所有需求 ID（以 ASWS 标记）
- 保留了 AUTOSAR 方框符
⌈⌋ - 保留了所有 AUTOSAR 文档间交叉引用
- 表格内容、章节描述、需求说明均已翻译为中文
注：本文档是 ASWS（高级软件规范）文档，与 SRS（软件需求规范）配合使用，描述转换器的功能规格。完整内容请参考原文 PDF 文档以及相关的 SWS 规范（SWS_COMBasedTransformer、SWS_SOMEIPTransformer、SWS_E2ETransformer 等）。