夜雨聆风学习资料网

ARTICLE · 1392057

VHAL 源码解析IVehicle、VehicleProperty 与车辆属性如何协同工作

VHAL 源码解析IVehicle、VehicleProperty 与车辆属性如何协同工作

在 AAOS 车载系统开发中,很多开发者已经知道:车辆 ECU 通过 CAN 总线发送数据,VHAL 负责将底层车辆信号转换成 Android 能够识别的 VehicleProperty,CarService 再将这些数据提供给上层应用。

但真正开始阅读 AOSP 源码时,很快就会遇到几个问题:IVehicle 定义了哪些接口、VehicleProperty 为什么不是简单枚举、VehiclePropConfig 与 VehiclePropValue 各负责什么,以及读写请求与事件回调究竟怎样落到源码上(见图 1)。

图 1 真正开始读 VHAL 源码时会遇到的问题

这些问题实际上构成了理解 VHAL 源码的基础。上一篇介绍了 VHAL 在 AAOS 中的整体架构,这一篇直接进入 AOSP 源码,从接口定义、属性模型和数据结构三个方面,拆解 VHAL 的核心实现。

一、先找到 VHAL 的核心源码

阅读 VHAL,首先要找到正确的源码目录。在 AOSP 中,AIDL VHAL 的核心代码位于 hardware/interfaces/automotive/vehicle/:接口定义放在 aidl/,参考实现放在 aidl/impl/,属性定义则单独放在 aidl_property/。

图 2 AIDL VHAL 的核心源码目录

这里需要注意 Android 版本差异:

•Android 13:VHAL 迁移到 AIDL。•Android 14:车辆属性定义进一步拆分到独立的 aidl_property 接口。•Android 15、16:继续演进 AIDL VHAL 和属性接口版本。

图 3 不同 Android 分支的 VHAL 接口差异

版本差异阅读源码时一定要先确定目标 Android 分支,不能直接把不同版本的接口文件混在一起。对于新项目,建议优先研究 AIDL VHAL,而不是从旧版 HIDL 开始开发。

二、IVehicle:VHAL 最核心的接口

先看 IVehicle.aidl,它定义了 Android Framework 与 Vendor VHAL 之间的通信契约。

接口契约CarService 不需要知道车辆使用什么 CAN 控制器,也不需要知道 ECU 报文格式,只需要按照 IVehicle 定义的接口访问车辆属性。

图 4 IVehicle 定义 Framework 与 Vendor VHAL 的契约

IVehicle 的核心方法可以归纳为六类:

方法

作用

getAllPropConfigs()

获取所有支持的车辆属性配置

getPropConfigs()

获取指定属性的配置

getValues()

异步读取车辆属性

setValues()

异步设置车辆属性

subscribe()

订阅车辆属性变化

unsubscribe()

取消属性订阅

图 5 IVehicle 的六类核心方法与三类能力

IVehicle 核心方法签名 · AIDL

VehiclePropConfigs getAllPropConfigs();VehiclePropConfigs getPropConfigs(in int[] props);void getValues(IVehicleCallback callback,    in GetValueRequests requests);void setValues(IVehicleCallback callback,    in SetValueRequests requests);void subscribe(IVehicleCallback callback,    in SubscribeOptions[] options,    int maxSharedMemoryFileCount);void unsubscribe(IVehicleCallback callback,    in int[] propIds);

1. getAllPropConfigs()

作用是获取当前 VHAL 支持的全部车辆属性配置,例如 PERF_VEHICLE_SPEED、ENGINE_RPM、GEAR_SELECTION、HVAC_TEMPERATURE_SET、DOOR_LOCK。CarService 在初始化阶段,需要了解当前车辆究竟支持哪些属性。

例如某车型支持车速、档位、空调温度,但不支持某些特定的座椅控制属性,那么 VHAL 返回的配置集合就反映了当前硬件实际提供的能力。

重要区别VehicleProperty 定义的是属性规范,getAllPropConfigs() 返回的是当前车辆实际支持的属性配置。两者不能混为一谈。

