HIDL软件包
HIDL 接口软件包位于 hardware/interfaces 或 vendor/ 目录下(个别情况除外)。顶层 hardware/interfaces 会直接映射到 android.hardware 软件包命名空间;版本是软件包(而不是接口)命名空间下的子目录。
hidl-gen 编译器会将 .hal 文件编译成一组 .h 和 .cpp 文件。这些自动生成的文件可用来构建客户端/服务器实现链接到的共享库。用于构建此共享库的 Android.bp 文件由 hardware/interfaces/update-makefiles.sh 脚本自动生成。
每次将新软件包添加到 hardware/interfaces 或在现有软件包中添加/移除 .hal 文件时,都必须重新运行该脚本,以确保生成的共享库是最新的。
例如,IFoo.hal
示例文件应该位于 hardware/interfaces/samples/1.0
下。IFoo.hal
示例文件会在 samples 软件包中创建一个 IFoo 接口:
package android.hardware.samples@1.0;
interface IFoo {struct Foo {int64_t someValue;handle myHandle;};someMethod() generates (vec<uint32_t>);anotherMethod(Foo foo) generates (int32_t ret);
};
生成的文件
HIDL 软件包中自动生成的文件会关联到与该软件包同名的单个共享库(例如 android.hardware.samples@1.0
)。该共享库还会导出单个头文件 IFoo.h
,它可以包含在客户端和服务器中。在 Binder 化模式下,使用 hidl-gen
编译器以 IFoo.hal
接口文件作为输入会自动生成以下文件:
上图由编译器生成的文件
IFoo.h
描述 C++ 类中的纯IFoo
接口;它包含IFoo.hal
文件中的IFoo
接口中定义的方法和类型。该类的命名空间包含软件包名称和版本号,例如::android::hardware::samples::IFoo::V1_0
。客户端和服务器都包含此头文件:客户端用它来调用方法,服务器用它来实现这些方法。IHwFoo.h
一个头文件,包含用于对接口中使用的数据类型进行序列化的函数的声明。开发者不得直接包含此头文件(它不包含任何类)。BpHwFoo.h
一个类,从IFoo
继承而来,并描述接口的HwBinder
代理(客户端)实现。开发者不得直接引用此类。BnHwFoo.h
一个类,保持对IFoo
实现的引用,并描述接口的HwBinder
存根(服务器端)实现。开发者不得直接引用此类。FooAll.cpp
一个类,包含HwBinder
代理和HwBinder
存根的实现。
关联到共享库
使用软件包中的任何接口的客户端或服务器必须在Android.mk或者Android.bp中包含该软件包的共享库:
-
在 Android.mk 中:
LOCAL_SHARED_LIBRARIES += android.hardware.samples@1.0
-
在 Android.bp 中:
shared_libs: [/* ... */"android.hardware.samples@1.0", ],
可能需要包含的其他库:
-
libhidlbase
包含标准 HIDL 数据类型。从 Android 10 开始,此库还包含先前在 libhidltransport 和 libhwbinder 中的所有符号。
-
libhidltransport
通过不同的 RPC/IPC 机制处理 HIDL 调用的传输。Android 10 弃用了此库。
-
libhwbinder
Binder 专用符号。Android 10 弃用了此库。
-
libfmq
快速消息队列 IPC。
hwservicemanager
注册接口实现时,hwservicemanager
进程会按名称和版本号跟踪设备上正在运行的已注册 HIDL 接口,务器可以按名称注册 HIDL 接口实现,而客户端则可以按名称和版本号请求服务实现。
每个自动生成的 HIDL 接口头文件都有一个registerAsService()
方法,可用于向 hwservicemanager
注册接口实现。唯一一个必需的参数是接口实现的名称,因为稍后客户端将使用此名称从 hwservicemanager
检索接口:
sp<IComponentStore> store;
store = new utils::ComponentStore(std::make_shared<StoreImpl>());
if (store == nullptr) {LOG(ERROR) << "Cannot create Codec2's IComponentStore service.";
} else {constexpr char const* serviceName = "default";if (store->registerAsService(serviceName) != OK) {LOG(ERROR) << "Cannot register Codec2's IComponentStore service";} else {LOG(DEBUG) << "Codec2's IComponentStore service registered. "}
}
hardware/google/interfaces/light/1.0/default/service.cpp
android::sp<hwLight> light = new LightExt{android::hardware::light::V2_0::implementation::HIDL_FETCH_ILight(nullptr)};auto ret = light->registerAsService();if (ret != android::OK) {ALOGE("open light servie failed, ret=%d", ret);return 1;}
LSHAL
LSHAL 是一种设备端工具,可以列出向 hwservicemanager
注册的所有 HAL 以及设备上所有可用的直通实现(例如 android.hardware.foo@1.0-impl.so
)。它还可以根据该列表生成设备清单文件:
$ lshal --init-vintf
service list
过滤hardware
关键字:
enus:/sdcard # service list | grep hardware
15 android.hardware.light.ILights/default: [android.hardware.light.ILights]
16 android.hardware.power.IPower/default: [android.hardware.power.IPower]
17 android.hardware.vibrator.IVibrator/default: [android.hardware.vibrator.IVibrator]
27 auth: [android.hardware.biometrics.IAuthService]
34 biometric: [android.hardware.biometrics.IBiometricService]
42 color_display: [android.hardware.display.IColorDisplayManager]
46 consumer_ir: [android.hardware.IConsumerIrService]
59 display: [android.hardware.display.IDisplayManager]
71 fingerprint: [android.hardware.fingerprint.IFingerprintService]
76 hardware_properties: [android.os.IHardwarePropertiesManager]
81 input: [android.hardware.input.IInputManager]
92 lights: [android.hardware.lights.ILightsManager]
100 media.camera: [android.hardware.ICameraService]
101 media.camera.proxy: [android.hardware.ICameraServiceProxy]
112 hui.cld.service: [hui.hardware.ICldManager]
168 sensor_privacy: [android.hardware.ISensorPrivacyManager]
170 serial: [android.hardware.ISerialManager]
205 usb: [android.hardware.usb.IUsbManager]
service list
过滤media
关键字:
1|shell:/sdcard # service list | grep media
26 audio: [android.media.IAudioService]
98 media.audio_flinger: [android.media.IAudioFlinger]
99 media.audio_policy: [android.media.IAudioPolicyService]
100 media.camera: [android.hardware.ICameraService]
101 media.camera.proxy: [android.hardware.ICameraServiceProxy]
102 media.extractor: [android.IMediaExtractorService]
103 media.metrics: [android.media.IMediaMetricsService]
104 media.player: [android.media.IMediaPlayerService]
105 media.resource_manager: [android.media.IResourceManagerService]
106 media_projection: [android.media.projection.IMediaProjectionManager]
107 media_resource_monitor: [android.media.IMediaResourceMonitor]
108 media_router: [android.media.IMediaRouterService]
109 media_session: [android.media.session.ISessionManager]
111 midi: [android.media.midi.IMidiManager]
178 soundtrigger_middleware: [android.media.soundtrigger_middleware.ISoundTriggerMiddlewareService]
207 vendor.audio.vrservice: [android.media.IVRAudioService]
lshal查看c2相关:
shell:/sdcard # lshal | grep c2
DM,FC Y android.hardware.media.c2@1.0::IComponentStore/default N/A N/A
DM,FM,FC Y android.hardware.media.c2@1.0::IComponentStore/softw N/A N/A
FM Y android.hardware.media.c2@1.1::IComponentStore/software N/A N/A
疑问:lshal | grep light
为什么没有light?
可能和defaultPassthroughServiceImplementation有关,需要深入研究下,暂缓。
1|shell:/sdcard # service list | grep light
15 android.hardware.light.ILights/default: [android.hardware.light.ILights]
92 lights: [android.hardware.lights.ILightsManager]
light的rc文件和service的代码:
hardware/interfaces/light/2.0/default/service.cpp
int main() {
#ifdef ARCH_ARM_32android::hardware::ProcessState::initWithMmapSize((size_t)(32768));
#endifreturn defaultPassthroughServiceImplementation<ILight>();
}
hardware/interfaces/light/2.0/default/android.hardware.light@2.0-service-lazy.rc
service vendor.light-hal-2-0 /vendor/bin/hw/android.hardware.light@2.0-serviceinterface android.hardware.light@2.0::ILight defaultclass haluser systemgroup system# shutting off lights while powering-offshutdown critical
defaultPassthroughServiceImplementation
将对提供的 -impl
库执行 dlopen()
操作,并将其作为 Binder 化服务提供。