P1 batch translation: 94 PDFs (Communication + Diagnostics + SystemServices + MCAL)
This commit is contained in:
opencode-translator
@@ -0,0 +1,176 @@
|
||||
# 转换器通用规范
|
||||
|
||||
## 元信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
|------|------|
|
||||
| 文档标题（中文） | 转换器通用规范 |
|
||||
| 文档标题（英文） | 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 等）。
|
||||
Reference in New Issue
Block a user