Files
autosar_standard_spec_v4.4/Communication/AUTOSAR_SWS_LargeDataCOM.md
T

6.2 KiB

大数据 COM 规范 (Specification of Large Data COM)

AUTOSAR CP Release 4.4.0 文档 ID 873: AUTOSAR_SWS_LargeDataCOM

元信息

项目 内容
文档标题 大数据 COM 规范 (Specification of LdCom)
文档所有者 AUTOSAR
文档责任方 AUTOSAR
文档标识号 873
文档状态 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 引入 LdCom

目录


1. 介绍

本规范规定了 AUTOSAR 基础软件模块 LdCom(大数据 COM)的功能、API 和配置。

LdCom 提供了在 SOME/IP-TP、CAN-TP 等大型消息上的 COM 替代方案,绕过 COM 的信号处理,直接在 RTE 和 PduR 之间传输大字节数组。

主要用途:

  • 包含 transformer 链(E2E、SOMEIP、COM)生成的 byte 数组的大型 PDU
  • 透明的传输

2. 缩略语

缩略语 描述
API Application Programming Interface
BSW Basic Software
COM Communication
DET Default Error Tracer
LdCom Large Data Communication
PDU Protocol Data Unit
PduR PDU Router
RTE Runtime Environment
SDU Service Data Unit
SW-C Software Component
TP Transport Protocol

3. 相关文档

  • [1] Layered Software Architecture
  • [2] General Requirements on Basic Software Modules
  • [3] Specification of RTE
  • [4] Specification of PDU Router
  • [5] Specification of Communication Stack Types
  • [6] General Specification of Basic Software Modules

4. 约束与假设

4.1 限制

LdCom 不支持信号级处理,仅按字节数组传输。

4.2 适用车域

适用于所有车域。


5. 与其他模块的依赖

  • RTE:LdCom 上层客户端
  • PduR:下层路由

6. 需求可追溯性

需求 ID 描述 满足者
SRS_BSW_00101 初始化 SWS_LdCom_00010
SRS_BSW_00407 版本信息 SWS_LdCom_00020
SRS_LDCom_00001 大数据传输 SWS_LdCom_00030

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


7. 功能规范

7.1 概述

LdCom 在 RTE 和 PduR 之间提供透明的 SDU 传输。

7.2 发送

  • RTE 通过 LdCom_Transmit 调用,传递 PDU ID 和数据
  • LdCom 调用 PduR_LdComTransmit 转发
  • 成功后 PduR 调用 LdCom_TxConfirmation
  • LdCom 通知 RTE

7.3 接收

  • PduR 调用 LdCom_RxIndication
  • LdCom 通知 RTE

7.4 TP 处理

对 TP 模块,LdCom 处理 StartOfReception/CopyRxData/CopyTxData/TpRxIndication/TpTxConfirmation。

7.5 错误分类

7.5.1 开发错误

错误名 错误码 含义
LDCOM_E_PARAM 0x01 参数错误
LDCOM_E_UNINIT 0x02 未初始化
LDCOM_E_PARAM_POINTER 0x03 NULL 指针

8. API 规范

8.1 导入类型

模块 头文件 导入类型
ComStack_Types ComStack_Types.h PduIdType, PduInfoType, RetryInfoType, BufReq_ReturnType
Std_Types Std_Types.h Std_ReturnType, Std_VersionInfoType

8.2 类型定义

8.2.1 LdCom_ConfigType

typedef struct LdCom_ConfigType LdCom_ConfigType;

8.3 函数定义

8.3.1 LdCom_Init

void LdCom_Init(const LdCom_ConfigType* config)
Service ID 0x01

8.3.2 LdCom_GetVersionInfo

void LdCom_GetVersionInfo(Std_VersionInfoType* versioninfo)

8.3.3 LdCom_Transmit

Std_ReturnType LdCom_Transmit(
    PduIdType TxPduId,
    const PduInfoType* PduInfoPtr
)
Service ID 0x05
描述 请求传输 SDU

8.4 回调通知

8.4.1 LdCom_RxIndication

void LdCom_RxIndication(
    PduIdType RxPduId,
    const PduInfoType* PduInfoPtr
)

8.4.2 LdCom_TxConfirmation

void LdCom_TxConfirmation(
    PduIdType TxPduId,
    Std_ReturnType result
)

8.4.3 LdCom_TriggerTransmit

Std_ReturnType LdCom_TriggerTransmit(
    PduIdType TxPduId,
    PduInfoType* PduInfoPtr
)

8.4.4 LdCom_StartOfReception

BufReq_ReturnType LdCom_StartOfReception(
    PduIdType id,
    const PduInfoType* info,
    PduLengthType TpSduLength,
    PduLengthType* bufferSizePtr
)

8.4.5 LdCom_CopyRxData

BufReq_ReturnType LdCom_CopyRxData(
    PduIdType id,
    const PduInfoType* info,
    PduLengthType* bufferSizePtr
)

8.4.6 LdCom_TpRxIndication

void LdCom_TpRxIndication(
    PduIdType id,
    Std_ReturnType result
)

8.4.7 LdCom_CopyTxData

BufReq_ReturnType LdCom_CopyTxData(
    PduIdType id,
    const PduInfoType* info,
    const RetryInfoType* retry,
    PduLengthType* availableDataPtr
)

8.4.8 LdCom_TpTxConfirmation

void LdCom_TpTxConfirmation(
    PduIdType id,
    Std_ReturnType result
)

8.5 期望接口

8.5.1 强制接口

  • PduR_LdComTransmit
  • Det_ReportError
  • RTE 回调函数

9. 时序图

[摘要] 详细时序图见原文 PDF 第 30-36 页。


10. 配置规范

10.1 容器与配置参数

10.1.1 LdCom

根容器。

10.1.2 LdComGeneral

参数 类型 说明
LdComDevErrorDetect bool DET 启用
LdComVersionInfoApi bool 版本信息 API

10.1.3 LdComConfig

配置集容器。

10.1.4 LdComIPdu

I-PDU 配置(PDU ID、方向、TP 引用等)。

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

10.2 已发布信息

按 BSW General。


翻译说明

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