图 6 属性规范不等于当前车辆实际支持的能力

2. getPropConfigs()

如果只想查询某几个属性,就不需要获取全部配置。VHAL 返回对应属性的配置后,上层可以据此判断:

属性是否支持

只读还是可读写

数据类型

是否连续更新

是否存在多个区域

区域配置

3. getValues()

这是车辆数据读取接口,注意这里采用的是异步请求方式 —— 并不是调用 getValues() 就立即返回所有车辆数据。

图 7 getValues() 是一次异步请求

为什么要采用异步方式?因为底层车辆通信可能涉及 CAN 总线请求、MCU 通信、车辆网关转发、ECU 响应等待,以及数据转换和校验。如果所有操作都采用同步阻塞方式,很容易影响系统服务的响应能力。另外,AIDL VHAL 支持批量读取请求,可以减少频繁跨进程通信带来的开销。

图 8 为什么 VHAL 读写采用异步方式

4. setValues()

与 getValues() 对应,setValues() 用于设置车辆属性,例如 HVAC_TEMPERATURE_SET = 22.0。请求进入 VHAL 后,通常需要经过属性校验、区域校验、权限与状态检查,再转换为车辆控制信号发送给 ECU。

图 9 setValues() 进入 VHAL 后的处理流水线

异步结果setValues() 请求被接收,不代表 ECU 已经成功执行。真正的执行结果需要通过 onSetValues() 等回调反馈。

5. subscribe()

车辆数据有些变化非常频繁,例如车速、发动机转速、电机转速、方向盘角度。如果 App 每隔几毫秒主动调用一次 getValues(),显然不合理,因此 VHAL 提供了订阅机制。

Property ID

Area ID

Sample Rate

Resolution

分别对应需要订阅的属性、需要监听的车辆区域、连续属性的采样频率,以及连续属性更新的最小变化粒度。例如 PERF_VEHICLE_SPEED 采样频率 10 Hz,表示希望以每秒 10 次的频率接收车速更新。

图 10 subscribe() 的四个订阅选项

注意具体更新频率还受到 VHAL 能力和车辆总线数据频率的限制。

6. unsubscribe()

当客户端不再需要某个属性时,可以取消订阅。这对于资源管理非常重要,例如进入车辆页面时订阅车速和档位,退出页面后取消不再需要的订阅。

要点VHAL 订阅通常由 CarService 统一管理和复用,不能简单理解为每个 App 都直接创建独立的底层硬件订阅。

三、IVehicleCallback:车辆数据如何返回?

如果说 IVehicle 负责接收请求,那么 IVehicleCallback 就负责把处理结果返回给调用方。主要包含四类回调:

回调

用途

onGetValues

返回读取属性的结果

onSetValues

返回设置属性的结果

onPropertyEvent

通知属性发生变化

onPropertySetError

报告无法关联到具体设置请求的异步设置错误

图 11 IVehicleCallback 的四类回调

这里重点看 onPropertyEvent()。例如车辆速度从 40km/h 变成 50km/h,VHAL 发现属性值发生变化后,就可以通过回调通知 CarService。

图 12 车速从 40 变成 50 km/h 的事件分发链

务必区分onGetValues() 响应主动读取请求,onPropertyEvent() 推送属性变化事件。两个回调虽然都能传递车辆属性值,但使用场景不同。

四、VehicleProperty:车辆属性究竟如何定义?

接下来进入 VHAL 最重要的数据模型:VehicleProperty,它定义了 Android 认识的车辆属性。但是 VehicleProperty 并不是简单的字符串,它的 ID 采用位字段编码,一个属性 ID 包含多个信息。

图 13 VehicleProperty 的 ID 采用位字段编码

•Group:属性分组,区分系统属性和供应商自定义属性(SYSTEM / VENDOR)。•Area:车辆区域类型,例如 GLOBAL / WINDOW / SEAT / DOOR / MIRROR。•Type:属性数据类型,例如 BOOLEAN / INT32 / FLOAT / STRING / MIXED。•ID:属性编号,用于区分具体的车辆属性。

