代码解析:安卓VHAL的AIDL参考实现
以下内容基于安卓14的VHAL代码。
总体架构
参考实现采用双层架构。上层是 DefaultVehicleHal,实现了 VHAL AIDL 接口,并提供适用于所有硬件设备的通用 VHAL 逻辑。下层是 FakeVehicleHardware,实现了 IVehicleHardware 接口。此类可模拟与实际硬件或车载总线交互的 VHAL 逻辑,并且特定于设备。供应商也可以视需要调整这一架构,重复使用同一 DefaultVehicleHal 类(扩展该类以覆盖某个方法),并提供自己的 IVehicleHardware 实现。
图1
DefaultVehicleHal 包含以下被认为适用于任何 VHAL 实现的通用逻辑:
- 实现 IVehicle 接口。
- 执行基本的输入检查,包括检查是否存在重复 ID。
- 为每个 binder 客户端的每个操作分配客户端对象(例如 GetValuesClient),并将每个对象添加到全局池。
- 管理异步回调逻辑,例如将待处理请求添加到待处理请求池。在我们收到结果时解决待处理的请求,或者在某个待处理的请求超时时返回错误。
- 序列化和反序列化 LargeParcelable(详见 ParcelableUtils.h)。
- 管理订阅(详见 SubscriptionManager.h)。
- 检查权限(详见 checkReadPermission 和 checkWritePermission 函数)。
- 定期调用 IVehicleHardware.checkHealth 并发送检测信号(详见 checkHealth 函数)。
IVehicleHardware 是一个通用接口,用于表示 VHAL 的硬件专用实现。IVehicleHardware 的参考实现是 FakeVehicleHardware,它使用内存中映射存储属性值,并且不与实际车载总线通信。其目的是在模拟器上运行,不依赖特定硬件。供应商实现不能直接使用它,而必须添加车载总线特定的逻辑。
调用时序
下面以setValues()接口为例进行说明:
FakeVehicleHardware实现了IVehicleHardware。
图2
PendingRequestHandler中有一个线程,一直在处理request。
图3
最终,FakeVehicleHardware将value写入VehiclePropertyStore::Record中保存。这里只是参考实现,所以没有实际发送给对手件,只是将数值存入VHAL。
图4
接口文件定义
HIDL VHAL中接口定义文件为types.hal,IVehicle.hal和IVehicleCallback.hal。
AIDL VHAL中,IVehicle .aidl和IVehicleCallback.aidl对应IVehicle.hal和IVehicleCallback.hal。
types.hal中的内容则是拆分到VehicleProperty.aidl,VehiclePropertyGroup.aidl, VehicleArea.aidl, VehiclePropertyType.aidl等等多个aidl文件中。其中VehicleProperty.aidl是用来添加信号ID的。
下面是VehicleProperty.aidl中一个原生的信号
HVAC_FAN_SPEED = 0x0500 + 0x10000000 + 0x05000000 + 0x00400000, // VehiclePropertyGroup:SYSTEM,VehicleArea:SEAT,VehiclePropertyType:INT32
信号ID的计算方式从types.hal中的或运算改为了更直观的加法,但信号ID的结构并没有发生变化,还是由4位的ID、VehiclePropertyGroup 、VehicleArea 、VehiclePropertyType 这4个部分组成。
默认值定义
HIDL VHAL中,定义默认值使用的文件为DefaultConfig.h,格式
{.config = {.prop = toInt(VehicleProperty::HVAC_FAN_SPEED),
.access = VehiclePropertyAccess::READ_WRITE,
.changeMode = VehiclePropertyChangeMode::ON_CHANGE,
.areaConfigs = {VehicleAreaConfig{
.areaId = HVAC_ALL, .minInt32Value = 1, .maxInt32Value = 7}}},
.initialValue = {.int32Values = {3}}},
AIDL VHAL中,定义默认值使用的文件为DefaultProperties.json,格式
{
"property": "VehicleProperty::HVAC_FAN_SPEED",
"defaultValue": {
"int32Values": [
3
]
},
"areas": [
{
"areaId": "Constants::SEAT_1_LEFT",
"minInt32Value": 1,
"maxInt32Value": 7
},
{
"areaId": "Constants::SEAT_1_RIGHT",
"minInt32Value": 1,
"maxInt32Value": 7
},
{
"areaId": "Constants::SEAT_2_LEFT",
"minInt32Value": 1,
"maxInt32Value": 7
},
{
"areaId": "Constants::SEAT_2_RIGHT",
"minInt32Value": 1,
"maxInt32Value": 7
},
{
"areaId": "Constants::SEAT_2_CENTER",
"minInt32Value": 1,
"maxInt32Value": 7
}
]
},
interfaces\automotive\vehicle\aidl\impl\default_config\config\README.md在README文件中有对json的格式有具体说明。
附录
最后附上本文中plantuml流程图的代码:
图2:
@startuml 'https://plantuml.com/sequence-diagram 'AIDL setValue autonumber AIDL_Client -> DefaultVehicleHal: setValues DefaultVehicleHal -> FakeVehicleHardware: setValues FakeVehicleHardware -> PendingRequestHandler: addRequest @enduml
图4:
@startuml 'https://plantuml.com/sequence-diagram autonumber PendingRequestHandler -> PendingRequestHandler: handleRequestsOnce PendingRequestHandler -> FakeVehicleHardware: handleSetValueRequest FakeVehicleHardware -> FakeVehicleHardware: setValue FakeVehicleHardware -> VehiclePropertyStore: writeValue @enduml