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_32
android::hardware::ProcessState::initWithMmapSize((size_t)(32768));
#endif
return 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-service
interface android.hardware.light@2.0::ILight default
class hal
user system
group system
# shutting off lights while powering-off
shutdown critical
defaultPassthroughServiceImplementation 将对提供的 -impl 库执行 dlopen() 操作，并将其作为 Binder 化服务提供。