图 14 四个字段各自的常见取值

这种编码方式的好处是:通过一个整数,就可以携带属性所属分组、区域类型和数据类型等信息。

扩展约束因此,Vendor 自定义属性不能随意定义一个整数,必须遵循 VHAL 的属性 ID 编码规则,并使用 VENDOR 属性分组。

五、VehiclePropertyType:属性值使用什么数据类型?

VehiclePropertyType 决定了属性值如何存储和解释,常见类型如下:

类型

含义

示例

BOOLEAN

布尔值

ABS_ACTIVE

INT32

32 位整数

GEAR_SELECTION

INT64

64 位整数

时间戳

FLOAT

浮点数

VEHICLE_SPEED

STRING

字符串

VIN

BYTES

字节数组

二进制数据

INT32_VEC

整数数组

多值属性

FLOAT_VEC

浮点数组

多值属性

MIXED

混合类型

复合数据

图 15 VehiclePropertyType 的九种常见类型

例如车速 PERF_VEHICLE_SPEED 是 FLOAT,档位 GEAR_SELECTION 是 INT32,VIN INFO_VIN 是 STRING。

容易忽略属性的数据类型是由 VehicleProperty 定义的,不能由 App 随意决定。例如车速定义为 FLOAT,VHAL 就必须按照对应类型提供数据,否则可能出现属性配置不匹配、数据解析失败等问题。

图 16 属性的数据类型由 VehicleProperty 定义

排查时应统一检查 Property ID、Property Type、VehiclePropConfig、VehiclePropValue 四者是否一致。

六、VehiclePropConfig:描述一个属性的能力

如果 VehicleProperty 负责定义属性,那么 VehiclePropConfig 就负责描述当前 VHAL 如何实现这个属性。它是 VHAL 初始化时非常重要的数据结构,通常包含 prop、access、changeMode、configFlags、configString、configArray、minSampleRate、maxSampleRate、areaConfigs 九个字段。

图 17 VehiclePropConfig 描述一个属性的能力

1. prop

属性 ID,例如 VehicleProperty::PERF_VEHICLE_SPEED。

2. access

访问权限分为 READ、WRITE、READ_WRITE。车速通常是只读属性,而空调目标温度可能是 READ_WRITE。

3. changeMode

变化模式分为 STATIC、ON_CHANGE、CONTINUOUS。例如车速是 CONTINUOUS,车门状态是 ON_CHANGE。

4. minSampleRate / maxSampleRate

用于描述连续属性支持的采样频率范围,例如 minSampleRate = 1 Hz、maxSampleRate = 50 Hz。具体数值需要由实际车辆硬件能力决定,不能随意填写。

5. areaConfigs

用于描述区域属性的配置。例如四座车辆可能具有多个座椅区域,每个区域还可以具有独立的最小值、最大值等配置:

DRIVER

FRONT_PASSENGER

REAR_LEFT

REAR_RIGHT

结论VehiclePropConfig 不仅告诉 Android 某个属性是否存在,还告诉 Android 应该如何使用它。

七、VehiclePropValue:真正承载车辆数据的结构

前面介绍了 VehicleProperty 与 VehiclePropConfig,现在看真正传递车辆数据的结构:VehiclePropValue。它主要包含 prop、areaId、timestamp、status、value。

图 18 VehiclePropValue 真正承载车辆数据

1. prop

表示当前数据属于哪个车辆属性,例如 PERF_VEHICLE_SPEED。

2. areaId

表示当前数据属于哪个区域,例如 GLOBAL、DRIVER、FRONT_PASSENGER。对于全局属性通常使用对应的全局区域 ID。

3. timestamp

表示属性值对应的时间戳。车辆数据通常来自不同 ECU,时间戳对于数据同步、延迟分析和数据融合非常重要。

4. status

表示属性值当前是否可用,常见状态如下:

AVAILABLE

UNAVAILABLE

ERROR

