ARTICLE · 1392057
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 信号映射和车辆数据订阅时,才不会陷入只会改代码、不理解数据链路的困境。 |















































































