# V2X 基础传输规范 (Specification of V2X Basic Transport)

> **AUTOSAR CP Release 4.4.0**
> **文档 ID 797: AUTOSAR_SWS_V2XBasicTransport**

## 元信息

| 项目 | 内容 |
| --- | --- |
| 文档标题 | V2X 基础传输规范 |
| 文档所有者 | AUTOSAR |
| 文档责任方 | AUTOSAR |
| 文档标识号 | 797 |
| 文档状态 | 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 | 引入 V2X BTP |

---

## 目录

- [1. 介绍](#1-介绍)
- [2. 缩略语](#2-缩略语)
- [3. 相关文档](#3-相关文档)
- [4. 约束与假设](#4-约束与假设)
- [5. 与其他模块的依赖](#5-与其他模块的依赖)
- [6. 需求可追溯性](#6-需求可追溯性)
- [7. 功能规范](#7-功能规范)
- [8. API 规范](#8-api-规范)
- [9. 配置规范](#9-配置规范)

---

## 1. 介绍

本规范规定了 AUTOSAR 基础软件模块 **V2X 基础传输** (V2xBtp) 的功能、API 和配置。

V2xBtp 实现 ETSI ITS 协议栈中的 **基础传输协议 (Basic Transport Protocol, BTP)**(ETSI EN 302 636-5-1),为上层设施层提供面向连接和无连接的传输服务。

### 1.1 BTP 类型
- **BTP-A**:面向连接(有 destination port info)
- **BTP-B**:无连接(broadcast/multicast 主要使用)

---

## 2. 缩略语

| 缩略语 | 描述 |
| --- | --- |
| BSW | Basic Software |
| BTP | Basic Transport Protocol |
| DET | Default Error Tracer |
| ETSI | European Telecommunications Standards Institute |
| GN | GeoNetworking |
| V2X | Vehicle-to-everything |
| V2xBtp | V2X Basic Transport |
| V2xFac | V2X Facilities |
| V2xGn | V2X GeoNetworking |

---

## 3. 相关文档

### 3.1 输入文档

- [1] Layered Software Architecture
- [2] General Specification of Basic Software Modules
- [3] Requirements on V2X
- [4] Specification of V2X GeoNetworking
- [5] Specification of V2X Facilities

### 3.2 相关标准

- [6] ETSI EN 302 636-5-1 V2.1.0:BTP 规范

---

## 4. 约束与假设

### 4.1 限制
V2xBtp 实现 ETSI BTP Release 1。

### 4.2 适用车域
V2X 应用。

---

## 5. 与其他模块的依赖

| 模块 | 依赖关系 |
| --- | --- |
| V2xFac | 上层设施 |
| V2xGn | 下层 GeoNetworking |
| Det | 错误上报 |

---

## 6. 需求可追溯性

| 需求 ID | 描述 | 满足者 |
| --- | --- | --- |
| SRS_BSW_00101 | 初始化 | SWS_V2xBtp_00010 |
| SRS_BSW_00407 | 版本信息 | SWS_V2xBtp_00020 |
| SRS_V2X_00001 | BTP 协议 | SWS_V2xBtp_00030 |

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

---

## 7. 功能规范

### 7.1 BTP 头部

#### BTP-A 头部 (4 字节)
| 字段 | 大小 | 含义 |
| --- | --- | --- |
| Destination Port | 2 字节 | 目的端口 |
| Source Port | 2 字节 | 源端口 |

#### BTP-B 头部 (4 字节)
| 字段 | 大小 | 含义 |
| --- | --- | --- |
| Destination Port | 2 字节 | 目的端口 |
| Destination Port Info | 2 字节 | 目的端口信息 |

### 7.2 标准 BTP 端口

| 端口 | 服务 |
| --- | --- |
| 2001 | CAM |
| 2002 | DENM |
| 2003 | MAPEM |
| 2004 | SPATEM |
| 2006 | IVIM |

### 7.3 发送

V2xFac 调用 V2xBtp_Transmit,V2xBtp 添加 BTP 头并调用 V2xGn_Transmit。

### 7.4 接收

V2xGn 调用 V2xBtp_RxIndication,V2xBtp 解析 BTP 头并根据 destination port 路由到相应的 V2xFac 子服务。

### 7.5 错误分类

#### 7.5.1 开发错误

| 错误名 | 错误码 | 含义 |
| --- | --- | --- |
| V2XBTP_E_UNINIT | 0x01 | 未初始化 |
| V2XBTP_E_PARAM_POINTER | 0x02 | NULL 指针 |
| V2XBTP_E_INVALID_PARAMETER | 0x03 | 无效参数 |

---

## 8. API 规范

### 8.1 导入类型

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

### 8.2 类型定义

#### 8.2.1 V2xBtp_ConfigType
```c
typedef struct V2xBtp_ConfigType V2xBtp_ConfigType;
```

#### 8.2.2 V2xBtp_PortType
```c
typedef uint16 V2xBtp_PortType;
```

### 8.3 函数定义

#### 8.3.1 V2xBtp_Init
```c
void V2xBtp_Init(const V2xBtp_ConfigType* configPtr)
```

#### 8.3.2 V2xBtp_GetVersionInfo
```c
void V2xBtp_GetVersionInfo(Std_VersionInfoType* versionInfo)
```

#### 8.3.3 V2xBtp_Transmit
```c
Std_ReturnType V2xBtp_Transmit(
    PduIdType TxPduId,
    const PduInfoType* PduInfoPtr,
    V2xBtp_PortType destPort,
    V2xBtp_PortType srcPort
)
```

### 8.4 回调通知

#### 8.4.1 V2xBtp_RxIndication
```c
void V2xBtp_RxIndication(
    PduIdType RxPduId,
    const PduInfoType* PduInfoPtr,
    V2xBtp_PortType destPort,
    V2xBtp_PortType destPortInfo
)
```

#### 8.4.2 V2xBtp_TxConfirmation
```c
void V2xBtp_TxConfirmation(PduIdType TxPduId)
```

### 8.5 调度函数
无。

### 8.6 期望接口

#### 8.6.1 强制接口
- V2xGn_Transmit
- V2xFac_RxIndication
- Det_ReportError

---

## 9. 配置规范

### 9.1 容器与配置参数

#### 9.1.1 V2xBtp
根容器。

#### 9.1.2 V2xBtpGeneral
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| V2xBtpDevErrorDetect | bool | DET 启用 |
| V2xBtpVersionInfoApi | bool | 版本信息 API |

#### 9.1.3 V2xBtpPdu
PDU 配置(端口、引用 V2xGn)。

> **[摘要]** 完整配置详见原文 PDF 第 25-32 页。

---

## 翻译说明

- 本译本基于 AUTOSAR CP 4.4.0 的 V2X 基础传输规范 (Document ID 797,共 33 页)
- 摘要标记位置:第 6 章需求追溯、第 9 章配置