例如车辆启动前,某些属性可能尚未准备好。

易错点这时候不能简单地把数值 0 理解为真实车辆数据。

5. value

真正的数据载体,内部使用 RawPropValues 表示不同类型的数据:

int32Values

int64Values

floatValues

byteValues

stringValue

RawPropValues

一个车速 VehiclePropValue

prop = PERF_VEHICLE_SPEEDareaId = GLOBALstatus = AVAILABLEvalue = 60.0

这样 Android 就可以通过统一结构传递不同车辆的属性数据。

八、把三个核心数据结构联系起来

现在可以把它们放在一起理解:VehicleProperty 定义属性是什么,VehiclePropConfig 描述属性如何使用,VehiclePropValue 承载属性的实际数据,最后交给 CarService 分发给应用。

图 19 三个核心数据结构如何串起一条链路

举一个完整例子:假设要实现车速读取,先定义属性,再配置访问方式、变化模式与类型,车辆行驶时 VHAL 接收到 60.0 km/h 的车速信号,最终封装为属性值:

车速读取:定义 → 配置 → 属性值

VehicleProperty:PERF_VEHICLE_SPEEDAccess: READ ChangeMode: CONTINUOUS Type: FLOATVehiclePropValue:{  prop: PERF_VEHICLE_SPEED,  areaId: GLOBAL,  status: AVAILABLE,  value: 60.0}

属性定义 → 属性配置 → 属性值 → 事件分发

再通过属性事件回调发送给 CarService,整个过程就是这四步。

九、从源码看 DefaultVehicleHal 的分层设计

理解接口和数据结构之后,就可以进入真正的 VHAL 实现。AOSP 提供了 AIDL VHAL 参考实现,重点关注:

DefaultVehicleHal.cpp

DefaultVehicleHal.h

VehicleService.cpp

其中 VehicleService 负责创建并启动 VHAL 服务,DefaultVehicleHal 负责实现通用的 IVehicle 接口逻辑,底层硬件则通过 IVehicleHardware 抽象,参考实现中的硬件模拟类是 FakeVehicleHardware。

图 20 DefaultVehicleHal 的分层设计

• 通用接口校验由 DefaultVehicleHal 处理。• 异步请求管理由通用实现处理。• 订阅管理由通用实现处理。• 真实 CAN 通信由 OEM 硬件层实现。• 车辆信号解析和属性映射由 OEM 根据车型实现。

设计价值通用 VHAL 逻辑与 OEM 硬件实现分离。因此 OEM 不一定需要从零实现整个 IVehicle,可以复用 AOSP 的通用实现,再替换底层硬件适配部分。

十、一个实际的 VehicleProperty 配置设计示例

假设现在需要实现一个车辆车速属性。设计目标是:属性 PERF_VEHICLE_SPEED、类型 FLOAT、访问方式 READ、变化模式 CONTINUOUS、更新频率 1~50 Hz、区域 GLOBAL。在配置逻辑中,需要保证:

VehiclePropConfig · C++

VehiclePropConfig config{};config.prop =    toInt(VehicleProperty::PERF_VEHICLE_SPEED);config.access =    VehiclePropertyAccess::READ;config.changeMode =    VehiclePropertyChangeMode::CONTINUOUS;config.minSampleRate = 1.0f;config.maxSampleRate = 50.0f;

这里是说明配置字段的简化示例,真实 AOSP 工程还需要根据目标版本使用对应的 AreaConfig、属性类型定义及配置容器。然后底层车辆数据转换为:

VehiclePropValue · C++

VehiclePropValue value{};value.prop =    toInt(VehicleProperty::PERF_VEHICLE_SPEED);value.areaId = 0;value.status =    VehiclePropertyStatus::AVAILABLE;value.value.floatValues = {  60.0f};

实际工程中还需要正确设置时间戳,并通过参考实现提供的属性值构造和事件分发机制提交数据。

注意这里的代码用于说明核心字段,并不是一个可以直接替换 DefaultVehicleHal 的完整驱动实现。

