Files
autosar_standard_spec_v4.4/Communication/AUTOSAR_SWS_COMBasedTransformer.md
T

6.6 KiB

COM 转换器规范 (Specification of COM Based Transformer)

AUTOSAR CP Release 4.4.0 文档 ID 662: AUTOSAR_SWS_COMBasedTransformer

元信息

项目 内容
文档标题 COM 转换器规范 (Specification of COM Based Transformer)
文档所有者 AUTOSAR
文档责任方 AUTOSAR
文档标识号 662
文档状态 Final
所属 AUTOSAR 标准 Classic Platform
所属标准版本 4.4.0

文档变更历史

日期 版本 变更方 变更说明
2018-10-31 4.4.0 AUTOSAR Release Management 字节序处理改进
2017-12-08 4.3.1 AUTOSAR Release Management 修正/澄清
2016-11-30 4.3.0 AUTOSAR Release Management 数据映射增强
2015-07-31 4.2.2 AUTOSAR Release Management 编辑修正
2014-10-31 4.2.1 AUTOSAR Release Management 初始正式版本

目录


1. 介绍

本规范规定了 COM 转换器 的功能、API 和配置。COM 转换器是 AUTOSAR Transformer 概念的一部分,用于将 SWC 数据序列化为 uint8 数组,以便通过 COM 模块传输。

1.1 COM 转换器的角色

转换器链将 SWC 数据按需序列化:

  • 发送端:RTE 调用转换器链 → 数据序列化为线性数组 → 传递给 COM
  • 接收端:反向执行 → COM 反序列化 → 还原原始数据结构

从 SWC 视角看,数据是否被转换是完全透明的。


2. 缩略语

缩略语 描述
COM Communication
ComXf COM Based Transformer
CRC Cyclic Redundancy Check
DET Default Error Tracer
E2E End-to-End
IPdu Interaction Layer PDU
RTE Runtime Environment
SDU Service Data Unit
SWC Software Component
TMS Transmission Mode Selection

3. 相关文档

3.1 输入文档

  • [1] Layered Software Architecture
  • [2] General Requirements on Basic Software Modules
  • [3] Specification of RTE
  • [4] Specification of SW-C End-to-End Communication Protection Library
  • [5] Specification of Communication
  • [6] ASW Specification of Transformer General
  • [7] System Template
  • [8] Requirements on Communication
  • [9] Requirements on Transformer
  • [10] Specification of ECU Configuration

4. 约束与假设

4.1 限制

COM 转换器仅适用于由 COM 配置的 ISignalGroup。

4.2 适用车域

适用于所有车域。


5. 与其他模块的依赖

  • RTE:调用 COM 转换器函数
  • COM:接收 uint8 数组并发送

6. 需求可追溯性

需求 ID 描述 满足者
SRS_Xfrm_00009 固定转换器类集 SWS_ComXf_00003
SRS_Xfrm_00011 属于特定转换器类 SWS_ComXf_00003, SWS_ComXf_00006
SRS_Xfrm_00201 序列化原子和结构化数据 SWS_ComXf_00004 ~ SWS_ComXf_00036
SRS_Xfrm_00202 配置来自 COM SWS_ComXf_00005, SWS_ComXf_00020
SRS_BSW_00407 版本信息 SWS_ComXf_00024, SWS_ComXf_00026, SWS_ComXf_00027
SRS_BSW_00411 API 启用/禁用命名 SWS_ComXf_00024
SRS_BSW_00441 命名约定 SWS_ComXf_00030

[摘要] 完整需求追溯表见原文 PDF 第 10-12 页。


7. 功能规范

7.1 概述

SWC 发起 inter-ECU 通信时,RTE 执行转换器链(含 COM 转换器,如配置要求)。

发送端流程:

  1. SWC 调用 Rte_Write_a {x, y, z}
  2. 数据基于 System Description 序列化
  3. 其他 Transformer 添加信息(如头/尾、CRC)
  4. 一个大的 uint8 数组
  5. 一次调用 Com_SendSignalGroupArray()
  6. COM 分析 uint8 数组基于 TMS(Transmission Mode Selection)
  7. IPdu 通过通信栈发送

7.2 数据映射

COM 转换器基于 ComSignalGroup 中的数据映射进行序列化。

  • [SWS_ComXf_00003] ⌈COM 转换器属于 transformer class "Serializer"。⌋
  • [SWS_ComXf_00004] ⌈COM 转换器应基于数据映射序列化。⌋
  • [SWS_ComXf_00005] ⌈配置应来自 COM。⌋

7.3 数据类型支持

7.3.1 原子数据类型

  • bool, uint8, uint16, uint32, uint64
  • sint8, sint16, sint32, sint64
  • float32, float64

7.3.2 字节序处理

  • [SWS_ComXf_00011] ⌈大端字节序数据应按大端序列化。⌋
  • [SWS_ComXf_00012] ⌈小端字节序数据应按小端序列化。⌋

7.3.3 结构化数据

  • 数组、结构体
  • 嵌套结构体支持

7.4 错误分类

7.4.1 开发错误

错误名 错误码 含义
COMXF_E_PARAM_POINTER 0x01 NULL 指针
COMXF_E_INVALID_BUF 0x02 缓冲区无效

7.4.2 运行时错误

错误名 含义
COMXF_E_BUFFER_TOO_SMALL 缓冲区不足

8. API 规范

8.1 序列化 API

8.1.1 Com__

uint8 Com_<TransformerId>_<ISignalGroupName>(
    uint8* buffer,
    uint32* bufferLength,
    const <DataType>* dataElement
)
Service ID 实现特定
Sync/Async Synchronous
描述 序列化 SWC 数据为 uint8 数组

返回:

  • E_OK:成功
  • E_NOT_OK:失败
  • E_SAFETY_*:E2E 转换器返回的码

8.2 反序列化 API

8.2.1 Com_Inv__

uint8 Com_Inv_<TransformerId>_<ISignalGroupName>(
    const uint8* buffer,
    uint32 bufferLength,
    <DataType>* dataElement
)
Service ID 实现特定
描述 反序列化 uint8 数组为 SWC 数据

8.3 版本信息

8.3.1 ComXf_GetVersionInfo

void ComXf_GetVersionInfo(Std_VersionInfoType* versioninfo)

9. 时序图

[摘要] 详细时序图见原文 PDF 第 35-45 页:发送和接收时序、与 E2E 转换器的协作等。


10. 配置规范

10.1 容器与配置参数

10.1.1 ComXf

根容器。

10.1.2 ComXfGeneral

参数 类型 说明
ComXfDevErrorDetect bool DET 启用
ComXfVersionInfoApi bool 版本信息 API
ComXfMainFunctionPeriod float 周期

10.2 信号组配置

由 COM 提供。每个 ISignalGroup 含 ComSignalGroupTransformation 引用 DataTransformation。

[摘要] 完整配置详见原文 PDF 第 50-58 页。


翻译说明

  • 本译本基于 AUTOSAR CP 4.4.0 的 COM 转换器规范 (Document ID 662,共 59 页)
  • 摘要标记位置:第 6 章需求追溯、第 9 章时序图、第 10 章配置