feifei.xu/autosar_standard_spec_v4.4
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
6f293acbf70ce755cc397f46142c440f608e4284
autosar_standard_spec_v4.4/Communication/AUTOSAR_SWS_E2ETransformer.md
T

7.7 KiB
Raw Blame History

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. 介绍

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_

uint8 E2EXf_<transformerId>(
    uint8* buffer,
    uint32* bufferLength,
    const <DataType>* dataElement
)
描述 发送端 E2E 保护,生成 CRC 等
返回 E_OK / E_SAFETY_* / E_NOT_OK

8.1.2 E2EXf_Inv_

uint8 E2EXf_Inv_<transformerId>(
    const uint8* buffer,
    uint32 bufferLength,
    <DataType>* dataElement
)
描述 接收端 E2E 检查,验证 CRC 等

8.2 版本信息

8.2.1 E2EXf_GetVersionInfo

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 章配置
Reference in New Issue View Git Blame Copy Permalink