图 21 设计一个车速属性配置需要设置哪些字段

十一、开发 VHAL 时最容易出现的几个问题

问题 1:属性 ID 定义正确,但数据类型不匹配

例如属性定义为 FLOAT,实际却返回 INT32,会造成属性数据解释错误。解决思路是统一检查:

Property ID

Property Type

VehiclePropConfig

VehiclePropValue

问题 2:属性配置支持,但实际车辆没有数据

getAllPropConfigs() 能够看到车速属性,但读取时一直返回错误。原因可能是:

• CAN 没有收到报文。• ECU 没有响应。• 信号解析错误。• 属性缓存没有更新。• 数据状态为 UNAVAILABLE。

所以属性存在,不代表属性数据一定可用。

问题 3:连续属性更新频率不合理

例如车速属性配置支持 50Hz,但实际 CAN 报文只有 10Hz,那么即使订阅 50Hz,也不能凭空产生 50 次真实数据更新。需要根据以下四项共同确定更新频率:

CAN 报文频率

VHAL 更新能力

Sample Rate

CarService 分发策略

问题 4:Area ID 使用错误

例如空调有左前和右前两个区域,如果始终使用全局 Area ID,就可能无法正确访问对应区域。因此开发区域属性时,必须同时检查:

VehicleArea

AreaConfig

Area ID

问题 5:只关注接口,不关注异步生命周期

VHAL 的 getValues 和 setValues 采用异步回调。如果请求一直没有结果,或者请求超时后没有正确释放资源,就可能造成:

请求堆积

回调丢失

内存增长

状态不一致

因此真正的 VHAL 实现还必须考虑请求超时、取消、回调和服务异常退出。

图 22 开发 VHAL 最容易出现的五个问题

十二、如何验证自己实现的 VHAL?

在实际项目中,不能只通过 Android App 判断 VHAL 是否正常,建议分三个层次验证。

第一层:检查 VHAL 服务

确认车辆 HAL 服务已经注册。

第二层:检查属性配置

参考 VHAL 支持通过 dump 命令查看属性信息,也可以用 --help 查看支持的调试参数。具体调试命令取决于当前 VHAL 实现。

第三层:执行 VTS

AOSP 提供 VtsHalAutomotiveVehicle_TargetTest,用于验证 VHAL 接口实现和属性配置是否符合规范。

VHAL 验证常用命令 · ADB / VTS

adb shell service listadb rootadb shell dumpsys \ android.hardware.automotive.vehicle.IVehicle/defaultadb shell dumpsys \ android.hardware.automotive.vehicle.IVehicle/default --helpVtsHalAutomotiveVehicle_TargetTest

图 23 验证自己实现的 VHAL:三个层次

工程建议对于 OEM 项目,建议将 VTS 纳入持续集成流程,而不是等到系统集成阶段才开始测试。

十三、总结:理解 VHAL,先掌握这三个核心对象

阅读完这篇源码解析,应该建立一个清晰的认识:IVehicle 提供统一读写订阅接口,VehicleProperty 定义属性,VehiclePropConfig 描述配置,VehiclePropValue 承载实际数据,再经 IVehicleCallback、CarService 到达 Android App。

图 24 总结:理解 VHAL,先掌握四个核心对象

可以记住四句话:

01IVehicle:定义 Android 如何访问车辆属性。02VehicleProperty:定义 Android 能够识别哪些车辆属性。03VehiclePropConfig:定义当前车辆支持这些属性的哪些能力。04VehiclePropValue:承载车辆属性的实际数据。

这四个概念是理解 VHAL 源码的基础。对于 OEM 开发者来说,真正需要掌握的并不是简单地调用几个接口,而是如何将车型底层的 CAN、MCU、ECU 数据,正确映射到 Android 标准车辆属性模型。

结语只有把接口、属性配置和数据结构三者的关系搞清楚,后面开发自定义 VHAL、Vendor Property、CAN 信号映射和车辆数据订阅时,才不会陷入只会改代码、不理解数据链路的困境。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料