P1 batch translation: 94 PDFs (Communication + Diagnostics + SystemServices + MCAL)

2026-06-13 00:29:54 +08:00
parent 0d470d1f17
commit 6f293acbf7
95 changed files with 70811 additions and 83 deletions
@@ -0,0 +1,284 @@
+# E2E 转换器规范 (Specification of Module E2E Transformer)
+
+> **AUTOSAR CP Release 4.4.0**
+> **文档 ID 650: AUTOSAR_SWS_E2ETransformer**
+
+## 元信息
+
+| 项目 | 内容 |
+| --- | --- |
+| 文档标题 | E2E 转换器规范 |
+| 文档所有者 | AUTOSAR |
+| 文档责任方 | AUTOSAR |
+| 文档标识号 | 650 |
+| 文档状态 | Final |
+| 所属 AUTOSAR 标准 | Classic Platform |
+| 所属标准版本 | 4.4.0 |
+
+## 文档变更历史
+
+| 日期 | 版本 | 变更方 | 变更说明 |
+| --- | --- | --- | --- |
+| 2018-10-31 | 4.4.0 | AUTOSAR Release Management | E2E Profile P22 和 P44 支持 |
+| 2017-12-08 | 4.3.1 | AUTOSAR Release Management | 修正/澄清 |
+| 2016-11-30 | 4.3.0 | AUTOSAR Release Management | 增加更多 E2E Profile 支持 |
+| 2015-07-31 | 4.2.2 | AUTOSAR Release Management | 初始正式版本 |
+
+---
+
+## 目录
+
+- [1. 介绍](#1-介绍)
+- [2. 缩略语](#2-缩略语)
+- [3. 相关文档](#3-相关文档)
+- [4. 约束与假设](#4-约束与假设)
+- [5. 与其他模块的依赖](#5-与其他模块的依赖)
+- [6. 需求可追溯性](#6-需求可追溯性)
+- [7. 功能规范](#7-功能规范)
+- [8. API 规范](#8-api-规范)
+- [9. 配置规范](#9-配置规范)
+
+---
+
+## 1. 介绍
+
+E2E 转换器负责保护安全相关的数据元素。它由 RTE 调用。在发送端,E2E 转换器对数据进行 E2E 保护。在接收端,E2E 转换器对数据进行 E2E 检查,并通过 RTE 将检查结果提供给 SWC。
+
+E2E 转换器是一种特殊类型的转换器,使用 E2E Library 提供的功能。
+
+---
+
+## 2. 缩略语
+
+| 缩略语 | 描述 |
+| --- | --- |
+| API | Application Programming Interface |
+| AUTOSAR | Automotive Open System Architecture |
+| BSW | Basic Software |
+| ComM | Communication Manager |
+| CRC | Cyclic Redundancy Check |
+| DET | Default Error Tracer |
+| E2E | End-to-End |
+| E2EXf | E2E Transformer |
+| ECU | Electronic Control Unit |
+| ISignal | Inter-ECU Signal |
+| LCfg | Link-time Configuration |
+| PBCfg | Post-build Configuration |
+| RTE | Runtime Environment |
+| SDU | Service Data Unit |
+| SWC | Software Component |
+
+---
+
+## 3. 相关文档
+
+### 3.1 输入文档
+
+- [1] List of Basic Software Modules
+- [2] Layered Software Architecture
+- [3] General Specification of Basic Software Modules
+- [4] Specification of Standard Types
+- [5] Specification of E2E Library
+- [6] Specification of RTE
+- [7] System Template
+- [8] Specification of Communication Stack Types
+- [9] AUTOSAR Specification of Transformer General
+- [10] Specification of COM Based Transformer
+- [11] Software Component Template
+- [12] Requirements on E2E
+
+### 3.2 相关标准
+无。
+
+### 3.3 相关规范
+
+AUTOSAR SWS BSW General [3] 适用。
+
+---
+
+## 4. 约束与假设
+
+### 4.1 限制
+
+E2E 转换器是无状态的(状态在调用者维护)。
+
+### 4.2 适用车域
+
+E2E 转换器适用于安全相关通信。
+
+---
+
+## 5. 与其他模块的依赖
+
+E2E 转换器依赖 E2E Library。E2E Library 提供数据类型和虚拟(无状态)函数。E2E 转换器执行 E2E Library 例程,传递配置和状态作为函数参数。
+
+### 5.1 支持的配置变体
+
+本文档规定两种配置变体:
+1. **Link-time**:链接时配置
+2. **Post-build-selectable**:后构建可选
+
+二者很相似,数据结构相同。Link-time 仅实例化一次,Post-build-selectable 可多次实例化(值不同)。配置结构驻留在不同文件中(LCfg vs. PBCfg)。
+
+目前无除 BSW General 和 ASWS TransformerGeneral 之外的显式 Pre-compile 时间配置设置。
+
+---
+
+## 6. 需求可追溯性
+
+| 需求 ID | 描述 | 满足者 |
+| --- | --- | --- |
+| SRS_BSW_00159 | 工具配置支持 | SWS_E2EXf_00156 |
+| SRS_E2E_08528 | E2E Library 应提供 E2E profile | SWS_E2EXf_00158, SWS_E2EXf_00159 |
+| SRS_E2E_08538 | 应提供 E2E 转换器 | SWS_E2EXf_00009 ~ SWS_E2EXf_00164 |
+
+> **[摘要]** 完整需求追溯表见原文 PDF 第 11 页。
+
+---
+
+## 7. 功能规范
+
+E2E 转换器负责保护安全相关数据元素。它由 RTE 调用。发送端 E2E 保护数据;接收端 E2E 检查数据,通过 RTE 将结果传给 SW-C。
+
+如接收 SWC 不读取转换器返回码,数据是否在总线上 E2E 保护对 SWC 完全透明。
+
+- **[SWS_E2EXf_00161]** ⌈本文档定义的 E2E 转换器在以下条件下使用:
+  1. TransformationTechnology 的 protocol 属性 = E2E
+  2. version 属性 = 1.0.0
+  3. transformerClass 属性 = safety⌋ (SRS_E2E_08538)
+
+### 7.1 支持的 RTE 函数
+
+目前支持以下 inter-ECU 通信函数:
+1. Rte_Write/Rte_Read
+2. Rte_IWrite/Rte_IRead
+3. Rte_Send/Rte_Receive
+
+未来将扩展到 client/server 函数。
+
+### 7.2 受 E2E 保护的函数和数据命名
+
+E2E 转换器函数和结构使用 `<transformerId>` 后缀。该模式定义为每个转换器函数的唯一 ID。
+
+### 7.3 配置三阶段
+
+- **EndToEndTransformationDescription**:定义 E2E 配置 profile,对多个 ISignal 有效
+- **EndToEndTransformationISignalProps**:定义特定引用 ISignal 的配置选项
+- **EndToEndTransformationComSpecProps**:定义 port 的覆盖配置选项
+
+- **[SWS_E2EXf_00134]** ⌈EndToEndTransformationComSpecProps 中的配置选项应优先于 EndToEndTransformationDescription 和 EndToEndTransformationISignalProps。⌋ (SRS_E2E_08538)
+
+- **[SWS_E2EXf_00154]** ⌈如 EndToEndTransformationComSpecProps.disableEndToEndCheck 为某 transformerId 设置,E2E 转换器应跳过 E2E Library 调用。⌋
+
+### 7.4 支持的 E2E Profile
+
+E2E 转换器支持以下 E2E Profile:
+- Profile 01 (P01) — 8 位 CRC, CounterOffset
+- Profile 02 (P02) — 8 位 CRC, DataID rotation
+- Profile 04 (P04) — 32 位 CRC + 长度,源 ID
+- Profile 05 (P05) — 16 位 CRC, DataID
+- Profile 06 (P06) — 16 位 CRC + 长度
+- Profile 07 (P07) — 64 位 CRC, ARXML 描述
+- Profile 11 (P11) — 8 位 CRC, DataID
+- Profile 22 (P22) — 8 位 CRC + nibble
+- Profile 44 (P44) — 32 位 CRC + 长度,无源 ID
+
+### 7.5 状态管理
+
+E2E 转换器无状态(状态在内部静态变量维护)。每次调用前/后调用 E2E Library 时传入状态。
+
+### 7.6 错误分类
+
+#### 7.6.1 转换器返回码
+
+| 返回码 | 含义 |
+| --- | --- |
+| E_OK | 成功 |
+| E_SAFETY_HARD_RUNTIMEERROR | 严重运行时错误 |
+| E_SAFETY_SOFT_RUNTIMEERROR | 软运行时错误 |
+| E_NOT_OK | 失败 |
+
+#### 7.6.2 开发错误
+
+| 错误名 | 错误码 | 含义 |
+| --- | --- | --- |
+| E2EXF_E_PARAM_POINTER | 0x01 | NULL 指针 |
+| E2EXF_E_INVALID_BUF | 0x02 | 缓冲区无效 |
+
+---
+
+## 8. API 规范
+
+### 8.1 转换器函数
+
+#### 8.1.1 E2EXf_<transformerId>
+
+```c
+uint8 E2EXf_<transformerId>(
+    uint8* buffer,
+    uint32* bufferLength,
+    const <DataType>* dataElement
+)
+```
+
+| 描述 | 发送端 E2E 保护,生成 CRC 等 |
+| --- | --- |
+| 返回 | E_OK / E_SAFETY_* / E_NOT_OK |
+
+#### 8.1.2 E2EXf_Inv_<transformerId>
+
+```c
+uint8 E2EXf_Inv_<transformerId>(
+    const uint8* buffer,
+    uint32 bufferLength,
+    <DataType>* dataElement
+)
+```
+
+| 描述 | 接收端 E2E 检查,验证 CRC 等 |
+| --- | --- |
+
+### 8.2 版本信息
+
+#### 8.2.1 E2EXf_GetVersionInfo
+
+```c
+void E2EXf_GetVersionInfo(Std_VersionInfoType* versioninfo)
+```
+
+---
+
+## 9. 配置规范
+
+### 9.1 配置容器
+
+E2E 转换器无模块特定 ECU 配置,因其全部配置基于:
+- EndToEndTransformationDescription (SystemTemplate)
+- EndToEndTransformationISignalProps
+- EndToEndTransformationComSpecProps
+
+ASWS Transformer General [9] 的通用 ECU 配置足够。
+
+### 9.2 配置示例
+
+#### Profile P01 示例
+```
+profileName: PROFILE_01
+counterOffset: 8
+crcOffset: 0
+dataId: 0x123
+dataIdMode: E2E_P01_DATAID_BOTH
+dataLength: 64
+maxDeltaCounterInit: 1
+maxNoNewOrRepeatedData: 15
+syncCounterInit: 0
+```
+
+> **[摘要]** 完整配置详见原文 PDF 第 38-44 页。
+
+---
+
+## 翻译说明
+
+- 本译本基于 AUTOSAR CP 4.4.0 的 E2E 转换器规范 (Document ID 650,共 44 页)
+- 摘要标记位置:第 6 章需求追溯、第 9 章配置