# V2X 管理规范 (Specification of V2X Management)

> **AUTOSAR CP Release 4.4.0**
> **文档 ID 794: AUTOSAR_SWS_V2XManagement**

## 元信息

| 项目 | 内容 |
| --- | --- |
| 文档标题 | V2X 管理规范 |
| 文档所有者 | AUTOSAR |
| 文档责任方 | AUTOSAR |
| 文档标识号 | 794 |
| 文档状态 | 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 Management |

---

## 目录

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

---

## 1. 介绍

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

V2xM 是 ETSI ITS 架构中的管理实体(Management Entity),为 V2X 协议栈提供管理服务。

### 1.1 V2xM 的主要任务
- V2X 协议栈生命周期管理
- DCC(分散拥塞控制)
- 时间和位置同步
- 安全管理(可选)
- 跨层信息交换

---

## 2. 缩略语

| 缩略语 | 描述 |
| --- | --- |
| BSW | Basic Software |
| BTP | Basic Transport Protocol |
| DCC | Decentralized Congestion Control |
| DEM | Diagnostic Event Manager |
| DET | Default Error Tracer |
| ETSI | European Telecommunications Standards Institute |
| GN | GeoNetworking |
| ITS | Intelligent Transport System |
| ITS-S | ITS Station |
| POTI | Position and Time |
| V2X | Vehicle-to-everything |
| V2xFac | V2X Facilities |
| V2xM | V2X Management |

---

## 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] Requirements on V2X
- [6] Specification of V2X Facilities
- [7] Specification of V2X GeoNetworking

### 3.2 相关标准

- [8] ETSI TS 102 723 系列(管理服务)
- [9] ETSI TS 102 687(DCC)

---

## 4. 约束与假设

### 4.1 限制
V2xM 是 V2X 协议栈的一部分,需与 V2xFac、V2xGn、V2xBtp 协同工作。

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

---

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

| 模块 | 依赖关系 |
| --- | --- |
| V2xFac | 设施层 |
| V2xGn | 网络层 |
| V2xBtp | 传输层 |
| EcuM | ECU 状态 |
| Det | 错误上报 |

---

## 6. 需求可追溯性

| 需求 ID | 描述 | 满足者 |
| --- | --- | --- |
| SRS_BSW_00101 | 初始化 | SWS_V2xM_00010 |
| SRS_BSW_00407 | 版本信息 | SWS_V2xM_00020 |
| SRS_V2X_00001 | DCC 支持 | SWS_V2xM_00030 |

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

---

## 7. 功能规范

### 7.1 DCC (Decentralized Congestion Control)

DCC 用于控制总线拥塞,通过限制发送速率维护网络稳定。

#### 7.1.1 DCC 状态
- RELAXED:网络空闲
- ACTIVE:正常
- RESTRICTIVE:限制
- BLOCKED:阻塞

#### 7.1.2 DCC 算法
基于通道占用率(CBR)调整发送间隔。

### 7.2 时间和位置同步

V2xM 从 VDP 或外部 GNSS 获取时间和位置,提供给其他 V2X 模块。

### 7.3 安全管理(可选)

可选支持 ITS-S 签名/验证。

### 7.4 错误分类

#### 7.4.1 开发错误

| 错误名 | 错误码 | 含义 |
| --- | --- | --- |
| V2XM_E_UNINIT | 0x01 | 未初始化 |
| V2XM_E_PARAM_POINTER | 0x02 | NULL 指针 |
| V2XM_E_INVALID_PARAMETER | 0x03 | 无效参数 |

---

## 8. API 规范

### 8.1 导入类型

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

### 8.2 类型定义

#### 8.2.1 V2xM_ConfigType
```c
typedef struct V2xM_ConfigType V2xM_ConfigType;
```

#### 8.2.2 V2xM_DccStateType
```c
typedef enum {
    V2XM_DCC_RELAXED,
    V2XM_DCC_ACTIVE,
    V2XM_DCC_RESTRICTIVE,
    V2XM_DCC_BLOCKED
} V2xM_DccStateType;
```

### 8.3 函数定义

#### 8.3.1 V2xM_Init
```c
void V2xM_Init(const V2xM_ConfigType* configPtr)
```

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

#### 8.3.3 V2xM_GetDccState
```c
Std_ReturnType V2xM_GetDccState(V2xM_DccStateType* statePtr)
```

#### 8.3.4 V2xM_RequestSlot
```c
Std_ReturnType V2xM_RequestSlot(
    uint8 priority,
    uint16 sduSize,
    uint32* tokenPtr
)
```
请求发送时隙。

#### 8.3.5 V2xM_ReleaseSlot
释放时隙。

#### 8.3.6 V2xM_GetTime
获取当前时间。

#### 8.3.7 V2xM_GetPosition
获取当前位置。

### 8.4 调度函数

#### 8.4.1 V2xM_MainFunction
```c
void V2xM_MainFunction(void)
```

### 8.5 期望接口

#### 8.5.1 强制接口
- Det_ReportError

#### 8.5.2 可选接口
- V2xVdpGetVehicleDynamicData
- GNSS 接口

---

## 9. 时序图

> **[摘要]** 详细时序图见原文 PDF 第 35-50 页。

---

## 10. 配置规范

### 10.1 容器与配置参数

#### 10.1.1 V2xM
根容器。

#### 10.1.2 V2xMGeneral
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| V2xMDevErrorDetect | bool | DET 启用 |
| V2xMVersionInfoApi | bool | 版本信息 API |
| V2xMMainFunctionPeriod | float | main 周期 |

#### 10.1.3 V2xMDccConfig
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| V2xMDccEnabled | bool | 启用 DCC |
| V2xMDccCbrThreshold | float | CBR 阈值 |
| V2xMDccPriorityLevels | int | 优先级数量 |

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

---

## 翻译说明

- 本译本基于 AUTOSAR CP 4.4.0 的 V2X 管理规范 (Document ID 794,共 61 页)
- 摘要标记位置:第 6 章需求追溯、第 9 章时序图、第 10 章配置