6.2 KiB
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 章配置